@namch/agent-assistant 1.0.1 → 1.0.3

package/documents/business/business-features.md

@@ -14,7 +14,7 @@ Agent Assistant provides a comprehensive feature set organized into six categori
 | Category | Feature Count | Description |
 |----------|---------------|-------------|
 | Specialist Agents | 20 | Domain expert personas |
-| Command Workflows | 40+ | Development workflow automations |
+| Command Workflows | 50+ | Development workflow automations (incl. /report, focus variant) |
 | Domain Skills | 310+ | On-demand knowledge modules |
 | Quality Gates | 5 | Automated verification checkpoints |
 | Orchestration Rules | 8 | Governance and coordination protocols |

package/documents/business/business-glossary.md

@@ -40,7 +40,7 @@ A **slash-prefixed workflow trigger** that initiates a structured development pr
 | With variant | `/cook:hard` |
 | With argument | `/cook:hard "implement OAuth"` |
 
-**Available Commands**: `/cook`, `/fix`, `/plan`, `/test`, `/review`, `/debug`, `/design`, `/docs`, `/deploy`, `/ask`, `/auto`, `/brainstorm`, `/code`
+**Available Commands**: `/cook`, `/fix`, `/plan`, `/test`, `/review`, `/debug`, `/design`, `/docs`, `/report`, `/deploy`, `/ask`, `/auto`, `/brainstorm`, `/code`
 
 ---
 
@@ -477,16 +477,17 @@ A **document specifying** what a product should do, including features, requirem
 
 | Command | Purpose | Variants |
 |---------|---------|----------|
-| `/cook` | Implement features | `:fast`, `:hard` |
-| `/code` | Generate code snippets | `:fast`, `:hard` |
-| `/fix` | Fix bugs | `:fast`, `:hard` |
-| `/test` | Generate tests | `:fast`, `:hard` |
+| `/cook` | Implement features | `:fast`, `:hard`, `:focus` |
+| `/code` | Generate code snippets | `:fast`, `:hard`, `:focus` |
+| `/fix` | Fix bugs | `:fast`, `:hard`, `:focus` |
+| `/test` | Generate tests | `:fast`, `:hard`, `:focus` |
 | `/review` | Code review | `:fast`, `:hard` |
-| `/debug` | Debug issues | `:fast`, `:hard` |
-| `/plan` | Create implementation plans | `:fast`, `:hard` |
+| `/debug` | Debug issues | `:fast`, `:hard`, `:focus` |
+| `/plan` | Create implementation plans | `:fast`, `:hard`, `:focus` |
 | `/brainstorm` | Discover requirements | `:fast`, `:hard` |
-| `/design` | UI/UX design | `:fast`, `:hard` |
+| `/design` | UI/UX design | `:fast`, `:hard`, `:focus` |
 | `/docs` | Generate documentation | `:core`, `:business`, `:audit` |
+| `/report` | Create/update reports, summaries | `:fast`, `:hard`, `:focus` |
 | `/deploy` | Deployment operations | `:check`, `:preview`, `:production`, `:rollback` |
 | `/ask` | Q&A about codebase | `:fast`, `:hard` |
 | `/auto` | Auto-detect best command | — |

package/documents/business/business-prd.md

@@ -11,7 +11,7 @@
 
 ### 1.1 Product Overview
 
-**Agent Assistant** is an open-source multi-agent orchestration framework that transforms a single AI coding assistant into a coordinated team of 20 specialist agents. It provides structured workflows, quality gates, and 310+ domain skills for production-grade AI-assisted software development.
+**Agent Assistant** is an open-source multi-agent orchestration framework that transforms a single AI coding assistant into a coordinated team of 21 specialist agents. It provides structured workflows, quality gates, and 310+ domain skills for production-grade AI-assisted software development.
 
 ### 1.2 Vision Statement
 
@@ -19,7 +19,7 @@
 
 ### 1.3 Mission Statement
 
-> **"To democratize software engineering excellence by orchestrating AI coding assistants into a cohesive team of 20 specialist agents, enabling developers to ship faster, safer, and more consistently through repeatable workflows and automated quality verification."**
+> **"To democratize software engineering excellence by orchestrating AI coding assistants into a cohesive team of 21 specialist agents, enabling developers to ship faster, safer, and more consistently through repeatable workflows and automated quality verification."**
 
 ### 1.4 Key Metrics
 
