@namch/agent-assistant 1.3.0 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/CHANGELOG.md +24 -1
  2. package/README.md +3 -4
  3. package/agents/backend-engineer.md +3 -3
  4. package/agents/brainstormer.md +3 -3
  5. package/agents/business-analyst.md +3 -3
  6. package/agents/database-architect.md +3 -3
  7. package/agents/debugger.md +2 -2
  8. package/agents/designer.md +2 -2
  9. package/agents/devops-engineer.md +2 -2
  10. package/agents/docs-manager.md +23 -15
  11. package/agents/frontend-engineer.md +3 -3
  12. package/agents/game-engineer.md +3 -3
  13. package/agents/mobile-engineer.md +4 -4
  14. package/agents/performance-engineer.md +3 -3
  15. package/agents/planner.md +4 -4
  16. package/agents/project-manager.md +3 -3
  17. package/agents/researcher.md +3 -3
  18. package/agents/reviewer.md +3 -3
  19. package/agents/scouter.md +3 -3
  20. package/agents/security-engineer.md +3 -3
  21. package/agents/tech-lead.md +3 -3
  22. package/agents/tester.md +2 -2
  23. package/code-assistants/codex-assistant/CODEX.md +1 -2
  24. package/commands/ask/hard.md +1 -1
  25. package/commands/brainstorm/hard.md +1 -1
  26. package/commands/code/hard.md +1 -1
  27. package/commands/code.md +2 -7
  28. package/commands/cook/hard.md +1 -1
  29. package/commands/cook.md +1 -6
  30. package/commands/debug/hard.md +1 -1
  31. package/commands/debug.md +1 -6
  32. package/commands/design/hard.md +1 -1
  33. package/commands/design.md +1 -6
  34. package/commands/docs/audit.md +554 -78
  35. package/commands/docs/business.md +392 -76
  36. package/commands/docs/core.md +573 -74
  37. package/commands/docs.md +62 -61
  38. package/commands/fix/hard.md +1 -1
  39. package/commands/fix.md +1 -6
  40. package/commands/plan/hard.md +1 -1
  41. package/commands/plan.md +1 -6
  42. package/commands/report/fast.md +2 -2
  43. package/commands/report/hard.md +1 -1
  44. package/commands/report.md +2 -7
  45. package/commands/review/hard.md +1 -1
  46. package/commands/test/hard.md +1 -1
  47. package/commands/test.md +1 -6
  48. package/documents/HSOL-ASSESSMENT.md +6 -6
  49. package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1 -1
  50. package/documents/business/business-features/00-index.md +101 -0
  51. package/documents/business/business-features/01-feature-inventory.md +341 -0
  52. package/documents/business/business-features/02-prioritization-moscow.md +148 -0
  53. package/documents/business/business-features/03-feature-specifications.md +511 -0
  54. package/documents/business/business-features/04-dependencies-and-release-sequencing.md +313 -0
  55. package/documents/business/business-features/05-success-metrics.md +290 -0
  56. package/documents/business/business-glossary/00-index.md +89 -0
  57. package/documents/business/business-glossary/01-canonical-terms.md +428 -0
  58. package/documents/business/business-glossary/02-synonyms-and-deprecated-terms.md +180 -0
  59. package/documents/business/business-glossary/03-domain-entities-and-events.md +395 -0
  60. package/documents/business/business-glossary/04-api-term-mapping.md +173 -0
  61. package/documents/business/business-prd/00-index.md +107 -0
  62. package/documents/business/business-prd/01-executive-summary.md +131 -0
  63. package/documents/business/business-prd/02-problem-goals-and-scope.md +204 -0
  64. package/documents/business/business-prd/03-stakeholders-and-requirements.md +210 -0
  65. package/documents/business/business-prd/04-acceptance-risks-assumptions.md +246 -0
  66. package/documents/business/business-workflows/00-index.md +107 -0
  67. package/documents/business/business-workflows/01-actor-map.md +303 -0
  68. package/documents/business/business-workflows/02-workflow-catalog.md +252 -0
  69. package/documents/business/business-workflows/03-detailed-workflows.md +641 -0
  70. package/documents/business/business-workflows/04-decision-rules-and-exceptions.md +216 -0
  71. package/documents/business/business-workflows/05-sla-and-handoffs.md +253 -0
  72. package/documents/knowledge-architecture/00-index.md +159 -0
  73. package/documents/knowledge-architecture/01-system-overview.md +240 -0
  74. package/documents/knowledge-architecture/02-components.md +419 -0
  75. package/documents/knowledge-architecture/03-data-flow.md +368 -0
  76. package/documents/knowledge-architecture/04-design-patterns.md +497 -0
  77. package/documents/knowledge-architecture/05-decisions.md +410 -0
  78. package/documents/knowledge-domain/00-index.md +251 -0
  79. package/documents/knowledge-domain/01-entities.md +582 -0
  80. package/documents/knowledge-domain/02-database-schema.md +138 -0
  81. package/documents/knowledge-domain/03-api-contracts.md +477 -0
  82. package/documents/knowledge-domain/04-business-rules.md +554 -0
  83. package/documents/knowledge-overview/00-index.md +107 -0
  84. package/documents/knowledge-overview/01-project-identity.md +162 -0
  85. package/documents/knowledge-overview/02-tech-stack.md +119 -0
  86. package/documents/knowledge-overview/03-features.md +232 -0
  87. package/documents/knowledge-overview/04-getting-started.md +394 -0
  88. package/documents/knowledge-source-base/00-index.md +107 -0
  89. package/documents/knowledge-source-base/01-directory-structure.md +312 -0
  90. package/documents/knowledge-source-base/02-entry-points.md +346 -0
  91. package/documents/knowledge-source-base/03-key-modules.md +581 -0
  92. package/documents/knowledge-source-base/04-configuration.md +467 -0
  93. package/documents/knowledge-standards/00-index.md +129 -0
  94. package/documents/knowledge-standards/01-code-style.md +161 -0
  95. package/documents/knowledge-standards/02-conventions.md +254 -0
  96. package/documents/knowledge-standards/03-git-workflow.md +228 -0
  97. package/documents/knowledge-standards/04-testing-standards.md +175 -0
  98. package/matrix-skills/_index.yaml +1 -1
  99. package/package.json +1 -1
  100. package/rules/AGENTS.md +1 -1
  101. package/rules/REFERENCE.md +18 -14
  102. package/rules/SKILLS.md +1 -1
  103. package/rules/TEAMS.md +1 -2
  104. package/skills/docs-audit/README.md +10 -8
  105. package/skills/docs-audit/SKILL.md +45 -41
  106. package/skills/docs-audit/references/scoring-framework.md +5 -5
  107. package/skills/docs-core/README.md +19 -14
  108. package/skills/docs-core/SKILL.md +189 -117
  109. package/skills/planning/references/codebase-understanding.md +5 -5
  110. package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/SKILL.md +0 -18
  111. package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/agents/openai.yaml +0 -4
  112. package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/SKILL.md +0 -18
  113. package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/agents/openai.yaml +0 -4
  114. package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/SKILL.md +0 -18
  115. package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/agents/openai.yaml +0 -4
  116. package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/SKILL.md +0 -18
  117. package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/agents/openai.yaml +0 -4
  118. package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/SKILL.md +0 -18
  119. package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/agents/openai.yaml +0 -4
  120. package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/SKILL.md +0 -18
  121. package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/agents/openai.yaml +0 -4
  122. package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/SKILL.md +0 -18
  123. package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/agents/openai.yaml +0 -4
  124. package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/SKILL.md +0 -18
  125. package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/agents/openai.yaml +0 -4
  126. package/commands/code/focus.md +0 -297
  127. package/commands/cook/focus.md +0 -209
  128. package/commands/debug/focus.md +0 -103
  129. package/commands/design/focus.md +0 -229
  130. package/commands/fix/focus.md +0 -145
  131. package/commands/plan/focus.md +0 -140
  132. package/commands/report/focus.md +0 -107
  133. package/commands/test/focus.md +0 -123
  134. package/documents/business/business-features.md +0 -894
  135. package/documents/business/business-glossary.md +0 -554
  136. package/documents/business/business-prd.md +0 -400
  137. package/documents/business/business-workflows.md +0 -713
  138. package/documents/knowledge-architecture.md +0 -621
  139. package/documents/knowledge-domain.md +0 -602
  140. package/documents/knowledge-overview.md +0 -316
  141. package/documents/knowledge-source-base.md +0 -581
  142. package/documents/knowledge-standards.md +0 -632
