@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
@@ -1,18 +0,0 @@
1
- ---
2
- name: agent-assistant-plan-focus
3
- description: "πŸ”’ Focused Plan β€” Research-backed planning with enforced context optimization. Use when user types /plan:focus."
4
- ---
5
-
6
- # /plan:focus
7
-
8
- > Activates Agent Assistant `/plan:focus` workflow.
9
-
10
- ## Rules
11
-
12
- 1. **Load first**: `~/.codex/skills/agent-assistant/rules/CORE.md` β€” follow all 10 Laws
13
- 2. **Agents**: Spawn via Codex native multi-agent (`~/.codex/agents/`)
14
- 3. **Skills**: Resolve from `~/.codex/skills/agent-assistant/matrix-skills/`
15
-
16
- ## Workflow
17
-
18
- **Load and follow**: `~/.codex/skills/agent-assistant/commands/plan/focus.md`
@@ -1,4 +0,0 @@
1
- display_name: "/plan:focus"
2
- short_description: "πŸ”’ Focused Plan β€” Research-backed planning with enforced context optimization"
3
- brand_color: "#F59E0B"
4
- allow_implicit_invocation: true
@@ -1,18 +0,0 @@
1
- ---
2
- name: agent-assistant-report-focus
3
- description: "πŸ”’ Focused Report β€” Deep analysis with enforced context optimization. Use when user types /report:focus."
4
- ---
5
-
6
- # /report:focus
7
-
8
- > Activates Agent Assistant `/report:focus` workflow.
9
-
10
- ## Rules
11
-
12
- 1. **Load first**: `~/.codex/skills/agent-assistant/rules/CORE.md` β€” follow all 10 Laws
13
- 2. **Agents**: Spawn via Codex native multi-agent (`~/.codex/agents/`)
14
- 3. **Skills**: Resolve from `~/.codex/skills/agent-assistant/matrix-skills/`
15
-
16
- ## Workflow
17
-
18
- **Load and follow**: `~/.codex/skills/agent-assistant/commands/report/focus.md`
@@ -1,4 +0,0 @@
1
- display_name: "/report:focus"
2
- short_description: "πŸ”’ Focused Report β€” Deep analysis with enforced context optimization"
3
- brand_color: "#3B82F6"
4
- allow_implicit_invocation: true
@@ -1,18 +0,0 @@
1
- ---
2
- name: agent-assistant-test-focus
3
- description: "πŸ”’ Focused Test β€” Comprehensive QA with enforced context optimization. Use when user types /test:focus."
4
- ---
5
-
6
- # /test:focus
7
-
8
- > Activates Agent Assistant `/test:focus` workflow.
9
-
10
- ## Rules
11
-
12
- 1. **Load first**: `~/.codex/skills/agent-assistant/rules/CORE.md` β€” follow all 10 Laws
13
- 2. **Agents**: Spawn via Codex native multi-agent (`~/.codex/agents/`)
14
- 3. **Skills**: Resolve from `~/.codex/skills/agent-assistant/matrix-skills/`
15
-
16
- ## Workflow
17
-
18
- **Load and follow**: `~/.codex/skills/agent-assistant/commands/test/focus.md`
@@ -1,4 +0,0 @@
1
- display_name: "/test:focus"
2
- short_description: "πŸ”’ Focused Test β€” Comprehensive QA with enforced context optimization"
3
- brand_color: "#10B981"
4
- allow_implicit_invocation: true
@@ -1,297 +0,0 @@
1
- ---
2
- description: πŸ”’ Focused Development β€” Full development cycle with enforced context optimization
3
- version: "1.0"
4
- category: engineering
5
- execution-mode: execute
6
- ---
7
-
8
- # /code:focus β€” Focus Development Cycle
9
-
10
- > **MISSION**: Execute complete development workflow with **enforced context optimization**.
11
- >
12
- > This variant automatically clears context before implementationβ€”no user prompt required.
13
- > Use when you want guaranteed clean implementation without context rot risk.
14
-
15
- <task>$ARGUMENTS</task>
16
-
17
- ---
18
-
19
- ## πŸ›‘ PRE-FLIGHT (DO FIRST β€” BLOCKS PHASE 1)
20
-
21
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
22
-
23
- 1. CORE.md β€” Identity, Laws, Routing
24
- 2. PHASES.md β€” Phase Execution
25
- 3. AGENTS.md β€” Tiered Execution
26
-
27
- **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
28
-
29
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (focus variant enables find-skills for superior skill matching).
30
-
31
- ---
32
-
33
- ## πŸ“Œ PLAN-ALREADY-PROVIDED: SKIP REDUNDANT PHASES
34
-
35
- **Before starting Phase 1**, resolve whether the user is **coding from an existing plan**. If yes, **do not** run research, scout, or brainstorm.
36
-
37
- ### Detection
38
-
39
- - User message references a plan: e.g. `@plan`, `@PLAN-...`, path like `./reports/{topic}/plans/PLAN-{name}`, or phrases like "according to plan", "follow the plan", "code from plan", "implement per plan".
40
- - Or a plan file already exists for this task at `./reports/{topic}/plans/PLAN-{task}` (derive `{task}` from `$ARGUMENTS` or from the referenced file name).
41
-
42
- ### Resolution
43
-
44
- 1. **CHECK**: Does a valid plan file exist (user-provided path or `./reports/{topic}/plans/PLAN-{task}`)?
45
- 2. **IF YES**:
46
- - **SKIP** Phase 1 (Requirements/Brainstorm), Phase 2 (Scout), Phase 3 (Planning).
47
- - **ANNOUNCE**: "βœ… Plan provided/found β€” skipping research, scout, and planning. Proceeding to implementation."
48
- - **GO TO**: Phase 4 (Implementation) β†’ Phase 5 (Testing) β†’ Phase 6 (Review).
49
- 3. **IF NO**: Run phases in order: Phase 1 β†’ 2 β†’ 3 β†’ 4 β†’ 5 β†’ 6.
50
-
51
- ---
52
-
53
- ## πŸ”€ TIERED EXECUTION PROTOCOL (MANDATORY)
54
-
55
- > **Reference: AGENTS.md (Tiered Execution)`
56
-
57
- ```yaml
58
- tiered_execution:
59
- principle: "Sub-agent FIRST (Tier 1). EMBODY ONLY on system failure (Tier 2)."
60
-
61
- tool_discovery: "Check runSubagent availability BEFORE first delegation"
62
-
63
- for_each_phase:
64
- TIER_1_MANDATORY: "IF tool exists β†’ MUST use SUB_AGENT_DELEGATION"
65
- TIER_2_FALLBACK: "ONLY on system errorβ€”NOT complexity/preference/speed"
66
-
67
- anti_lazy_fallback:
68
- - ❌ NEVER use Tier 2 when Tier 1 tool is available
69
- - βœ… ALWAYS attempt Tier 1 first when tool exists
70
- - βœ… ALWAYS log justification for Tier 2 fallback
71
- ```
72
-
73
- ---
74
-
75
- ## ⚠️ CRITICAL: PHASE CONTINUITY RULES
76
-
77
- ```yaml
78
- phase_continuity:
79
- rule: "Each phase MUST reference and follow outputs from prior phases"
80
-
81
- check_for_files:
82
- - "./reports/{topic}/brainstorms/BRAINSTORM-{task}"
83
- - "./reports/{topic}/scouts/SCOUT-{task}"
84
- - "./reports/{topic}/plans/PLAN-{task}"
85
-
86
- enforcement:
87
- - Phase 3 (Planning) MUST incorporate Scout findings
88
- - Phase 4 (Implementation) MUST follow the Plan file exactly
89
- - Phase 5 (Testing) MUST verify all plan checkpoints
90
- - If prior phase file missing β†’ Agent MUST create it
91
- ```
92
-
93
- All files in `./reports/{topic}/` β†’ English only.
94
- **⚠️ Paths above = base names.** Small (≀ 150 lines) β†’ create as `{name}.md`. Large (> 150 lines or β‰₯ 4 sections) β†’ create as `{name}/` folder with `00-index.md` + `01-*.md`, `02-*.md` section files.
95
-
96
- ---
97
-
98
- ## β›” INCREMENTAL EXECUTION (MANDATORY)
99
-
100
- One phase at a time, each phase independent: Phase 1 β†’ then Phase 2 β†’ … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what's happening (announce before doing).
101
-
102
- ---
103
-
104
- ## 🎭 Phase 1: REQUIREMENTS ANALYSIS
105
-
106
- | Attribute | Value |
107
- | ----------- | --------------------------------- |
108
- | **Agent** | `brainstormer` |
109
- | **Goal** | Clarify requirements if ambiguous |
110
- | **Trigger** | If requirements unclear |
111
-
112
- ### ⚑ TIERED EXECUTION
113
-
114
- **TIER 1 (MANDATORY when tool exists):**
115
-
116
- > Invoke runSubagent for `brainstormer`. Context: ISOLATED.
117
-
118
- **TIER 2 (FALLBACK on system error only):**
119
-
120
- > Load `{AGENTS_PATH}/brainstormer.md`
121
- > EMBODY [brainstormer] β€” Requires logged system error justification.
122
-
123
- **Exit Criteria:**
124
-
125
- - [ ] Requirements clear
126
- - [ ] Scope defined
127
- - [ ] Acceptance criteria established
128
- - [ ] **METHODOLOGY CHECK**: Output aligns with `brainstormer` Thinking Protocol
129
-
130
- ---
131
-
132
- ## 🎭 Phase 2: CODEBASE ANALYSIS
133
-
134
- | Attribute | Value |
135
- | --------- | ----------------------------- |
136
- | **Agent** | `scouter` |
137
- | **Goal** | Full codebase context mapping |
138
-
139
- ### ⚑ TIERED EXECUTION
140
-
141
- **TIER 1 (MANDATORY when tool exists):**
142
-
143
- > Invoke runSubagent for `scouter`. Context: ISOLATED.
144
-
145
- **TIER 2 (FALLBACK on system error only):**
146
-
147
- > Load `{AGENTS_PATH}/scouter.md`
148
- > EMBODY [scouter] β€” Requires logged system error justification.
149
-
150
- **Exit Criteria:**
151
-
152
- - [ ] Architecture understood
153
- - [ ] Patterns documented
154
- - [ ] Integration points identified
155
- - [ ] **METHODOLOGY CHECK**: Output aligns with `scouter` Thinking Protocol
156
-
157
- ---
158
-
159
- ## 🎭 Phase 3: IMPLEMENTATION PLANNING
160
-
161
- | Attribute | Value |
162
- | --------- | -------------------------- |
163
- | **Agent** | `planner` |
164
- | **Goal** | Create implementation plan |
165
-
166
- ### ⚑ TIERED EXECUTION
167
-
168
- **TIER 1 (MANDATORY when tool exists):**
169
-
170
- > Invoke runSubagent for `planner`. Context: ISOLATED.
171
-
172
- **TIER 2 (FALLBACK on system error only):**
173
-
174
- > Load `{AGENTS_PATH}/planner.md`
175
- > EMBODY [planner] β€” Requires logged system error justification.
176
-
177
- **Exit Criteria:**
178
-
179
- - [ ] Plan created
180
- - [ ] Steps defined
181
- - [ ] Risks identified
182
- - [ ] **METHODOLOGY CHECK**: Output aligns with `planner` Thinking Protocol
183
-
184
- ---
185
-
186
- Mode: Fresh implementation start
187
-
188
- Proceeding to Implementation...
189
- ```
190
-
191
- ---
192
-
193
- ## 🎭 Phase 4: IMPLEMENTATION
194
-
195
- | Attribute | Value |
196
- | --------- | ----------------------------------- |
197
- | **Agent** | `tech-lead` β†’ routes to specialists |
198
- | **Goal** | Execute plan with specialist agents |
199
-
200
- ### ⚑ TIERED EXECUTION
201
-
202
- **TIER 1 (MANDATORY when tool exists):**
203
-
204
- > Invoke runSubagent for `tech-lead`. Context: ISOLATED.
205
- > Tech-lead will spawn specialist subagents as needed.
206
-
207
- **TIER 2 (FALLBACK on system error only):**
208
-
209
- > Load `{AGENTS_PATH}/tech-lead.md`
210
- > EMBODY [tech-lead] β€” Requires logged system error justification.
211
- > Then recursively EMBODY specialists as needed.
212
-
213
- ### ⚑ FOCUS ADHERENCE DIRECTIVE
214
-
215
- ```
216
- 1. READ plan completely BEFORE any implementation
217
- 2. FOR EACH plan step:
218
- a. Implement EXACTLY as specified
219
- b. Mark complete: `- [ ]` β†’ `- [x]`
220
- 3. IF deviation needed:
221
- a. STOP
222
- b. REQUEST Re-Planning
223
- c. DO NOT proceed with own interpretation
224
- ```
225
-
226
- **Exit Criteria:**
227
-
228
- - [ ] All plan steps executed
229
- - [ ] Code complete
230
- - [ ] Documentation updated
231
- - [ ] **Each plan step has corresponding implementation**
232
- - [ ] **No unauthorized deviations**
233
- - [ ] **METHODOLOGY CHECK**: Output aligns with `tech-lead` Thinking Protocol
234
-
235
- ---
236
-
237
- ## 🎭 Phase 5: TESTING
238
-
239
- | Attribute | Value |
240
- | --------- | --------------------- |
241
- | **Agent** | `tester` |
242
- | **Goal** | Comprehensive testing |
243
-
244
- ### ⚑ TIERED EXECUTION
245
-
246
- **TIER 1 (MANDATORY when tool exists):**
247
-
248
- > Invoke runSubagent for `tester`. Context: ISOLATED.
249
-
250
- **TIER 2 (FALLBACK on system error only):**
251
-
252
- > Load `{AGENTS_PATH}/tester.md`
253
- > EMBODY [tester] β€” Requires logged system error justification.
254
-
255
- **Exit Criteria:**
256
-
257
- - [ ] Tests written
258
- - [ ] All tests pass
259
- - [ ] Coverage adequate
260
- - [ ] **METHODOLOGY CHECK**: Output aligns with `tester` Thinking Protocol
261
-
262
- ---
263
-
264
- ## 🎭 Phase 6: REVIEW
265
-
266
- | Attribute | Value |
267
- | --------- | ------------------- |
268
- | **Agent** | `reviewer` |
269
- | **Goal** | Code quality review |
270
-
271
- ### ⚑ TIERED EXECUTION
272
-
273
- **TIER 1 (MANDATORY when tool exists):**
274
-
275
- > Invoke runSubagent for `reviewer`. Context: ISOLATED.
276
-
277
- **TIER 2 (FALLBACK on system error only):**
278
-
279
- > Load `{AGENTS_PATH}/reviewer.md`
280
- > EMBODY [reviewer] β€” Requires logged system error justification.
281
-
282
- **Exit Criteria:**
283
-
284
- - [ ] Code reviewed
285
- - [ ] Standards met
286
- - [ ] No blocking issues
287
- - [ ] **METHODOLOGY CHECK**: Output aligns with `reviewer` Thinking Protocol
288
-
289
- ---
290
-
291
- ## COMPLETION
292
-
293
- Present implementation report with:
294
-
295
- 1. βœ… **Done** β€” Feature complete (Focus Mode)
296
- 2. πŸš€ **Deploy** β†’ `/deploy:preview`
297
- 3. πŸ“ **Docs** β†’ `/docs:core`
@@ -1,209 +0,0 @@
1
- ---
2
- description: πŸ”’ Focused Feature β€” Complete development with enforced context optimization
3
- version: "1.0"
4
- category: engineering
5
- execution-mode: execute
6
- ---
7
-
8
- # /cook:focus β€” Focus Feature Development
9
-
10
- > **MISSION**: Full feature development with **enforced context optimization**.
11
- >
12
- > This variant automatically clears context before implementationβ€”no user prompt required.
13
- > Use when you want guaranteed clean implementation without context rot risk.
14
-
15
- <feature>$ARGUMENTS</feature>
16
-
17
- ---
18
-
19
- ## πŸ›‘ PRE-FLIGHT (DO FIRST β€” BLOCKS PHASE 1)
20
-
21
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
22
-
23
- 1. CORE.md β€” Identity, Laws, Routing
24
- 2. PHASES.md β€” Phase Execution
25
- 3. AGENTS.md β€” Tiered Execution
26
-
27
- **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
28
-
29
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (focus variant enables find-skills for superior skill matching).
30
-
31
- ---
32
-
33
- ## πŸ”€ TIERED EXECUTION
34
-
35
- > Reference: AGENTS.md (Tiered Execution)`
36
-
37
- | Tier | When | Action |
38
- | ---------- | ----------------------------- | ---------------------------- |
39
- | **TIER 1** | runSubagent/Agent Tool EXISTS | Invoke sub-agent (MANDATORY) |
40
- | **TIER 2** | Tool MISSING or SYSTEM error | EMBODY agent file (FALLBACK) |
41
-
42
- **❌ Anti-Lazy**: Never use TIER 2 when TIER 1 tool available.
43
-
44
- ---
45
-
46
- ## πŸ“ DELIVERABLE FILES
47
-
48
- | Agent | Output |
49
- | ------------ | ----------------------------------------------- |
50
- | brainstormer | `./reports/{topic}/brainstorms/BRAINSTORM-{feature}` |
51
- | researcher | `./reports/{topic}/researchers/RESEARCH-{feature}` |
52
- | scouter | `./reports/{topic}/scouts/SCOUT-{feature}` |
53
- | designer | `./reports/{topic}/designs/DESIGN-{feature}` |
54
- | planner | `./reports/{topic}/plans/PLAN-{feature}` |
55
-
56
- All files in `./reports/{topic}/` β†’ English only.
57
- **⚠️ Paths above = base names.** Small (≀ 150 lines) β†’ create as `{name}.md`. Large (> 150 lines or β‰₯ 4 sections) β†’ create as `{name}/` folder with `00-index.md` + `01-*.md`, `02-*.md` section files.
58
-
59
- ---
60
-
61
- ## πŸ”— PHASE DEPENDENCIES
62
-
63
- | Phase | Requires | Blocking |
64
- | ------------------ | ---------------------- | ----------- |
65
- | P1: Brainstorm | User request | No |
66
- | P2: Research | User request | No |
67
- | P3: Scout | User request | No |
68
- | P3.5: DB Design | Data requirements | Conditional |
69
- | P4: Design | Scout findings | Conditional |
70
- | P5: Planning | RESEARCH + SCOUT files | **YES** |
71
- | P5.5: Context Gate | **PLAN file** | **AUTO** |
72
- | P6: Implementation | **PLAN file** | **YES** |
73
- | P7: Testing | PLAN + Code | **YES** |
74
- | P8: Review | PLAN + Code + Tests | **YES** |
75
-
76
- **β›” Blocking**: If input missing β†’ STOP β†’ Create it first β†’ Resume
77
-
78
- ---
79
-
80
- ## β›” INCREMENTAL EXECUTION (MANDATORY)
81
-
82
- One phase at a time, each phase independent: Phase 1 β†’ then Phase 2 β†’ … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what's happening (announce before doing). Format: rules/PHASES.md Β§ Phase output structure.
83
-
84
- ---
85
-
86
- ## 🎭 Phase 1: REQUIREMENTS CLARIFICATION
87
-
88
- | Agent | `brainstormer` |
89
- | ----- | -------------------------------------------------------------------- |
90
- | Goal | Full requirements discovery |
91
- | Exit | Requirements clear, constraints identified, success criteria defined |
92
-
93
- ---
94
-
95
- ## 🎭 Phase 2: RESEARCH
96
-
97
- | Agent | `researcher` |
98
- | ----- | -------------------------------------------------------------------------- |
99
- | Goal | Research best practices and patterns |
100
- | Exit | Patterns researched, best practices identified, recommendations documented |
101
-
102
- ---
103
-
104
- ## 🎭 Phase 3: CODEBASE ANALYSIS
105
-
106
- | Agent | `scouter` |
107
- | ----- | ----------------------------------------------------------------------- |
108
- | Goal | Map architecture and integration points |
109
- | Exit | Architecture understood, integration points mapped, patterns documented |
110
-
111
- ---
112
-
113
- ## 🎭 Phase 3.5: DATABASE DESIGN (IF DATA CHANGES)
114
-
115
- | Agent | `database-architect` |
116
- | ------- | ----------------------------------------------------------- |
117
- | Trigger | Feature involves database changes/migrations |
118
- | Goal | Schema design and data modeling |
119
- | Exit | Schema designed, migrations planned, query patterns defined |
120
-
121
- ---
122
-
123
- ## 🎭 Phase 4: DESIGN (IF UI NEEDED)
124
-
125
- | Agent | `designer` |
126
- | ------- | ----------------------------------------------------- |
127
- | Trigger | Feature has UI components |
128
- | Goal | UI/UX design |
129
- | Exit | Design created, accessibility considered, specs ready |
130
-
131
- ---
132
-
133
- ## 🎭 Phase 5: PLANNING
134
-
135
- | Agent | `planner` |
136
- | ------------ | --------------------------------------------------- |
137
- | Prerequisite | **READ** RESEARCH + SCOUT + DESIGN files |
138
- | Goal | Create detailed implementation plan |
139
- | Output | `./reports/{topic}/plans/PLAN-{feature}` |
140
- | Exit | Plan file created, phases defined, risks identified |
141
-
142
- ---
143
-
144
- ## 🎭 Phase 6: IMPLEMENTATION
145
-
146
- | Agent | `tech-lead` β†’ routes to specialists |
147
- | ------------ | ------------------------------------------------------- |
148
- | Prerequisite | **READ and FOLLOW** `./reports/{topic}/plans/PLAN-{feature}` |
149
- | Goal | Execute implementation plan |
150
-
151
- **FOCUS ADHERENCE:**
152
-
153
- ```
154
- 1. READ plan FIRST
155
- 2. FOR EACH step:
156
- - Implement EXACTLY as specified
157
- - Mark step complete: [ ] β†’ [x]
158
- 3. IF step seems wrong:
159
- - STOP β†’ Document β†’ Request Re-Planning
160
- - DO NOT implement your own interpretation
161
- ```
162
-
163
- | Exit | All plan phases complete, no unauthorized deviations |
164
-
165
- ---
166
-
167
- ## 🎭 Phase 7: TESTING
168
-
169
- | Agent | `tester` |
170
- | ------------ | ---------------------------- |
171
- | Prerequisite | **READ** PLAN + Code changes |
172
- | Goal | Comprehensive testing |
173
-
174
- **PLAN CHECKPOINT VERIFICATION:**
175
-
176
- ```
177
- FOR EACH checkpoint in PLAN:
178
- - Write test that verifies criteria
179
- - Document: "Checkpoint X β†’ Test Y"
180
- ```
181
-
182
- | Exit | All tests pass, each plan checkpoint has test |
183
-
184
- ---
185
-
186
- ## 🎭 Phase 8: REVIEW
187
-
188
- | Agent | `reviewer` |
189
- | ------------ | -------------------------------- |
190
- | Prerequisite | **READ** PLAN + Code + Tests |
191
- | Goal | Quality review + Plan compliance |
192
-
193
- **REVIEW CHECKLIST:**
194
-
195
- - Does code implement plan specification?
196
- - Any unauthorized deviations?
197
- - All plan phases reflected in code?
198
-
199
- | Exit | Code matches plan intent, standards met, approved |
200
-
201
- ---
202
-
203
- ## COMPLETION
204
-
205
- Present feature report with:
206
-
207
- 1. βœ… **Done** β€” Feature complete (Focus Mode)
208
- 2. πŸš€ **Deploy** β†’ `/deploy:preview`
209
- 3. πŸ“ **Docs** β†’ `/docs:core`
@@ -1,103 +0,0 @@
1
- ---
2
- description: πŸ”’ Focused Debug β€” Deep investigation with enforced context optimization
3
- version: "1.0"
4
- category: debugging
5
- execution-mode: execute
6
- ---
7
-
8
- # /debug:focus β€” Focus Deep Investigation
9
-
10
- > **MISSION**: Thorough investigation with **enforced context optimization**.
11
- >
12
- > This variant automatically clears context before fix handoffβ€”no user prompt required.
13
- > Use when you want guaranteed clean fix handoff without hypothesis drift.
14
-
15
- <issue>$ARGUMENTS</issue>
16
-
17
- ---
18
-
19
- ## πŸ›‘ PRE-FLIGHT (DO FIRST β€” BLOCKS PHASE 1)
20
-
21
- **LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
22
-
23
- 1. CORE.md β€” Identity, Laws, Routing
24
- 2. PHASES.md β€” Phase Execution
25
- 3. AGENTS.md β€” Tiered Execution
26
-
27
- **β›” Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
28
-
29
- **Skills Resolution**: When delegating, load `SKILLS.md` on-demand for fitness calculation and dynamic discovery (focus variant enables find-skills for superior skill matching).
30
-
31
- ---
32
-
33
- ## πŸ”€ TIERED EXECUTION
34
-
35
- | Tier | When | Action |
36
- | ---------- | ------------------ | ---------------------------- |
37
- | **TIER 1** | runSubagent EXISTS | Invoke sub-agent (MANDATORY) |
38
- | **TIER 2** | Tool MISSING | EMBODY agent file (FALLBACK) |
39
-
40
- ---
41
-
42
- ## πŸ“ DELIVERABLE FILES
43
-
44
- | Agent | Output |
45
- | -------- | ----------------------------------- |
46
- | debugger | `./reports/{topic}/debugs/DEBUG-{issue}` |
47
-
48
- All files in `./reports/{topic}/` β†’ English only.
49
- **⚠️ Paths above = base names.** Small (≀ 150 lines) β†’ create as `{name}.md`. Large (> 150 lines or β‰₯ 4 sections) β†’ create as `{name}/` folder with `00-index.md` + `01-*.md`, `02-*.md` section files.
50
-
51
- ---
52
-
53
- ## β›” INCREMENTAL EXECUTION (MANDATORY)
54
-
55
- One phase at a time, each phase independent: Phase 1 β†’ then Phase 2 β†’ … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what's happening (announce before doing).
56
-
57
- ---
58
-
59
- ## 🎭 Phase 1: INFORMATION GATHERING
60
-
61
- | Agent | `scouter` |
62
- | ----- | ----------------------------------------- |
63
- | Goal | Gather context and reproduction steps |
64
- | Exit | Context gathered, reproduction documented |
65
-
66
- ---
67
-
68
- ## 🎭 Phase 2: HYPOTHESIS FORMATION
69
-
70
- | Agent | `debugger` |
71
- | ----- | ----------------------------------- |
72
- | Goal | Form and rank hypotheses |
73
- | Exit | Hypotheses documented with evidence |
74
-
75
- ---
76
-
77
- ## 🎭 Phase 3: ROOT CAUSE ANALYSIS
78
-
79
- | Agent | `debugger` |
80
- | ------ | ----------------------------------------------- |
81
- | Goal | Deep investigation |
82
- | Output | `./reports/{topic}/debugs/DEBUG-{issue}` |
83
- | Exit | Root cause identified, failure chain documented |
84
-
85
- ---
86
-
87
- ## 🎭 Phase 4: SOLUTION DESIGN
88
-
89
- | Agent | `planner` |
90
- | ----- | --------------------------------------- |
91
- | Goal | Design fix strategy |
92
- | Exit | Fix approach defined with rollback plan |
93
-
94
- ---
95
-
96
- ## COMPLETION
97
-
98
- Present findings with:
99
-
100
- 1. βœ… **Root Cause** β€” Identified (Focus Mode)
101
- 2. πŸ”’ **Context Optimized** β€” Ready for focus fix
102
- 3. πŸ”§ **Fix** β†’ `/fix:focus`
103
- 4. πŸ“ **Document** β†’ `/docs:core`