@namch/agent-assistant 1.1.0 → 1.2.0
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 +51 -1
- package/README.md +6 -1
- package/agents/teams/backend-team/executor.md +188 -0
- package/agents/teams/backend-team/reviewer.md +328 -0
- package/agents/teams/backend-team/techlead.md +166 -0
- package/agents/teams/database-team/executor.md +189 -0
- package/agents/teams/database-team/reviewer.md +333 -0
- package/agents/teams/database-team/techlead.md +168 -0
- package/agents/teams/debug-team/executor.md +195 -0
- package/agents/teams/debug-team/reviewer.md +324 -0
- package/agents/teams/debug-team/techlead.md +173 -0
- package/agents/teams/design-team/executor.md +196 -0
- package/agents/teams/design-team/reviewer.md +405 -0
- package/agents/teams/design-team/techlead.md +170 -0
- package/agents/teams/devops-team/executor.md +199 -0
- package/agents/teams/devops-team/reviewer.md +332 -0
- package/agents/teams/devops-team/techlead.md +168 -0
- package/agents/teams/docs-team/executor.md +196 -0
- package/agents/teams/docs-team/reviewer.md +331 -0
- package/agents/teams/docs-team/techlead.md +168 -0
- package/agents/teams/frontend-team/executor.md +190 -0
- package/agents/teams/frontend-team/reviewer.md +333 -0
- package/agents/teams/frontend-team/techlead.md +169 -0
- package/agents/teams/fullstack-team/executor.md +290 -0
- package/agents/teams/fullstack-team/reviewer.md +365 -0
- package/agents/teams/fullstack-team/techlead.md +254 -0
- package/agents/teams/game-team/executor.md +193 -0
- package/agents/teams/game-team/reviewer.md +331 -0
- package/agents/teams/game-team/techlead.md +167 -0
- package/agents/teams/mobile-team/executor.md +192 -0
- package/agents/teams/mobile-team/reviewer.md +328 -0
- package/agents/teams/mobile-team/techlead.md +168 -0
- package/agents/teams/performance-team/executor.md +192 -0
- package/agents/teams/performance-team/reviewer.md +322 -0
- package/agents/teams/performance-team/techlead.md +175 -0
- package/agents/teams/planning-team/executor.md +197 -0
- package/agents/teams/planning-team/reviewer.md +279 -0
- package/agents/teams/planning-team/techlead.md +169 -0
- package/agents/teams/project-team/executor.md +190 -0
- package/agents/teams/project-team/reviewer.md +328 -0
- package/agents/teams/project-team/techlead.md +168 -0
- package/agents/teams/qa-team/executor.md +198 -0
- package/agents/teams/qa-team/reviewer.md +271 -0
- package/agents/teams/qa-team/techlead.md +175 -0
- package/agents/teams/report-team/executor.md +195 -0
- package/agents/teams/report-team/reviewer.md +328 -0
- package/agents/teams/report-team/techlead.md +168 -0
- package/agents/teams/research-team/executor.md +200 -0
- package/agents/teams/research-team/reviewer.md +272 -0
- package/agents/teams/research-team/techlead.md +168 -0
- package/agents/teams/security-team/executor.md +193 -0
- package/agents/teams/security-team/reviewer.md +338 -0
- package/agents/teams/security-team/techlead.md +178 -0
- package/cli/README.md +19 -2
- package/cli/install.js +300 -9
- package/cli/install.test.js.example +1 -1
- package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +86 -39
- package/code-assistants/antigravity-assistant/GEMINI.md +105 -30
- package/code-assistants/claude-assistant/CLAUDE.md +4 -4
- package/code-assistants/codex-assistant/CODEX.md +235 -0
- package/code-assistants/codex-assistant/agents/backend-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/brainstormer.toml +26 -0
- package/code-assistants/codex-assistant/agents/business-analyst.toml +26 -0
- package/code-assistants/codex-assistant/agents/database-architect.toml +26 -0
- package/code-assistants/codex-assistant/agents/debugger.toml +26 -0
- package/code-assistants/codex-assistant/agents/designer.toml +26 -0
- package/code-assistants/codex-assistant/agents/devops-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/docs-manager.toml +26 -0
- package/code-assistants/codex-assistant/agents/frontend-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/game-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/mobile-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/performance-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/planner.toml +26 -0
- package/code-assistants/codex-assistant/agents/project-manager.toml +26 -0
- package/code-assistants/codex-assistant/agents/reporter.toml +26 -0
- package/code-assistants/codex-assistant/agents/researcher.toml +26 -0
- package/code-assistants/codex-assistant/agents/reviewer.toml +26 -0
- package/code-assistants/codex-assistant/agents/scouter.toml +26 -0
- package/code-assistants/codex-assistant/agents/security-engineer.toml +26 -0
- package/code-assistants/codex-assistant/agents/tech-lead.toml +26 -0
- package/code-assistants/codex-assistant/agents/tester.toml +26 -0
- package/code-assistants/codex-assistant/config.toml +109 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-ask/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-ask/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-ask-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-ask-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-ask-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-ask-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-auto/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-auto/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-code-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-cook-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-debug-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-check/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-check/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-preview/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-preview/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-production/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-production/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-rollback/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-deploy-rollback/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-design-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs-audit/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs-audit/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs-business/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs-business/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs-core/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-docs-core/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-fix-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-plan-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-report-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-review-team/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-fast/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-fast/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-hard/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-hard/agents/openai.yaml +4 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-team/SKILL.md +18 -0
- package/code-assistants/codex-assistant/skills/agent-assistant-test-team/agents/openai.yaml +4 -0
- package/code-assistants/copilot-assistant/agent-assistant.agent.md +149 -51
- package/code-assistants/cursor-assistant/.cursorrules +5 -5
- package/code-assistants/cursor-assistant/rules/agent-assistant.mdc +5 -5
- package/commands/brainstorm/team.md +295 -0
- package/commands/brainstorm.md +5 -0
- package/commands/code/team.md +456 -0
- package/commands/code.md +5 -0
- package/commands/cook/team.md +609 -0
- package/commands/cook.md +5 -0
- package/commands/debug/team.md +396 -0
- package/commands/debug.md +5 -0
- package/commands/design/team.md +567 -0
- package/commands/design.md +5 -0
- package/commands/fix/team.md +596 -0
- package/commands/fix.md +5 -0
- package/commands/plan/team.md +358 -0
- package/commands/plan.md +5 -0
- package/commands/report/team.md +502 -0
- package/commands/report.md +5 -0
- package/commands/review/team.md +353 -0
- package/commands/review.md +5 -0
- package/commands/test/team.md +303 -0
- package/commands/test.md +5 -0
- package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +4 -2
- package/documents/business/business-prd.md +2 -1
- package/documents/business/business-workflows.md +2 -2
- package/documents/knowledge-architecture.md +13 -12
- package/documents/knowledge-domain.md +2 -2
- package/documents/knowledge-overview.md +2 -2
- package/documents/knowledge-source-base.md +11 -7
- package/package.json +5 -2
- package/rules/AGENTS.md +55 -0
- package/rules/CORE.md +27 -13
- package/rules/PHASES.md +58 -0
- package/rules/TEAMS.md +530 -0
|
@@ -0,0 +1,609 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: "🔺 Team Feature — Golden Triangle parallel agent collaboration for maximum quality"
|
|
3
|
+
version: "2.0"
|
|
4
|
+
category: engineering
|
|
5
|
+
execution-mode: execute
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# /cook:team — Golden Triangle Feature Development
|
|
9
|
+
|
|
10
|
+
> **MISSION**: Maximum quality feature development through adversarial collaboration.
|
|
11
|
+
> Each phase spawns a **Golden Triangle** of 3 agents: Tech Lead (coordinator),
|
|
12
|
+
> Executor (implementer), Reviewer (devil's advocate). Output is released ONLY
|
|
13
|
+
> upon consensus after debate.
|
|
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
|
+
4. **TEAMS.md** — Golden Triangle protocol (MANDATORY)
|
|
27
|
+
|
|
28
|
+
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
29
|
+
|
|
30
|
+
**Skills Resolution**: Load `SKILLS.md` on-demand for fitness calculation and dynamic discovery.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 🔀 TIERED EXECUTION
|
|
35
|
+
|
|
36
|
+
> Reference: AGENTS.md (Tiered Execution) + TEAMS.md (Golden Triangle Protocol)
|
|
37
|
+
|
|
38
|
+
| Tier | When | Action |
|
|
39
|
+
| ---------- | ----------------------------- | ------------------------------------------------------------------------- |
|
|
40
|
+
| **TIER 1** | runSubagent/Agent Tool EXISTS | Orchestrator spawns Tech Lead → Tech Lead spawns Executor + Reviewer |
|
|
41
|
+
| **TIER 2** | Tool MISSING or SYSTEM error | EMBODY Tech Lead → EMBODY Executor → EMBODY Reviewer → EMBODY Tech Lead |
|
|
42
|
+
|
|
43
|
+
**❌ Anti-Lazy**: Never use TIER 2 when TIER 1 tool available.
|
|
44
|
+
|
|
45
|
+
**TIER 2 Golden Triangle Embodiment** (per TEAMS.md):
|
|
46
|
+
```
|
|
47
|
+
1. EMBODY Tech Lead → decompose task → produce Shared Task List → dispatch
|
|
48
|
+
2. EMBODY Executor → implement assigned tasks → post SUBMISSION to Mailbox
|
|
49
|
+
3. EMBODY Reviewer → review submissions → post REVIEW to Mailbox
|
|
50
|
+
4. IF FAIL → EMBODY Executor again → fix/defend → EMBODY Reviewer → re-check
|
|
51
|
+
5. Repeat steps 3–4 max 3 rounds
|
|
52
|
+
6. EMBODY Tech Lead → arbitrate if needed → post DECISION → synthesize output
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## 📬 MAILBOX — Central Communication Hub
|
|
58
|
+
|
|
59
|
+
**Location**: `./reports/MAILBOX-{date}.md`
|
|
60
|
+
|
|
61
|
+
All 3 triangle agents READ from and APPEND to this file. Never overwrite — append only.
|
|
62
|
+
|
|
63
|
+
**Message Format**:
|
|
64
|
+
```markdown
|
|
65
|
+
---
|
|
66
|
+
## [{TIMESTAMP}] {MESSAGE_TYPE} | {AGENT} → {TARGET}
|
|
67
|
+
**Phase**: {phase number}
|
|
68
|
+
**Task**: {task ID from Shared Task List}
|
|
69
|
+
**Content**:
|
|
70
|
+
{message body}
|
|
71
|
+
---
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
**Message Types**:
|
|
75
|
+
|
|
76
|
+
| Type | Sender | Receiver | Purpose |
|
|
77
|
+
| ----------------- | --------- | --------- | ---------------------------------------------- |
|
|
78
|
+
| TASK_ASSIGNMENT | Tech Lead | Executor | Assign task with requirements and context |
|
|
79
|
+
| SUBMISSION | Executor | Reviewer | Submit completed work for review |
|
|
80
|
+
| REVIEW | Reviewer | Executor | Review result: PASS or FAIL with findings |
|
|
81
|
+
| DEFENSE | Executor | Reviewer | Defend implementation against FAIL findings |
|
|
82
|
+
| RESUBMISSION | Executor | Reviewer | Resubmit after fixing FAIL findings |
|
|
83
|
+
| APPROVAL | Reviewer | Tech Lead | Confirm task passes all review criteria |
|
|
84
|
+
| ESCALATION | Any | Tech Lead | Escalate unresolvable disagreement |
|
|
85
|
+
| ARBITRATION | Tech Lead | All | Tech Lead resolves dispute with binding decision|
|
|
86
|
+
| DECISION | Tech Lead | All | Final phase decision with consensus stamp |
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 📁 DELIVERABLE FILES
|
|
91
|
+
|
|
92
|
+
| Phase / Team | Output |
|
|
93
|
+
| --------------- | ----------------------------------------------- |
|
|
94
|
+
| Phase 1 (Disc.) | `./reports/brainstorms/BRAINSTORM-{feature}.md` |
|
|
95
|
+
| Phase 2 (Res.) | `./reports/researchers/RESEARCH-{feature}.md` |
|
|
96
|
+
| Phase 2 (Res.) | `./reports/scouts/SCOUT-{feature}.md` |
|
|
97
|
+
| Phase 4 (Des.) | `./reports/designs/DESIGN-{feature}.md` |
|
|
98
|
+
| Phase 5 (Plan) | `./reports/plans/PLAN-{feature}.md` |
|
|
99
|
+
| ALL Phases | `./reports/MAILBOX-{date}.md` |
|
|
100
|
+
|
|
101
|
+
All files in `./reports/` → English only.
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 🔗 PHASE DEPENDENCIES
|
|
106
|
+
|
|
107
|
+
| Phase | Requires | Blocking |
|
|
108
|
+
| ---------------------------- | -------------------------------- | ----------- |
|
|
109
|
+
| P1: Requirements & Discovery | User request | No |
|
|
110
|
+
| P2: Research & Patterns | P1 requirements | No |
|
|
111
|
+
| P3: Database Design | Data requirements from P1/P2 | Conditional |
|
|
112
|
+
| P4: Design | Scout findings from P2 | Conditional |
|
|
113
|
+
| P5: Planning | RESEARCH + SCOUT + DESIGN | **YES** |
|
|
114
|
+
| 🛡️ CHECKPOINT | PLAN file + User approval | **YES** |
|
|
115
|
+
| P6: Implementation | **PLAN file + User approval** | **YES** |
|
|
116
|
+
| P7: Testing & Review | PLAN + Code + Tests | **YES** |
|
|
117
|
+
|
|
118
|
+
**⛔ Blocking**: If input missing → STOP → Create it first → Resume
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
123
|
+
|
|
124
|
+
One phase at a time. Within each phase:
|
|
125
|
+
|
|
126
|
+
```
|
|
127
|
+
1. Spawn Golden Triangle (Tech Lead + Executor + Reviewer)
|
|
128
|
+
2. Tech Lead decomposes → publishes Shared Task List
|
|
129
|
+
3. Executor implements → posts SUBMISSION to Mailbox
|
|
130
|
+
4. Reviewer critiques → posts REVIEW to Mailbox
|
|
131
|
+
5. Debate loop: fix/defend → re-review (max 3 rounds)
|
|
132
|
+
6. Consensus reached → Tech Lead posts DECISION → Phase output released
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
**Consensus Stamp Format** (required to close each phase):
|
|
136
|
+
```
|
|
137
|
+
✅ CONSENSUS: {TechLead} ✓ | {Executor} ✓ | {Reviewer} ✓
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
Format: rules/PHASES.md § Phase output structure + rules/TEAMS.md § Golden Triangle Phase Output Format.
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 🔺 GOLDEN TRIANGLE LOOP — Universal Protocol
|
|
145
|
+
|
|
146
|
+
> Every phase below follows this exact loop. Deviations are PROHIBITED.
|
|
147
|
+
|
|
148
|
+
```
|
|
149
|
+
┌─────────────────────────────────────────────────────────────────────┐
|
|
150
|
+
│ GOLDEN TRIANGLE LOOP │
|
|
151
|
+
│ │
|
|
152
|
+
│ 1. Tech Lead decomposes phase goal into tasks │
|
|
153
|
+
│ → Publishes Shared Task List │
|
|
154
|
+
│ → Posts TASK_ASSIGNMENT to Mailbox for each task │
|
|
155
|
+
│ │
|
|
156
|
+
│ 2. Executor works each task │
|
|
157
|
+
│ → Posts SUBMISSION to Mailbox per task │
|
|
158
|
+
│ → Includes: what was done, files/artifacts, approach, notes │
|
|
159
|
+
│ │
|
|
160
|
+
│ 3. Reviewer reviews each SUBMISSION │
|
|
161
|
+
│ → Posts REVIEW to Mailbox: PASS or FAIL │
|
|
162
|
+
│ → FAIL includes: findings table, severity, required actions │
|
|
163
|
+
│ │
|
|
164
|
+
│ 4. IF FAIL (debate loop, max 3 rounds): │
|
|
165
|
+
│ → Executor reads findings │
|
|
166
|
+
│ → For each finding: Fix (if valid) or DEFENSE (if disputed) │
|
|
167
|
+
│ → Posts RESUBMISSION or DEFENSE to Mailbox │
|
|
168
|
+
│ → Reviewer re-reviews → back to step 3 │
|
|
169
|
+
│ → After 3 rounds without resolution → ESCALATION to Tech Lead │
|
|
170
|
+
│ │
|
|
171
|
+
│ 5. IF PASS: │
|
|
172
|
+
│ → Reviewer posts APPROVAL to Mailbox │
|
|
173
|
+
│ → Task marked ✅ in Shared Task List │
|
|
174
|
+
│ │
|
|
175
|
+
│ 6. After ALL tasks complete: │
|
|
176
|
+
│ → Tech Lead verifies integration/coherence │
|
|
177
|
+
│ → Tech Lead posts DECISION with consensus stamp │
|
|
178
|
+
│ → Phase output released │
|
|
179
|
+
│ │
|
|
180
|
+
│ OUTPUT: ✅ CONSENSUS: TechLead ✓ | Executor ✓ | Reviewer ✓ │
|
|
181
|
+
└─────────────────────────────────────────────────────────────────────┘
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 🎭 Phase 1: REQUIREMENTS & DISCOVERY — 🔺 GOLDEN TRIANGLE
|
|
187
|
+
|
|
188
|
+
| Role | Agent | Mission |
|
|
189
|
+
| --------- | ------------------------------------ | ---------------------------------------------------------- |
|
|
190
|
+
| Tech Lead | `researcher` | Decompose: requirements gathering, codebase survey, prior art |
|
|
191
|
+
| Executor | `scouter` | Execute: deep codebase analysis, map architecture, identify integration points |
|
|
192
|
+
| Reviewer | `brainstormer` (Devil's Advocate) | Challenge: poke holes in findings, identify missed requirements, question assumptions |
|
|
193
|
+
|
|
194
|
+
**Triangle Loop**:
|
|
195
|
+
1. `researcher` decomposes discovery into areas: functional requirements, non-functional requirements, codebase context, prior art
|
|
196
|
+
2. `researcher` posts TASK_ASSIGNMENT to Mailbox for each area → dispatches to `scouter`
|
|
197
|
+
3. `scouter` surveys codebase deeply → posts SUBMISSION to Mailbox with findings per area
|
|
198
|
+
4. `brainstormer` reviews each SUBMISSION → posts REVIEW to Mailbox:
|
|
199
|
+
- Are requirements complete? Any edge cases missed?
|
|
200
|
+
- Are assumptions validated or just guesses?
|
|
201
|
+
- What user scenarios are unaccounted for?
|
|
202
|
+
5. If REVIEW = FAIL → `scouter` addresses gaps or defends findings → posts RESUBMISSION/DEFENSE
|
|
203
|
+
6. `brainstormer` re-reviews → max 3 rounds → ESCALATION to `researcher` if unresolved
|
|
204
|
+
7. `researcher` synthesizes all approved findings into unified requirements document
|
|
205
|
+
|
|
206
|
+
**Deliverable**: Requirements + discovery report in `./reports/brainstorms/BRAINSTORM-{feature}.md`
|
|
207
|
+
**Exit Criteria**: All requirements captured, codebase understood, gaps identified, assumptions challenged
|
|
208
|
+
**Consensus**: ✅ CONSENSUS: researcher ✓ | scouter ✓ | brainstormer ✓
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## 🎭 Phase 2: RESEARCH & PATTERNS — 🔺 GOLDEN TRIANGLE
|
|
213
|
+
|
|
214
|
+
| Role | Agent | Mission |
|
|
215
|
+
| --------- | ------------------------------------ | ---------------------------------------------------------- |
|
|
216
|
+
| Tech Lead | `researcher` | Decompose: pattern research areas, technology evaluation criteria |
|
|
217
|
+
| Executor | `researcher` (self-executes research)| Execute: deep-dive patterns, libraries, best practices, alternatives |
|
|
218
|
+
| Reviewer | `tech-lead` (feasibility critic) | Challenge: assess feasibility, question complexity, verify patterns fit existing codebase |
|
|
219
|
+
|
|
220
|
+
**Triangle Loop**:
|
|
221
|
+
1. `researcher` (as Tech Lead) identifies research areas → Shared Task List → Mailbox
|
|
222
|
+
2. `researcher` (as Executor) deep-dives each area → posts SUBMISSION with findings, comparisons, trade-offs
|
|
223
|
+
3. `tech-lead` reviews each research finding → posts REVIEW:
|
|
224
|
+
- Does this pattern actually fit our codebase?
|
|
225
|
+
- Is the complexity justified for our scale?
|
|
226
|
+
- Are there simpler alternatives overlooked?
|
|
227
|
+
- Will this introduce maintenance burden?
|
|
228
|
+
4. Debate loop if FAIL → `researcher` defends or pivots → max 3 rounds
|
|
229
|
+
5. `researcher` (as Tech Lead) synthesizes approved research into final deliverables
|
|
230
|
+
|
|
231
|
+
**Deliverable**: `./reports/researchers/RESEARCH-{feature}.md` + `./reports/scouts/SCOUT-{feature}.md`
|
|
232
|
+
**Exit Criteria**: Patterns researched, alternatives documented, feasibility validated by tech-lead
|
|
233
|
+
**Consensus**: ✅ CONSENSUS: researcher ✓ | researcher(exec) ✓ | tech-lead ✓
|
|
234
|
+
|
|
235
|
+
---
|
|
236
|
+
|
|
237
|
+
## 🎭 Phase 3: DATABASE DESIGN (IF DATA CHANGES) — 🔺 GOLDEN TRIANGLE
|
|
238
|
+
|
|
239
|
+
> **Trigger**: Feature involves database changes, new models, or migrations. Skip if no data changes.
|
|
240
|
+
|
|
241
|
+
| Role | Agent | Mission |
|
|
242
|
+
| --------- | ------------------------------------ | ---------------------------------------------------------- |
|
|
243
|
+
| Tech Lead | `tech-lead` | Decompose: schema design tasks, migration planning, data validation rules |
|
|
244
|
+
| Executor | `database-architect` | Execute: design schema, write migrations, plan indexes, define constraints |
|
|
245
|
+
| Reviewer | `reviewer` + security/perf lens | Challenge: SQL injection risks, N+1 queries, missing indexes, data integrity holes |
|
|
246
|
+
|
|
247
|
+
**Triangle Loop**:
|
|
248
|
+
1. `tech-lead` decomposes database work → Shared Task List → TASK_ASSIGNMENT to Mailbox
|
|
249
|
+
2. `database-architect` designs schema, relations, migrations → posts SUBMISSION with:
|
|
250
|
+
- Schema diagram / ERD description
|
|
251
|
+
- Migration scripts
|
|
252
|
+
- Index strategy
|
|
253
|
+
- Query patterns for common operations
|
|
254
|
+
3. `reviewer` reviews with security + performance lens → posts REVIEW:
|
|
255
|
+
- Any SQL injection vectors in query patterns?
|
|
256
|
+
- Missing indexes for expected query patterns?
|
|
257
|
+
- N+1 query risks in relation design?
|
|
258
|
+
- Data integrity: foreign keys, constraints, cascades correct?
|
|
259
|
+
- Encryption at rest for sensitive fields?
|
|
260
|
+
4. Debate loop if FAIL → `database-architect` fixes or defends → max 3 rounds
|
|
261
|
+
5. `tech-lead` arbitrates any disputes → posts DECISION
|
|
262
|
+
|
|
263
|
+
**Deliverable**: Approved schema design + migration plan
|
|
264
|
+
**Exit Criteria**: Schema designed, security reviewed, performance validated, migrations planned
|
|
265
|
+
**Consensus**: ✅ CONSENSUS: tech-lead ✓ | database-architect ✓ | reviewer ✓
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
## 🎭 Phase 4: DESIGN (IF UI NEEDED) — 🔺 GOLDEN TRIANGLE
|
|
270
|
+
|
|
271
|
+
> **Trigger**: Feature has UI components. Skip if backend-only.
|
|
272
|
+
|
|
273
|
+
| Role | Agent | Mission |
|
|
274
|
+
| --------- | ------------------------------------ | ---------------------------------------------------------- |
|
|
275
|
+
| Tech Lead | `designer` | Decompose: UI components, interaction flows, design system tokens |
|
|
276
|
+
| Executor | `frontend-engineer` | Execute: create design specs, component structures, responsive layouts |
|
|
277
|
+
| Reviewer | `reviewer` + UX/accessibility lens | Challenge: accessibility issues, UX friction, design inconsistencies, mobile gaps |
|
|
278
|
+
|
|
279
|
+
**Triangle Loop**:
|
|
280
|
+
1. `designer` decomposes UI work into components → Shared Task List → TASK_ASSIGNMENT to Mailbox
|
|
281
|
+
2. `frontend-engineer` creates design specs per component → posts SUBMISSION with:
|
|
282
|
+
- Component hierarchy and props
|
|
283
|
+
- Responsive behavior description
|
|
284
|
+
- State management approach
|
|
285
|
+
- Interaction patterns
|
|
286
|
+
3. `reviewer` reviews with UX/a11y lens → posts REVIEW:
|
|
287
|
+
- WCAG 2.1 AA compliance?
|
|
288
|
+
- Keyboard navigation complete?
|
|
289
|
+
- Screen reader compatibility?
|
|
290
|
+
- Consistent with existing design system?
|
|
291
|
+
- Mobile-first responsive handling?
|
|
292
|
+
4. Debate loop if FAIL → fixes/defenses → max 3 rounds
|
|
293
|
+
5. `designer` synthesizes into final design spec
|
|
294
|
+
|
|
295
|
+
**Deliverable**: `./reports/designs/DESIGN-{feature}.md`
|
|
296
|
+
**Exit Criteria**: Design complete, accessibility validated, technical feasibility confirmed
|
|
297
|
+
**Consensus**: ✅ CONSENSUS: designer ✓ | frontend-engineer ✓ | reviewer ✓
|
|
298
|
+
|
|
299
|
+
---
|
|
300
|
+
|
|
301
|
+
## 🎭 Phase 5: PLANNING — 🔺 GOLDEN TRIANGLE
|
|
302
|
+
|
|
303
|
+
| Role | Agent | Mission |
|
|
304
|
+
| --------- | ------------------------------------ | ---------------------------------------------------------- |
|
|
305
|
+
| Tech Lead | `planner` | Decompose: plan creation with all dependencies, task ordering, effort estimation |
|
|
306
|
+
| Executor | `researcher` | Execute: fill knowledge gaps, validate approaches, draft plan sections |
|
|
307
|
+
| Reviewer | `tech-lead` (feasibility critic) | Challenge: question estimates, find risks, verify technical approach is sound |
|
|
308
|
+
|
|
309
|
+
**Prerequisite**: **READ** RESEARCH + SCOUT + DESIGN files before starting.
|
|
310
|
+
|
|
311
|
+
**Triangle Loop**:
|
|
312
|
+
1. `planner` reads all prior deliverables → decomposes plan into sections → Shared Task List → TASK_ASSIGNMENT
|
|
313
|
+
2. `researcher` drafts plan sections, fills knowledge gaps → posts SUBMISSION per section:
|
|
314
|
+
- Implementation tasks with ordering
|
|
315
|
+
- Dependencies between tasks
|
|
316
|
+
- Risk assessment per task
|
|
317
|
+
- Acceptance criteria
|
|
318
|
+
3. `tech-lead` reviews each plan section → posts REVIEW:
|
|
319
|
+
- Are estimates realistic or optimistic?
|
|
320
|
+
- Are risks identified and mitigated?
|
|
321
|
+
- Does the technical approach fit the codebase?
|
|
322
|
+
- Are there hidden dependencies?
|
|
323
|
+
- Is rollback strategy adequate?
|
|
324
|
+
4. Debate loop if FAIL → `researcher` adjusts or defends → max 3 rounds
|
|
325
|
+
5. `planner` synthesizes all approved sections into final plan
|
|
326
|
+
|
|
327
|
+
**Deliverable**: `./reports/plans/PLAN-{feature}.md`
|
|
328
|
+
**Exit Criteria**: Plan complete, technically validated, risks mitigated, acceptance criteria defined
|
|
329
|
+
**Consensus**: ✅ CONSENSUS: planner ✓ | researcher ✓ | tech-lead ✓
|
|
330
|
+
|
|
331
|
+
---
|
|
332
|
+
|
|
333
|
+
## 🛡️ VERIFICATION CHECKPOINT
|
|
334
|
+
|
|
335
|
+
> **⛔ BLOCKING**: Load Context Gate protocol NOW before proceeding.
|
|
336
|
+
>
|
|
337
|
+
> **LOAD**: `rules/CONTEXT-GATE.md` — Execute HARD MODE protocol
|
|
338
|
+
>
|
|
339
|
+
> This is a MANDATORY checkpoint. Cannot skip or bypass.
|
|
340
|
+
|
|
341
|
+
### ⚡ EXECUTION
|
|
342
|
+
|
|
343
|
+
```yaml
|
|
344
|
+
context_gate_execution:
|
|
345
|
+
mode: "HARD (User Choice)"
|
|
346
|
+
trigger: "After Phase 5 (Planning) completes"
|
|
347
|
+
protocol: "Follow rules/CONTEXT-GATE.md § HARD MODE"
|
|
348
|
+
|
|
349
|
+
variant_adjustments:
|
|
350
|
+
plan_file: "PLAN-{feature}.md"
|
|
351
|
+
remaining_phases: "Phase 6 → 7"
|
|
352
|
+
mailbox: "MAILBOX-{date}.md contains full debate history"
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
**DO NOT proceed to Phase 6 until user selects option.**
|
|
356
|
+
|
|
357
|
+
---
|
|
358
|
+
|
|
359
|
+
## 🎭 Phase 6: IMPLEMENTATION — 🔺 GOLDEN TRIANGLE
|
|
360
|
+
|
|
361
|
+
> **THIS IS THE MOST CRITICAL PHASE.** Every step is detailed. No shortcuts.
|
|
362
|
+
|
|
363
|
+
### Team Selection
|
|
364
|
+
|
|
365
|
+
```
|
|
366
|
+
IF fullstack (frontend + backend) →
|
|
367
|
+
Tech Lead: tech-lead
|
|
368
|
+
Executor: backend-engineer (then frontend-engineer, sequential)
|
|
369
|
+
Reviewer: reviewer
|
|
370
|
+
|
|
371
|
+
IF backend-only →
|
|
372
|
+
Tech Lead: tech-lead
|
|
373
|
+
Executor: backend-engineer
|
|
374
|
+
Reviewer: reviewer
|
|
375
|
+
|
|
376
|
+
IF frontend-only →
|
|
377
|
+
Tech Lead: tech-lead
|
|
378
|
+
Executor: frontend-engineer
|
|
379
|
+
Reviewer: reviewer
|
|
380
|
+
|
|
381
|
+
IF game development →
|
|
382
|
+
Tech Lead: tech-lead
|
|
383
|
+
Executor: game-engineer
|
|
384
|
+
Reviewer: reviewer
|
|
385
|
+
|
|
386
|
+
IF mobile development →
|
|
387
|
+
Tech Lead: tech-lead
|
|
388
|
+
Executor: mobile-engineer
|
|
389
|
+
Reviewer: reviewer
|
|
390
|
+
|
|
391
|
+
IF other domain → Consult TEAMS.md roster for correct triangle
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
| Role | Agent | Mission |
|
|
395
|
+
| --------- | ------------------------------------ | ---------------------------------------------------------- |
|
|
396
|
+
| Tech Lead | `tech-lead` | Load PLAN → decompose into implementation tasks → Shared Task List → coordinate all work |
|
|
397
|
+
| Executor | `backend-engineer` / `frontend-engineer` / `game-engineer` / `mobile-engineer` | Follow plan EXACTLY → implement each task → submit via Mailbox |
|
|
398
|
+
| Reviewer | `reviewer` | Review EVERY submission → check code quality, security, performance, plan compliance |
|
|
399
|
+
|
|
400
|
+
**Prerequisite**: **READ and FOLLOW** `./reports/plans/PLAN-{feature}.md`
|
|
401
|
+
|
|
402
|
+
### GOLDEN TRIANGLE IMPLEMENTATION LOOP (CRITICAL — Step by Step)
|
|
403
|
+
|
|
404
|
+
```
|
|
405
|
+
╔══════════════════════════════════════════════════════════════════════╗
|
|
406
|
+
║ PHASE 6: IMPLEMENTATION LOOP — FOLLOW EXACTLY ║
|
|
407
|
+
╠══════════════════════════════════════════════════════════════════════╣
|
|
408
|
+
║ ║
|
|
409
|
+
║ STEP 1: Tech Lead reads PLAN-{feature}.md ║
|
|
410
|
+
║ ───────────────────────────────────────── ║
|
|
411
|
+
║ - Load full plan into working context ║
|
|
412
|
+
║ - Identify all implementation tasks ║
|
|
413
|
+
║ - Determine task ordering and dependencies ║
|
|
414
|
+
║ ║
|
|
415
|
+
║ STEP 2: Tech Lead creates Shared Task List ║
|
|
416
|
+
║ ───────────────────────────────────────── ║
|
|
417
|
+
║ - Break plan into atomic implementation tasks ║
|
|
418
|
+
║ - Order by priority and dependency ║
|
|
419
|
+
║ - Format: [ID] [Status] [Description] [Files] [Acceptance] ║
|
|
420
|
+
║ - Post Shared Task List in Mailbox as TASK_ASSIGNMENT ║
|
|
421
|
+
║ ║
|
|
422
|
+
║ STEP 3: Tech Lead dispatches ALL tasks to Executor ║
|
|
423
|
+
║ ───────────────────────────────────────── ║
|
|
424
|
+
║ - Posts TASK_ASSIGNMENT to Mailbox for each task ║
|
|
425
|
+
║ - Each assignment includes: ║
|
|
426
|
+
║ • Task ID and description ║
|
|
427
|
+
║ • Exact files to create/modify ║
|
|
428
|
+
║ • Acceptance criteria from plan ║
|
|
429
|
+
║ • Dependencies on other tasks ║
|
|
430
|
+
║ ║
|
|
431
|
+
║ STEP 4: FOR EACH TASK — Executor implements ║
|
|
432
|
+
║ ───────────────────────────────────────── ║
|
|
433
|
+
║ a. Executor reads TASK_ASSIGNMENT from Mailbox ║
|
|
434
|
+
║ b. Executor implements task EXACTLY as plan specifies ║
|
|
435
|
+
║ c. Executor posts SUBMISSION to Mailbox: ║
|
|
436
|
+
║ ┌──────────────────────────────────────┐ ║
|
|
437
|
+
║ │ SUBMISSION │ ║
|
|
438
|
+
║ │ Task: {task ID} │ ║
|
|
439
|
+
║ │ What was implemented: {description} │ ║
|
|
440
|
+
║ │ Files changed: {list of files} │ ║
|
|
441
|
+
║ │ Approach taken: {rationale} │ ║
|
|
442
|
+
║ │ Self-review notes: {any concerns} │ ║
|
|
443
|
+
║ │ Plan step reference: {which plan step}│ ║
|
|
444
|
+
║ └──────────────────────────────────────┘ ║
|
|
445
|
+
║ ║
|
|
446
|
+
║ STEP 5: Reviewer reviews each SUBMISSION ║
|
|
447
|
+
║ ───────────────────────────────────────── ║
|
|
448
|
+
║ d. Reviewer reads SUBMISSION from Mailbox ║
|
|
449
|
+
║ e. Reviewer checks against ALL 5 dimensions: ║
|
|
450
|
+
║ ┌──────────────────────────────────────────────────────┐ ║
|
|
451
|
+
║ │ 1. CORRECTNESS — Does it work? Edge cases handled? │ ║
|
|
452
|
+
║ │ 2. SECURITY — Injection, auth, input validation? │ ║
|
|
453
|
+
║ │ 3. PERFORMANCE — N+1 queries, unnecessary loops? │ ║
|
|
454
|
+
║ │ 4. PLAN COMPLIANCE — Matches plan spec exactly? │ ║
|
|
455
|
+
║ │ 5. CODE QUALITY — Naming, structure, DRY, SOLID? │ ║
|
|
456
|
+
║ └──────────────────────────────────────────────────────┘ ║
|
|
457
|
+
║ f. Reviewer posts REVIEW to Mailbox: ║
|
|
458
|
+
║ ┌──────────────────────────────────────┐ ║
|
|
459
|
+
║ │ REVIEW │ ║
|
|
460
|
+
║ │ Task: {task ID} │ ║
|
|
461
|
+
║ │ Status: PASS or FAIL │ ║
|
|
462
|
+
║ │ Findings: │ ║
|
|
463
|
+
║ │ | # | Finding | Severity | Action | │ ║
|
|
464
|
+
║ │ |---|---------|----------|--------| │ ║
|
|
465
|
+
║ │ | 1 | ... | CRITICAL | Fix | │ ║
|
|
466
|
+
║ │ | 2 | ... | MINOR | Suggest| │ ║
|
|
467
|
+
║ │ Required actions: {list} │ ║
|
|
468
|
+
║ └──────────────────────────────────────┘ ║
|
|
469
|
+
║ ║
|
|
470
|
+
║ STEP 6: IF FAIL — Debate Loop (max 3 rounds) ║
|
|
471
|
+
║ ───────────────────────────────────────── ║
|
|
472
|
+
║ g. Executor reads REVIEW findings from Mailbox ║
|
|
473
|
+
║ h. For EACH finding: ║
|
|
474
|
+
║ - If VALID → Fix the code → Note what was fixed ║
|
|
475
|
+
║ - If DISPUTED → Write DEFENSE with evidence: ║
|
|
476
|
+
║ "Finding #2 is invalid because [evidence/reasoning]" ║
|
|
477
|
+
║ i. Executor posts RESUBMISSION or DEFENSE to Mailbox: ║
|
|
478
|
+
║ ┌──────────────────────────────────────┐ ║
|
|
479
|
+
║ │ RESUBMISSION / DEFENSE │ ║
|
|
480
|
+
║ │ Task: {task ID} │ ║
|
|
481
|
+
║ │ Round: {1/2/3} │ ║
|
|
482
|
+
║ │ Fixes applied: {list} │ ║
|
|
483
|
+
║ │ Defended findings: {list + evidence} │ ║
|
|
484
|
+
║ └──────────────────────────────────────┘ ║
|
|
485
|
+
║ j. Reviewer re-reviews → posts new REVIEW → back to step (e) ║
|
|
486
|
+
║ k. After round 3 without resolution: ║
|
|
487
|
+
║ → Reviewer posts ESCALATION to Mailbox ║
|
|
488
|
+
║ → Tech Lead reads all debate history ║
|
|
489
|
+
║ → Tech Lead posts ARBITRATION with binding resolution ║
|
|
490
|
+
║ ║
|
|
491
|
+
║ STEP 7: IF PASS ║
|
|
492
|
+
║ ───────────────── ║
|
|
493
|
+
║ l. Reviewer posts APPROVAL to Mailbox ║
|
|
494
|
+
║ m. Tech Lead marks task ✅ in Shared Task List ║
|
|
495
|
+
║ n. Move to next task → back to step (a) ║
|
|
496
|
+
║ ║
|
|
497
|
+
║ STEP 8: After ALL tasks complete ║
|
|
498
|
+
║ ───────────────────────────── ║
|
|
499
|
+
║ o. Tech Lead verifies full integration: ║
|
|
500
|
+
║ - All tasks ✅ in Shared Task List ║
|
|
501
|
+
║ - No cross-task conflicts ║
|
|
502
|
+
║ - API contracts match between backend and frontend ║
|
|
503
|
+
║ p. Tech Lead posts DECISION to Mailbox: ║
|
|
504
|
+
║ ┌──────────────────────────────────────┐ ║
|
|
505
|
+
║ │ DECISION │ ║
|
|
506
|
+
║ │ Phase: 6 — Implementation │ ║
|
|
507
|
+
║ │ Status: COMPLETE │ ║
|
|
508
|
+
║ │ Tasks completed: {count}/{total} │ ║
|
|
509
|
+
║ │ Disputes resolved: {count} │ ║
|
|
510
|
+
║ │ Arbitrations needed: {count} │ ║
|
|
511
|
+
║ │ ✅ CONSENSUS: tech-lead ✓ | │ ║
|
|
512
|
+
║ │ {executor} ✓ | reviewer ✓ │ ║
|
|
513
|
+
║ └──────────────────────────────────────┘ ║
|
|
514
|
+
║ q. Phase output released ║
|
|
515
|
+
╚══════════════════════════════════════════════════════════════════════╝
|
|
516
|
+
```
|
|
517
|
+
|
|
518
|
+
### STRICT PLAN ADHERENCE (ENFORCED BY REVIEWER)
|
|
519
|
+
|
|
520
|
+
```
|
|
521
|
+
1. READ PLAN FIRST — every task MUST trace to a plan step
|
|
522
|
+
2. IF step seems wrong → STOP → Executor posts ESCALATION to Mailbox
|
|
523
|
+
→ Tech Lead evaluates → Request Re-Planning or Override
|
|
524
|
+
3. NO unauthorized deviations — Reviewer explicitly checks for this:
|
|
525
|
+
"Does this SUBMISSION match the plan step? Any additions not in plan?"
|
|
526
|
+
4. Deviations found by Reviewer → automatic FAIL with:
|
|
527
|
+
Severity: CRITICAL | Action: "Remove unauthorized code or get plan amended"
|
|
528
|
+
```
|
|
529
|
+
|
|
530
|
+
**Exit Criteria**: All plan tasks implemented, all reviews passed, no unauthorized deviations, integration verified
|
|
531
|
+
**Consensus**: ✅ CONSENSUS: tech-lead ✓ | {executor} ✓ | reviewer ✓
|
|
532
|
+
|
|
533
|
+
---
|
|
534
|
+
|
|
535
|
+
## 🎭 Phase 7: TESTING & REVIEW — 🔺 GOLDEN TRIANGLE
|
|
536
|
+
|
|
537
|
+
| Role | Agent | Mission |
|
|
538
|
+
| --------- | ----------------------------------------------- | ---------------------------------------------------------- |
|
|
539
|
+
| Tech Lead | `tester` | Decompose: test strategy, coverage targets, acceptance verification plan |
|
|
540
|
+
| Executor | `tester` (self-implements tests) | Execute: write tests, run tests, generate coverage report |
|
|
541
|
+
| Reviewer | `reviewer` + security/performance combined lens | Challenge: test gaps, missing security tests, perf benchmarks not met |
|
|
542
|
+
|
|
543
|
+
**Triangle Loop**:
|
|
544
|
+
1. `tester` (as Tech Lead) reads PLAN + implementation → decomposes into test strategy:
|
|
545
|
+
- Unit tests per module
|
|
546
|
+
- Integration tests per API endpoint
|
|
547
|
+
- E2E tests per user flow
|
|
548
|
+
- Security test cases (injection, auth bypass, IDOR)
|
|
549
|
+
- Performance baseline assertions
|
|
550
|
+
2. `tester` (as Tech Lead) posts TASK_ASSIGNMENT to Mailbox with test plan
|
|
551
|
+
3. `tester` (as Executor) writes and runs tests → posts SUBMISSION per test category:
|
|
552
|
+
- Tests written (file list)
|
|
553
|
+
- Tests passed / failed
|
|
554
|
+
- Coverage percentage
|
|
555
|
+
- Plan checkpoint verification results
|
|
556
|
+
4. `reviewer` reviews test submissions with combined security + performance lens → posts REVIEW:
|
|
557
|
+
- Coverage sufficient? Any untested critical paths?
|
|
558
|
+
- Security test cases: SQL injection, XSS, CSRF, auth bypass covered?
|
|
559
|
+
- Performance assertions: response time, memory, query count baselines?
|
|
560
|
+
- Plan acceptance criteria: every criterion has a corresponding test?
|
|
561
|
+
5. Debate loop if FAIL → fix gaps or defend → max 3 rounds
|
|
562
|
+
6. `tester` (as Tech Lead) synthesizes final QA report
|
|
563
|
+
|
|
564
|
+
**PLAN CHECKPOINT VERIFICATION** (MANDATORY):
|
|
565
|
+
```
|
|
566
|
+
FOR EACH acceptance criterion in PLAN-{feature}.md:
|
|
567
|
+
→ tester: Write test that specifically verifies this criterion
|
|
568
|
+
→ reviewer: Confirm test actually validates the criterion (not a trivial pass)
|
|
569
|
+
→ Document: "AC-{id} → Test: {test name} → Verified: {pass/fail}"
|
|
570
|
+
```
|
|
571
|
+
|
|
572
|
+
**Deliverable**: Test results + coverage report + QA summary
|
|
573
|
+
**Exit Criteria**: All tests pass, coverage meets threshold, security validated, performance acceptable, all plan acceptance criteria verified
|
|
574
|
+
**Consensus**: ✅ CONSENSUS: tester ✓ | tester(exec) ✓ | reviewer ✓
|
|
575
|
+
|
|
576
|
+
---
|
|
577
|
+
|
|
578
|
+
## ✅ COMPLETION
|
|
579
|
+
|
|
580
|
+
Present final feature report with consensus stamps from ALL phases:
|
|
581
|
+
|
|
582
|
+
```markdown
|
|
583
|
+
# 🔺 Golden Triangle Feature Report: {feature}
|
|
584
|
+
|
|
585
|
+
## Phase Results
|
|
586
|
+
| Phase | Triangle | Consensus | Rounds |
|
|
587
|
+
|-------|----------|-----------|--------|
|
|
588
|
+
| P1: Requirements | researcher / scouter / brainstormer | ✅ | {n} |
|
|
589
|
+
| P2: Research | researcher / researcher / tech-lead | ✅ | {n} |
|
|
590
|
+
| P3: Database | tech-lead / database-architect / reviewer | ✅ or SKIPPED | {n} |
|
|
591
|
+
| P4: Design | designer / frontend-engineer / reviewer | ✅ or SKIPPED | {n} |
|
|
592
|
+
| P5: Planning | planner / researcher / tech-lead | ✅ | {n} |
|
|
593
|
+
| P6: Implementation | tech-lead / {executor} / reviewer | ✅ | {n} |
|
|
594
|
+
| P7: Testing | tester / tester / reviewer | ✅ | {n} |
|
|
595
|
+
|
|
596
|
+
## Debate Summary
|
|
597
|
+
- Total submissions: {count}
|
|
598
|
+
- First-pass approvals: {count}
|
|
599
|
+
- Debates triggered: {count}
|
|
600
|
+
- Arbitrations needed: {count}
|
|
601
|
+
|
|
602
|
+
## Mailbox Reference
|
|
603
|
+
Full debate history: `./reports/MAILBOX-{date}.md`
|
|
604
|
+
|
|
605
|
+
## Next Actions
|
|
606
|
+
1. ✅ **Done** — Feature complete (triangle-validated across all phases)
|
|
607
|
+
2. 🚀 **Deploy** → `/deploy:preview`
|
|
608
|
+
3. 📝 **Docs** → `/docs:core`
|
|
609
|
+
```
|
package/commands/cook.md
CHANGED
|
@@ -37,6 +37,9 @@ IF feature is complex (multi-component, research needed):
|
|
|
37
37
|
IF feature is complex AND context optimization is critical:
|
|
38
38
|
→ Route to /cook:focus
|
|
39
39
|
|
|
40
|
+
IF feature is complex AND maximum quality with team collaboration needed:
|
|
41
|
+
→ Route to /cook:team
|
|
42
|
+
|
|
40
43
|
IF unsure:
|
|
41
44
|
→ Default to /cook:fast
|
|
42
45
|
```
|
|
@@ -50,6 +53,7 @@ IF unsure:
|
|
|
50
53
|
| `/cook:fast` | Quick features, clear specifications |
|
|
51
54
|
| `/cook:hard` | Complex features, full workflow |
|
|
52
55
|
| `/cook:focus` | Complex features with **enforced context optimization** |
|
|
56
|
+
| `/cook:team` | Maximum quality with parallel agent team collaboration |
|
|
53
57
|
|
|
54
58
|
---
|
|
55
59
|
|
|
@@ -65,6 +69,7 @@ IF unsure:
|
|
|
65
69
|
1. ⚡ **Fast** → `/cook:fast` — Quick implementation
|
|
66
70
|
2. ⚡⚡⚡ **Hard** → `/cook:hard` — Full feature development
|
|
67
71
|
3. 🎯 **Focus** → `/cook:focus` — Full development with **automatic context clearing** (prevents hallucination)
|
|
72
|
+
4. 👥 **Team** → `/cook:team` — Full team collaboration (parallel agents, maximum quality)
|
|
68
73
|
|
|
69
74
|
⏳ Awaiting selection...
|
|
70
75
|
```
|