package/CHANGELOG.md CHANGED
@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.3.2] - 2026-03-30
9
+
10
+ ### Removed
11
+ - **Focus workflow variant deprecation (complete)**:
12
+ - Removed remaining focus workflow files and command-level focus routing references.
13
+ - Removed focus variant mentions from active command metadata and workflow documentation.
14
+ - Removed stale focus references from business analysis docs that still listed `fast/hard/focus/team`.
15
+
16
+ ### Changed
17
+ - **Changelog and docs normalization after focus cleanup**:
18
+ - Updated changelog wording to avoid legacy focus workflow terminology in active release notes.
19
+ - Kept accessibility/UI focus semantics (e.g., `:focus`, `:focus-visible`) untouched where they are unrelated to command variants.
20
+
21
+ ## [1.3.1] - 2026-03-26
22
+
23
+ ### Changed
24
+ - **Documentation Workflows — Folder-Based Architecture**: Migrated all 3 `/docs` sub-command workflows from single-file to folder-based structure for greater detail and maintainability
25
+ - **`/docs:core` (v3.0)**: 5 knowledge folders, each with `00-index.md` + numbered sub-files. Added MIGRATE mode for legacy flat-file-to-folder conversion, Thinking Protocol (7-question pre-write checklist), Anti-Shallow Guardrails, and Mode Detection table with per-folder CREATE/UPDATE/MIGRATE resolution
26
+ - **`/docs:business` (v4.0)**: 4 business folders with folder-based structure. Added MIGRATE mode, Thinking Protocol (5-question checklist), Anti-Shallow Guardrails, and Business Evidence Ledger
27
+ - **`/docs:audit` (v4.0)**: 4 audit folders with folder-based structure. Added MIGRATE mode, Thinking Protocol (5-question security-focused checklist), and Signal Precision Rules
28
+ - **`/docs` router (v2.0)**: Updated sequential execution flow references to match new folder-based deliverables and corrected version references
29
+ - **Cross-Workflow Consistency**: Harmonized agent roles (`docs-manager` for generation phase), mode rules (CREATE/UPDATE/MIGRATE), quality mechanisms (Thinking Protocol, Evidence Ledger), and exit criteria across all 3 workflows
30
+
8
31
  ## [1.3.0] - 2026-03-23
