@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,91 @@
1
+ #!/usr/bin/env node
2
+ // snapshot-version.js
3
+ //
4
+ // Copy every shipped artifact into .versions/<x.y.z>/ so a later install can
5
+ // run a three-way diff between:
6
+ // - source @ recorded version ←─ this snapshot, read from the installed copy
7
+ // - installed copy in target ←─ what the user has on disk
8
+ // - source @ current version ←─ the active tree in this package
9
+ //
10
+ // Run while preparing the release version so the snapshot is committed in the
11
+ // Version Packages PR. Also runnable by hand if you need to rebuild a snapshot.
12
+
13
+ import { readFileSync, mkdirSync, cpSync, existsSync, rmSync } from "node:fs";
14
+ import { fileURLToPath } from "node:url";
15
+ import { dirname, join, resolve } from "node:path";
16
+
17
+ const __dirname = dirname(fileURLToPath(import.meta.url));
18
+ const root = resolve(__dirname, "..");
19
+ const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
20
+ const version = pkg.version;
21
+ const snapDir = join(root, ".versions", version);
22
+
23
+ // Paths that travel into the snapshot — matches package.json `files` for the
24
+ // installable artifacts. We deliberately skip the meta files (README, LICENSE,
25
+ // CHANGELOG, package.json) — the diff only cares about the artifacts.
26
+ const ARTIFACT_PATHS = [
27
+ "skills",
28
+ "vendor/agent-skills-upstream",
29
+ "agents",
30
+ ".claude/commands",
31
+ ".claude/orchestrate-teams.yaml",
32
+ ".opencode/commands",
33
+ ".opencode/orchestrate-teams.yaml",
34
+ ".pi/prompts",
35
+ ".pi/extensions",
36
+ ".pi/harnesses",
37
+ ".pi/skills",
38
+ ".pi/agents",
39
+ ".pi/damage-control-rules.yaml",
40
+ // scripts/ ships runtime helpers like team-up.ts that the pi harness
41
+ // recipes shell out to. Test files stay out (filtered below) — they're
42
+ // dev-only.
43
+ "scripts",
44
+ // justfile carries the pi harness launch recipes. It is a companion of the
45
+ // harness group in guided-workspace-setup, so the snapshot must hold a
46
+ // per-version copy for the upgrade three-way diff (retired-harness recipes
47
+ // pruned, new-harness recipes added on refresh).
48
+ "justfile",
49
+ "references",
50
+ "hooks",
51
+ ];
52
+
53
+ if (existsSync(snapDir)) {
54
+ console.log(`snapshot: .versions/${version}/ already exists — rebuilding`);
55
+ rmSync(snapDir, { recursive: true, force: true });
56
+ }
57
+
58
+ mkdirSync(snapDir, { recursive: true });
59
+
60
+ // Skip nested node_modules and build artifacts — they bloat the tarball and
61
+ // the user reinstalls them after init.
62
+ const SKIP_NAMES = new Set(["node_modules", ".DS_Store", "dist", "build"]);
63
+
64
+ for (const rel of ARTIFACT_PATHS) {
65
+ const src = join(root, rel);
66
+ if (!existsSync(src)) continue;
67
+ const dest = join(snapDir, rel);
68
+ mkdirSync(dirname(dest), { recursive: true });
69
+ cpSync(src, dest, {
70
+ recursive: true,
71
+ filter: (srcPath) => {
72
+ const base = srcPath.split("/").pop();
73
+ if (SKIP_NAMES.has(base)) return false;
74
+ // Match what the npm `files` allowlist ships — dev-only tests stay out.
75
+ if (
76
+ base.endsWith(".test.mjs") ||
77
+ base.endsWith(".test.js") ||
78
+ base.endsWith(".test.ts") ||
79
+ base.endsWith("-test.sh")
80
+ ) return false;
81
+ return true;
82
+ },
83
+ });
84
+ }
85
+
86
+ // Stamp the snapshot with its version so the skill can verify it loaded the right one.
87
+ const stampPath = join(snapDir, ".version");
88
+ const fs = await import("node:fs/promises");
89
+ await fs.writeFile(stampPath, `${version}\n`, "utf8");
90
+
91
+ console.log(`snapshot: wrote .versions/${version}/`);
@@ -0,0 +1,355 @@
1
+ # Agent Fleet — Project Files
2
+
3
+ agent-fleet keeps up to two small files in a project's `.ai/` directory. They
4
+ have different readers and different lifetimes, so they are kept separate.
5
+
6
+ | File | Read by | When |
7
+ |------|---------|------|
8
+ | `.ai/agent-fleet-overrides.md` | `spec-driven-development`, `planning-and-task-breakdown`, `browser-testing-with-devtools`, `git-workflow-and-versioning`, `compound-learning` (the `rules:`/`docs:` keys of `## agent-hub`), `agent-hub` pi harness | Every run of those skills / every session start of the harness |
9
+ | `.ai/agent-fleet-setup.md` | `guided-workspace-setup` | Only when setup is run or re-run |
10
+ | `.ai/stt.json` *(optional)* | `pi-voice-stt` extension | Every pi session start, when the extension is installed |
11
+
12
+ The `.ai/stt.json` file is present only when the optional `pi-voice-stt` voice-dictation
13
+ extension has been configured (by guided setup or by hand). Like the overrides file it holds
14
+ **no secrets** — it names the env vars (`apiKeyEnv`, plus the Azure endpoint var) whose values
15
+ live in a gitignored root `.env`. See [pi-voice-stt config](#ai-sttjson) below.
16
+
17
+ Keep them split: the overrides file is loaded into context constantly, so it
18
+ must stay minimal; the install record is consulted rarely, so it can be large.
19
+
20
+ ## The overrides file — `.ai/agent-fleet-overrides.md`
21
+
22
+ Some skills and pi harnesses need facts specific to each project — where specs
23
+ and plans are saved, how to start a dev server, whether the agent may create
24
+ branches, or which user-facing language a dispatcher should use. Each reader
25
+ ships a sensible **default**; a project that needs something different declares
26
+ it here, and the reader picks it up.
27
+
28
+ - **Location:** `.ai/agent-fleet-overrides.md` at the project root.
29
+ - **Format:** Markdown. One `## <section-name>` section per skill or harness reader, with terse
30
+ `key: value` lines. Block values use the `key: |` multi-line form. No prose
31
+ and no install detail — readers parse it by key and load it on every run/session start.
32
+ - **Commit it.** Shared project configuration belongs in version control. Make
33
+ sure no `.gitignore` rule (for example a broad `.env*` pattern) excludes it.
34
+ - **No secrets.** For anything sensitive (test-account credentials), reference
35
+ the **name** of an environment variable; the real value lives in a gitignored
36
+ `.env`.
37
+ - If the file is absent, or a reader has no section in it, that reader uses its
38
+ built-in default.
39
+ - **Validation.** Because an unknown section or key silently falls back to the
40
+ default, typos are invisible at runtime. `agent-fleet doctor` (and the
41
+ `/doctor-agent-fleet` command) validates the file — unknown sections,
42
+ unknown keys in known sections, invalid values for the mechanically parsed
43
+ `agent-hub` keys, missing `rules:` folders, and unset `## env` vars — as
44
+ **advisory, warn-only findings**; it never edits the file.
45
+
46
+ ### `spec-driven-development`
47
+
48
+ | Key | Default | Meaning |
49
+ |-----|---------|---------|
50
+ | `spec-dir` | `docs/prds/{area}` | Directory specs are written to |
51
+ | `naming` | `PRD{n}-{topic}` | File name pattern; `{n}` = next free PRD number, `{topic}` = kebab-case slug |
52
+
53
+ Default output: `docs/prds/{area}/PRD{n}-{topic}.md`.
54
+
55
+ ### `planning-and-task-breakdown`
56
+
57
+ | Key | Default | Meaning |
58
+ |-----|---------|---------|
59
+ | `plan-dir` | `docs/plans/{area}` | Directory plans are written to |
60
+ | `naming` | `PLAN-{prd-name}-{phase}` | File name pattern; `{phase}` suffix only when a plan spans multiple files |
61
+ | `todo` | `embedded` | `embedded` keeps the task list inside the plan; `separate` writes a standalone `todo.md` |
62
+
63
+ Default output: `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, task list embedded.
64
+
65
+ ### `browser-testing-with-devtools`
66
+
67
+ This skill has **no default** — the section is required for browser testing,
68
+ because dev-server commands and login flows cannot be guessed.
69
+
70
+ | Key | Meaning |
71
+ |-----|---------|
72
+ | `dev-server` | Command to start the local dev server |
73
+ | `ready-check` | How to confirm the server is up |
74
+ | `base-url` | Root URL for navigation |
75
+ | `auth-flow` | Steps to log in (multi-line `|` block) |
76
+ | `roles` | Test account per privilege level, referenced by env-var name |
77
+ | `notes` | Anything else the agent should know (certs, seed data, ...) |
78
+
79
+ ### `git-workflow-and-versioning`
80
+
81
+ | Key | Default | Meaning |
82
+ |-----|---------|---------|
83
+ | `branching` | `never` | `never` = agent works in the current branch and never creates or switches branches; `allow` = agent may create feature branches |
84
+
85
+ ### `agent-hub`
86
+
87
+ Read by the `.pi/harnesses/agent-hub/` pi harness on every session start. The canonical
88
+ section name is `## agent-hub`; the harness also accepts the legacy `## agent-team` name
89
+ (from before the standalone `agent-team` harness was retired), so existing project
90
+ override files keep working unchanged. When both sections are present their keys merge,
91
+ with later lines winning.
92
+
93
+ The `rules:` and `docs:` keys are also read outside the harness: the `compound-learning`
94
+ skill (and the `/compound` claude-code/opencode commands built on it) resolves them as the
95
+ targets an end-of-session compound pass writes lessons to.
96
+
97
+ | Key | Default | Meaning |
98
+ |-----|---------|---------|
99
+ | `language` | `English` | User-facing language the dispatcher uses for every `ask_user` question, every `context` field, and every summary. Specialist task strings always stay in English regardless. |
100
+ | `persona-gate` | `off` | When `on`, blocks input at session start until an orchestrator persona is picked. |
101
+ | `model.<persona>` | persona frontmatter `model:` | Replaces the named persona's default model for this project (a full pi model spec). |
102
+ | `models.<persona>` | persona frontmatter `models:` | Replaces the named persona's model-candidate list for `/agent-model` and `/models` profiles (comma-separated pi model specs). |
103
+ | `thinking.<persona>` | persona frontmatter `thinking:` | Replaces the named persona's pi `--thinking` reasoning level for this project: one of `off`, `minimal`, `low`, `medium`, `high`, `xhigh`. Switchable at runtime with `/agent-model-thinking <persona>`. An invalid value is ignored with a session-start warning. |
104
+ | `subagents.<persona>.<role>` | persona frontmatter `subagents:` | Replaces or adds one delegate sub-role for this project: `<model>[, tools=<caps>]`. Other declared roles keep their frontmatter values. |
105
+ | `delegate-depth.<persona>` | persona frontmatter `delegate_depth:` (default/max 1) | Replaces the persona's delegation depth budget: `0` makes its delegate tool refuse (delegation off for this project), `1` lets it spawn terminal children. Values above 1 are clamped to 1; children at remaining depth 0 do not receive delegate tooling. |
106
+ | `rules` | none | Comma-separated repo-relative folders holding the project's own rule files (HOW — implementation patterns the work must comply with). Resolution is **index-first**: when a folder has a top-level `README.md`/`index.md`, personas read it first and follow its loading manifest (session bundles, conditional-load lists) instead of bulk-reading the tree; a folder without an index is searched **recursively** through all subfolders. The harness tells every dispatched specialist where the rules live and how to resolve them; the planner and code-reviewer personas read the relevant rules, validate their subject against them, and pass them on (cited in plan acceptance criteria / handed to delegate sub-reviewers). Missing folders produce a session-start warning. |
107
+ | `docs` | none | Comma-separated repo-relative documentation **entry points** (WHAT/WHY — architecture, standards, decisions): canonical files (e.g. `Docs/AGENTS.md`) or doc folders (personas start from a folder's `README.md`/index). Unlike `rules`, docs orient rather than bind: every dispatched specialist and research helper is told to read the entry points relevant to its task and follow their links instead of bulk-reading doc trees; the code-reviewer flags changes that alter documented behavior without a doc update; the documenter treats the entry points and the trees they link as the docs it maintains. Missing paths produce a session-start warning. |
108
+
109
+ Example — switch the dispatcher to Bulgarian, pin the builder to sonnet, raise the
110
+ code-reviewer's thinking level, move the code-reviewer's docs sub-reviewer to a
111
+ different model, and point the team at the project's rule folders and doc entry
112
+ points:
113
+
114
+ ```markdown
115
+ ## agent-hub
116
+ language: Bulgarian
117
+ model.builder: github-copilot/claude-sonnet-4.6
118
+ models.builder: github-copilot/claude-sonnet-4.6, github-copilot/claude-haiku-4.5
119
+ thinking.code-reviewer: xhigh
120
+ subagents.code-reviewer.docs: github-copilot/claude-sonnet-4.6, tools=read,grep
121
+ delegate-depth.code-reviewer: 1
122
+ rules: docs/rules, .ai/rules
123
+ docs: Docs/AGENTS.md, Docs/architecture/ARCHITECTURE_OVERVIEW.md
124
+ ```
125
+
126
+ ### `env` (optional, read by the doctor)
127
+
128
+ The overrides file references environment variables by **name** — test-account
129
+ credentials for `browser-testing-with-devtools`, the `pi-voice-stt` API key —
130
+ while the values live in a gitignored root `.env`. The optional `## env`
131
+ section declares which names the project's readers expect, so a fresh clone
132
+ can find out what's missing *before* a skill fails mid-run:
133
+
134
+ | Key | Meaning |
135
+ |-----|---------|
136
+ | `required` | Comma-separated env-var **names** (never values) the project's sections reference |
137
+
138
+ ```markdown
139
+ ## env
140
+ required: APP_TEST_ADMIN_USER, APP_TEST_ADMIN_PASS, AZURE_SPEECH_KEY
141
+ ```
142
+
143
+ No skill or harness loads this section. Its only reader is `agent-fleet doctor`
144
+ (and `/doctor-agent-fleet`), which warns when a declared name is neither set in
145
+ the environment nor declared in the workspace root `.env`.
146
+
147
+ ### Per-peer env files (`env_file:` in peers.yaml)
148
+
149
+ Fleet peers spawned by `just team-up` / `just hub-team` can carry their own
150
+ environment: an `env_file:` entry in `.pi/agents/peers.yaml` names a
151
+ **repo-relative** KEY=VALUE file (same format as `.env`, no shell evaluation)
152
+ that herdr injects into the peer's pane before the command runs — no `source`,
153
+ no leaking into sibling panes. The file must exist at spawn (team-up refuses
154
+ otherwise, never mid-run), and its **values never appear in `--dry-run`
155
+ output** — only the path. Keep these files gitignored exactly like the root
156
+ `.env` this section describes.
157
+
158
+ ## The setup file — `.ai/agent-fleet-setup.md`
159
+
160
+ The `guided-workspace-setup` skill writes this file to record what it installed
161
+ into the project — which skills, commands, personas, and extensions, by what
162
+ method, and when. It reads the file on a re-run to add, update, or remove
163
+ artifacts without reinstalling everything. No other skill loads it.
164
+
165
+ | Section | Meaning |
166
+ |---------|---------|
167
+ | `workspace-summary` | Workspace path, coding agent, **agent-fleet version**, project shape, checks discovered |
168
+ | `install-status` | Installed artifacts, their targets, and the method (`copy` or `symlink`) |
169
+ | `doctor-runs` | One line per doctor pass (preflight / postflight, repaired / deleted / skipped counts) |
170
+ | `verification` | Checks confirming the install |
171
+
172
+ ### The `version:` line
173
+
174
+ `workspace-summary` carries a `version:` line set to the package version that
175
+ performed the install (e.g. `version: 1.4.2`). It drives the version-aware
176
+ update flow — on every re-run, `guided-workspace-setup` compares this against
177
+ the current package version and:
178
+
179
+ 1. Reads `CHANGELOG.md` between the two versions.
180
+ 2. For each installed artifact, runs a three-way diff between
181
+ *source@recorded*, the installed copy on disk, and *source@current*.
182
+ 3. Surfaces the result in the install menu using these `Status` values:
183
+
184
+ | Status | Meaning |
185
+ |---|---|
186
+ | `installed · upgrade available` | Source changed upstream; user copy still matches the old source → clean refresh |
187
+ | `installed · conflicting upgrade` | Source changed upstream AND user modified the copy → menu shows the three-way diff before overwriting |
188
+ | `installed · removed upstream` | Artifact gone in the new version → menu proposes deletion (subject to the removal-scope rule) |
189
+ | `not installed · new in this version` | New artifact added in the new version → menu offers it, marked `★` if recommended |
190
+
191
+ The diff sources at *source@recorded* are read from the package's
192
+ `.versions/<x.y.z>/` snapshot tree, which the release pipeline writes for every
193
+ published version. If the snapshot is missing (e.g. an unpublished local
194
+ build), the skill falls back to "treat installed copy as canonical" and
195
+ prompts for an explicit baseline.
196
+
197
+ ### Pre-versioning workspaces
198
+
199
+ A workspace whose `agent-fleet-setup.md` predates the `version:` line is
200
+ treated as "pre-versioning". On first re-run, `guided-workspace-setup` prompts
201
+ for a clean baseline: either accept the installed artifacts as matching the
202
+ current source (stamp the current version), or re-run the install from scratch.
203
+
204
+ Commit this file if the team should share install state — keep paths relative
205
+ so it stays portable. A self-referencing checkout (agent-fleet itself) may
206
+ instead `.gitignore` it, since its recorded paths are local to one machine.
207
+
208
+ ## The `/orchestrate` command and its team config
209
+
210
+ `/orchestrate` turns the main session (Claude Code) or primary agent (OpenCode)
211
+ into an **orchestrator** that drives a config-defined team of installed
212
+ subagents — subagents cannot nest, so all dispatching is the main session's job.
213
+ The default team is `planner` + `builder` (no reviewer); the orchestrator routes
214
+ the team as a **runtime roster, not a fixed `researcher → planner → builder`
215
+ pipeline** — it skips planning when a plan already exists, re-runs `researcher`
216
+ at any point, and loops back to `planner` when the build surfaces a wrong plan.
217
+ It honours the existing subagent handoff markers: `PLAN_FILE: <path>` from the
218
+ planner, and `NEEDS_RESEARCH: <question>` from planner/builder (which dispatches a
219
+ read-only `researcher` and resumes the paused persona with the findings inlined).
220
+
221
+ The named teams live in a per-agent config that mirrors pi's
222
+ `.pi/agents/teams.yaml` (a map of team-name → ordered persona list, first key =
223
+ default; `researcher`/`deep-researcher` deliberately unlisted but always
224
+ available). The reader differs by runtime: pi's harness parses its YAML, while
225
+ `/orchestrate` has the **command's instructions** read the YAML via the Read tool
226
+ (no harness runtime in claude-code/opencode):
227
+
228
+ | | Config file | Command |
229
+ |---|---|---|
230
+ | claude-code | `.claude/orchestrate-teams.yaml` | `/orchestrate` |
231
+ | opencode | `.opencode/orchestrate-teams.yaml` | `/af-orchestrate` |
232
+ | pi | `.pi/agents/teams.yaml` | via the `agent-hub` harness (no `/orchestrate`) |
233
+
234
+ Switch teams at runtime with `/orchestrate <team> "<task>"` (parallel of pi's
235
+ `/agents-team`); use `/orchestrate team=<name> <task>` to disambiguate when the
236
+ task text starts with a word that collides with a team key.
237
+
238
+ **Guided-setup behaviour.** `guided-workspace-setup` offers `/orchestrate`
239
+ **`★`-recommended** for claude-code + opencode (hidden for pi via the existing
240
+ source-availability filter — there is no `.pi/prompts/orchestrate.md`), and
241
+ installs the agent's `orchestrate-teams.yaml` as a **companion** of the command
242
+ (a user-edited config is preserved on uninstall, never silently clobbered).
243
+ Two artifacts stay **claude-only**: the lifecycle **hooks** (they register into
244
+ `.claude/settings.json`, which opencode/pi have no install path for) and the
245
+ **`AskUserQuestion` questionnaire menu mode** (the primary menu interaction on
246
+ claude-code). The orchestrate command and its team config are *not* claude-only —
247
+ they ship for opencode too.
248
+
249
+ ## Templates
250
+
251
+ ### `.ai/agent-fleet-overrides.md`
252
+
253
+ Copy this in and delete the sections you don't need — anything absent falls
254
+ back to that reader's default.
255
+
256
+ ```markdown
257
+ # Agent Fleet — Project Overrides
258
+ #
259
+ # Each section is applied ON TOP of the skill's built-in defaults.
260
+ # Keys not listed keep the default. Absent file/section → pure defaults.
261
+
262
+ ## spec-driven-development
263
+ spec-dir: docs/prds/{area}
264
+ naming: PRD{n}-{topic}
265
+
266
+ ## planning-and-task-breakdown
267
+ plan-dir: docs/plans/{area}
268
+ naming: PLAN-{prd-name}-{phase}
269
+ todo: embedded
270
+
271
+ ## browser-testing-with-devtools
272
+ dev-server: <command to start the local dev server>
273
+ ready-check: <url or check that confirms the server is up>
274
+ base-url: <root url>
275
+ auth-flow: |
276
+ 1. Navigate to <login url>
277
+ 2. Submit credentials for the role needed by the screen under test
278
+ roles:
279
+ admin: env APP_TEST_ADMIN_USER / APP_TEST_ADMIN_PASS
280
+ player: env APP_TEST_PLAYER_USER / APP_TEST_PLAYER_PASS
281
+ notes: |
282
+ <anything else: self-signed certs, required seed data, ...>
283
+
284
+ ## git-workflow-and-versioning
285
+ branching: never
286
+
287
+ # Optional for pi agent-hub; omit this section to keep default English.
288
+ # (`## agent-team` is still accepted as a legacy alias for this section.)
289
+ ## agent-hub
290
+ language: <language name>
291
+ rules: <repo-relative rule folder>[, <another folder>]
292
+ docs: <repo-relative doc entry point>[, <another file or folder>]
293
+
294
+ # Optional; names (never values) of env vars the sections above reference.
295
+ # Only `agent-fleet doctor` reads this — it warns when one is unset.
296
+ ## env
297
+ required: <ENV_VAR_NAME>[, <ANOTHER_NAME>]
298
+ ```
299
+
300
+ ### `.ai/agent-fleet-setup.md`
301
+
302
+ Written and maintained by `guided-workspace-setup`; shown here for reference.
303
+
304
+ ```markdown
305
+ # Agent Fleet — Workspace Setup
306
+ #
307
+ # Maintained by the guided-workspace-setup skill.
308
+
309
+ ## workspace-summary
310
+ agent: claude-code
311
+ method: copy
312
+ version: 1.4.2
313
+ shape: <one line on the project shape>
314
+
315
+ ## install-status
316
+ skills: [spec-driven-development, test-driven-development, code-review-and-quality]
317
+ commands: [spec, plan, build]
318
+ personas: [code-reviewer]
319
+ extensions: []
320
+ harnesses: []
321
+ harness-support: [] # justfile (managed region) + scripts/agents companions; tracked when any harness is installed
322
+ updated: 2026-05-22
323
+
324
+ ## verification
325
+ - Every recorded artifact exists at its target path.
326
+ - No secrets are stored in this file.
327
+ ```
328
+
329
+ ### `.ai/stt.json`
330
+
331
+ Optional. Present only when the `pi-voice-stt` extension is installed and configured. Read by
332
+ the extension on every pi session start, ahead of the global `~/.pi/agent/stt.json`. Holds the
333
+ non-secret provider config; the API key (and Azure endpoint) live in a gitignored root `.env`
334
+ as named env vars, which the `justfile`'s `dotenv-load` exposes to the session.
335
+
336
+ ```json
337
+ {
338
+ "language": "bg-BG",
339
+ "provider": {
340
+ "type": "azure",
341
+ "apiKeyEnv": "AZURE_SPEECH_KEY",
342
+ "locales": ["bg-BG", "en-US"]
343
+ }
344
+ }
345
+ ```
346
+
347
+ Corresponding gitignored `.env` at the repo root:
348
+
349
+ ```sh
350
+ AZURE_SPEECH_ENDPOINT=https://<resource>.cognitiveservices.azure.com
351
+ AZURE_SPEECH_KEY=<your-resource-key>
352
+ ```
353
+
354
+ For the OpenAI-compatible backend, `provider.type` is `openai` with `baseUrl` / `model` and an
355
+ `OPENAI_API_KEY` env var instead. Full schema: [.pi/extensions/pi-voice-stt/README.md](../.pi/extensions/pi-voice-stt/README.md).
@@ -0,0 +1,93 @@
1
+ # Claude Code as a coms peer — the bridge
2
+
3
+ Makes an interactive Claude Code (terminal CLI) a **first-class, bidirectional peer** in
4
+ the local coms pool: pi agents reach it with plain `coms_send`/`coms_await`, and Claude
5
+ Code itself asks pi peers questions mid-task via `coms-cli`. Requires a running
6
+ [herdr](https://herdr.dev) server (the bridge drives the Claude pane through herdr's
7
+ socket API).
8
+
9
+ ```
10
+ pi hub ── coms envelope ──▶ coms-claude-bridge ── pane.send_text ──▶ Claude Code (pane)
11
+ pi hub ◀── response ─────── coms-claude-bridge ◀── Stop hook file ─── (turn ends)
12
+ Claude Code ── Bash: coms-cli send/await ──▶ any pi peer (outbound asks)
13
+ ```
14
+
15
+ ## Pieces
16
+
17
+ | Piece | File | Role |
18
+ |---|---|---|
19
+ | Bridge daemon | `scripts/coms-claude-bridge.ts` | One per Claude pane. Registers coms peer `<name>`, serializes inbound prompts, types them into the pane (+ Enter separately — TUI quirk), captures the reply, sends the response envelope. |
20
+ | Envelope CLI | `scripts/coms-cli.ts` | `list` / `send` / `await` / `reply` — any process becomes a coms participant. `send --await` is a blocking round trip; plain `send` prints a `msg_id` and a detached waiter holds the reply for `await`. |
21
+ | Stop hook | `hooks/coms-stop-hook.mjs` | PRIMARY completion path: writes each turn's final assistant message to `~/.pi/coms/claude-bridge/<pane>/last-message.json` (keyed by `HERDR_PANE_ID`). Exact text, no scraping. |
22
+ | Skill | `skills/peer-coms/SKILL.md` | Teaches Claude Code its peer role: discover with `coms-cli list`, ask with `send --await`, answer inbound prompts normally, never drive panes itself. |
23
+ | Runner | `runner: claude-code` in `.pi/agents/peers.yaml` | `just team-up` spawns the Claude CLI + its bridge in one pane (`_claude-peer` recipe); `model:` maps to `claude --model`, team-resume maps the herdr-captured session id to `claude --resume`. |
24
+
25
+ ## Setup
26
+
27
+ 1. **Hook (recommended):** add to the project's (or user's) Claude Code `settings.json`:
28
+
29
+ ```json
30
+ {
31
+ "hooks": {
32
+ "Stop": [{ "hooks": [{ "type": "command",
33
+ "command": "node /path/to/agent-fleet/hooks/coms-stop-hook.mjs" }] }]
34
+ }
35
+ }
36
+ ```
37
+
38
+ Without the hook the bridge falls back to asking Claude for a
39
+ `<<COMS_DONE:msg_id>>` sentinel and scraping the pane — it works, but replies can
40
+ carry TUI noise (tool-status lines). The hook returns exact text.
41
+
42
+ 2. **Skill:** install `peer-coms` via the normal per-agent flow so Claude Code knows it
43
+ is a peer and how to use `coms-cli`.
44
+
45
+ 3. **Spawn:** either add a `runner: claude-code` peer to a peers.yaml team and
46
+ `just team-up <team>`, or attach a bridge to an existing herdr Claude pane:
47
+
48
+ ```bash
49
+ node --experimental-strip-types scripts/coms-claude-bridge.ts --name claude-main
50
+ # (inside the pane: HERDR_PANE_ID is inherited; or pass --pane <id>)
51
+ ```
52
+
53
+ ## Demo scenario (verified live)
54
+
55
+ ```bash
56
+ just team-up docs # pi peers up
57
+ # pane with: bridge (claude-main) + claude
58
+ just hub # in another pane: the orchestrator
59
+ # from the hub (or any shell):
60
+ node --experimental-strip-types scripts/coms-cli.ts send claude-main \
61
+ "Summarize the failing test output in artifacts/test.log" --await --timeout 300000
62
+ ```
63
+
64
+ And the reverse — Claude Code, mid-task, asking a pi peer:
65
+
66
+ ```bash
67
+ node --experimental-strip-types scripts/coms-cli.ts send researcher \
68
+ "Where is the retry logic for webhooks? file:line" --await --timeout 300000
69
+ ```
70
+
71
+ ## Serving team dispatches (coms-backed dispatch)
72
+
73
+ A bridge peer that shares a name with an agent-hub team member (e.g. `code-reviewer`,
74
+ `plan-reviewer` in the shipped `peers.yaml`) can serve that member's `dispatch_agent`
75
+ calls transparently: `.pi/agents/dispatch-policy.yaml` marks the member `prefer: coms`,
76
+ and the hub routes the dispatch to the live peer instead of spawning a native subagent —
77
+ same return contract, ASK_USER handling, and history. The standing Claude session keeps
78
+ its context across review rounds, which is the point for code/plan review. See
79
+ "Coms-backed dispatch" in `.pi/harnesses/agent-hub/README.md`.
80
+
81
+ ## Behavior notes
82
+
83
+ - **Serialization:** one prompt at a time per pane; queue depth shows in the peer's
84
+ agent card and the herdr sidebar (`<name> q<depth>`).
85
+ - **Blocked panes:** a Claude waiting on a permission prompt returns a readable error
86
+ envelope ("blocked on a permission prompt — a human must approve it") instead of
87
+ hanging until timeout.
88
+ - **Busy panes:** a prompt arriving while Claude is mid-turn errors immediately
89
+ ("mid-turn — try again shortly") rather than typing into a running turn.
90
+ - **Restarts:** the bridge is bound to the pane id, not the Claude process — restart
91
+ Claude in the pane and the bridge keeps working.
92
+ - **Fleet safety:** the bridge and skill never create or close panes; herdr driving
93
+ stays with the orchestrator (see `.pi/damage-control-rules.yaml`).