@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.
- package/CHANGELOG.md +24 -1
- package/README.md +3 -4
- package/agents/backend-engineer.md +3 -3
- package/agents/brainstormer.md +3 -3
- package/agents/business-analyst.md +3 -3
- package/agents/database-architect.md +3 -3
- package/agents/debugger.md +2 -2
- package/agents/designer.md +2 -2
- package/agents/devops-engineer.md +2 -2
- package/agents/docs-manager.md +23 -15
- package/agents/frontend-engineer.md +3 -3
- package/agents/game-engineer.md +3 -3
- package/agents/mobile-engineer.md +4 -4
- package/agents/performance-engineer.md +3 -3
- package/agents/planner.md +4 -4
- package/agents/project-manager.md +3 -3
- package/agents/researcher.md +3 -3
- package/agents/reviewer.md +3 -3
- package/agents/scouter.md +3 -3
- package/agents/security-engineer.md +3 -3
- package/agents/tech-lead.md +3 -3
- package/agents/tester.md +2 -2
- package/code-assistants/codex-assistant/CODEX.md +1 -2
- package/commands/ask/hard.md +1 -1
- package/commands/brainstorm/hard.md +1 -1
- package/commands/code/hard.md +1 -1
- package/commands/code.md +2 -7
- package/commands/cook/hard.md +1 -1
- package/commands/cook.md +1 -6
- package/commands/debug/hard.md +1 -1
- package/commands/debug.md +1 -6
- package/commands/design/hard.md +1 -1
- package/commands/design.md +1 -6
- package/commands/docs/audit.md +554 -78
- package/commands/docs/business.md +392 -76
- package/commands/docs/core.md +573 -74
- package/commands/docs.md +62 -61
- package/commands/fix/hard.md +1 -1
- package/commands/fix.md +1 -6
- package/commands/plan/hard.md +1 -1
- package/commands/plan.md +1 -6
- package/commands/report/fast.md +2 -2
- package/commands/report/hard.md +1 -1
- package/commands/report.md +2 -7
- package/commands/review/hard.md +1 -1
- package/commands/test/hard.md +1 -1
- package/commands/test.md +1 -6
- package/documents/HSOL-ASSESSMENT.md +6 -6
- package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +1 -1
- package/documents/business/business-features/00-index.md +101 -0
- package/documents/business/business-features/01-feature-inventory.md +341 -0
- package/documents/business/business-features/02-prioritization-moscow.md +148 -0
- package/documents/business/business-features/03-feature-specifications.md +511 -0
- package/documents/business/business-features/04-dependencies-and-release-sequencing.md +313 -0
- package/documents/business/business-features/05-success-metrics.md +290 -0
- package/documents/business/business-glossary/00-index.md +89 -0
- package/documents/business/business-glossary/01-canonical-terms.md +428 -0
- package/documents/business/business-glossary/02-synonyms-and-deprecated-terms.md +180 -0
- package/documents/business/business-glossary/03-domain-entities-and-events.md +395 -0
- package/documents/business/business-glossary/04-api-term-mapping.md +173 -0
- package/documents/business/business-prd/00-index.md +107 -0
- package/documents/business/business-prd/01-executive-summary.md +131 -0
- package/documents/business/business-prd/02-problem-goals-and-scope.md +204 -0
- package/documents/business/business-prd/03-stakeholders-and-requirements.md +210 -0
- package/documents/business/business-prd/04-acceptance-risks-assumptions.md +246 -0
- package/documents/business/business-workflows/00-index.md +107 -0
- package/documents/business/business-workflows/01-actor-map.md +303 -0
- package/documents/business/business-workflows/02-workflow-catalog.md +252 -0
- package/documents/business/business-workflows/03-detailed-workflows.md +641 -0
- package/documents/business/business-workflows/04-decision-rules-and-exceptions.md +216 -0
- package/documents/business/business-workflows/05-sla-and-handoffs.md +253 -0
- package/documents/knowledge-architecture/00-index.md +159 -0
- package/documents/knowledge-architecture/01-system-overview.md +240 -0
- package/documents/knowledge-architecture/02-components.md +419 -0
- package/documents/knowledge-architecture/03-data-flow.md +368 -0
- package/documents/knowledge-architecture/04-design-patterns.md +497 -0
- package/documents/knowledge-architecture/05-decisions.md +410 -0
- package/documents/knowledge-domain/00-index.md +251 -0
- package/documents/knowledge-domain/01-entities.md +582 -0
- package/documents/knowledge-domain/02-database-schema.md +138 -0
- package/documents/knowledge-domain/03-api-contracts.md +477 -0
- package/documents/knowledge-domain/04-business-rules.md +554 -0
- package/documents/knowledge-overview/00-index.md +107 -0
- package/documents/knowledge-overview/01-project-identity.md +162 -0
- package/documents/knowledge-overview/02-tech-stack.md +119 -0
- package/documents/knowledge-overview/03-features.md +232 -0
- package/documents/knowledge-overview/04-getting-started.md +394 -0
- package/documents/knowledge-source-base/00-index.md +107 -0
- package/documents/knowledge-source-base/01-directory-structure.md +312 -0
- package/documents/knowledge-source-base/02-entry-points.md +346 -0
- package/documents/knowledge-source-base/03-key-modules.md +581 -0
- package/documents/knowledge-source-base/04-configuration.md +467 -0
- package/documents/knowledge-standards/00-index.md +129 -0
- package/documents/knowledge-standards/01-code-style.md +161 -0
- package/documents/knowledge-standards/02-conventions.md +254 -0
- package/documents/knowledge-standards/03-git-workflow.md +228 -0
- package/documents/knowledge-standards/04-testing-standards.md +175 -0
- package/matrix-skills/_index.yaml +1 -1
- package/package.json +1 -1
- package/rules/AGENTS.md +1 -1
- package/rules/REFERENCE.md +18 -14
- package/rules/SKILLS.md +1 -1
- package/rules/TEAMS.md +1 -2
- package/skills/docs-audit/README.md +10 -8
- package/skills/docs-audit/SKILL.md +45 -41
- package/skills/docs-audit/references/scoring-framework.md +5 -5
- package/skills/docs-core/README.md +19 -14
- package/skills/docs-core/SKILL.md +189 -117
- package/skills/planning/references/codebase-understanding.md +5 -5
- package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/agents/openai.yaml +0 -4
- package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/SKILL.md +0 -18
- package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/agents/openai.yaml +0 -4
- package/commands/code/focus.md +0 -297
- package/commands/cook/focus.md +0 -209
- package/commands/debug/focus.md +0 -103
- package/commands/design/focus.md +0 -229
- package/commands/fix/focus.md +0 -145
- package/commands/plan/focus.md +0 -140
- package/commands/report/focus.md +0 -107
- package/commands/test/focus.md +0 -123
- package/documents/business/business-features.md +0 -894
- package/documents/business/business-glossary.md +0 -554
- package/documents/business/business-prd.md +0 -400
- package/documents/business/business-workflows.md +0 -713
- package/documents/knowledge-architecture.md +0 -621
- package/documents/knowledge-domain.md +0 -602
- package/documents/knowledge-overview.md +0 -316
- package/documents/knowledge-source-base.md +0 -581
- 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
|
|
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`/`
|
|
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:
|
|
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,
|
|
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?
|
package/agents/brainstormer.md
CHANGED
|
@@ -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}
|
package/agents/debugger.md
CHANGED
|
@@ -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
|
|
package/agents/designer.md
CHANGED
|
@@ -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}
|
package/agents/docs-manager.md
CHANGED
|
@@ -62,29 +62,37 @@ ALWAYS:
|
|
|
62
62
|
|
|
63
63
|
```
|
|
64
64
|
CHECK EXISTING PROJECT DOCS (./documents/):
|
|
65
|
-
|
|
66
|
-
-
|
|
67
|
-
- knowledge-
|
|
68
|
-
- knowledge-
|
|
69
|
-
→
|
|
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
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
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
|
-
- [ ]
|
|
85
|
-
- [ ]
|
|
86
|
-
- [ ]
|
|
87
|
-
- [ ]
|
|
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:
|
package/agents/game-engineer.md
CHANGED
|
@@ -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
|
|
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
|
|
package/agents/researcher.md
CHANGED
|
@@ -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
|
|
package/agents/reviewer.md
CHANGED
|
@@ -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
|
|
package/agents/tech-lead.md
CHANGED
|
@@ -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:
|
|
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
|
|
package/commands/ask/hard.md
CHANGED
|
@@ -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/
|
|
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/
|
|
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/hard.md
CHANGED
|
@@ -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/
|
|
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
|
|
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.
|
|
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
|
```
|
package/commands/cook/hard.md
CHANGED
|
@@ -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/
|
|
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.
|
|
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
|
```
|
package/commands/debug/hard.md
CHANGED
|
@@ -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/
|
|
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.
|
|
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
|
```
|
package/commands/design/hard.md
CHANGED
|
@@ -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/
|
|
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/design.md
CHANGED
|
@@ -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.
|
|
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
|
```
|