@@ -135,7 +135,7 @@ AI coding assistants are powerful but unstructured. Developers use AI tools in a
 
 | ID | Requirement | Priority | Status |
 |----|-------------|----------|--------|
-| FR-001.1 | System SHALL support 20 specialist agents | Must-Have | ✅ Complete |
+| FR-001.1 | System SHALL support 21 specialist agents | Must-Have | ✅ Complete |
 | FR-001.2 | System SHALL route tasks to appropriate agents | Must-Have | ✅ Complete |
 | FR-001.3 | System SHALL support tiered execution (sub-agent + embody) | Must-Have | ✅ Complete |
 | FR-001.4 | System SHALL enforce orchestration laws | Must-Have | ✅ Complete |
@@ -145,7 +145,7 @@ AI coding assistants are powerful but unstructured. Developers use AI tools in a
 
 | ID | Requirement | Priority | Status |
 |----|-------------|----------|--------|
-| FR-002.1 | System SHALL support 40+ command workflows | Must-Have | ✅ Complete |
+| FR-002.1 | System SHALL support 50+ command workflows | Must-Have | ✅ Complete |
 | FR-002.2 | System SHALL support workflow variants (:fast, :hard) | Must-Have | ✅ Complete |
 | FR-002.3 | System SHALL execute phases sequentially | Must-Have | ✅ Complete |
 | FR-002.4 | System SHALL verify exit criteria before phase transition | Must-Have | ✅ Complete |
@@ -284,8 +284,8 @@ AI coding assistants are powerful but unstructured. Developers use AI tools in a
 
 | Feature | Description | Status |
 |---------|-------------|--------|
-| 20 Specialist Agents | Domain experts | ✅ Complete |
-| Core Command Workflows | /cook, /fix, /plan, etc. | ✅ Complete |
+| 21 Specialist Agents | Domain experts | ✅ Complete |
+| Core Command Workflows | /cook, /fix, /plan, /report, etc. | ✅ Complete |
 | Quality Gates | 5 automated gates | ✅ Complete |
 | Matrix Skill Discovery | 310+ skills | ✅ Complete |
 | Multi-Tool Support | 4 AI tools | ✅ Complete |
@@ -324,8 +324,8 @@ AI coding assistants are powerful but unstructured. Developers use AI tools in a
 
 | Feature | Status |
 |---------|--------|
-| 20 Specialist Agents | ✅ |
-| 40+ Command Workflows | ✅ |
+| 21 Specialist Agents | ✅ |
+| 50+ Command Workflows | ✅ |
 | 310+ Domain Skills | ✅ |
 | Matrix Skill Discovery | ✅ |
 | Multi-Tool Support | ✅ |

package/documents/knowledge-architecture.md

@@ -41,7 +41,7 @@ Agent Assistant is a **multi-agent orchestration framework** that transforms a s
                     └─────────────────┬─────────────────┘
                                       ▼
 ┌─────────────────────────────────────────────────────────────────────────────┐
-│                         SPECIALIST AGENTS (20)                               │
+│                         SPECIALIST AGENTS (21)                               │
 │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐           │
 │  │ tech-lead   │ │ backend-    │ │ frontend-   │ │ security-   │ ...       │
 │  │             │ │ engineer    │ │ engineer    │ │ engineer    │           │

package/documents/knowledge-domain.md