9
32
 
10
33
  ### Added
@@ -90,7 +113,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
90
113
  - **Blueprint**: `documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md` — architecture for dynamic skill resolution
91
114
  - **Assessment**: `documents/HSOL-ASSESSMENT.md` — production readiness evaluation
92
115
  - **Manifest**: `matrix-skills/_dynamic.yaml` — tracking for dynamically installed community skills
93
- - **Knowledge base**: Updated `documents/knowledge-architecture.md`, `documents/knowledge-source-base.md` with HSOL references
116
+ - **Knowledge base**: Updated `documents/knowledge-architecture/` folder, `documents/knowledge-source-base/` folder with HSOL references
94
117
 
95
118
  ### Changed
96
119
 
package/README.md CHANGED
@@ -22,7 +22,7 @@ Transform one AI into a coordinated team of 21 specialist agents with structured
22
22
  | **One-Time Setup, Forever Use** | Configure once at global level (`~/.cursor/`, `~/.claude/`, etc.) and it auto-applies to ALL your projects. No more repetitive config for every new repo. |
23
23
  | **Sub-Agent Orchestration** | When supported (Claude Code, Cursor Max mode), the main agent spawns specialized sub-agents to handle tasks **in parallel** — backend, frontend, testing, security all working simultaneously. |
24
24
  | **Multi-Platform Support** | Works seamlessly across **Cursor**, **GitHub Copilot**, **Claude Code**, **Codex**, and **Antigravity/Gemini**. Same workflows, any tool. |
25
- | **Matrix Skill Discovery (HSOL)** | Injects the right skills by profile and request; optional dynamic discovery (find-skills) for `hard`/`focus` when matrix fitness < 0.8. 1400+ matrix skills, zero manual config. |
25
+ | **Matrix Skill Discovery (HSOL)** | Injects the right skills by profile and request; optional dynamic discovery (find-skills) for `hard`/`team` when matrix fitness < 0.8. 1400+ matrix skills, zero manual config. |
26
26
 
27
27
  ### The Goal
28
28
 
@@ -140,7 +140,6 @@ Creates `./documents/` files that agents reference. Without docs, agents work ge
140
140
  | ------- | ---------------- | -------------------------- |
141
141
  | `:fast` | Simple tasks | 2-3 agents |
142
142
  | `:hard` | Complex features | 5-8 agents + quality gates |
143
- | `:focus` | Clean execution | (cook, code, fix, debug, design, plan, test, report) |
144
143
  | `:team` | Team workflows | All agents, structured phases |
145
144
 
146
145
  ## Commands Reference
@@ -151,7 +150,7 @@ Creates `./documents/` files that agents reference. Without docs, agents work ge
151
150
  | **Quality** | `/test`, `/review`, `/debug` |
152
151
  | **Plan** | `/plan`, `/brainstorm`, `/design` |
153
152
  | **Docs** | `/docs:core`, `/docs:business`, `/docs:audit` |
154
- | **Report** | `/report:fast`, `/report:hard`, `/report:focus` |
153
+ | **Report** | `/report:fast`, `/report:hard`, `/report:team` |
155
154
  | **Deploy** | `/deploy:check`, `/deploy:preview`, `/deploy:production` |
156
155
 
