@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.
Files changed (239) hide show
  1. package/CHANGELOG.md +51 -1
  2. package/README.md +6 -1
  3. package/agents/teams/backend-team/executor.md +188 -0
  4. package/agents/teams/backend-team/reviewer.md +328 -0
  5. package/agents/teams/backend-team/techlead.md +166 -0
  6. package/agents/teams/database-team/executor.md +189 -0
  7. package/agents/teams/database-team/reviewer.md +333 -0
  8. package/agents/teams/database-team/techlead.md +168 -0
  9. package/agents/teams/debug-team/executor.md +195 -0
  10. package/agents/teams/debug-team/reviewer.md +324 -0
  11. package/agents/teams/debug-team/techlead.md +173 -0
  12. package/agents/teams/design-team/executor.md +196 -0
  13. package/agents/teams/design-team/reviewer.md +405 -0
  14. package/agents/teams/design-team/techlead.md +170 -0
  15. package/agents/teams/devops-team/executor.md +199 -0
  16. package/agents/teams/devops-team/reviewer.md +332 -0
  17. package/agents/teams/devops-team/techlead.md +168 -0
  18. package/agents/teams/docs-team/executor.md +196 -0
  19. package/agents/teams/docs-team/reviewer.md +331 -0
  20. package/agents/teams/docs-team/techlead.md +168 -0
  21. package/agents/teams/frontend-team/executor.md +190 -0
  22. package/agents/teams/frontend-team/reviewer.md +333 -0
  23. package/agents/teams/frontend-team/techlead.md +169 -0
  24. package/agents/teams/fullstack-team/executor.md +290 -0
  25. package/agents/teams/fullstack-team/reviewer.md +365 -0
  26. package/agents/teams/fullstack-team/techlead.md +254 -0
  27. package/agents/teams/game-team/executor.md +193 -0
  28. package/agents/teams/game-team/reviewer.md +331 -0
  29. package/agents/teams/game-team/techlead.md +167 -0
  30. package/agents/teams/mobile-team/executor.md +192 -0
  31. package/agents/teams/mobile-team/reviewer.md +328 -0
  32. package/agents/teams/mobile-team/techlead.md +168 -0
  33. package/agents/teams/performance-team/executor.md +192 -0
  34. package/agents/teams/performance-team/reviewer.md +322 -0
  35. package/agents/teams/performance-team/techlead.md +175 -0
  36. package/agents/teams/planning-team/executor.md +197 -0
  37. package/agents/teams/planning-team/reviewer.md +279 -0
  38. package/agents/teams/planning-team/techlead.md +169 -0
  39. package/agents/teams/project-team/executor.md +190 -0
  40. package/agents/teams/project-team/reviewer.md +328 -0
  41. package/agents/teams/project-team/techlead.md +168 -0
  42. package/agents/teams/qa-team/executor.md +198 -0
  43. package/agents/teams/qa-team/reviewer.md +271 -0
  44. package/agents/teams/qa-team/techlead.md +175 -0
  45. package/agents/teams/report-team/executor.md +195 -0
  46. package/agents/teams/report-team/reviewer.md +328 -0
  47. package/agents/teams/report-team/techlead.md +168 -0
  48. package/agents/teams/research-team/executor.md +200 -0
  49. package/agents/teams/research-team/reviewer.md +272 -0
  50. package/agents/teams/research-team/techlead.md +168 -0
  51. package/agents/teams/security-team/executor.md +193 -0
  52. package/agents/teams/security-team/reviewer.md +338 -0
  53. package/agents/teams/security-team/techlead.md +178 -0
  54. package/cli/README.md +19 -2
  55. package/cli/install.js +300 -9
  56. package/cli/install.test.js.example +1 -1
  57. package/code-assistants/antigravity-assistant/AntigravityGlobal.agent.md +86 -39
  58. package/code-assistants/antigravity-assistant/GEMINI.md +105 -30
  59. package/code-assistants/claude-assistant/CLAUDE.md +4 -4
  60. package/code-assistants/codex-assistant/CODEX.md +235 -0
  61. package/code-assistants/codex-assistant/agents/backend-engineer.toml +26 -0
  62. package/code-assistants/codex-assistant/agents/brainstormer.toml +26 -0
  63. package/code-assistants/codex-assistant/agents/business-analyst.toml +26 -0
  64. package/code-assistants/codex-assistant/agents/database-architect.toml +26 -0
  65. package/code-assistants/codex-assistant/agents/debugger.toml +26 -0
  66. package/code-assistants/codex-assistant/agents/designer.toml +26 -0
  67. package/code-assistants/codex-assistant/agents/devops-engineer.toml +26 -0
  68. package/code-assistants/codex-assistant/agents/docs-manager.toml +26 -0
  69. package/code-assistants/codex-assistant/agents/frontend-engineer.toml +26 -0
  70. package/code-assistants/codex-assistant/agents/game-engineer.toml +26 -0
  71. package/code-assistants/codex-assistant/agents/mobile-engineer.toml +26 -0
  72. package/code-assistants/codex-assistant/agents/performance-engineer.toml +26 -0
  73. package/code-assistants/codex-assistant/agents/planner.toml +26 -0
  74. package/code-assistants/codex-assistant/agents/project-manager.toml +26 -0
  75. package/code-assistants/codex-assistant/agents/reporter.toml +26 -0
  76. package/code-assistants/codex-assistant/agents/researcher.toml +26 -0
  77. package/code-assistants/codex-assistant/agents/reviewer.toml +26 -0
  78. package/code-assistants/codex-assistant/agents/scouter.toml +26 -0
  79. package/code-assistants/codex-assistant/agents/security-engineer.toml +26 -0
  80. package/code-assistants/codex-assistant/agents/tech-lead.toml +26 -0
  81. package/code-assistants/codex-assistant/agents/tester.toml +26 -0
  82. package/code-assistants/codex-assistant/config.toml +109 -0
  83. package/code-assistants/codex-assistant/skills/agent-assistant-ask/SKILL.md +18 -0
  84. package/code-assistants/codex-assistant/skills/agent-assistant-ask/agents/openai.yaml +4 -0
  85. package/code-assistants/codex-assistant/skills/agent-assistant-ask-fast/SKILL.md +18 -0
  86. package/code-assistants/codex-assistant/skills/agent-assistant-ask-fast/agents/openai.yaml +4 -0
  87. package/code-assistants/codex-assistant/skills/agent-assistant-ask-hard/SKILL.md +18 -0
  88. package/code-assistants/codex-assistant/skills/agent-assistant-ask-hard/agents/openai.yaml +4 -0
  89. package/code-assistants/codex-assistant/skills/agent-assistant-auto/SKILL.md +18 -0
  90. package/code-assistants/codex-assistant/skills/agent-assistant-auto/agents/openai.yaml +4 -0
  91. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm/SKILL.md +18 -0
  92. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm/agents/openai.yaml +4 -0
  93. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-fast/SKILL.md +18 -0
  94. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-fast/agents/openai.yaml +4 -0
  95. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-hard/SKILL.md +18 -0
  96. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-hard/agents/openai.yaml +4 -0
  97. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-team/SKILL.md +18 -0
  98. package/code-assistants/codex-assistant/skills/agent-assistant-brainstorm-team/agents/openai.yaml +4 -0
  99. package/code-assistants/codex-assistant/skills/agent-assistant-code/SKILL.md +18 -0
  100. package/code-assistants/codex-assistant/skills/agent-assistant-code/agents/openai.yaml +4 -0
  101. package/code-assistants/codex-assistant/skills/agent-assistant-code-fast/SKILL.md +18 -0
  102. package/code-assistants/codex-assistant/skills/agent-assistant-code-fast/agents/openai.yaml +4 -0
  103. package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/SKILL.md +18 -0
  104. package/code-assistants/codex-assistant/skills/agent-assistant-code-focus/agents/openai.yaml +4 -0
  105. package/code-assistants/codex-assistant/skills/agent-assistant-code-hard/SKILL.md +18 -0
  106. package/code-assistants/codex-assistant/skills/agent-assistant-code-hard/agents/openai.yaml +4 -0
  107. package/code-assistants/codex-assistant/skills/agent-assistant-code-team/SKILL.md +18 -0
  108. package/code-assistants/codex-assistant/skills/agent-assistant-code-team/agents/openai.yaml +4 -0
  109. package/code-assistants/codex-assistant/skills/agent-assistant-cook/SKILL.md +18 -0
  110. package/code-assistants/codex-assistant/skills/agent-assistant-cook/agents/openai.yaml +4 -0
  111. package/code-assistants/codex-assistant/skills/agent-assistant-cook-fast/SKILL.md +18 -0
  112. package/code-assistants/codex-assistant/skills/agent-assistant-cook-fast/agents/openai.yaml +4 -0
  113. package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/SKILL.md +18 -0
  114. package/code-assistants/codex-assistant/skills/agent-assistant-cook-focus/agents/openai.yaml +4 -0
  115. package/code-assistants/codex-assistant/skills/agent-assistant-cook-hard/SKILL.md +18 -0
  116. package/code-assistants/codex-assistant/skills/agent-assistant-cook-hard/agents/openai.yaml +4 -0
  117. package/code-assistants/codex-assistant/skills/agent-assistant-cook-team/SKILL.md +18 -0
  118. package/code-assistants/codex-assistant/skills/agent-assistant-cook-team/agents/openai.yaml +4 -0
  119. package/code-assistants/codex-assistant/skills/agent-assistant-debug/SKILL.md +18 -0
  120. package/code-assistants/codex-assistant/skills/agent-assistant-debug/agents/openai.yaml +4 -0
  121. package/code-assistants/codex-assistant/skills/agent-assistant-debug-fast/SKILL.md +18 -0
  122. package/code-assistants/codex-assistant/skills/agent-assistant-debug-fast/agents/openai.yaml +4 -0
  123. package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/SKILL.md +18 -0
  124. package/code-assistants/codex-assistant/skills/agent-assistant-debug-focus/agents/openai.yaml +4 -0
  125. package/code-assistants/codex-assistant/skills/agent-assistant-debug-hard/SKILL.md +18 -0
  126. package/code-assistants/codex-assistant/skills/agent-assistant-debug-hard/agents/openai.yaml +4 -0
  127. package/code-assistants/codex-assistant/skills/agent-assistant-debug-team/SKILL.md +18 -0
  128. package/code-assistants/codex-assistant/skills/agent-assistant-debug-team/agents/openai.yaml +4 -0
  129. package/code-assistants/codex-assistant/skills/agent-assistant-deploy/SKILL.md +18 -0
  130. package/code-assistants/codex-assistant/skills/agent-assistant-deploy/agents/openai.yaml +4 -0
  131. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-check/SKILL.md +18 -0
  132. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-check/agents/openai.yaml +4 -0
  133. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-preview/SKILL.md +18 -0
  134. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-preview/agents/openai.yaml +4 -0
  135. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-production/SKILL.md +18 -0
  136. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-production/agents/openai.yaml +4 -0
  137. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-rollback/SKILL.md +18 -0
  138. package/code-assistants/codex-assistant/skills/agent-assistant-deploy-rollback/agents/openai.yaml +4 -0
  139. package/code-assistants/codex-assistant/skills/agent-assistant-design/SKILL.md +18 -0
  140. package/code-assistants/codex-assistant/skills/agent-assistant-design/agents/openai.yaml +4 -0
  141. package/code-assistants/codex-assistant/skills/agent-assistant-design-fast/SKILL.md +18 -0
  142. package/code-assistants/codex-assistant/skills/agent-assistant-design-fast/agents/openai.yaml +4 -0
  143. package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/SKILL.md +18 -0
  144. package/code-assistants/codex-assistant/skills/agent-assistant-design-focus/agents/openai.yaml +4 -0
  145. package/code-assistants/codex-assistant/skills/agent-assistant-design-hard/SKILL.md +18 -0
  146. package/code-assistants/codex-assistant/skills/agent-assistant-design-hard/agents/openai.yaml +4 -0
  147. package/code-assistants/codex-assistant/skills/agent-assistant-design-team/SKILL.md +18 -0
  148. package/code-assistants/codex-assistant/skills/agent-assistant-design-team/agents/openai.yaml +4 -0
  149. package/code-assistants/codex-assistant/skills/agent-assistant-docs/SKILL.md +18 -0
  150. package/code-assistants/codex-assistant/skills/agent-assistant-docs/agents/openai.yaml +4 -0
  151. package/code-assistants/codex-assistant/skills/agent-assistant-docs-audit/SKILL.md +18 -0
  152. package/code-assistants/codex-assistant/skills/agent-assistant-docs-audit/agents/openai.yaml +4 -0
  153. package/code-assistants/codex-assistant/skills/agent-assistant-docs-business/SKILL.md +18 -0
  154. package/code-assistants/codex-assistant/skills/agent-assistant-docs-business/agents/openai.yaml +4 -0
  155. package/code-assistants/codex-assistant/skills/agent-assistant-docs-core/SKILL.md +18 -0
  156. package/code-assistants/codex-assistant/skills/agent-assistant-docs-core/agents/openai.yaml +4 -0
  157. package/code-assistants/codex-assistant/skills/agent-assistant-fix/SKILL.md +18 -0
  158. package/code-assistants/codex-assistant/skills/agent-assistant-fix/agents/openai.yaml +4 -0
  159. package/code-assistants/codex-assistant/skills/agent-assistant-fix-fast/SKILL.md +18 -0
  160. package/code-assistants/codex-assistant/skills/agent-assistant-fix-fast/agents/openai.yaml +4 -0
  161. package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/SKILL.md +18 -0
  162. package/code-assistants/codex-assistant/skills/agent-assistant-fix-focus/agents/openai.yaml +4 -0
  163. package/code-assistants/codex-assistant/skills/agent-assistant-fix-hard/SKILL.md +18 -0
  164. package/code-assistants/codex-assistant/skills/agent-assistant-fix-hard/agents/openai.yaml +4 -0
  165. package/code-assistants/codex-assistant/skills/agent-assistant-fix-team/SKILL.md +18 -0
  166. package/code-assistants/codex-assistant/skills/agent-assistant-fix-team/agents/openai.yaml +4 -0
  167. package/code-assistants/codex-assistant/skills/agent-assistant-plan/SKILL.md +18 -0
  168. package/code-assistants/codex-assistant/skills/agent-assistant-plan/agents/openai.yaml +4 -0
  169. package/code-assistants/codex-assistant/skills/agent-assistant-plan-fast/SKILL.md +18 -0
  170. package/code-assistants/codex-assistant/skills/agent-assistant-plan-fast/agents/openai.yaml +4 -0
  171. package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/SKILL.md +18 -0
  172. package/code-assistants/codex-assistant/skills/agent-assistant-plan-focus/agents/openai.yaml +4 -0
  173. package/code-assistants/codex-assistant/skills/agent-assistant-plan-hard/SKILL.md +18 -0
  174. package/code-assistants/codex-assistant/skills/agent-assistant-plan-hard/agents/openai.yaml +4 -0
  175. package/code-assistants/codex-assistant/skills/agent-assistant-plan-team/SKILL.md +18 -0
  176. package/code-assistants/codex-assistant/skills/agent-assistant-plan-team/agents/openai.yaml +4 -0
  177. package/code-assistants/codex-assistant/skills/agent-assistant-report/SKILL.md +18 -0
  178. package/code-assistants/codex-assistant/skills/agent-assistant-report/agents/openai.yaml +4 -0
  179. package/code-assistants/codex-assistant/skills/agent-assistant-report-fast/SKILL.md +18 -0
  180. package/code-assistants/codex-assistant/skills/agent-assistant-report-fast/agents/openai.yaml +4 -0
  181. package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/SKILL.md +18 -0
  182. package/code-assistants/codex-assistant/skills/agent-assistant-report-focus/agents/openai.yaml +4 -0
  183. package/code-assistants/codex-assistant/skills/agent-assistant-report-hard/SKILL.md +18 -0
  184. package/code-assistants/codex-assistant/skills/agent-assistant-report-hard/agents/openai.yaml +4 -0
  185. package/code-assistants/codex-assistant/skills/agent-assistant-report-team/SKILL.md +18 -0
  186. package/code-assistants/codex-assistant/skills/agent-assistant-report-team/agents/openai.yaml +4 -0
  187. package/code-assistants/codex-assistant/skills/agent-assistant-review/SKILL.md +18 -0
  188. package/code-assistants/codex-assistant/skills/agent-assistant-review/agents/openai.yaml +4 -0
  189. package/code-assistants/codex-assistant/skills/agent-assistant-review-fast/SKILL.md +18 -0
  190. package/code-assistants/codex-assistant/skills/agent-assistant-review-fast/agents/openai.yaml +4 -0
  191. package/code-assistants/codex-assistant/skills/agent-assistant-review-hard/SKILL.md +18 -0
  192. package/code-assistants/codex-assistant/skills/agent-assistant-review-hard/agents/openai.yaml +4 -0
  193. package/code-assistants/codex-assistant/skills/agent-assistant-review-team/SKILL.md +18 -0
  194. package/code-assistants/codex-assistant/skills/agent-assistant-review-team/agents/openai.yaml +4 -0
  195. package/code-assistants/codex-assistant/skills/agent-assistant-test/SKILL.md +18 -0
  196. package/code-assistants/codex-assistant/skills/agent-assistant-test/agents/openai.yaml +4 -0
  197. package/code-assistants/codex-assistant/skills/agent-assistant-test-fast/SKILL.md +18 -0
  198. package/code-assistants/codex-assistant/skills/agent-assistant-test-fast/agents/openai.yaml +4 -0
  199. package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/SKILL.md +18 -0
  200. package/code-assistants/codex-assistant/skills/agent-assistant-test-focus/agents/openai.yaml +4 -0
  201. package/code-assistants/codex-assistant/skills/agent-assistant-test-hard/SKILL.md +18 -0
  202. package/code-assistants/codex-assistant/skills/agent-assistant-test-hard/agents/openai.yaml +4 -0
  203. package/code-assistants/codex-assistant/skills/agent-assistant-test-team/SKILL.md +18 -0
  204. package/code-assistants/codex-assistant/skills/agent-assistant-test-team/agents/openai.yaml +4 -0
  205. package/code-assistants/copilot-assistant/agent-assistant.agent.md +149 -51
  206. package/code-assistants/cursor-assistant/.cursorrules +5 -5
  207. package/code-assistants/cursor-assistant/rules/agent-assistant.mdc +5 -5
  208. package/commands/brainstorm/team.md +295 -0
  209. package/commands/brainstorm.md +5 -0
  210. package/commands/code/team.md +456 -0
  211. package/commands/code.md +5 -0
  212. package/commands/cook/team.md +609 -0
  213. package/commands/cook.md +5 -0
  214. package/commands/debug/team.md +396 -0
  215. package/commands/debug.md +5 -0
  216. package/commands/design/team.md +567 -0
  217. package/commands/design.md +5 -0
  218. package/commands/fix/team.md +596 -0
  219. package/commands/fix.md +5 -0
  220. package/commands/plan/team.md +358 -0
  221. package/commands/plan.md +5 -0
  222. package/commands/report/team.md +502 -0
  223. package/commands/report.md +5 -0
  224. package/commands/review/team.md +353 -0
  225. package/commands/review.md +5 -0
  226. package/commands/test/team.md +303 -0
  227. package/commands/test.md +5 -0
  228. package/documents/SMART-SKILL-ORCHESTRATION-BLUEPRINT.md +4 -2
  229. package/documents/business/business-prd.md +2 -1
  230. package/documents/business/business-workflows.md +2 -2
  231. package/documents/knowledge-architecture.md +13 -12
  232. package/documents/knowledge-domain.md +2 -2
  233. package/documents/knowledge-overview.md +2 -2
  234. package/documents/knowledge-source-base.md +11 -7
  235. package/package.json +5 -2
  236. package/rules/AGENTS.md +55 -0
  237. package/rules/CORE.md +27 -13
  238. package/rules/PHASES.md +58 -0
  239. 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
  ```