@chankov/agent-fleet 0.0.1

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 (419) hide show
  1. package/.claude/commands/build.md +44 -0
  2. package/.claude/commands/code-simplify.md +22 -0
  3. package/.claude/commands/design-agent.md +14 -0
  4. package/.claude/commands/doctor-agent-fleet.md +17 -0
  5. package/.claude/commands/orchestrate.md +112 -0
  6. package/.claude/commands/plan.md +16 -0
  7. package/.claude/commands/prime.md +22 -0
  8. package/.claude/commands/review.md +16 -0
  9. package/.claude/commands/setup-agent-fleet.md +25 -0
  10. package/.claude/commands/ship.md +72 -0
  11. package/.claude/commands/spec.md +15 -0
  12. package/.claude/commands/test.md +19 -0
  13. package/.claude/commands/webperf.md +32 -0
  14. package/.claude/orchestrate-teams.yaml +24 -0
  15. package/.opencode/commands/af-build.md +17 -0
  16. package/.opencode/commands/af-code-simplify.md +16 -0
  17. package/.opencode/commands/af-compound.md +16 -0
  18. package/.opencode/commands/af-design-agent.md +15 -0
  19. package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  20. package/.opencode/commands/af-orchestrate.md +112 -0
  21. package/.opencode/commands/af-plan.md +16 -0
  22. package/.opencode/commands/af-prime.md +22 -0
  23. package/.opencode/commands/af-review.md +15 -0
  24. package/.opencode/commands/af-setup-agent-fleet.md +15 -0
  25. package/.opencode/commands/af-ship.md +16 -0
  26. package/.opencode/commands/af-spec.md +16 -0
  27. package/.opencode/commands/af-test.md +21 -0
  28. package/.opencode/commands/af-webperf.md +32 -0
  29. package/.opencode/orchestrate-teams.yaml +24 -0
  30. package/.pi/agents/dispatch-policy.yaml +32 -0
  31. package/.pi/agents/model-profiles.yaml +20 -0
  32. package/.pi/agents/peers.yaml +142 -0
  33. package/.pi/agents/teams.yaml +39 -0
  34. package/.pi/damage-control-rules.yaml +297 -0
  35. package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  36. package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  37. package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  38. package/.pi/extensions/btw/README.md +118 -0
  39. package/.pi/extensions/btw/index.ts +917 -0
  40. package/.pi/extensions/btw/package.json +6 -0
  41. package/.pi/extensions/btw/state.js +179 -0
  42. package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  43. package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  44. package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  45. package/.pi/extensions/compact-and-continue/README.md +42 -0
  46. package/.pi/extensions/compact-and-continue/index.ts +120 -0
  47. package/.pi/extensions/compact-and-continue/package.json +6 -0
  48. package/.pi/extensions/mcp-bridge/README.md +46 -0
  49. package/.pi/extensions/mcp-bridge/index.ts +206 -0
  50. package/.pi/extensions/mcp-bridge/package.json +6 -0
  51. package/.pi/extensions/package-lock.json +1143 -0
  52. package/.pi/extensions/package.json +9 -0
  53. package/.pi/extensions/pi-voice-stt/README.md +201 -0
  54. package/.pi/extensions/pi-voice-stt/config.ts +198 -0
  55. package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  56. package/.pi/extensions/pi-voice-stt/index.ts +248 -0
  57. package/.pi/extensions/pi-voice-stt/package.json +6 -0
  58. package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  59. package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  60. package/.pi/harnesses/agent-hub/README.md +562 -0
  61. package/.pi/harnesses/agent-hub/artifacts.js +92 -0
  62. package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  63. package/.pi/harnesses/agent-hub/delegate.ts +363 -0
  64. package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.pi/harnesses/agent-hub/helpers.ts +165 -0
  66. package/.pi/harnesses/agent-hub/index.ts +7098 -0
  67. package/.pi/harnesses/agent-hub/package.json +6 -0
  68. package/.pi/harnesses/agent-hub/return-contract.js +215 -0
  69. package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  70. package/.pi/harnesses/agent-hub/spawn.ts +179 -0
  71. package/.pi/harnesses/ask-user-remote/README.md +10 -0
  72. package/.pi/harnesses/ask-user-remote/index.ts +253 -0
  73. package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  74. package/.pi/harnesses/coms/README.md +71 -0
  75. package/.pi/harnesses/coms/index.ts +1743 -0
  76. package/.pi/harnesses/coms/package.json +6 -0
  77. package/.pi/harnesses/damage-control/README.md +65 -0
  78. package/.pi/harnesses/damage-control/index.ts +250 -0
  79. package/.pi/harnesses/damage-control/package.json +6 -0
  80. package/.pi/harnesses/damage-control/shared.ts +183 -0
  81. package/.pi/harnesses/damage-control-continue/README.md +116 -0
  82. package/.pi/harnesses/damage-control-continue/index.ts +522 -0
  83. package/.pi/harnesses/damage-control-continue/package.json +6 -0
  84. package/.pi/harnesses/lib/herdr-client.ts +458 -0
  85. package/.pi/harnesses/lib/herdr-presence.ts +288 -0
  86. package/.pi/harnesses/package-lock.json +35 -0
  87. package/.pi/harnesses/package.json +9 -0
  88. package/.pi/prompts/build.md +24 -0
  89. package/.pi/prompts/code-simplify.md +22 -0
  90. package/.pi/prompts/doctor-agent-fleet.md +15 -0
  91. package/.pi/prompts/plan.md +16 -0
  92. package/.pi/prompts/review.md +16 -0
  93. package/.pi/prompts/setup-agent-fleet.md +27 -0
  94. package/.pi/prompts/ship.md +17 -0
  95. package/.pi/prompts/spec.md +15 -0
  96. package/.pi/prompts/test.md +19 -0
  97. package/.pi/skills/bowser/SKILL.md +145 -0
  98. package/.versions/0.0.1/.claude/commands/build.md +44 -0
  99. package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
  100. package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
  101. package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
  102. package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
  103. package/.versions/0.0.1/.claude/commands/plan.md +16 -0
  104. package/.versions/0.0.1/.claude/commands/prime.md +22 -0
  105. package/.versions/0.0.1/.claude/commands/review.md +16 -0
  106. package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
  107. package/.versions/0.0.1/.claude/commands/ship.md +72 -0
  108. package/.versions/0.0.1/.claude/commands/spec.md +15 -0
  109. package/.versions/0.0.1/.claude/commands/test.md +19 -0
  110. package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
  111. package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
  112. package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
  113. package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
  114. package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
  115. package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
  116. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  117. package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
  118. package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
  119. package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
  120. package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
  121. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
  122. package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
  123. package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
  124. package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
  125. package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
  126. package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
  127. package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  128. package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
  129. package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
  130. package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
  131. package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
  132. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  133. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  134. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  135. package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
  136. package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
  137. package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
  138. package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
  139. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  140. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  141. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  142. package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  143. package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  144. package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  145. package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  146. package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  147. package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  148. package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
  149. package/.versions/0.0.1/.pi/extensions/package.json +9 -0
  150. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
  151. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  152. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  153. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  154. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  155. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  156. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  157. package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
  158. package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
  159. package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  160. package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
  161. package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  162. package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
  163. package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
  164. package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
  165. package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
  166. package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  167. package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
  168. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
  169. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
  170. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  171. package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
  172. package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
  173. package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
  174. package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
  175. package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
  176. package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
  177. package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
  178. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
  179. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
  180. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
  181. package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
  182. package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
  183. package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
  184. package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
  185. package/.versions/0.0.1/.pi/prompts/build.md +24 -0
  186. package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
  187. package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
  188. package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
  189. package/.versions/0.0.1/.pi/prompts/review.md +16 -0
  190. package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
  191. package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
  192. package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
  193. package/.versions/0.0.1/.pi/prompts/test.md +19 -0
  194. package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
  195. package/.versions/0.0.1/.version +1 -0
  196. package/.versions/0.0.1/agents/architect.md +21 -0
  197. package/.versions/0.0.1/agents/bowser.md +25 -0
  198. package/.versions/0.0.1/agents/builder.md +52 -0
  199. package/.versions/0.0.1/agents/code-reviewer.md +205 -0
  200. package/.versions/0.0.1/agents/deep-researcher.md +31 -0
  201. package/.versions/0.0.1/agents/documenter.md +16 -0
  202. package/.versions/0.0.1/agents/orchestrator.md +43 -0
  203. package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
  204. package/.versions/0.0.1/agents/planner.md +69 -0
  205. package/.versions/0.0.1/agents/releaser.md +22 -0
  206. package/.versions/0.0.1/agents/researcher.md +28 -0
  207. package/.versions/0.0.1/agents/security-auditor.md +166 -0
  208. package/.versions/0.0.1/agents/test-engineer.md +144 -0
  209. package/.versions/0.0.1/agents/web-debugger.md +42 -0
  210. package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
  211. package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
  212. package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
  213. package/.versions/0.0.1/hooks/hooks.json +14 -0
  214. package/.versions/0.0.1/hooks/session-start.sh +74 -0
  215. package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
  216. package/.versions/0.0.1/justfile +143 -0
  217. package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
  218. package/.versions/0.0.1/references/definition-of-done.md +67 -0
  219. package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
  220. package/.versions/0.0.1/references/observability-checklist.md +91 -0
  221. package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
  222. package/.versions/0.0.1/references/performance-checklist.md +153 -0
  223. package/.versions/0.0.1/references/prompting-patterns.md +380 -0
  224. package/.versions/0.0.1/references/security-checklist.md +179 -0
  225. package/.versions/0.0.1/references/testing-patterns.md +236 -0
  226. package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
  227. package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
  228. package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
  229. package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
  230. package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
  231. package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
  232. package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
  233. package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
  234. package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
  235. package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
  236. package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
  237. package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
  238. package/.versions/0.0.1/scripts/team-up.ts +245 -0
  239. package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
  240. package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
  241. package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  242. package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
  243. package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
  244. package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  245. package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
  246. package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
  247. package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  248. package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  249. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
  250. package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
  251. package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
  252. package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
  253. package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  254. package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  255. package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
  256. package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
  257. package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
  258. package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
  259. package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
  260. package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
  261. package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
  262. package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
  263. package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
  264. package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  265. package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
  266. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  267. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  268. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  269. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  270. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  271. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  272. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  273. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  274. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  275. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  276. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  278. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  279. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  280. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  284. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  285. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  286. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  287. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  288. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  289. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  290. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  291. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  292. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  293. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  294. package/CHANGELOG.md +65 -0
  295. package/LICENSE +21 -0
  296. package/README.md +458 -0
  297. package/agents/architect.md +21 -0
  298. package/agents/bowser.md +25 -0
  299. package/agents/builder.md +52 -0
  300. package/agents/code-reviewer.md +205 -0
  301. package/agents/deep-researcher.md +31 -0
  302. package/agents/documenter.md +16 -0
  303. package/agents/orchestrator.md +43 -0
  304. package/agents/plan-reviewer.md +60 -0
  305. package/agents/planner.md +69 -0
  306. package/agents/releaser.md +22 -0
  307. package/agents/researcher.md +28 -0
  308. package/agents/security-auditor.md +166 -0
  309. package/agents/test-engineer.md +144 -0
  310. package/agents/web-debugger.md +42 -0
  311. package/agents/web-performance-auditor.md +192 -0
  312. package/bin/cli.js +633 -0
  313. package/bin/force-patch-changesets.js +44 -0
  314. package/bin/lib/bootstrap.js +323 -0
  315. package/bin/lib/detect-agent.js +49 -0
  316. package/bin/lib/doctor.js +302 -0
  317. package/bin/lib/transform-persona.js +180 -0
  318. package/bin/lib/update-notifier.js +195 -0
  319. package/bin/lib/validate-overrides.js +229 -0
  320. package/bin/snapshot-version.js +91 -0
  321. package/docs/agent-fleet-setup.md +355 -0
  322. package/docs/claude-code-coms-bridge.md +93 -0
  323. package/docs/getting-started.md +169 -0
  324. package/docs/npm-install.md +335 -0
  325. package/docs/opencode-setup.md +248 -0
  326. package/docs/pi-extensions.md +237 -0
  327. package/docs/pi-setup.md +455 -0
  328. package/docs/skill-anatomy.md +150 -0
  329. package/hooks/SIMPLIFY-IGNORE.md +90 -0
  330. package/hooks/coms-stop-hook.mjs +73 -0
  331. package/hooks/hooks.json +14 -0
  332. package/hooks/session-start.sh +74 -0
  333. package/hooks/simplify-ignore.sh +302 -0
  334. package/justfile +143 -0
  335. package/node_modules/pi-ask-user/LICENSE +21 -0
  336. package/node_modules/pi-ask-user/README.md +156 -0
  337. package/node_modules/pi-ask-user/index.ts +1795 -0
  338. package/node_modules/pi-ask-user/package.json +51 -0
  339. package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
  340. package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
  341. package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
  342. package/package.json +121 -0
  343. package/references/accessibility-checklist.md +160 -0
  344. package/references/definition-of-done.md +67 -0
  345. package/references/fleet-coordination-patterns.md +151 -0
  346. package/references/observability-checklist.md +91 -0
  347. package/references/orchestration-patterns.md +370 -0
  348. package/references/performance-checklist.md +153 -0
  349. package/references/prompting-patterns.md +380 -0
  350. package/references/security-checklist.md +179 -0
  351. package/references/testing-patterns.md +236 -0
  352. package/scripts/coms-claude-bridge.ts +286 -0
  353. package/scripts/coms-cli.ts +372 -0
  354. package/scripts/coms-hermes-bridge.ts +399 -0
  355. package/scripts/lib/claude-bridge-core.ts +100 -0
  356. package/scripts/lib/coms-envelope.ts +494 -0
  357. package/scripts/lib/herdr-layout.ts +235 -0
  358. package/scripts/lib/hermes-bridge-core.ts +238 -0
  359. package/scripts/lib/persona-banner.ts +62 -0
  360. package/scripts/lib/team-project.ts +75 -0
  361. package/scripts/lib/team-snapshot.ts +146 -0
  362. package/scripts/peer-banner.ts +40 -0
  363. package/scripts/team-snapshot.ts +221 -0
  364. package/scripts/team-up.ts +245 -0
  365. package/skills/_internal/grilling.md +11 -0
  366. package/skills/browser-testing-with-devtools/SKILL.md +352 -0
  367. package/skills/code-review-and-quality/SKILL.md +381 -0
  368. package/skills/compound-learning/SKILL.md +137 -0
  369. package/skills/context-engineering/SKILL.md +291 -0
  370. package/skills/deprecation-and-migration/SKILL.md +206 -0
  371. package/skills/designing-agents/SKILL.md +394 -0
  372. package/skills/designing-agents/pi-harness-authoring.md +209 -0
  373. package/skills/frontend-ui-engineering/SKILL.md +328 -0
  374. package/skills/git-workflow-and-versioning/SKILL.md +316 -0
  375. package/skills/guided-workspace-setup/SKILL.md +506 -0
  376. package/skills/idea-refine/SKILL.md +182 -0
  377. package/skills/idea-refine/examples.md +238 -0
  378. package/skills/idea-refine/frameworks.md +99 -0
  379. package/skills/idea-refine/refinement-criteria.md +113 -0
  380. package/skills/idea-refine/scripts/idea-refine.sh +15 -0
  381. package/skills/incremental-implementation/SKILL.md +287 -0
  382. package/skills/interview-me/SKILL.md +226 -0
  383. package/skills/orchestration-verification/SKILL.md +181 -0
  384. package/skills/peer-coms/SKILL.md +81 -0
  385. package/skills/performance-optimization/SKILL.md +350 -0
  386. package/skills/planning-and-task-breakdown/SKILL.md +236 -0
  387. package/skills/security-and-hardening/SKILL.md +461 -0
  388. package/skills/spec-driven-development/SKILL.md +245 -0
  389. package/skills/using-agent-skills/SKILL.md +199 -0
  390. package/vendor/agent-skills-upstream/LICENSE +21 -0
  391. package/vendor/agent-skills-upstream/README.md +11 -0
  392. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  393. package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  394. package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  395. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  396. package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  397. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  398. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  399. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  400. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  401. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  402. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  404. package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  405. package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  406. package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  407. package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  410. package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  411. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  412. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  413. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  414. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  415. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  416. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  417. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  418. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  419. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