@@ -11,7 +11,7 @@ Agent Assistant operates in the domain of **AI-assisted software development orc
 ```
 ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
 │     AGENTS      │────▶│    COMMANDS     │────▶│     SKILLS      │
-│  (20 entities)  │     │  (40+ entities) │     │ (310+ entities)  │
+│  (21 entities)  │     │  (50+ entities) │     │ (310+ entities)  │
 └─────────────────┘     └─────────────────┘     └─────────────────┘
          │                      │                       │
          ▼                      ▼                       ▼
@@ -123,13 +123,14 @@ execution-mode: string          # "execute" | "router"
 
 | Command | Description | Variants | Category |
 |---------|-------------|----------|----------|
-| `/cook` | Implement features | `:fast`, `:hard` | development |
+| `/cook` | Implement features | `:fast`, `:hard`, `:focus` | development |
 | `/code` | Write code snippets | `:fast`, `:hard` | development |
-| `/fix` | Fix bugs and refactor | `:fast`, `:hard` | development |
+| `/fix` | Fix bugs and refactor | `:fast`, `:hard`, `:focus` | development |
 | `/test` | Generate tests | `:fast`, `:hard` | quality |
 | `/review` | Code review | `:fast`, `:hard` | quality |
 | `/debug` | Systematic debugging | `:fast`, `:hard` | quality |
-| `/plan` | Implementation planning | `:fast`, `:hard` | planning |
+| `/plan` | Implementation planning | `:fast`, `:hard`, `:focus` | planning |
+| `/report` | Create/update reports, summaries | `:fast`, `:hard`, `:focus` | documentation |
 | `/brainstorm` | Requirements discovery | `:fast`, `:hard` | planning |
 | `/design` | UI/UX design | `:fast`, `:hard` | planning |
 | `/docs` | Documentation | `:core`, `:business`, `:audit` | documentation |

package/documents/knowledge-overview.md

@@ -19,7 +19,7 @@
 
 ## 2. Purpose and Mission
 
-Agent Assistant transforms a single AI coding assistant into a **coordinated team of 20 specialist agents** with structured workflows, quality gates, and 310+ domain skills.
+Agent Assistant transforms a single AI coding assistant into a **coordinated team of 21 specialist agents** with structured workflows, quality gates, and 310+ domain skills.
 
 ### Core Value Proposition
 
@@ -35,7 +35,7 @@ With Agent Assistant:
 
 | Benefit            | Description                                           |
 | ------------------ | ----------------------------------------------------- |
-| **Specialization** | 20 domain expert agents instead of one generalist     |
+| **Specialization** | 21 domain expert agents instead of one generalist     |
 | **Consistency**    | Shared rules, skills, and conventions across all work |
 | **Quality**        | Built-in test, review, and security workflows         |
 | **Efficiency**     | 85% token cost reduction through targeted expertise   |
@@ -47,8 +47,8 @@ With Agent Assistant:
 
 | Metric            | Count | Description                                                |
 | ----------------- | ----- | ---------------------------------------------------------- |
-| Specialist Agents | 20    | Domain experts (backend, frontend, security, tester, etc.) |
-| Command Workflows | 40+   | Development workflows (/cook, /fix, /plan, /deploy, etc.)  |
+| Specialist Agents | 21    | Domain experts (backend, frontend, security, tester, reporter, etc.) |
+| Command Workflows | 50+   | Development workflows (/cook, /fix, /plan, /report, /deploy, etc.; variants: fast, hard, focus) |
 | Domain Skills     | 310   | On-demand knowledge (React, APIs, databases, DevOps, AI/ML, Security, etc.) |
 | Matrix Domains    | 19    | Skill categories (backend, frontend, security, ai-ml, etc.)       |
 | Quality Gates     | 5     | Compile, lint, test, security, review                      |
@@ -200,7 +200,7 @@ Then try development commands:
 
 ## 7. Key Features
 
-### 7.1 20 Specialist Agents
+### 7.1 21 Specialist Agents
 
 | Category           | Agents                                                              |
 | ------------------ | ------------------------------------------------------------------- |
@@ -214,7 +214,7 @@ Then try development commands:
 | **Design**         | designer                                                            |
 | **Management**     | project-manager                                                     |
 
-### 7.2 40+ Command Workflows
+### 7.2 50+ Command Workflows
 
 | Category          | Commands                                                                     |
 | ----------------- | ---------------------------------------------------------------------------- |
@@ -222,6 +222,7 @@ Then try development commands:
 | **Quality**       | `/test`, `/review`, `/debug`                                                 |
 | **Planning**      | `/plan`, `/brainstorm`, `/design`                                            |
 | **Documentation** | `/docs:core`, `/docs:business`, `/docs:audit`                                |
+| **Report**        | `/report:fast`, `/report:hard`, `/report:focus`                               |
 | **Deployment**    | `/deploy:check`, `/deploy:preview`, `/deploy:production`, `/deploy:rollback` |
 | **Utility**       | `/ask`, `/auto`                                                              |
 

package/documents/knowledge-source-base.md

@@ -8,11 +8,11 @@
 
 ```
 agent-assistant/                     # Project root