157
156
  ---
@@ -188,7 +187,7 @@ profile: "backend:execution"
188
187
  ```
189
188
  agent-assistant/
190
189
  ├── agents/ # 21 specialist agents
191
- ├── commands/ # 50+ workflow commands (routers + variants: fast, hard, focus)
190
+ ├── commands/ # 50+ workflow commands (routers + variants: fast, hard, team)
192
191
  ├── rules/ # 8 orchestration rules
193
192
  ├── matrix-skills/ # 19 domain skill registries
194
193
  ├── skills/ # 1400+ domain skills
@@ -60,9 +60,9 @@ ALWAYS:
60
60
 
61
61
  ```
62
62
  1. CHECK PROJECT DOCS (if ./documents/ exists):
63
- - knowledge-standards.md → Coding standards
64
- - knowledge-architecture.md → Architecture patterns
65
- - knowledge-domain.md → Data models, API contracts
63
+ - knowledge-standards/00-index.md → Coding standards (drill into sub-files as needed)
64
+ - knowledge-architecture/00-index.md → Architecture patterns (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → Data models, API contracts (drill into sub-files as needed)
66
66
  → USE these as constraints for implementation
67
67
 
68
68
  2. CHECK: ./reports/{topic}/plans/PLAN-{feature} exists?
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-overview.md → Project scope
65
- - business/business-prd.md → Existing requirements
66
- - business/business-features.md → Existing features
64
+ - knowledge-overview/00-index.md → Project scope (drill into sub-files as needed)
65
+ - business/business-prd/00-index.md → Existing requirements (drill into sub-files as needed)
66
+ - business/business-features/00-index.md → Existing features (drill into sub-files as needed)
67
67
  → USE these to avoid re-asking known context
68
68
  ```
69
69
 
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if ./documents/ exists):
64
- - business/business-prd.md → Existing PRD
65
- - business/business-features.md → Feature list
66
- - business/business-workflows.md → User workflows
64
+ - business/business-prd/00-index.md → Existing PRD (drill into sub-files as needed)
65
+ - business/business-features/00-index.md → Feature list (drill into sub-files as needed)
66
+ - business/business-workflows/00-index.md → User workflows (drill into sub-files as needed)
67
67
  → BUILD ON existing docs, don't start from scratch
68
68
  ```
69
69
 
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  1. CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-architecture.md → Existing architecture
65
- - knowledge-domain.md → Data models, schema
66
- - knowledge-standards.md → Naming conventions
64
+ - knowledge-architecture/00-index.md → Existing architecture (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → Data models, schema (drill into sub-files as needed)
66
+ - knowledge-standards/00-index.md → Naming conventions (drill into sub-files as needed)
67
67
  → USE these for schema naming and structure
68
68
 
69
69
  2. CHECK: ./reports/{topic}/plans/PLAN-{feature}
@@ -61,8 +61,8 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if bug involves domain logic):
64
- - knowledge-architecture.md → System understanding
65
- - knowledge-domain.md → Expected behavior
64
+ - knowledge-architecture/00-index.md → System understanding (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → Expected behavior (drill into sub-files as needed)
66
66
  → USE these to understand what SHOULD happen
67
67
  ```
68
68
 
@@ -61,8 +61,8 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-standards.md → Design standards
65
- - business/business-workflows.md → User flows
64
+ - knowledge-standards/00-index.md → Design standards (drill into sub-files as needed)
65
+ - business/business-workflows/00-index.md → User flows (drill into sub-files as needed)
66
66
  → USE these for design decisions
67
67
  ```
68
68
 
@@ -61,8 +61,8 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  1. CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-architecture.md → Infrastructure patterns
65
- - knowledge-standards.md → Deployment standards
64
+ - knowledge-architecture/00-index.md → Infrastructure patterns (drill into sub-files as needed)
65
+ - knowledge-standards/00-index.md → Deployment standards (drill into sub-files as needed)
66
66
  → FOLLOW existing infra conventions
67
67
 
68
68
  2. CHECK: ./reports/{topic}/plans/PLAN-{feature}
@@ -62,29 +62,37 @@ ALWAYS:
62
62
 
63
63
  ```
64
64
  CHECK EXISTING PROJECT DOCS (./documents/):
65
- - knowledge-overview.md → Project overview
66
- - knowledge-architecture.md Architecture docs
67
- - knowledge-domain.md Data models, API contracts
68
- - knowledge-standards.md → Coding standards
69
- UPDATE existing docs rather than creating new
65
+
66
+ FOLDER-BASED (v2.0 preferred):
67
+ - knowledge-overview/00-index.md Project overview + sub-files
68
+ - knowledge-architecture/00-index.md → Architecture docs + sub-files
69
+ - knowledge-domain/00-index.md Data models, API contracts + sub-files
70
+ - knowledge-source-base/00-index.md → Source base + sub-files
71
+ - knowledge-standards/00-index.md → Coding standards + sub-files
72
+ → UPDATE existing sub-files; add new sub-files if needed
70
73
  ```
71
74
 
72
75
  ### Step 1: DOCUMENTATION SCOPE
73
76
 
74
- | Type | Purpose | Audience |
75
- | ------------ | -------------------- | -------------- |
76
- | README | Overview, quick start| New users/devs |
77
- | API Docs | Endpoint reference | Developers |
78
- | Architecture | System design | Team |
79
- | Guides | How-to | Various |
77
+ | Type | Purpose | Audience | Structure |
78
+ | ------------ | -------------------- | -------------- | -------------- |
79
+ | README | Overview, quick start| New users/devs | Single file |
80
+ | Knowledge | AI-consumable docs | AI agents/devs | Folder + sub-files |
81
+ | API Docs | Endpoint reference | Developers | Sub-file in domain/ |
82
+ | Architecture | System design | Team | Folder + sub-files |
83
+ | Guides | How-to | Various | Single file |
84
+
85
+ **Folder-based docs pattern**: Each knowledge area = folder with `00-index.md` (TOC) + numbered sub-files (`01-*.md`, `02-*.md`, ...).
80
86
 
81
87
  ### Step 2: DOCUMENTATION AUDIT
82
88
 
83
89
  - [ ] README exists and current
84
- - [ ] API endpoints documented
85
- - [ ] Setup instructions work
86
- - [ ] Environment variables listed
87
- - [ ] Architecture documented
90
+ - [ ] Knowledge folders exist with 00-index.md + sub-files
91
+ - [ ] API endpoints documented (in knowledge-domain/03-api-contracts.md)
92
+ - [ ] Setup instructions work (in knowledge-overview/04-getting-started.md)
93
+ - [ ] Environment variables listed (in knowledge-source-base/04-configuration.md)
94
+ - [ ] Architecture documented (in knowledge-architecture/ folder)
95
+ - [ ] All 00-index.md files have accurate sub-file TOC
88
96
 
89
97
  ### Step 3: DOCUMENTATION PRINCIPLES
90
98
 
@@ -60,9 +60,9 @@ ALWAYS:
60
60
 
61
61
  ```
62
62
  1. CHECK PROJECT DOCS (if ./documents/ exists):
63
- - knowledge-standards.md → Coding standards
64
- - knowledge-architecture.md → Component patterns
65
- - knowledge-domain.md → API contracts, data shapes
63
+ - knowledge-standards/00-index.md → Coding standards (drill into sub-files as needed)
64
+ - knowledge-architecture/00-index.md → Component patterns (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → API contracts, data shapes (drill into sub-files as needed)
66
66
  → USE these as constraints
67
67
 
68
68
  2. CHECK for:
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  1. CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-standards.md → Coding standards
65
- - knowledge-architecture.md → Game architecture
66
- - knowledge-domain.md → Game data models
64
+ - knowledge-standards/00-index.md → Coding standards (drill into sub-files as needed)
65
+ - knowledge-architecture/00-index.md → Game architecture (drill into sub-files as needed)
66
+ - knowledge-domain/00-index.md → Game data models (drill into sub-files as needed)
67
67
  → USE these for implementation decisions
68
68
 
69
69
  2. IF plan exists: READ → FOLLOW specifications EXACTLY
@@ -61,10 +61,10 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  1. CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-standards.md → Coding standards
65
- - knowledge-architecture.md → App architecture
66
- - knowledge-domain.md → API contracts, data shapes
67
- → USE these for implementation decisions
64
+ - knowledge-standards/00-index.md → Coding standards (drill into sub-files as needed)
65
+ - knowledge-architecture/00-index.md → App architecture (drill into sub-files as needed)
66
+ - knowledge-domain/00-index.md → API contracts, data shapes (drill into sub-files as needed)
67
+ → USE these as constraints for implementation
68
68
 
69
69
  2. IF plan exists: READ → FOLLOW EXACTLY
70
70
  3. IF no plan + complex: STOP → Request plan
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-standards.md → Performance budgets
65
- - knowledge-architecture.md → System architecture
66
- - knowledge-domain.md → Data flows, API surface
64
+ - knowledge-standards/00-index.md → Performance budgets (drill into sub-files as needed)
65
+ - knowledge-architecture/00-index.md → System architecture (drill into sub-files as needed)
66
+ - knowledge-domain/00-index.md → Data flows, API surface (drill into sub-files as needed)
67
67
  → USE these to understand performance targets
68
68
  ```
69
69
 
package/agents/planner.md CHANGED
@@ -82,10 +82,10 @@ ALWAYS:
82
82
 
83
83
  ```
84
84
  1. CHECK PROJECT DOCS (CRITICAL):
85
- - knowledge-overview.md → Project scope
86
- - knowledge-architecture.md → Existing architecture
87
- - knowledge-domain.md → Data models, API contracts
88
- - knowledge-standards.md → Standards to enforce
85
+ - knowledge-overview/00-index.md → Project scope (drill into sub-files as needed)
86
+ - knowledge-architecture/00-index.md → Existing architecture (drill into sub-files as needed)
87
+ - knowledge-domain/00-index.md → Data models, API contracts (drill into sub-files as needed)
88
+ - knowledge-standards/00-index.md → Standards to enforce (drill into sub-files as needed)
89
89
  → INCORPORATE into plan constraints
90
90
 
91
91
  2. CHECK for prior deliverables:
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-overview.md → Project scope
65
- - knowledge-domain.md → Data/API scope
66
- - business/business-prd.md → Requirements
64
+ - knowledge-overview/00-index.md → Project scope (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → Data/API scope (drill into sub-files as needed)
66
+ - business/business-prd/00-index.md → Requirements (drill into sub-files as needed)
67
67
  → USE these for project tracking and scope management
68
68
  ```
69
69
 
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-overview.md → Project context
65
- - knowledge-architecture.md → Technical context
66
- - knowledge-domain.md → Domain concepts
64
+ - knowledge-overview/00-index.md → Project context (drill into sub-files as needed)
65
+ - knowledge-architecture/00-index.md → Technical context (drill into sub-files as needed)
66
+ - knowledge-domain/00-index.md → Domain concepts (drill into sub-files as needed)
67
67
  → USE these to focus research on project needs
68
68
  ```
69
69
 
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  1. CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-standards.md → Standards to enforce
65
- - knowledge-architecture.md → Architecture to verify
66
- - knowledge-domain.md → Data/API contracts to verify
64
+ - knowledge-standards/00-index.md → Standards to enforce (drill into sub-files as needed)
65
+ - knowledge-architecture/00-index.md → Architecture to verify (drill into sub-files as needed)
66
+ - knowledge-domain/00-index.md → Data/API contracts to verify (drill into sub-files as needed)
67
67
  → VERIFY code follows project standards
68
68
 
69
69
  2. IF ./reports/{topic}/plans/PLAN-{feature} exists:
package/agents/scouter.md CHANGED
@@ -61,9 +61,9 @@ ALWAYS:
61
61
 
62
62
  ```
63
63
  1. CHECK PROJECT DOCS (if ./documents/ exists):
64
- - knowledge-architecture.md → Already documented architecture
65
- - knowledge-domain.md → Data models, API contracts
66
- - knowledge-standards.md → Existing standards
64
+ - knowledge-architecture/00-index.md → Already documented architecture (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → Data models, API contracts (drill into sub-files as needed)
66
+ - knowledge-standards/00-index.md → Existing standards (drill into sub-files as needed)
67
67
  → REFERENCE these, don't duplicate findings
68
68
 
69
69
  2. Your output becomes CONSTRAINTS for downstream agents
@@ -62,9 +62,9 @@ ALWAYS:
62
62
 
63
63
  ```
64
64
  CHECK PROJECT DOCS (if ./documents/ exists):
65
- - knowledge-standards.md → Security standards
66
- - knowledge-architecture.md → Attack surface
67
- - knowledge-domain.md → API surface, auth boundaries
65
+ - knowledge-standards/00-index.md → Security standards (drill into sub-files as needed)
66
+ - knowledge-architecture/00-index.md → Attack surface (drill into sub-files as needed)
67
+ - knowledge-domain/00-index.md → API surface, auth boundaries (drill into sub-files as needed)
68
68
  → USE these to understand what to protect
69
69
  ```
70
70
 
@@ -60,9 +60,9 @@ ALWAYS:
60
60
 
61
61
  ```
62
62
  1. CHECK PROJECT DOCS (if ./documents/ exists):
63
- - knowledge-standards.md → Enforce these
64
- - knowledge-architecture.md → Architecture constraints
65
- - knowledge-domain.md → Data/API constraints
63
+ - knowledge-standards/00-index.md → Enforce these (drill into sub-files as needed)
64
+ - knowledge-architecture/00-index.md → Architecture constraints (drill into sub-files as needed)
65
+ - knowledge-domain/00-index.md → Data/API constraints (drill into sub-files as needed)
66
66
  → VERIFY all work aligns with project standards
67
67
 
68
68
  2. IF ./reports/{topic}/plans/PLAN-{feature} exists:
package/agents/tester.md CHANGED
@@ -60,8 +60,8 @@ ALWAYS:
60
60
 
61
61
  ```
62
62
  1. CHECK PROJECT DOCS (if ./documents/ exists):
63
- - knowledge-standards.md → Testing standards
64
- - knowledge-domain.md → Data shapes, API contracts
63
+ - knowledge-standards/00-index.md → Testing standards (drill into sub-files as needed)
64
+ - knowledge-domain/00-index.md → Data shapes, API contracts (drill into sub-files as needed)
65
65
  → USE these for test fixtures/assertions
66
66
 
67
67
  2. IF ./reports/{topic}/plans/PLAN-{feature} exists:
@@ -133,9 +133,8 @@ Append `:variant` to any command for specialized workflows:
133
133
  | `:hard` | `commands/{cmd}/hard.md` | Complex/deep variant |
134
134
  | `:fast` | `commands/{cmd}/fast.md` | Quick/lightweight variant |
135
135
  | `:team` | `commands/{cmd}/team.md` | Parallel multi-agent team |
136
- | `:focus` | `commands/{cmd}/focus.md` | Focused single-concern variant |
137
136
 
138
- **Examples**: `/cook:hard`, `/fix:fast`, `/review:team`, `/plan:focus`
137
+ **Examples**: `/cook:hard`, `/fix:fast`, `/review:team`, `/plan:team`
139
138
 
140
139
  **Team variant baseline**: `:team` is supported only where `commands/{cmd}/team.md` exists. Deploy uses specialized variants (`check`, `preview`, `production`, `rollback`).
141
140
 
@@ -23,7 +23,7 @@ execution-mode: execute
23
23
 
24
24
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
27
27
 
28
28
  ---
29
29
 
@@ -23,7 +23,7 @@ execution-mode: execute
23
23
 
24
24
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
27
27
 
28
28
  ---
29
29
 
@@ -23,7 +23,7 @@ execution-mode: execute
23
23
 
24
24
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
27
27
 
28
28
  ---
29
29
 
package/commands/code.md CHANGED
@@ -29,7 +29,7 @@ execution-mode: router
29
29
 
30
30
  ```
31
31
  IF user references an existing plan (@plan, @PLAN-..., path to PLAN-*.md, or "according to plan" / "follow the plan"):
32
- → Route to /code:hard or /code:focus (workflow will SKIP research, scout, brainstorm and go straight to implementation)
32
+ → Route to /code:hard (workflow will SKIP research, scout, brainstorm and go straight to implementation)
33
33
 
34
34
  IF task is simple (clear requirements, single file):
35
35
  → Route to /code:fast
@@ -37,9 +37,6 @@ IF task is simple (clear requirements, single file):
37
37
  IF task is complex (multi-file, research needed):
38
38
  → Route to /code:hard
39
39
 
40
- IF task is complex AND context optimization is critical:
41
- → Route to /code:focus
42
-
43
40
  IF task is complex AND maximum quality with team collaboration needed:
44
41
  → Route to /code:team
45
42
 
@@ -55,7 +52,6 @@ IF unsure:
55
52
  | ------------- | ------------------------------------------------------- |
56
53
  | `/code:fast` | Quick implementation, clear requirements |
57
54
  | `/code:hard` | Complex features, multi-file changes |
58
- | `/code:focus` | Complex features with **enforced context optimization** |
59
55
  | `/code:team` | Maximum quality with parallel agent team collaboration |
60
56
 
61
57
  ---
@@ -71,8 +67,7 @@ IF unsure:
71
67
 
72
68
  1. ⚡ **Fast** → `/code:fast` — Quick implementation
73
69
  2. ⚡⚡⚡ **Hard** → `/code:hard` — Full development cycle
74
- 3. 🎯 **Focus** → `/code:focus` — Full cycle with **automatic context clearing** (prevents hallucination)
75
- 4. 👥 **Team** → `/code:team` — Full team collaboration (parallel agents, maximum quality)
70
+ 3. 👥 **Team** → `/code:team` — Full team collaboration (parallel agents, maximum quality)
76
71
 
77
72
  ⏳ Awaiting selection...
78
73
  ```
@@ -23,7 +23,7 @@ execution-mode: execute
23
23
 
24
24
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
27
27
 
28
28
  ---
29
29
 
package/commands/cook.md CHANGED
@@ -34,9 +34,6 @@ IF feature is simple (clear spec, low complexity):
34
34
  IF feature is complex (multi-component, research needed):
35
35
  → Route to /cook:hard
36
36
 
37
- IF feature is complex AND context optimization is critical:
38
- → Route to /cook:focus
39
-
40
37
  IF feature is complex AND maximum quality with team collaboration needed:
41
38
  → Route to /cook:team
42
39
 
@@ -52,7 +49,6 @@ IF unsure:
52
49
  | ------------- | ------------------------------------------------------- |
53
50
  | `/cook:fast` | Quick features, clear specifications |
54
51
  | `/cook:hard` | Complex features, full workflow |
55
- | `/cook:focus` | Complex features with **enforced context optimization** |
56
52
  | `/cook:team` | Maximum quality with parallel agent team collaboration |
57
53
 
58
54
  ---
@@ -68,8 +64,7 @@ IF unsure:
68
64
 
69
65
  1. ⚡ **Fast** → `/cook:fast` — Quick implementation
70
66
  2. ⚡⚡⚡ **Hard** → `/cook:hard` — Full feature development
71
- 3. 🎯 **Focus** → `/cook:focus` — Full development with **automatic context clearing** (prevents hallucination)
72
- 4. 👥 **Team** → `/cook:team` — Full team collaboration (parallel agents, maximum quality)
67
+ 3. 👥 **Team** → `/cook:team` — Full team collaboration (parallel agents, maximum quality)
73
68
 
74
69
  ⏳ Awaiting selection...
75
70
  ```
@@ -23,7 +23,7 @@ execution-mode: execute
23
23
 
24
24
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
27
27
 
28
28
  ---
29
29
 
package/commands/debug.md CHANGED
@@ -33,9 +33,6 @@ IF issue is simple (clear error, reproducible):
33
33
  IF issue is complex (intermittent, unclear cause):
34
34
  → Route to /debug:hard
35
35
 
36
- IF issue is complex AND clean fix handoff is critical:
37
- → Route to /debug:focus
38
-
39
36
  IF issue is complex AND maximum quality with team collaboration needed:
40
37
  → Route to /debug:team
41
38
 
@@ -51,7 +48,6 @@ IF unsure:
51
48
  | --------------- | ---------------------------------------------------- |
52
49
  | `/debug:fast` | Quick diagnosis for simple bugs |
53
50
  | `/debug:hard` | Deep investigation for complex issues |
54
- | `/debug:focus` | Deep investigation with **enforced context optimization** |
55
51
  | `/debug:team` | Maximum quality with parallel agent team collaboration |
56
52
 
57
53
  ---
@@ -67,8 +63,7 @@ IF unsure:
67
63
 
68
64
  1. ⚡ **Fast** → `/debug:fast` — Quick diagnosis
69
65
  2. ⚡⚡⚡ **Hard** → `/debug:hard` — Deep investigation
70
- 3. 🔒 **Focus** → `/debug:focus` — Deep investigation with **automatic context clearing** (clean fix handoff)
71
- 4. 👥 **Team** → `/debug:team` — Full team collaboration (parallel agents, maximum quality)
66
+ 3. 👥 **Team** → `/debug:team` — Full team collaboration (parallel agents, maximum quality)
72
67
 
73
68
  ⏳ Awaiting selection...
74
69
  ```
@@ -23,7 +23,7 @@ execution-mode: execute
23
23
 
24
24
  **⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
25
25
 
26
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/focus variants enable find-skills).
26
+ **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (hard/team variants enable find-skills).
27
27
 
28
28
  ---
29
29
 
@@ -34,9 +34,6 @@ IF design is simple (component, quick mockup):
34
34
  IF design is complex (full feature, system):
35
35
  → Route to /design:hard
36
36
 
37
- IF design is complex AND clean implementation handoff is critical:
38
- → Route to /design:focus
39
-
40
37
  IF design is complex AND maximum quality with team collaboration needed:
41
38
  → Route to /design:team
42
39
 
@@ -52,7 +49,6 @@ IF unsure:
52
49
  | --------------- | -------------------------------------------------- |
53
50
  | `/design:fast` | Quick component design, simple UI |
54
51
  | `/design:hard` | Full feature design, system design |
55
- | `/design:focus` | Full design with **enforced context optimization** |
56
52
  | `/design:team` | Maximum quality with parallel agent team collaboration |
57
53
 
58
54
  ---
@@ -68,8 +64,7 @@ IF unsure:
68
64
 
69
65
  1. ⚡ **Fast** → `/design:fast` — Quick design
70
66
  2. ⚡⚡⚡ **Hard** → `/design:hard` — Full design process
71
- 3. 🎯 **Focus** → `/design:focus` — Full design with **automatic context clearing** (clean implementation handoff)
72
- 4. 👥 **Team** → `/design:team` — Full team collaboration (parallel agents, maximum quality)
67
+ 3. 👥 **Team** → `/design:team` — Full team collaboration (parallel agents, maximum quality)
73
68
 
74
69
  ⏳ Awaiting selection...
75
70
  ```