@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
|
@@ -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,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,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`
|
package/commands/code/focus.md
DELETED
|
@@ -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`
|
package/commands/cook/focus.md
DELETED
|
@@ -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`
|
package/commands/debug/focus.md
DELETED
|
@@ -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`
|