-├── agents/                          # 🤖 20 specialist agent definitions
+├── agents/                          # 🤖 21 specialist agent definitions
 ├── assets/                          # 🎨 Static assets (logo, images)
 ├── cli/                             # 🔧 CLI installer system
 ├── code-assistants/                 # 🔌 IDE-specific configurations
-├── commands/                        # 📋 40+ command workflow definitions
+├── commands/                        # 📋 50+ command workflow definitions
 ├── documents/                       # 📚 Generated documentation
 ├── matrix-skills/                   # 🎯 Skill discovery matrix (19 domains)
 ├── rules/                           # ⚖️ Orchestration rules and protocols
@@ -35,7 +35,7 @@ agent-assistant/                     # Project root
 
 ### 2.1 `agents/` — Specialist Agent Definitions
 
-Contains 20 specialist agent definition files.
+Contains 21 specialist agent definition files.
 
 ```
 agents/
@@ -73,7 +73,7 @@ agents/
 
 ### 2.2 `commands/` — Command Workflow Definitions
 
-Contains 40+ command workflow files organized by command and variant.
+Contains 50+ command workflow files organized by command and variant (fast, hard, focus).
 
 ```
 commands/
@@ -158,11 +158,11 @@ rules/
 
 ### 2.4 `matrix-skills/` — Skill Discovery Matrix
 
-Contains 20 YAML files that define skill-to-agent mappings.
+Contains 19 YAML domain files that define skill-to-agent mappings (plus _index.yaml).
 
 ```
 matrix-skills/
-├── _index.yaml                      # Central registry (310 skills, 20 agents)
+├── _index.yaml                      # Central registry (310 skills, 21 agents)
 ├── ai-ml.yaml                       # 40 AI/ML skills (+27: agent development, LLM patterns, RAG, voice AI)
 ├── architecture.yaml                # 9 architecture skills
 ├── backend.yaml                     # 32 backend skills (+12: job queues, payments, communications)
@@ -401,7 +401,7 @@ domains:                         # 19 domain registrations
   frontend: { file: "frontend.yaml", ... }
   # ...
 
-agent_profiles:                  # 20 agent-to-domain mappings
+agent_profiles:                  # 21 agent-to-domain mappings
   backend-engineer:
     profile: "backend:execution"
     inherit_from: [backend, architecture, quality, data, languages]
@@ -544,8 +544,8 @@ REPORTS_PATH  = ./reports/
 
 | Category | Count | Description |
 |----------|-------|-------------|
-| Agent Files | 20 | Specialist agent definitions |
-| Command Files | 40+ | Workflow definitions |
+| Agent Files | 21 | Specialist agent definitions |
+| Command Files | 50+ | Workflow definitions (routers + variants: fast, hard, focus) |
 | Rule Files | 8 | Orchestration protocols |
 | Matrix Files | 20 | Skill discovery config |
 | Skill Folders | 310+ | Domain skill definitions |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namch/agent-assistant",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Multi-agent orchestration framework for AI coding assistants (Cursor, Copilot, Antigravity, Claude Code).",
   "main": "cli/install.js",
   "bin": {

package/rules/AGENT-RULES.md

@@ -27,7 +27,7 @@ philosophy:
 
 ```
 agent-assistant/
-├── agents/           # 21 Specialized Agents (~150-200 lines each)
+├── agents/           # 21 Specialized Agents (~150-200 lines each, including reporter)
 ├── commands/         # Command Workflows (router + variants)
 ├── rules/            # Orchestration Protocols
 │   ├── BOOTSTRAP.md  # ⚡ ENTRY POINT - Load this first
@@ -194,6 +194,7 @@ execution-mode: execute
 | designer     | `./reports/designs/DESIGN-{feature}.md`         |
 | planner      | `./reports/plans/PLAN-{feature}.md`             |
 | debugger     | `./reports/debugs/DEBUG-{issue}.md`             |
+| reporter     | `./reports/` (create/update per task)           |
 
 ---
 

package/rules/BOOTSTRAP.md

@@ -72,6 +72,7 @@ echo $HOME  # Capture result, e.g., /Users/jdoe
 | `/brainstorm ...`               | Brainstorming          | `~/.{TOOL}/skills/agent-assistant/commands/brainstorm.md`                     |
 | `/ask ...`                      | Q&A                    | `~/.{TOOL}/skills/agent-assistant/commands/ask.md`                            |
 | `/code ...`                     | Direct Coding          | `~/.{TOOL}/skills/agent-assistant/commands/code.md`                           |
