📖 What is Ingvar Workflow Kit?

Ingvar Workflow Kit is an intelligent CLI tool that revolutionizes software development workflow management following Ingka Way of Working. Born from real-world development challenges at Ingka Digital (IKEA's digital hub), Ingvar combines multi-agent AI orchestration, spec-driven development, automated GitHub Projects integration, and intelligent workflow automation into a single, powerful command-line interface.

$3

Named after Ingvar Kamprad, the founder of IKEA, this toolkit embodies his core principles:

- Simplicity: Complex workflows made simple through intelligent automation
- Quality: Best practices enforced by specialized AI agents
- Efficiency: One command replaces hours of manual setup
- Accessibility: Designed for developers at all levels
- Continuous Improvement: Evolving with Ingka's way of working

$3

Modern development teams at Ingka and beyond face common challenges:

- ⏰ Time-consuming setup: Hours spent configuring GitHub Projects, labels, and templates
- 🔀 Inconsistent workflows: Each developer follows different processes
- 📝 Poor documentation: Features built without proper planning
- 🤖 Generic AI assistance: One-size-fits-all AI that lacks domain expertise
- 🔄 Manual tracking: Constantly updating issue statuses and project boards

$3

Ingvar transforms these pain points into strengths:

| Challenge | Ingvar Solution | Time Saved |
| ------------------------ | ------------------------------------------ | --------------------------------- |
| Manual GitHub setup | One-command initialization | 2-4 hours → 5 minutes |
| Inconsistent AI guidance | Multi-agent orchestration with specialists | 60% faster development |
| Unclear requirements | Spec-first decision making | 50% fewer missed requirements |
| Manual status updates | Automatic GitHub Projects sync | 100% automated |
| Generic best practices | Domain-specific expertise per agent | Higher code quality |

$3

- 🤖 Multi-Agent Intelligence: 6 specialized AI agents (Orchestrator, Frontend, Backend, DevOps, Testing, Documentation) provide expert guidance for every task
- 🎯 Smart Task Routing: Orchestrator analyzes your request and routes to the right specialist(s)
- 📋 Spec-First Methodology: Complex features get structured planning; simple tasks move fast
- ⚡ Lightning Setup: Complete workflow configuration in 5 minutes vs 2-4 hours manually
- 🔄 Zero-Touch Automation: Issues automatically sync with GitHub Projects, statuses update as you work
- 🎨 Best Practices Enforced: Component-first architecture, performance optimization, SEO excellence—built into every agent
- 🔧 Flexibility: Enable only the agents you need for your project type
- 🌍 Universal Compatibility: Works with personal repos, organizations, and any project type
- 🇸🇪 Ingka Standards: Aligned with Ingka Digital's development standards and best practices

---

🏗️ System Architecture

$3

Ingvar introduces an intelligent orchestration system that routes tasks to specialized AI agents based on domain expertise:

``
Your Development Request
│
▼
┌──────────────────────────────────────────┐
│ 🎛️ Orchestrator Agent │
│ Analyzes Keywords, Files & Intent │
└──────────┬───────────────────────────────┘
│
┌──────────────┬───────────┼───────────┬──────────────┬──────────────┐
│ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐
│ 🎨 Front│ │ ⚙️ Back │ │ 🚀 Dev │ │ 🧪 Test │ │ 📚 Docs │ │ 🔧 Config│
│ -end │ │ -end │ │ Ops │ │ -ing │ │ │ │ │
│ Expert │ │ Expert │ │ Expert │ │ Expert │ │ Expert │ │ Manager │
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └──────────┘ └──────────┘
UI/UX APIs CI/CD Quality Guides Settings
Components Database Deploy Coverage API Docs Projects
`

📊 View Full Architecture Diagram

---

✨ Core Features

$3

Ingvar v1.0 features an intelligent orchestration system with specialized agents:

#### Orchestrator Agent (Router & Coordinator)

- Analyzes every request to determine task type
- Routes to appropriate specialist agent(s)
- Coordinates multi-agent tasks
- Enforces Ingka workflow standards

#### Frontend Agent (UI/UX Specialist)

- Component-first architecture (Atomic Design)
- Accessibility compliance (WCAG 2.1 AA)
- Mobile-first responsive design
- Performance optimization (Core Web Vitals)
- SEO best practices

Triggers: component, UI, style, design, responsive, accessibility

#### Backend Agent (API & Database Specialist)

- RESTful API design
- Database optimization
- Authentication & security
- Input validation
- Error handling

Triggers: API, endpoint, database, auth, query, security

#### DevOps Agent (Infrastructure Specialist)

- CI/CD pipeline setup
- Docker containerization
- Cloud deployment (AWS, Azure, Railway)
- Monitoring & logging
- Environment configuration

Triggers: deploy, CI/CD, Docker, pipeline, infrastructure

#### Testing Agent (Quality Assurance Specialist)

- Unit testing strategies
- Integration tests
- E2E test automation
- Code coverage analysis
- Test-driven development

Triggers: test, spec, coverage, mock, fixture

#### Documentation Agent (Technical Writer)

- README maintenance
- API documentation
- User guides
- Code comments (JSDoc)
- Changelog management

Triggers: documentation, README, guide, comment, docs

$3

Ingvar works seamlessly with 4 major AI assistants:

- ✅ GitHub Copilot (.github/copilot-instructions.md)
- ✅ Cursor AI (.cursorrules)
- ✅ Cline (.clinerules)
- ✅ Codeium (.codeium/instructions.md)

Smart Sync: When you enable/disable agents, all AI instruction files update automatically.

$3

Ingvar enforces a smart decision tree for complex work:

`
┌─────────────────────────────────────┐
│ New Feature Request Arrives │
└──────────────┬──────────────────────┘
│
▼
┌──────────────┐
│ Effort > 1wk?│
└──────┬───────┘
│
┌──────┴───────┐
│ │
YES NO
│ │
▼ ▼
┌──────────┐ ┌──────────┐
│ Create │ │ Create │
│ SPEC │ │ Issue │
│ First │ │ Directly │
└──────────┘ └──────────┘
│ │
▼ ▼
┌──────────┐ ┌──────────┐
│ Get │ │ Start │
│ Approval │ │ Work │
└──────────┘ └──────────┘
│
▼
┌──────────┐
│ Break │
│ into │
│ Issues │
└──────────┘
`

Benefits:

- 🚀 Simple tasks move fast (< 1 day → immediate implementation)
- 🏗️ Complex features get structured planning (> 1 week → spec review)
- 📊 Better estimates and clearer expectations
- 🎯 Reduced scope creep and missed requirements

$3

Ingvar automatically syncs with GitHub Projects:

1. Issue Creation: Automatically creates GitHub issues with proper labels
2. Status Tracking: Updates project board as work progresses
3. Auto-Close: Issues close when PRs merge with "Closes #123"
4. Label Management: Sets up comprehensive label system (P0-P3, types, status)

Supported Project Layouts:

- ✅ Basic Kanban (Todo, In Progress, Done)
- ✅ Agile Sprint (Backlog, Todo, In Progress, Review, Done)
- ✅ Custom columns (auto-detected)

$3

8 production-ready templates following Ingka standards:

1. Bug Report: Detailed reproduction steps, environment info
2. Feature Request: User stories, acceptance criteria, mockups
3. Documentation: Gaps identified, target audience, scope
4. Security Vulnerability: CVSS scoring, impact assessment
5. Performance Issue: Metrics, profiling data, thresholds
6. Accessibility: WCAG level, affected users, severity
7. Refactoring: Technical debt assessment, migration plan
8. Deployment: Rollout strategy, rollback plan, monitoring

$3

Auto-configured labels with semantic meaning:

Priority (P0-P3):

- P0 🔴 Critical (production down, data loss)
- P1 🟠 High (major feature broken)
- P2 🟡 Medium (minor bug, enhancement)
- P3 🟢 Low (nice-to-have, polish)

Type (Feature, Bug, Docs, etc.):

- feature ✨ New functionality
- bug 🐛 Something broken
- docs 📚 Documentation
- refactor 🔧 Code improvement
- security 🔒 Vulnerability
- performance ⚡ Speed/efficiency

Status (Workflow stages):

- needs-review 👀 Awaiting review
- in-progress 🚧 Active work
- blocked 🚫 Dependencies

---

📦 Installation

$3

`bash
npm install -g ingvar-workflow-kit
`

$3

`bash
ingvar --version
`

$3

`bash

Navigate to your project

cd your-project

Initialize Ingvar workflow (one-time setup)

ingvar init
`

What ingvar init does:

1. ✅ Sets up docs/specs/ directory
2. ✅ Installs 8 professional issue templates
3. ✅ Configures comprehensive label system
4. ✅ Creates .ingvarrc.json configuration
5. ✅ Installs AI assistant instructions (Copilot, Cursor, Cline, Codeium)
6. ✅ Links to GitHub Projects (optional)

Time: ~5 minutes (vs 2-4 hours manual setup)

---

🚀 Quick Start

$3

`bash
npm install -g ingvar-workflow-kit
`

$3

`bash
cd your-project
ingvar init
`

$3

`bash

Authenticate with GitHub CLI (if not already)

gh auth login

Configure your repository in .ingvarrc.json

ingvar config github.owner your-org
ingvar config github.repo your-repo
`

$3

`bash
ingvar issue
`

Interactive prompt:

1. Choose template (bug, feature, docs, etc.)
2. Fill in details
3. Assign priority (P0-P3)
4. Auto-creates GitHub issue
5. Auto-links to GitHub Project
6. Status tracked automatically

$3

GitHub Copilot / Cursor / Cline / Codeium will now:

- ✅ Automatically create issues for work descriptions
- ✅ Route tasks to specialized agents
- ✅ Enforce Ingka best practices
- ✅ Update project board status
- ✅ Generate spec-compliant commit messages

Example:

`
You: "Add dark mode toggle to settings page"

Copilot (via Ingvar):
✓ Issue created: #42 - "Add dark mode toggle"
✓ Routing to Frontend Agent...
✓ Creating component with accessibility support
✓ Status updated: Todo → In Progress
`

---

🎯 Command Reference

$3

#### ingvar init

Initialize Ingvar workflow in current project.

`bash
ingvar init [options]

Options:
-o, --org GitHub organization name
-p, --project GitHub project number
--skip-project Skip GitHub Project setup
--skip-labels Skip label setup
--skip-vscode Skip VS Code configuration
--non-interactive Run with defaults (CI/CD mode)
`

Example:

`bash

Interactive setup (recommended)

ingvar init

Non-interactive with org

ingvar init --org ingka-group --project 4

Skip GitHub Project integration

ingvar init --skip-project
`

---

#### ingvar issue

Create spec-driven issue from templates.

`bash
ingvar issue [options]

Alias: ingvar i

Options:
-t, --template Template type (bug, feature, docs, etc.)
-T, --title