@@ -0,0 +1,145 @@
1
+ ---
2
+ name: bowser
3
+ description: Headless browser automation using Playwright CLI. Use when you need headless browsing, parallel browser sessions, UI testing, screenshots, web scraping, or browser automation that can run in the background. Keywords - playwright, headless, browser, test, screenshot, scrape, parallel.
4
+ allowed-tools: Bash
5
+ ---
6
+
7
+ # Playwright Bowser
8
+
9
+ ## Purpose
10
+
11
+ Automate browsers using `playwright-cli` — a token-efficient CLI for Playwright. Runs headless by default, supports parallel sessions via named sessions (`-s=`), and doesn't load tool schemas into context.
12
+
13
+ ## Requirements
14
+
15
+ This skill drives the external **Playwright Agent CLI** (`playwright-cli`). It is **not** bundled with agent-fleet — install it once before using this skill (the guided setup checks for it when `bowser` is selected).
16
+
17
+ - **Node.js 20+**
18
+ - **`playwright-cli`** — install globally:
19
+
20
+ ```bash
21
+ npm install -g @playwright/cli@latest
22
+ playwright-cli --help # verify it responds
23
+ ```
24
+
25
+ Or run ad-hoc without a global install via `npx playwright-cli <command>`.
26
+
27
+ Browsers are downloaded automatically on first use; to pre-install explicitly:
28
+
29
+ ```bash
30
+ playwright-cli install-browser # default (chromium)
31
+ playwright-cli install-browser firefox # a specific browser
32
+ playwright-cli install-browser --with-deps # include system dependencies
33
+ ```
34
+
35
+ Full install docs: <https://playwright.dev/agent-cli/installation>
36
+
37
+ ## When to use this vs Chrome DevTools MCP
38
+
39
+ This skill (`playwright-cli`) and the `chrome-devtools-mcp` pi extension are **complementary**, not redundant — they differ by tool model, not just headless-vs-headful (both can do either):
40
+
41
+ - **`bowser` / `playwright-cli` (this skill)** — CLI-driven, headless-first, parallel named sessions, token-efficient (no tool schemas in context). It needs only Bash, so it works as a **dispatched subagent** under `--no-extensions`. Use it for automated, parallel, or background runtime-UI evidence and scraping.
42
+ - **`web-debugger` / `chrome-devtools-mcp`** — live `chrome_devtools__*` tools (DOM/console/network/performance traces) for **interactive headful** debugging with a human in the loop. Those tools come from an always-on extension, so they are reachable in the main session or a **coms peer**, not a `--no-extensions` subagent. Use it to *understand* a failure in a running dev app.
43
+
44
+ ## Key Details
45
+
46
+ - **Headless by default** — pass `--headed` to `open` to see the browser
47
+ - **Parallel sessions** — use `-s=<name>` to run multiple independent browser instances
48
+ - **Persistent profiles** — cookies and storage state preserved between calls
49
+ - **Token-efficient** — CLI-based, no accessibility trees or tool schemas in context
50
+ - **Vision mode** (opt-in) — set `PLAYWRIGHT_MCP_CAPS=vision` to receive screenshots as image responses in context instead of just saving to disk
51
+
52
+ ## Sessions
53
+
54
+ **Always use a named session.** Derive a short, descriptive kebab-case name from the user's prompt. This gives each task a persistent browser profile (cookies, localStorage, history) that accumulates across calls.
55
+
56
+ ```bash
57
+ # Derive session name from prompt context:
58
+ # "test the checkout flow on mystore.com" → -s=mystore-checkout
59
+ # "scrape pricing from competitor.com" → -s=competitor-pricing
60
+ # "UI test the login page" → -s=login-ui-test
61
+
62
+ playwright-cli -s=mystore-checkout open https://mystore.com --persistent
63
+ playwright-cli -s=mystore-checkout snapshot
64
+ playwright-cli -s=mystore-checkout click e12
65
+ ```
66
+
67
+ Managing sessions:
68
+ ```bash
69
+ playwright-cli list # list all sessions
70
+ playwright-cli close-all # close all sessions
71
+ playwright-cli -s=<name> close # close specific session
72
+ playwright-cli -s=<name> delete-data # wipe session profile
73
+ ```
74
+
75
+ ## Quick Reference
76
+
77
+ ```
78
+ Core: open [url], goto <url>, click <ref>, fill <ref> <text>, type <text>, snapshot, screenshot [ref], close
79
+ Navigate: go-back, go-forward, reload
80
+ Keyboard: press <key>, keydown <key>, keyup <key>
81
+ Mouse: mousemove <x> <y>, mousedown, mouseup, mousewheel <dx> <dy>
82
+ Tabs: tab-list, tab-new [url], tab-close [index], tab-select <index>
83
+ Save: screenshot [ref], pdf, screenshot --filename=f
84
+ Storage: state-save, state-load, cookie-*, localstorage-*, sessionstorage-*
85
+ Network: route <pattern>, route-list, unroute, network
86
+ DevTools: console, run-code <code>, tracing-start/stop, video-start/stop
87
+ Sessions: -s=<name> <cmd>, list, close-all, kill-all
88
+ Config: open --headed, open --browser=chrome, resize <w> <h>
89
+ ```
90
+
91
+ ## Workflow
92
+
93
+ 1. Derive a session name from the user's prompt and open with `--persistent` to preserve cookies/state. Always set the viewport via env var at launch:
94
+ ```bash
95
+ PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<session-name> open <url> --persistent
96
+ # or headed:
97
+ PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 playwright-cli -s=<session-name> open <url> --persistent --headed
98
+ # or with vision (screenshots returned as image responses in context):
99
+ PLAYWRIGHT_MCP_VIEWPORT_SIZE=1440x900 PLAYWRIGHT_MCP_CAPS=vision playwright-cli -s=<session-name> open <url> --persistent
100
+ ```
101
+
102
+ 2. Get element references via snapshot:
103
+ ```bash
104
+ playwright-cli snapshot
105
+ ```
106
+
107
+ 3. Interact using refs from snapshot:
108
+ ```bash
109
+ playwright-cli click <ref>
110
+ playwright-cli fill <ref> "text"
111
+ playwright-cli type "text"
112
+ playwright-cli press Enter
113
+ ```
114
+
115
+ 4. Capture results:
116
+ ```bash
117
+ playwright-cli screenshot
118
+ playwright-cli screenshot --filename=output.png
119
+ ```
120
+
121
+ 5. **Always close the session when done.** This is not optional — close the named session after finishing your task:
122
+ ```bash
123
+ playwright-cli -s=<session-name> close
124
+ ```
125
+
126
+ ## Configuration
127
+
128
+ If a `playwright-cli.json` exists in the working directory, use it automatically. If the user provides a path to a config file, use `--config path/to/config.json`. Otherwise, skip configuration — the env var and CLI defaults are sufficient.
129
+
130
+ ```json
131
+ {
132
+ "browser": {
133
+ "browserName": "chromium",
134
+ "launchOptions": { "headless": true },
135
+ "contextOptions": { "viewport": { "width": 1440, "height": 900 } }
136
+ },
137
+ "outputDir": "./screenshots"
138
+ }
139
+ ```
140
+
141
+ ## Full Help
142
+
143
+ Run `playwright-cli --help` or `playwright-cli --help <command>` for detailed command usage.
144
+
145
+ See the [Playwright Agent CLI docs](https://playwright.dev/agent-cli/installation) for full documentation.
@@ -0,0 +1,44 @@
1
+ ---
2
+ description: Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.
3
+ ---
4
+
5
+ Invoke the agent-fleet:incremental-implementation skill alongside agent-fleet:test-driven-development.
6
+
7
+ ## Modes
8
+
9
+ - **`/build`** — implement the *next* pending task, then stop (careful, one slice at a time).
10
+ - **`/build auto`** — generate the plan if needed, get a single approval, then implement *every* task without stopping between them.
11
+
12
+ `$ARGUMENTS` selects the mode. Treat `auto` (canonical) or `all` as autonomous mode; anything else (or empty) is the default single-task mode. Note: autonomous mode is not faster *per task* — it runs the same test-driven loop — it only removes the human stepping *between* tasks.
13
+
14
+ ## Default: one task
15
+
16
+ Pick the next pending task from the plan. Then:
17
+
18
+ 1. Read the task's acceptance criteria
19
+ 2. Load relevant context (existing code, patterns, types)
20
+ 3. Write a failing test for the expected behavior (RED)
21
+ 4. Implement the minimum code to pass the test (GREEN)
22
+ 5. Run the full test suite to check for regressions
23
+ 6. Run the build to verify compilation
24
+ 7. Commit with a descriptive message
25
+ 8. Mark the task complete and stop
26
+
27
+ ## Autonomous: the whole plan (`/build auto`)
28
+
29
+ Use this once a spec exists and you want to collapse plan + build into one run. It removes the manual stepping between tasks — **not** the verification. Every task still earns a passing test and its own commit.
30
+
31
+ 1. **Require a spec.** Look only for a spec at a known path: `SPEC.md` at the repo root, `docs/SPEC.md`, or a file under `spec/`. A README or arbitrary doc does **not** count. If none exists, stop and tell the user to run `/spec` first — do not invent requirements.
32
+ 2. **Establish a clean baseline.** Run `git status --porcelain`. If there are uncommitted changes outside the expected planning artifacts (`SPEC.md`, `docs/SPEC.md`, `spec/*`, `tasks/plan.md`, `tasks/todo.md`), stop and ask the user to commit, stash, or confirm how to handle them. Autonomous per-task commits must not absorb unrelated local work, or the clean-rollback guarantee breaks.
33
+ 3. **Plan if needed.** If there is no `tasks/plan.md`, invoke agent-fleet:planning-and-task-breakdown to generate one.
34
+ 4. **Single checkpoint.** Present the full plan and wait for an unambiguous affirmative (e.g. "approve", "go", "yes"). Treat hedged responses ("looks reasonable", "I guess") as **not** approved. This is the only human gate — after approval, run autonomously. If you generated `tasks/plan.md`, commit it as a single preparatory commit now so it doesn't bleed into the first task's commit.
35
+ 5. **Execute every task in dependency order.** Use each task's declared dependencies; if they aren't explicit, execute in the order the plan lists them. For each task, run the full default loop above (RED → GREEN → regression → build → commit → mark complete). Stage only the files that task touched plus its task-status update — never `git add -A` blindly — and make one commit per task so any point is a clean rollback.
36
+ 6. **Stop and ask the user** (do not push through) when:
37
+ - a test can't be made to pass or the build breaks without an obvious fix → follow agent-fleet:debugging-and-error-recovery
38
+ - the spec is ambiguous, or a task needs a decision the spec doesn't cover
39
+ - a task is high-risk or irreversible — auth/permission changes, destructive data migrations, payments, deletions, deploys, anything touching secrets, **or anything you can't undo with `git revert`** → follow agent-fleet:doubt-driven-development and get explicit sign-off before continuing
40
+
41
+ After the user resolves a blocker, they re-invoke `/build auto` — it resumes from the next pending task.
42
+ 7. **Summarize at the end:** tasks completed, tests added, commits made, and anything skipped, flagged, or left for the user.
43
+
44
+ If any step fails, follow the agent-fleet:debugging-and-error-recovery skill.
@@ -0,0 +1,22 @@
1
+ ---
2
+ description: Simplify code for clarity and maintainability — reduce complexity without changing behavior
3
+ ---
4
+
5
+ Invoke the agent-fleet:code-simplification skill.
6
+
7
+ Simplify recently changed code (or the specified scope) while preserving exact behavior:
8
+
9
+ 1. Read CLAUDE.md and study project conventions
10
+ 2. Identify the target code — recent changes unless a broader scope is specified
11
+ 3. Understand the code's purpose, callers, edge cases, and test coverage before touching it
12
+ 4. Scan for simplification opportunities:
13
+ - Deep nesting → guard clauses or extracted helpers
14
+ - Long functions → split by responsibility
15
+ - Nested ternaries → if/else or switch
16
+ - Generic names → descriptive names
17
+ - Duplicated logic → shared functions
18
+ - Dead code → remove after confirming
19
+ 5. Apply each simplification incrementally — run tests after each change
20
+ 6. Verify all tests pass, the build succeeds, and the diff is clean
21
+
22
+ If tests fail after a simplification, revert that change and reconsider. Use `code-review-and-quality` to review the result.
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: Design and write a new agent persona (agents/), workflow skill (skills/), or pi harness (.pi/harnesses/)
3
+ ---
4
+
5
+ Invoke the agent-fleet:designing-agents skill.
6
+
7
+ Begin by understanding what the user wants to author:
8
+ 1. Is this a **persona** (a role/lens the agent adopts, e.g. a reviewer or auditor), a **skill** (a repeatable workflow with gated steps and verification), or a **pi harness** (a TypeScript pi extension that reshapes the session — footer, tool-call gate, new command, or orchestrator)?
9
+ 2. The one-sentence purpose and when it should be invoked
10
+ 3. The framework or steps — dimensions evaluated (persona), ordered workflow (skill), or session surface and events hooked (harness)
11
+ 4. Explicit non-goals and scope limits
12
+ 5. Output shape — what a typical invocation should produce
13
+
14
+ Then scan the target location (`agents/`, `skills/`, or `.pi/harnesses/`) for overlap, draft the artifact using the matching template — four-block persona structure, the section order from `docs/skill-anatomy.md`, or the harness pattern in `skills/designing-agents/pi-harness-authoring.md` — verify the draft against `references/prompting-patterns.md`, and confirm with the user before writing the file(s).
@@ -0,0 +1,17 @@
1
+ ---
2
+ description: Scan agent-fleet install targets for broken symlinks, stale persona references, and overrides-file problems, then offer repairs
3
+ ---
4
+
5
+ Invoke the Doctor scan from the `agent-fleet:guided-workspace-setup` skill — Step 5 (the preflight scan) — without running the rest of the install flow. Use this when the user wants the repair pass on its own; the full `/setup-agent-fleet` flow runs the same scan automatically as soon as it detects prior install state.
6
+
7
+ Walk every install-target directory the chosen coding agent uses (`agents/`, `.claude/agents/`, `.opencode/agent/` (+ legacy `.opencode/agents/`), `.pi/agents/`, `.claude/skills/`, `.opencode/skills/`, `.pi/skills/`, `.agents/skills`, `.claude/commands/`, `.opencode/commands/`, `.pi/prompts/`, `.claude/references/`, `.claude/hooks/`). For each broken symlink, resolve where it pointed, look for a canonical replacement in the source `agents/` and `skills/` trees, and offer to repair or delete (persona links under `.claude/agents/` and `.opencode/agent(s)/` are repaired by regenerating a transformed copy via `transform-persona`, not by re-symlinking the raw source). Common stale names from the pre-merge persona layout: `reviewer` → `code-reviewer`, `red-team` → `security-auditor`.
8
+
9
+ Also flag and offer to rewrite any remaining YAML configs (`teams.yaml`, `peers.yaml`, etc.) that still reference removed persona names.
10
+
11
+ Also flag malformed peer entries in `.pi/agents/peers.yaml`: field lines (`persona:`, `model:`, ...) that sit under a team heading before any `- name: ...` list item. The team-up launcher's minimal parser silently drops such lines, so the peer never spawns and nothing errors — the usual cause is a `- name:` line lost in an edit. These findings are advisory only: report them with the missing `- name: <peer>` suggestion, never rewrite the file.
12
+
13
+ Also validate `.ai/agent-fleet-overrides.md` when it exists, against the schema in `docs/agent-fleet-setup.md`: unknown sections, unknown keys in known sections, invalid values for the mechanically parsed `agent-hub` keys, missing `rules:` folders and `docs:` entry points, and `## env` `required:` names that are neither set nor declared in the root `.env`. These findings are advisory only — report them with fix "edit by hand", never edit the overrides file.
14
+
15
+ Present findings as a `# | Path | Issue | Suggested fix` table and ask the user to pick which fixes to apply.
16
+
17
+ Never overwrite a regular file — only act on symlinks whose target is missing. Report `repaired`, `deleted`, and `skipped` counts, and append a `## doctor-runs` line to `.ai/agent-fleet-setup.md` with the date, agent, phase (`standalone`), and counts.
@@ -0,0 +1,112 @@
1
+ ---
2
+ description: Orchestrate a config-defined team of subagents — route planner/builder (and more) as a runtime roster, handling NEEDS_RESEARCH and PLAN_FILE handoffs
3
+ ---
4
+
5
+ You are the **orchestrator**. The primary agent drives a team of installed Claude Code
6
+ subagents to deliver the task in `$ARGUMENTS`. Subagents cannot nest — **all dispatching is
7
+ yours**.
8
+
9
+ ## Roles
10
+
11
+ | Role | What it does |
12
+ |---|---|
13
+ | `researcher` | Always-available read-only recon. Cites `file:line`. Never edits. |
14
+ | `planner` | Writes a plan doc only; ends with `PLAN_FILE: <path>` or pauses on `NEEDS_RESEARCH:`. |
15
+ | `builder` | Implements in small increments; may pause on `NEEDS_RESEARCH:`. |
16
+ | `plan-reviewer` / `code-reviewer` | Read-only; their whole result is findings (no handoff marker). |
17
+
18
+ ## Step 0 — Resolve the team
19
+
20
+ 1. Read `.claude/orchestrate-teams.yaml` (a map of team-name → ordered persona list).
21
+ 2. Resolve team + task from `$ARGUMENTS`:
22
+ - Treat the **first token** as a team name **only** when it is a bare single word that
23
+ exactly matches a config key **and** is followed by the rest of the task. To force a
24
+ team explicitly, the user writes `/orchestrate team=<name> <task>`. Otherwise the
25
+ team is the first key (`default`) and all of `$ARGUMENTS` is the task.
26
+ - **Fallbacks:** if the config is **absent / empty / fails to parse**, fall back to the
27
+ built-in `planner` + `builder` default and **say which fallback fired** (don't proceed
28
+ silently). If a named team is requested but not found, list the available team keys and
29
+ ask rather than guessing.
30
+ 3. **Validate personas:** each persona in the resolved team must exist in `.claude/agents/`.
31
+ Skip-with-warning any that don't. If every persona is missing, fall back to the built-in
32
+ default.
33
+ 4. List the resolved team back to the user before dispatching.
34
+
35
+ `researcher` / `deep-researcher` are **always available** even when not listed in the team.
36
+
37
+ ## Step 1 — The team is a roster, not a fixed pipeline
38
+
39
+ The persona list is the set of specialists you may route to; **you decide the order at
40
+ runtime from the task state** (the listed order is only a sensible starting default). So:
41
+
42
+ - **Skip `planner`** when a usable plan already exists (the user passed a `PLAN_FILE` or
43
+ pointed at one) — go straight to `builder`.
44
+ - **Re-dispatch `researcher` at any point** — after `planner`, mid-build — whenever a
45
+ specialist needs a fact checked, not only as a first step.
46
+ - **Loop back to `planner`** if `builder` surfaces that the plan is wrong.
47
+
48
+ Do **not** enforce a hard `researcher → planner → builder` sequence.
49
+
50
+ ## The Verification Contract (applies across every step)
51
+
52
+ Read `skills/orchestration-verification/SKILL.md` before non-trivial work and hold its
53
+ contract for the whole run. Subagents here cannot persist a shared ledger, so **you** keep
54
+ the acceptance assertions in your own working notes and refuse "done" until each is proven.
55
+
56
+ - **Build the assertions first.** Before dispatching `builder` for any non-trivial task,
57
+ convert the request into numbered, tagged assertions (`test` | `runtime-ui` | `code-grep`
58
+ | `manual`, one checkable pass condition each). Pass the relevant assertions **verbatim**
59
+ into each dispatch and advance only on assertions that come back *proven with named
60
+ evidence* — propagation in prose is not verification.
61
+ - **Inventory parity for "behave like X" requests.** When the request is "make X behave like
62
+ existing Y", dispatch `researcher` / `deep-researcher` **first** to enumerate every site
63
+ where the exemplar is special-cased (flags, branches, display, validation, translations,
64
+ fixtures, tests), and turn each site into an assertion covering the *whole* set — otherwise
65
+ the exemplar ships and its siblings are missed.
66
+ - **Require runtime proof for UI assertions.** A `runtime-ui` assertion (visibility,
67
+ placement, "appears in the table") is closed only by an actual runtime observation via
68
+ `browser-testing-with-devtools`, never a static review.
69
+ - **Accept assertion status, not verdicts.** Treat specialist returns as `assertions_proven`
70
+ / `assertions_unproven` / `assertions_failed`; demote any "approved" claim with no named
71
+ evidence to unproven and re-dispatch it.
72
+ - **Reset on "wrong again".** When the user reports a delivered requirement is wrong again,
73
+ treat prior summaries as suspect, rebuild the affected assertions from the **latest**
74
+ correction (re-running the parity inventory for "behave like" cases), then re-dispatch.
75
+
76
+ ## Step 2 — Route to specialists, honouring handoff markers
77
+
78
+ State the chosen next step (and why) before each dispatch, so routing is visible.
79
+
80
+ - `planner` → read its `PLAN_FILE: <path>` and load the plan.
81
+ - `builder` → loop over the plan's `## Task List`, **one task per dispatch**, checking each
82
+ task's acceptance criteria **and the relevant acceptance assertions** before moving on.
83
+ - **Marker-less personas** (`plan-reviewer` / `code-reviewer`) emit no handoff marker —
84
+ their returned report **is** the result; "done" = the report came back, nothing to wait
85
+ for. Fold findings forward; if a `code-reviewer` raised must-fix issues, loop back to
86
+ `builder`.
87
+
88
+ ## Step 3 — NEEDS_RESEARCH dispatch (core)
89
+
90
+ Whenever any persona's result contains one or more `NEEDS_RESEARCH: <question>` lines:
91
+
92
+ 1. Pause that track.
93
+ 2. Dispatch `researcher` (read-only) once per question — in parallel when independent.
94
+ 3. Collect the findings.
95
+ 4. Resume the paused persona by re-dispatching it with the **original task plus the
96
+ findings inlined**.
97
+
98
+ **Never** answer a `NEEDS_RESEARCH` by guessing.
99
+
100
+ ## Step 4 — Reviewer only if present
101
+
102
+ The `default` roster has **no reviewer**. After the final builder task's acceptance criteria
103
+ pass, report completion and **state explicitly that review/verification was not run** and
104
+ which acceptance assertions therefore remain unproven (the user can pick the `full` team or
105
+ run `/review`). When the active team *does* include a reviewer, run it as a normal step and
106
+ require it to report parity across sibling cases, not just the exemplar.
107
+
108
+ ## Step 5 — Report
109
+
110
+ Report crisply: **active team**, what changed, which acceptance assertions are **proven (with
111
+ evidence)**, which remain **unproven or failed**, and what's next. Never report "done" while a
112
+ relevant assertion is unproven.
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: Break work into small verifiable tasks with acceptance criteria and dependency ordering
3
+ ---
4
+
5
+ Invoke the agent-fleet:planning-and-task-breakdown skill.
6
+
7
+ Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:
8
+
9
+ 1. Enter plan mode — read only, no code changes
10
+ 2. Identify the dependency graph between components
11
+ 3. Slice work vertically (one complete path per task, not horizontal layers)
12
+ 4. Write tasks with acceptance criteria and verification steps
13
+ 5. Add checkpoints between phases
14
+ 6. Present the plan for human review
15
+
16
+ Save the plan to the location the `planning-and-task-breakdown` skill defines (default `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, with the task list embedded — no separate todo file; overridable per project via `.ai/agent-fleet-overrides.md`). Match the project's existing `docs`/`Docs` capitalization.
@@ -0,0 +1,22 @@
1
+ ---
2
+ description: Load foundational context for the agent-fleet repository
3
+ ---
4
+
5
+ # Purpose
6
+
7
+ Orient yourself in **agent-fleet** — a collection of production-grade engineering skills
8
+ for AI coding agents, plus pi extensions, specialist agent personas, and lifecycle
9
+ commands that map to the software development lifecycle.
10
+
11
+ ## Workflow
12
+
13
+ 1. Run `git ls-files` to see the full project file tree
14
+ 2. Read `README.md` and `CLAUDE.md` for the project overview and conventions
15
+ 3. Read `docs/skill-anatomy.md` to learn the required skill format
16
+ 4. Skim `skills/*/SKILL.md` — the core skills, grouped by lifecycle phase
17
+ (Define → Plan → Build → Verify → Review → Ship)
18
+ 5. Read `agents/*.md` — the specialist review personas
19
+ 6. Read `docs/pi-extensions.md`, `.pi/extensions/*/README.md` (always-on utilities), and `.pi/harnesses/*/README.md` (selectable session harnesses)
20
+ 7. Summarize your understanding: purpose, structure, key files, and entry points
21
+
22
+ Do this directly — read the files yourself rather than delegating to subagents.
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: Conduct a five-axis code review — correctness, readability, architecture, security, performance
3
+ ---
4
+
5
+ Invoke the agent-fleet:code-review-and-quality skill.
6
+
7
+ Review the current changes (staged or recent commits) across all five axes:
8
+
9
+ 1. **Correctness** — Does it match the spec? Edge cases handled? Tests adequate?
10
+ 2. **Readability** — Clear names? Straightforward logic? Well-organized?
11
+ 3. **Architecture** — Follows existing patterns? Clean boundaries? Right abstraction level?
12
+ 4. **Security** — Input validated? Secrets safe? Auth checked? (Use security-and-hardening skill)
13
+ 5. **Performance** — No N+1 queries? No unbounded ops? (Use performance-optimization skill)
14
+
15
+ Categorize findings as Critical, Important, or Suggestion.
16
+ Output a structured review with specific file:line references and fix recommendations.
@@ -0,0 +1,25 @@
1
+ ---
2
+ description: Guided setup — install agent-fleet artifacts into a workspace for a chosen coding agent
3
+ ---
4
+
5
+ Invoke the agent-fleet:guided-workspace-setup skill.
6
+
7
+ Run the guided install for a target workspace. If the user passed a workspace path, use it; otherwise ask for it. Detect the running coding agent and confirm it with the user.
8
+
9
+ Analyse the workspace. If prior install state is found (`.ai/agent-fleet-setup.md` or a populated agent directory), run the **Doctor preflight** first (Step 5) — scan for broken symlinks and stale persona references, present findings as a table, and apply the fixes the user picks before continuing.
10
+
11
+ The Skills group draws from **two roots**: fleet-native `skills/` and the vendored upstream import `vendor/agent-skills-upstream/skills/` (see `docs/UPSTREAM-SKILLS.md`). On a name collision the native copy wins — never offer the vendored duplicate as a separate row.
12
+
13
+ Then present the install menu as **one multi-select per group** — **7 groups** (4 shared: Skills, Agent personas, Commands/prompts, References & Hooks; 3 pi-only: pi extensions & runtime skills, pi harnesses, External pi packages — so a claude-code workspace sees just the 4 shared groups) with `★` marking recommendations. Multi-type groups carry a leading `Group` column labelling the sub-category (lifecycle phase for Skills, `rw`/`ro`/`pi-only` for personas, etc.). Each group renders as a `Pick | Item | Group | Status | Rec | Purpose` table; every row carries an explicit status text — `installed · up to date`, `installed · outdated`, `installed · modified`, `not installed`, or `broken · skipped in preflight`. Installed items are **pre-checked `[x]`** so unchecking = remove; not-installed items start `[ ]`. Per-group reply shortcuts: `all`, `recommended` (adds `★` items on top of the pre-selection — never unticks installed ones), `none`, `keep` (accept the pre-selection unchanged), or a list of picks. Never offer `setup`, `doctor`, or `guided-workspace-setup` — those are installer-only and live in the source agent-fleet repo.
14
+
15
+ Unchecking an installed item means *remove it*, but **removal is scoped**: only act on items whose name is in the agent-fleet inventory **and** that are recorded in `## install-status` (or are symlinks resolving into the source repo). User-authored skills, custom commands, third-party plugins, and unrelated settings/env keys are left untouched and logged as "Skipped — not owned by agent-fleet".
16
+
17
+ **No cross-tool substitution.** Each row is offered only when the source file the chosen agent needs already exists — for `pi`, that means `.pi/prompts/<name>.md`, `.pi/extensions/<name>/`, etc. Never fall back to `.claude/commands/` (or another agent's tree) to satisfy a pi prompt request; items missing their per-agent source are filtered out of the menu entirely.
18
+
19
+ **Personas are generated for non-pi targets.** The personas group lists the full availability roster from `node <source-root>/bin/cli.js transform-persona --list --agent <agent>` (pi-only personas — `bowser`, `orchestrator` — appear only when the agent is `pi`). For `claude-code`/`opencode` the apply step installs personas via `transform-persona --agent <agent> --workspace <workspace> <name…>` — always a generated copy, even in symlink mode — and records the rows with `transformed: true`; status checks diff against the generated output, not the raw canonical source.
20
+
21
+ **pi harness companions.** When the agent is `pi`, installing/refreshing/removing any harness also refreshes its companions — the `justfile` launch recipes, the `team-up`/`coms-net` scripts, the peer/team YAML, `.pi/damage-control-rules.yaml`, and `.pi/harnesses/package.json`. Refresh the `justfile` from the current source (rewriting only the `agent-fleet:harnesses` managed region so user recipes survive) so retired-harness recipes are pruned and new ones added; a stale `justfile` left after a harness change is the regression this prevents.
22
+
23
+ **No mid-apply overwrite prompts.** The Step 6 status text already warns that `installed · modified` rows will have local edits overwritten if kept ticked. The user's tick is the consent; the Step 9 confirmation is the single gate. During apply, refresh ticked items unconditionally — never pause to ask "should I overwrite this file?". Genuine errors (permission denied, missing source) still stop and report.
24
+
25
+ Offer override sections for the workspace's `.ai/agent-fleet-overrides.md` based on the analysis, and record what was installed in `.ai/agent-fleet-setup.md`. Summarise the full plan and wait for explicit confirmation before writing anything, then perform the setup, re-scan for any new breakage, and report what changed.
@@ -0,0 +1,72 @@
1
+ ---
2
+ description: Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision
3
+ ---
4
+
5
+ Invoke the agent-fleet:shipping-and-launch skill.
6
+
7
+ `/ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.
8
+
9
+ ## Phase A — Parallel fan-out
10
+
11
+ Spawn three subagents concurrently using the Agent tool. **Issue all three Agent tool calls in a single assistant turn so they execute in parallel** — sequential calls defeat the purpose of this command.
12
+
13
+ In Claude Code, each call passes `subagent_type` matching the persona's `name` field:
14
+
15
+ 1. **`code-reviewer`** — Run a five-axis review (correctness, readability, architecture, security, performance) on the staged changes or recent commits. Output the standard review template.
16
+ 2. **`security-auditor`** — Run a vulnerability and threat-model pass. Check OWASP Top 10, secrets handling, auth/authz, dependency CVEs. Output the standard audit report.
17
+ 3. **`test-engineer`** — Analyze test coverage for the change. Identify gaps in happy path, edge cases, error paths, and concurrency scenarios. Output the standard coverage analysis.
18
+
19
+ In other harnesses without an Agent tool, invoke each persona's system prompt sequentially and treat their outputs as if returned in parallel — the merge phase still works.
20
+
21
+ Constraints (from Claude Code's subagent model):
22
+ - Subagents cannot spawn other subagents — do not let one persona delegate to another.
23
+ - Each subagent gets its own context window and returns only its report to this main session.
24
+ - If you need teammates that talk to each other instead of just reporting back, use Claude Code Agent Teams and reference these personas as teammate types (see `references/orchestration-patterns.md`).
25
+
26
+ **Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `.claude/agents/` or `~/.claude/agents/`, those take precedence over this plugin's versions — `/ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Claude Code's scope priority table, so user-level definitions win by design.
27
+
28
+ ## Phase B — Merge in main context
29
+
30
+ Once all three reports are back, the main agent (not a sub-persona) synthesizes them:
31
+
32
+ 1. **Code Quality** — Aggregate Critical/Important findings from `code-reviewer` and any failing tests, lint, or build output. Resolve duplicates between reviewers.
33
+ 2. **Security** — Promote any Critical/High `security-auditor` findings to launch blockers. Cross-reference with `code-reviewer`'s security axis.
34
+ 3. **Performance** — Pull from `code-reviewer`'s performance axis; cross-check Core Web Vitals if applicable.
35
+ 4. **Accessibility** — Verify keyboard nav, screen reader support, contrast (not covered by the three personas — handle directly here, or invoke the accessibility checklist).
36
+ 5. **Infrastructure** — Env vars, migrations, monitoring, feature flags. Verify directly.
37
+ 6. **Documentation** — README, ADRs, changelog. Verify directly.
38
+
39
+ ## Phase C — Decision and rollback
40
+
41
+ Produce a single output:
42
+
43
+ ```markdown
44
+ ## Ship Decision: GO | NO-GO
45
+
46
+ ### Blockers (must fix before ship)
47
+ - [Source persona: Critical finding + file:line]
48
+
49
+ ### Recommended fixes (should fix before ship)
50
+ - [Source persona: Important finding + file:line]
51
+
52
+ ### Acknowledged risks (shipping anyway)
53
+ - [Risk + mitigation]
54
+
55
+ ### Rollback plan
56
+ - Trigger conditions: [what signals would prompt rollback]
57
+ - Rollback procedure: [exact steps]
58
+ - Recovery time objective: [target]
59
+
60
+ ### Specialist reports (full)
61
+ - [code-reviewer report]
62
+ - [security-auditor report]
63
+ - [test-engineer report]
64
+ ```
65
+
66
+ ## Rules
67
+
68
+ 1. The three Phase A personas run in parallel — never sequentially.
69
+ 2. Personas do not call each other. The main agent merges in Phase B.
70
+ 3. The rollback plan is mandatory before any GO decision.
71
+ 4. If any persona returns a Critical finding, the default verdict is NO-GO unless the user explicitly accepts the risk.
72
+ 5. **Skip the fan-out only if all of the following are true:** the change touches 2 files or fewer, the diff is under 50 lines, and it does not touch auth, payments, data access, or config/env. Otherwise, default to fan-out. `/ship` is designed for production-bound changes — when the blast radius is non-trivial, run the parallel review even if the diff looks small.
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Start spec-driven development — write a structured specification before writing code
3
+ ---
4
+
5
+ Invoke the agent-fleet:spec-driven-development skill.
6
+
7
+ Begin by understanding what the user wants to build. Ask clarifying questions about:
8
+ 1. The objective and target users
9
+ 2. Core features and acceptance criteria
10
+ 3. Tech stack preferences and constraints
11
+ 4. Known boundaries (what to always do, ask first about, and never do)
12
+
13
+ Then generate a structured spec covering all six core areas: objective, commands, project structure, code style, testing strategy, and boundaries.
14
+
15
+ Save the spec to the location the `spec-driven-development` skill defines (default `docs/prds/{area}/PRD{n}-{topic}.md`; overridable per project via `.ai/agent-fleet-overrides.md`). Confirm with the user before proceeding.
@@ -0,0 +1,19 @@
1
+ ---
2
+ description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern.
3
+ ---
4
+
5
+ Invoke the agent-fleet:test-driven-development skill.
6
+
7
+ For new features:
8
+ 1. Write tests that describe the expected behavior (they should FAIL)
9
+ 2. Implement the code to make them pass
10
+ 3. Refactor while keeping tests green
11
+
12
+ For bug fixes (Prove-It pattern):
13
+ 1. Write a test that reproduces the bug (must FAIL)
14
+ 2. Confirm the test fails
15
+ 3. Implement the fix
16
+ 4. Confirm the test passes
17
+ 5. Run the full test suite for regressions
18
+
19
+ For browser-related issues, also invoke agent-fleet:browser-testing-with-devtools to verify with Chrome DevTools MCP.
@@ -0,0 +1,32 @@
1
+ ---
2
+ description: Run a web performance audit via the web-performance-auditor persona
3
+ ---
4
+
5
+ `/webperf` targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
6
+
7
+ ## Determine the mode
8
+
9
+ **Deep mode** — activate when any of these is available:
10
+ - A Lighthouse JSON report file (e.g. `npx lighthouse <url> --output json --output-path ./report.json`, or `npx -p chrome-devtools-mcp chrome-devtools lighthouse_audit --output-format=json` from the Chrome DevTools MCP CLI)
11
+ - A PageSpeed Insights JSON response (includes Lighthouse + CrUX)
12
+ - A CrUX API response (requires `CRUX_API_KEY` or `GOOGLE_API_KEY`)
13
+ - A DevTools performance trace
14
+ - A live URL plus the `chrome-devtools` MCP server configured in the harness (the agent can capture metrics directly via `lighthouse_audit` and `performance_*` tools)
15
+ - The Chrome DevTools MCP CLI invoked locally (via `npx -p chrome-devtools-mcp chrome-devtools <tool>` or after `npm i -g chrome-devtools-mcp`) — the user runs commands like `chrome-devtools lighthouse_audit --output-format=json` and passes the JSON output to the agent
16
+
17
+ **Quick mode** — default when none of the above are available. The agent scans source code for structural anti-patterns and labels every finding as `potential impact`.
18
+
19
+ ## Run the audit
20
+
21
+ Spawn the `web-performance-auditor` subagent. Pass it explicitly:
22
+
23
+ - The files, components, or diff under review
24
+ - Any artifact paths (Lighthouse JSON, PSI JSON, CrUX response, trace) or pasted JSON content
25
+ - The target URL or page name when known
26
+ - A note on which mode you expect (Quick or Deep), so the agent surfaces missing inputs if Deep was intended
27
+
28
+ The subagent returns a scorecard (only populated with sourced values), a ranked list of findings, positive observations, and proactive recommendations.
29
+
30
+ ## Output
31
+
32
+ Return the full audit report to the user. No synthesis or merge step is needed — this is a single-persona command.
@@ -0,0 +1,24 @@
1
+ # Teams for /orchestrate. The main session reads this file and routes the
2
+ # named team as a ROSTER (runtime-decided order), not a fixed pipeline.
3
+ #
4
+ # Rules the /orchestrate command relies on:
5
+ # 1. First key is the default team (used when no team argument is given).
6
+ # 2. researcher / deep-researcher are NOT listed — they are always available
7
+ # out-of-band for NEEDS_RESEARCH dispatch (mirrors pi's spawn_research).
8
+ # 3. Every listed persona must exist in .claude/agents/ or it is skipped with
9
+ # a warning.
10
+ #
11
+ # Switch at runtime: /orchestrate <team> "<task>" (parallels pi's /agents-team).
12
+
13
+ default:
14
+ - planner
15
+ - builder
16
+
17
+ full:
18
+ - planner
19
+ - plan-reviewer
20
+ - builder
21
+ - code-reviewer
22
+
23
+ hotfix:
24
+ - builder
@@ -0,0 +1,17 @@
1
+ ---
2
+ description: Implement the next task incrementally - build, test, verify, commit
3
+ ---
4
+
5
+ Invoke the `incremental-implementation` skill and the `test-driven-development` skill via the `skill` tool.
6
+
7
+ Pick the next pending task from the plan. For each task:
8
+
9
+ 1. Read the task's acceptance criteria.
10
+ 2. Load relevant context: existing code, patterns, and types.
11
+ 3. Write a failing test for the expected behavior.
12
+ 4. Implement the minimum code to pass the test.
13
+ 5. Run the relevant test suite to check for regressions.
14
+ 6. Run the build to verify compilation.
15
+ 7. Mark the task complete and move to the next one.
16
+
17
+ If any step fails, invoke the `debugging-and-error-recovery` skill via the `skill` tool.