+| `/report ...`                   | Reporting              | `~/.{TOOL}/skills/agent-assistant/commands/report.md` → `report/:variant`      |
 
 **Variant form**: Both `/{command}/{variant}` and `/{command}:{variant}` are valid (e.g. `/docs/core` = `/docs:core`). When a variant is present, **LOAD** `~/.{TOOL}/skills/agent-assistant/commands/{command}/{variant}.md` directly; do not load `~/.{TOOL}/skills/agent-assistant/commands/{command}.md` first.
 
@@ -88,6 +89,7 @@ echo $HOME  # Capture result, e.g., /Users/jdoe
 | "document", "readme", "api docs"                            | Documentation | `/docs`   |
 | "design", "UI", "UX", "mockup"                              | Design        | `/design` |
 | "deploy", "release", "production"                           | Deployment    | `/deploy` |
+| "report", "status report", "summary", "documentation update" | Reporting     | `/report` |
 
 **If unclear → Ask: "Should I treat this as /cook (implement) or /fix (bug fix)?"**
 
@@ -176,6 +178,7 @@ for_each_phase:
 | scouter      | `./reports/scouts/SCOUT-{feature}.md`           |
 | designer     | `./reports/designs/DESIGN-{feature}.md`         |
 | planner      | `./reports/plans/PLAN-{feature}.md`             |
+| reporter     | `./reports/` (create/update per task)           |
 
 **Rule**: Subsequent phases MUST read prior deliverables as IMMUTABLE CONSTRAINTS.
 

package/rules/QUICK-REFERENCE.md

@@ -24,6 +24,10 @@
 | `/brainstorm X`     | `/brainstorm:auto` | `~/.{TOOL}/skills/agent-assistant/commands/brainstorm.md` |
 | `/ask X`            | `/ask:auto`        | `~/.{TOOL}/skills/agent-assistant/commands/ask.md`        |
 | `/code X`           | `/code:auto`       | `~/.{TOOL}/skills/agent-assistant/commands/code.md`       |
+| `/report X`         | `/report:auto`     | `~/.{TOOL}/skills/agent-assistant/commands/report.md`     |
+| `/report:fast X`    | `/report:fast`     | `~/.{TOOL}/skills/agent-assistant/commands/report/fast.md` |
+| `/report:hard X`    | `/report:hard`     | `~/.{TOOL}/skills/agent-assistant/commands/report/hard.md`  |
+| `/report:focus X`   | `/report:focus`    | `~/.{TOOL}/skills/agent-assistant/commands/report/focus.md` |
 
 ---
 
@@ -51,6 +55,7 @@
 | DevOps        | `devops-engineer`      | `~/.{TOOL}/skills/agent-assistant/agents/devops-engineer.md`      | support     |
 | Business      | `business-analyst`     | `~/.{TOOL}/skills/agent-assistant/agents/business-analyst.md`     | support     |
 | Project       | `project-manager`      | `~/.{TOOL}/skills/agent-assistant/agents/project-manager.md`      | support     |
+| Reporting     | `reporter`             | `~/.{TOOL}/skills/agent-assistant/agents/reporter.md`             | support     |
 
 ---
 
@@ -78,6 +83,7 @@
 | AI/ML agents      | `backend-engineer`     | `tech-lead`         |
 | Penetration test  | `security-engineer`    | —                   |
 | Workflow automation | `devops-engineer`    | `backend-engineer`  |
+| Reports, status, documentation updates | `reporter` | `docs-manager` |
 
 ---
 
@@ -104,6 +110,7 @@ researcher: "./reports/researchers/RESEARCH-{feature}.md"
 scouter: "./reports/scouts/SCOUT-{feature}.md"
 designer: "./reports/designs/DESIGN-{feature}.md"
 planner: "./reports/plans/PLAN-{feature}.md"
+reporter: "./reports/ (create/update per task)"
 ```
 
 ---
@@ -194,3 +201,4 @@ anti_lazy: ❌ TIER 2 when TIER 1 available
 | "design", "UI", "UX", "mockup"                 | `/design`     |
 | "deploy", "release", "production"              | `/deploy`     |
 | "brainstorm", "ideas", "explore"               | `/brainstorm` |
+| "report", "status report", "summary", "documentation update" | `/report` |