@chankov/agent-fleet 0.0.5 → 0.0.6

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 (314) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +10 -10
  3. package/.pi/extensions/btw/index.ts +11 -11
  4. package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
  5. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  6. package/.pi/extensions/compact-and-continue/README.md +2 -2
  7. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  8. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  9. package/.pi/harnesses/agent-hub/README.md +58 -58
  10. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  11. package/.pi/harnesses/agent-hub/delegate.ts +3 -3
  12. package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
  13. package/.pi/harnesses/agent-hub/index.ts +248 -248
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/run-budget.js +1 -1
  16. package/.pi/harnesses/coms/README.md +2 -2
  17. package/.pi/harnesses/coms/index.ts +13 -13
  18. package/.pi/harnesses/coms/package.json +1 -1
  19. package/.pi/harnesses/damage-control-continue/README.md +9 -9
  20. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  21. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  22. package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
  23. package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
  24. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  25. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  26. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  27. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  28. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  29. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  30. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  31. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  32. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  33. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  34. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  35. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  36. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  37. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  38. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  39. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  40. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  41. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  42. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  43. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  44. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  45. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  46. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  47. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  48. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  49. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  50. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  51. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  52. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  53. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  54. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  55. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  56. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  57. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  58. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  59. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  60. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  61. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  62. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  63. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  64. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  65. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  66. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  67. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  68. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  69. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  70. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  71. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  72. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  73. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  74. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  75. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  76. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  77. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  78. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  79. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  80. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  81. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  82. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  83. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  84. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  85. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  86. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  87. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  88. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  89. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  90. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  91. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  92. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  93. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  94. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  95. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  96. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  97. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  98. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  99. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  100. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  101. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  102. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  103. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  104. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  105. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  106. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  107. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  108. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  109. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  110. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  111. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  112. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  113. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  114. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  115. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  116. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  117. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  118. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  119. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  120. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  121. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  122. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  123. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  124. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  125. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  126. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  127. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  128. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  129. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  130. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  131. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  132. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  133. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  134. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  135. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  136. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  137. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  138. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  139. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  140. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  141. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  142. package/.versions/0.0.6/.version +1 -0
  143. package/.versions/0.0.6/agents/architect.md +23 -0
  144. package/.versions/0.0.6/agents/bowser.md +26 -0
  145. package/.versions/0.0.6/agents/builder.md +53 -0
  146. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  147. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  148. package/.versions/0.0.6/agents/documenter.md +18 -0
  149. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  150. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  151. package/.versions/0.0.6/agents/planner.md +69 -0
  152. package/.versions/0.0.6/agents/releaser.md +24 -0
  153. package/.versions/0.0.6/agents/researcher.md +28 -0
  154. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  155. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  156. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  157. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  158. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  159. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  160. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  161. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  162. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  163. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  164. package/.versions/0.0.6/docs/getting-started.md +183 -0
  165. package/.versions/0.0.6/docs/npm-install.md +337 -0
  166. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  167. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  168. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  169. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  170. package/.versions/0.0.6/hermes/README.md +231 -0
  171. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  172. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  173. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  174. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  175. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  176. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  177. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  178. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  179. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  180. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  181. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  182. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  183. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  184. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  185. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  186. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  187. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  188. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  189. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  190. package/.versions/0.0.6/hooks/hooks.json +14 -0
  191. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  192. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  193. package/.versions/0.0.6/justfile +245 -0
  194. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  195. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  196. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  197. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  198. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  199. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  200. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  201. package/.versions/0.0.6/references/security-checklist.md +179 -0
  202. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  203. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  204. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  205. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  206. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  207. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  208. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  209. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  210. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  211. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  212. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  213. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  214. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  215. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  216. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  217. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  218. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  219. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  220. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  221. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  222. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  223. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  224. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  225. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  226. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  227. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  228. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  229. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  230. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  231. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  232. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  233. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  234. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  235. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  236. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  237. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  238. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  239. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  240. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  241. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  242. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  243. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  244. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  245. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  246. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  247. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  248. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  249. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  250. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  251. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  252. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  253. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  254. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  255. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  256. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  257. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  258. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  259. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  260. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  261. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  262. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  263. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  264. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  265. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  266. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  267. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  268. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  269. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  270. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  271. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  272. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  273. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  274. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  275. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  276. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  277. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  278. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  279. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  280. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  281. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  282. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  283. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  284. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  285. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  286. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  287. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  288. package/CHANGELOG.md +6 -0
  289. package/README.md +24 -23
  290. package/agents/documenter.md +1 -1
  291. package/agents/releaser.md +1 -1
  292. package/bin/cli.js +20 -20
  293. package/bin/lib/bootstrap.js +16 -16
  294. package/bin/lib/doctor.js +1 -1
  295. package/docs/ARCHITECTURE.md +4 -4
  296. package/docs/agent-fleet-setup.md +11 -11
  297. package/docs/coms-hermes-bridge.md +8 -8
  298. package/docs/npm-install.md +21 -21
  299. package/docs/pi-extensions.md +7 -7
  300. package/docs/pi-setup.md +51 -47
  301. package/hermes/README.md +1 -1
  302. package/package.json +1 -1
  303. package/references/fleet-coordination-patterns.md +2 -2
  304. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  305. package/skills/compound-learning/SKILL.md +3 -3
  306. package/skills/guided-workspace-setup/SKILL.md +16 -14
  307. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  308. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  309. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  310. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  311. /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
  312. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  313. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  314. /package/.pi/prompts/{test.md → af-test.md} +0 -0
@@ -0,0 +1,191 @@
1
+ ---
2
+ name: using-agent-skills
3
+ description: Discovers and invokes agent skills. Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
4
+ ---
5
+
6
+ # Using Agent Skills
7
+
8
+ ## Overview
9
+
10
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
11
+
12
+ ## Skill Discovery
13
+
14
+ When a task arrives, identify the development phase and apply the corresponding skill:
15
+
16
+ ```
17
+ Task arrives
18
+ │
19
+ ├── Don't know what you want yet? ──────→ interview-me
20
+ ├── Have a rough concept, need variants? → idea-refine
21
+ ├── New project/feature/change? ──→ spec-driven-development
22
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
23
+ ├── Implementing code? ────────────→ incremental-implementation
24
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
25
+ │ ├── API work? ────────────────→ api-and-interface-design
26
+ │ ├── Need better context? ─────→ context-engineering
27
+ │ ├── Need doc-verified code? ───→ source-driven-development
28
+ │ └── Stakes high / unfamiliar code? ──→ doubt-driven-development
29
+ ├── Writing/running tests? ────────→ test-driven-development
30
+ │ └── Browser-based? ───────────→ browser-testing-with-devtools
31
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
32
+ ├── Reviewing code? ───────────────→ code-review-and-quality
33
+ │ ├── Too complex? ─────────────→ code-simplification
34
+ │ ├── Security concerns? ───────→ security-and-hardening
35
+ │ └── Performance concerns? ────→ performance-optimization
36
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
37
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
38
+ ├── Deprecating/migrating? ────────→ deprecation-and-migration
39
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
40
+ ├── Adding logs/metrics/alerts? ───→ observability-and-instrumentation
41
+ └── Deploying/launching? ─────────→ shipping-and-launch
42
+ ```
43
+
44
+ ## Core Operating Behaviors
45
+
46
+ These behaviors apply at all times, across all skills. They are non-negotiable.
47
+
48
+ ### 1. Surface Assumptions
49
+
50
+ Before implementing anything non-trivial, explicitly state your assumptions:
51
+
52
+ ```
53
+ ASSUMPTIONS I'M MAKING:
54
+ 1. [assumption about requirements]
55
+ 2. [assumption about architecture]
56
+ 3. [assumption about scope]
57
+ → Correct me now or I'll proceed with these.
58
+ ```
59
+
60
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
61
+
62
+ ### 2. Manage Confusion Actively
63
+
64
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
65
+
66
+ 1. **STOP.** Do not proceed with a guess.
67
+ 2. Name the specific confusion.
68
+ 3. Present the tradeoff or ask the clarifying question.
69
+ 4. Wait for resolution before continuing.
70
+
71
+ **Bad:** Silently picking one interpretation and hoping it's right.
72
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
73
+
74
+ ### 3. Push Back When Warranted
75
+
76
+ You are not a yes-machine. When an approach has clear problems:
77
+
78
+ - Point out the issue directly
79
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
80
+ - Propose an alternative
81
+ - Accept the human's decision if they override with full information
82
+
83
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
84
+
85
+ ### 4. Enforce Simplicity
86
+
87
+ Your natural tendency is to overcomplicate. Actively resist it.
88
+
89
+ Before finishing any implementation, ask:
90
+ - Can this be done in fewer lines?
91
+ - Are these abstractions earning their complexity?
92
+ - Would a staff engineer look at this and say "why didn't you just..."?
93
+
94
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
95
+
96
+ ### 5. Maintain Scope Discipline
97
+
98
+ Touch only what you're asked to touch.
99
+
100
+ Do NOT:
101
+ - Remove comments you don't understand
102
+ - "Clean up" code orthogonal to the task
103
+ - Refactor adjacent systems as a side effect
104
+ - Delete code that seems unused without explicit approval
105
+ - Add features not in the spec because they "seem useful"
106
+
107
+ Your job is surgical precision, not unsolicited renovation.
108
+
109
+ ### 6. Verify, Don't Assume
110
+
111
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
112
+
113
+ Per-skill verification is the local check. The project-wide bar that applies to *every* change, regardless of which skill is active, is the Definition of Done: tests pass, no regressions, behavior verified at runtime, docs updated. See `references/definition-of-done.md`. It complements each task's acceptance criteria rather than replacing them.
114
+
115
+ ## Failure Modes to Avoid
116
+
117
+ These are the subtle errors that look like productivity but create problems:
118
+
119
+ 1. Making wrong assumptions without checking
120
+ 2. Not managing your own confusion — plowing ahead when lost
121
+ 3. Not surfacing inconsistencies you notice
122
+ 4. Not presenting tradeoffs on non-obvious decisions
123
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
124
+ 6. Overcomplicating code and APIs
125
+ 7. Modifying code or comments orthogonal to the task
126
+ 8. Removing things you don't fully understand
127
+ 9. Building without a spec because "it's obvious"
128
+ 10. Skipping verification because "it looks right"
129
+
130
+ ## Skill Rules
131
+
132
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
133
+
134
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
135
+
136
+ 3. **Multiple skills can apply.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `code-simplification` → `shipping-and-launch` in sequence.
137
+
138
+ 4. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
139
+
140
+ ## Lifecycle Sequence
141
+
142
+ For a complete feature, the typical skill sequence is:
143
+
144
+ ```
145
+ 1. interview-me → Extract what the user actually wants
146
+ 2. idea-refine → Refine vague ideas
147
+ 3. spec-driven-development → Define what we're building
148
+ 4. planning-and-task-breakdown → Break into verifiable chunks
149
+ 5. context-engineering → Load the right context
150
+ 6. source-driven-development → Verify against official docs
151
+ 7. incremental-implementation → Build slice by slice
152
+ 8. observability-and-instrumentation → Instrument as you build (runs parallel with 7-9, not after)
153
+ 9. doubt-driven-development → Cross-examine non-trivial decisions in-flight
154
+ 10. test-driven-development → Prove each slice works
155
+ 11. code-review-and-quality → Review before merge
156
+ 12. code-simplification → Reduce unnecessary complexity while preserving behavior
157
+ 13. git-workflow-and-versioning → Clean commit history
158
+ 14. documentation-and-adrs → Document decisions
159
+ 15. deprecation-and-migration → Retire old systems and move users safely when needed
160
+ 16. shipping-and-launch → Deploy safely
161
+ ```
162
+
163
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
164
+
165
+ ## Quick Reference
166
+
167
+ | Phase | Skill | One-Line Summary |
168
+ |-------|-------|-----------------|
169
+ | Define | interview-me | Surface what the user actually wants before any plan, spec, or code exists |
170
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
171
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
172
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
173
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
174
+ | Build | source-driven-development | Verify against official docs before implementing |
175
+ | Build | doubt-driven-development | Adversarial fresh-context review of every non-trivial decision |
176
+ | Build | context-engineering | Right context at the right time |
177
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
178
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
179
+ | Verify | test-driven-development | Failing test first, then make it pass |
180
+ | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
181
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
182
+ | Review | code-review-and-quality | Five-axis review with quality gates |
183
+ | Review | code-simplification | Preserve behavior while reducing unnecessary complexity |
184
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
185
+ | Review | performance-optimization | Measure first, optimize only what matters |
186
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
187
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
188
+ | Ship | deprecation-and-migration | Remove old systems and migrate users safely |
189
+ | Ship | documentation-and-adrs | Document the why, not just the what |
190
+ | Ship | observability-and-instrumentation | Structured logs, RED metrics, traces, symptom-based alerts |
191
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Agent Fleet changelog
2
2
 
3
+ ## 0.0.6
4
+
5
+ ### Patch Changes
6
+
7
+ - 9b81430: Namespace every Agent Fleet Pi slash command under `/af-*`, including lifecycle prompt templates, harness controls, utility-extension commands, and installer entrypoints. Pi bootstrap and guided setup migrate owned legacy prompt targets while preserving modified or unowned files.
8
+
3
9
  ## 0.0.5
4
10
 
5
11
  ### Patch Changes
package/README.md CHANGED
@@ -37,7 +37,7 @@ Agent Fleet is a **multi-agent orchestration system for AI coding agents**, buil
37
37
  ```bash
38
38
  pi install -l npm:@chankov/agent-fleet # project-scoped package: skills, prompts, ask-user
39
39
  # then, inside pi:
40
- # /setup-agent-fleet # guided install of harnesses, personas, extensions
40
+ # /af-setup-agent-fleet # guided install of harnesses, personas, extensions
41
41
  # and once set up:
42
42
  just fleet # guarded Pi + STT and core utilities
43
43
  just fleet hub # guarded multi-agent dispatcher
@@ -48,17 +48,18 @@ just fleet team docs # hub + guarded peers in one tiled herdr workspace
48
48
 
49
49
  ```bash
50
50
  npx @chankov/agent-fleet init
51
- # then open your coding agent in this directory and run:
52
- # /setup-agent-fleet
51
+ # then open your coding agent in this directory and run the command it prints:
52
+ # Claude Code: /setup-agent-fleet
53
+ # OpenCode: /af-setup-agent-fleet
53
54
  ```
54
55
 
55
- The CLI detects your coding agent and `/setup-agent-fleet` runs the full guided install — analysing the workspace, showing grouped menus, and confirming everything before writing a single file.
56
+ The CLI detects your coding agent and prints the correct setup command. It runs the full guided install — analysing the workspace, showing grouped menus, and confirming everything before writing a single file.
56
57
 
57
58
  | CLI command | What it does |
58
59
  |---|---|
59
- | `npx @chankov/agent-fleet init` | Materialize the package + hand off to `/setup-agent-fleet` |
60
+ | `npx @chankov/agent-fleet init` | Materialize the package + hand off to the runtime's setup command |
60
61
  | `npx @chankov/agent-fleet doctor` | Scan for broken symlinks and stale persona refs |
61
- | `npx @chankov/agent-fleet update` | Surface the version delta + hand off to `/setup-agent-fleet` for the per-artifact diff |
62
+ | `npx @chankov/agent-fleet update` | Surface the version delta + hand off to the runtime's setup command for the per-artifact diff |
62
63
  | `npx @chankov/agent-fleet transform-persona` | Generate per-agent subagent files from the canonical personas |
63
64
 
64
65
  <details>
@@ -121,7 +122,7 @@ What makes it different is what it **doesn't** put in front of the dispatcher LL
121
122
 
122
123
  ![agent-hub compact view with the btw side-session](docs/assets/agent-hub-compact.png)
123
124
 
124
- Personas don't hardcode one frontier model — each declares a default plus a switch list on a three-tier policy (deep reasoning / workhorse / fast recon), switchable at runtime per persona (`/agent-model`) or fleet-wide (`/models <profile>`). `plan-reviewer` and `code-reviewer` can run as **Claude Code peers** for cross-model review.
125
+ Personas don't hardcode one frontier model — each declares a default plus a switch list on a three-tier policy (deep reasoning / workhorse / fast recon), switchable at runtime per persona (`/af-agent-model`) or fleet-wide (`/af-models <profile>`). `plan-reviewer` and `code-reviewer` can run as **Claude Code peers** for cross-model review.
125
126
 
126
127
  ```bash
127
128
  just fleet hub # guarded dispatcher + research + coms + orchestrator persona
@@ -146,23 +147,23 @@ Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the fu
146
147
  │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
147
148
  │Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
148
149
  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
149
- /spec /plan /build /test /review /ship
150
+ spec plan build test review ship
150
151
  ```
151
152
 
152
- 10 slash commands map to the development lifecycle; each activates the right skills automatically:
153
-
154
- | What you're doing | Command | Key principle |
155
- |-------------------|---------|---------------|
156
- | Define what to build | `/spec` | Spec before code |
157
- | Plan how to build it | `/plan` | Small, atomic tasks |
158
- | Build incrementally | `/build` | One slice at a time (`/build auto` runs the whole plan in one approved pass) |
159
- | Prove it works | `/test` | Tests are proof |
160
- | Review before merge | `/review` | Improve code health |
161
- | Audit web performance | `/webperf` | Measure before you optimize |
162
- | Simplify the code | `/code-simplify` | Clarity over cleverness |
163
- | Ship to production | `/ship` | Faster is safer |
164
- | Orchestrate a team | `/orchestrate` | Main session drives a config-defined subagent roster (claude-code/opencode; pi uses agent-hub) |
165
- | Capture session lessons | `/compound` | Every session improves the next — lessons land as minimal diffs on your rule tree |
153
+ 10 slash commands map to the development lifecycle; each activates the right skills automatically. **Claude Code uses the unprefixed form; Pi and OpenCode use `/af-*`.**
154
+
155
+ | What you're doing | Claude Code | Pi / OpenCode | Key principle |
156
+ |-------------------|-------------|---------------|---------------|
157
+ | Define what to build | `/spec` | `/af-spec` | Spec before code |
158
+ | Plan how to build it | `/plan` | `/af-plan` | Small, atomic tasks |
159
+ | Build incrementally | `/build` | `/af-build` | One slice at a time (`auto` runs the whole plan in one approved pass) |
160
+ | Prove it works | `/test` | `/af-test` | Tests are proof |
161
+ | Review before merge | `/review` | `/af-review` | Improve code health |
162
+ | Audit web performance | `/webperf` | `/af-webperf` *(OpenCode)* | Measure before you optimize |
163
+ | Simplify the code | `/code-simplify` | `/af-code-simplify` | Clarity over cleverness |
164
+ | Ship to production | `/ship` | `/af-ship` | Faster is safer |
165
+ | Orchestrate a team | `/orchestrate` | `/af-orchestrate` *(OpenCode; Pi uses agent-hub)* | Main session drives a config-defined roster |
166
+ | Capture session lessons | `/compound` | `/af-compound` | Every session improves the next |
166
167
 
167
168
  Under the hood are **29 skills** — each a structured workflow with steps, verification gates, and anti-rationalization tables (never vague advice). Skills also activate automatically from what you're doing: designing an API triggers `api-and-interface-design`, building UI triggers `frontend-ui-engineering`.
168
169
 
@@ -183,7 +184,7 @@ Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/ski
183
184
 
184
185
  15 pre-configured specialist personas live in [`agents/`](agents/) — reusable subagent definitions your coding agent delegates work to: `planner`, `plan-reviewer`, `builder`, `code-reviewer`, `test-engineer`, `security-auditor`, `web-performance-auditor`, `documenter`, `architect`, `releaser`, `researcher`, `deep-researcher`, plus the pi-only `bowser`, `web-debugger`, and `orchestrator`.
185
186
 
186
- Each persona is one Markdown file; the canonical format is pi-flavored and `/setup-agent-fleet` transforms it per target agent on install (Claude Code subagents, OpenCode `mode: subagent`, pi as-is). Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub or via `/orchestrate`.
187
+ Each persona is one Markdown file; the canonical format is pi-flavored and the runtime's Agent Fleet setup command transforms it per target agent on install (Claude Code subagents, OpenCode `mode: subagent`, pi as-is). Personas are the *who*, skills are the *how* — each carries a conditional hook to its primary skill, and they compose into teams under the hub or via `/orchestrate`.
187
188
 
188
189
  Full roster, skill hooks, install matrix, and team composition: **[docs/agents.md](docs/agents.md)**.
189
190
 
@@ -14,5 +14,5 @@ You are a documentation agent. Write clear, concise documentation. Update README
14
14
 
15
15
  - Project docs: read `.ai/agent-fleet-overrides.md` if it exists; in its `## agent-hub` (legacy `## agent-team`) section a `docs:` entry (comma-separated repo-relative files or folders) names the project's canonical documentation entry points. Treat those files and the trees they link to as the documentation you maintain: prefer updating existing files over creating new ones, keep indexes and cross-links current, and check the project's `rules:` folders for docs-maintenance rules that govern documentation work before writing.
16
16
  - If `skills/documentation-and-adrs/SKILL.md` exists in the repo, read it before starting and follow its process — including when a decision deserves an ADR and the doc formats it defines.
17
- - If the dispatch is a **compound task** (end-of-session lessons capture into the project's rules/docs — a `/compound` dispatch or any task asking you to turn session findings into durable rules), read `skills/compound-learning/SKILL.md` first and follow it exactly: treat the dispatch brief as candidate lessons rather than conclusions, dedupe against the existing rule tree index-first, land minimal diffs on existing files, and respect its caps and approval gate.
17
+ - If the dispatch is a **compound task** (end-of-session lessons capture into the project's rules/docs — a `/compound` or `/af-compound` dispatch or any task asking you to turn session findings into durable rules), read `skills/compound-learning/SKILL.md` first and follow it exactly: treat the dispatch brief as candidate lessons rather than conclusions, dedupe against the existing rule tree index-first, land minimal diffs on existing files, and respect its caps and approval gate.
18
18
  - If you lack information your own tools cannot answer, do not guess — pause per the research protocol with `NEEDS_RESEARCH: <one specific, self-contained question>` lines (nothing after them); you will be resumed in the same session with findings file paths to read.
@@ -13,7 +13,7 @@ thinking: low
13
13
 
14
14
  # Releaser (coms peer)
15
15
 
16
- You are the release-owner peer, reached over coms and via `/handoff`. When a main agent hands off
16
+ You are the release-owner peer, reached over coms and via Pi's `/af-handoff`. When a main agent hands off
17
17
  a finished change, you take it from "implemented" to "published".
18
18
 
19
19
  - **Run the ship flow.** Add the changeset (correct bump per `CONTRIBUTING.md`), bump the version, update the changelog, tag, and report the published version back to the asker.
package/bin/cli.js CHANGED
@@ -2,9 +2,9 @@
2
2
  // agent-fleet — thin dispatcher into the LLM-driven guided setup.
3
3
  //
4
4
  // Main commands:
5
- // init materialize the package, detect the coding agent, hand off to /setup-agent-fleet
5
+ // init materialize the package, detect the coding agent, hand off to its setup command
6
6
  // doctor deterministic preflight scan (broken symlinks, stale persona refs)
7
- // update refresh the package, then hand off to /setup-agent-fleet for the version-diff
7
+ // update refresh the package, then hand off to the setup workflow for the version-diff
8
8
  // transform-persona generate per-agent subagent files from the canonical agents/*.md
9
9
  // set-hermes-telegram install/inspect the liaison and start/stop its bridge
10
10
  //
@@ -165,10 +165,9 @@ async function cmdInit() {
165
165
  }
166
166
 
167
167
  // Bootstrap the installer artifacts (setup + doctor + the skill they invoke).
168
- // Without this, the agent has no /setup-agent-fleet command to hand off to — the
169
- // /setup-agent-fleet command is itself one of the files this writes. The rest of the
170
- // catalogue (skills, personas, etc.) is the job of /setup-agent-fleet running inside
171
- // the agent; we only drop the plumbing it needs to exist.
168
+ // Without this, the agent has no setup command to hand off to. The command itself
169
+ // is one of the files this writes; the rest of the catalogue (skills, personas,
170
+ // etc.) is the setup workflow's job inside the agent.
172
171
  printSection("Bootstrap installer");
173
172
  const { written, skipped, removed, warnings } = bootstrap({
174
173
  agent,
@@ -256,7 +255,7 @@ async function cmdDoctor() {
256
255
  `\n✓ Doctor finished — repaired ${repaired}, deleted ${deleted}, skipped ${skipped}.`,
257
256
  );
258
257
  console.log(
259
- "Re-run /setup-agent-fleet inside your coding agent if you also want to add or remove artifacts.",
258
+ "Re-run Agent Fleet's setup command inside your coding agent if you also want to add or remove artifacts.",
260
259
  );
261
260
  }
262
261
 
@@ -269,7 +268,7 @@ async function cmdUpdate() {
269
268
 
270
269
  // npm itself does the package upgrade. The CLI's job here is to read the
271
270
  // workspace's install record, surface the version delta, re-install the
272
- // /setup-agent-fleet command, and hand off to the skill for the diff-aware
271
+ // setup command, and hand off to the skill for the diff-aware
273
272
  // refresh.
274
273
  const recordPath = join(workspace, ".ai", "agent-fleet-setup.md");
275
274
  if (!existsSync(recordPath)) {
@@ -285,11 +284,11 @@ async function cmdUpdate() {
285
284
  console.log(`Installed package: v${current}`);
286
285
  console.log();
287
286
 
288
- // Re-bootstrap the installer artifacts so /setup-agent-fleet is present
287
+ // Re-bootstrap the installer artifacts so the runtime's setup command is present
289
288
  // after the update. guided-workspace-setup removes these at the end of a
290
289
  // run by default (Step 10b / cleanupInstaller), so a workspace that has
291
290
  // completed setup once no longer has the command — and `update` used to
292
- // only print "run /setup-agent-fleet" while pointing at a command that no
291
+ // only print a stale setup instruction while pointing at a command that no
293
292
  // longer existed. The marker recovers the agent/method from init time; if
294
293
  // it was cleaned up too, fall back to detection (and prompt if ambiguous).
295
294
  const marker = readBootstrapMarker(workspace);
@@ -324,7 +323,7 @@ async function cmdUpdate() {
324
323
  console.log(` ✗ skipped: ${relative(workspace, f.dest)} — ${f.error}`);
325
324
  }
326
325
 
327
- const setupCmd = agent === "opencode" ? "/af-setup-agent-fleet" : "/setup-agent-fleet";
326
+ const setupCmd = agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
328
327
 
329
328
  printSection("Next step");
330
329
  if (recorded === current) {
@@ -470,7 +469,7 @@ async function chooseAgent(supplied) {
470
469
  function printHandoff({ agent, method, workspace, source, version }) {
471
470
  const rel = relative(process.cwd(), workspace) || ".";
472
471
  const setupCmd =
473
- agent === "opencode" ? "/af-setup-agent-fleet" : "/setup-agent-fleet";
472
+ agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
474
473
  const lines = [
475
474
  `agent-fleet v${version} is ready.`,
476
475
  "",
@@ -517,7 +516,8 @@ function tryLaunch(agent, cwd) {
517
516
  const r = spawnSync(cmd, [], { cwd, stdio: "inherit" });
518
517
  if (r.error) {
519
518
  console.log(`(could not launch ${cmd}: ${r.error.message})`);
520
- console.log(`Open ${cmd} manually and run /setup-agent-fleet.`);
519
+ const setupCmd = agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
520
+ console.log(`Open ${cmd} manually and run ${setupCmd}.`);
521
521
  }
522
522
  }
523
523
 
@@ -582,7 +582,7 @@ function printHelp(sub) {
582
582
  if (sub === "init") {
583
583
  console.log(`agent-fleet init [options]
584
584
 
585
- Materialize the package and hand off to the LLM-driven /setup-agent-fleet skill.
585
+ Materialize the package and hand off to the runtime's Agent Fleet setup command.
586
586
 
587
587
  Options:
588
588
  --agent <claude-code|opencode|pi> Skip the agent auto-detection
@@ -660,10 +660,10 @@ Examples:
660
660
  if (sub === "update") {
661
661
  console.log(`agent-fleet update [options]
662
662
 
663
- Surface the version delta and re-install the /setup-agent-fleet command so
664
- it is always present after an update (guided-workspace-setup removes it at
665
- the end of a run by default). The actual diff-aware refresh then runs inside
666
- your coding agent via /setup-agent-fleet.
663
+ Surface the version delta and re-install the runtime's Agent Fleet setup
664
+ command so it is always present after an update (guided-workspace-setup
665
+ removes it at the end of a run by default). The actual diff-aware refresh
666
+ then runs inside your coding agent via that command.
667
667
 
668
668
  Options:
669
669
  --agent <claude-code|opencode|pi> Override the agent (default: marker → auto-detect)
@@ -684,9 +684,9 @@ Usage:
684
684
  npx agent-fleet <command> [options]
685
685
 
686
686
  Commands:
687
- init Bootstrap installer files + hand off to /setup-agent-fleet
687
+ init Bootstrap installer files + hand off to the setup workflow
688
688
  doctor Scan for broken symlinks and stale persona references
689
- update Surface the version delta + hand off to /setup-agent-fleet
689
+ update Surface the version delta + hand off to the setup workflow
690
690
  check-update One-line registry check (used by session hooks; safe to script)
691
691
  cleanup-installer Remove the installer slash commands from a workspace (used
692
692
  by the skill at end of setup; safe to run by hand)
@@ -1,10 +1,10 @@
1
1
  // bootstrap.js — drop the minimum installer artifacts a coding agent needs
2
- // to recognize `/setup-agent-fleet` and `/doctor-agent-fleet`.
2
+ // to recognize Agent Fleet's setup and doctor slash commands.
3
3
  //
4
4
  // The CLI's `init` calls this before the handoff message. Without it, a
5
- // fresh workspace has no `.claude/commands/setup-agent-fleet.md`, `.pi/prompts/setup-agent-fleet.md`,
6
- // etc., so the agent has no idea what `/setup-agent-fleet` is and the whole hand-off
7
- // breaks silently.
5
+ // fresh workspace has no `.claude/commands/setup-agent-fleet.md`,
6
+ // `.pi/prompts/af-setup-agent-fleet.md`, etc., so the agent has no setup
7
+ // entrypoint and the whole hand-off breaks silently.
8
8
  //
9
9
  // What we bootstrap (per agent):
10
10
  // - The `setup` slash command (so the user can invoke it)
@@ -16,7 +16,7 @@
16
16
  // What we do NOT bootstrap:
17
17
  // - Any of the user-facing skills (spec-driven-development,
18
18
  // test-driven-development, …). Those are picked by the user inside
19
- // /setup-agent-fleet, by design. The CLI never decides the workspace's catalogue
19
+ // through the runtime's setup command, by design. The CLI never decides the workspace's catalogue
20
20
  // for the user.
21
21
  //
22
22
  // Method:
@@ -93,10 +93,10 @@ function plan({ agent, sourceRoot, workspace }) {
93
93
 
94
94
  case "pi":
95
95
  return [
96
- { kind: "prompt", src: join(sourceRoot, ".pi/prompts/setup-agent-fleet.md"),
97
- dest: join(workspace, ".pi/prompts/setup-agent-fleet.md") },
98
- { kind: "prompt", src: join(sourceRoot, ".pi/prompts/doctor-agent-fleet.md"),
99
- dest: join(workspace, ".pi/prompts/doctor-agent-fleet.md") },
96
+ { kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-setup-agent-fleet.md"),
97
+ dest: join(workspace, ".pi/prompts/af-setup-agent-fleet.md") },
98
+ { kind: "prompt", src: join(sourceRoot, ".pi/prompts/af-doctor-agent-fleet.md"),
99
+ dest: join(workspace, ".pi/prompts/af-doctor-agent-fleet.md") },
100
100
  // pi auto-discovers skills from .pi/skills/ and .agents/skills/ —
101
101
  // we use .pi/skills/ to avoid polluting a shared .agents/ dir if
102
102
  // the user has other tools there.
@@ -124,9 +124,8 @@ function plan({ agent, sourceRoot, workspace }) {
124
124
  }
125
125
  }
126
126
 
127
- // Files that were the bootstrap targets in 0.2.0 and earlier (pre-rename).
128
- // Removed during bootstrap so a workspace upgraded from 0.2.0 doesn't end
129
- // up with both the old and new slash commands.
127
+ // Previous bootstrap targets. Removed during bootstrap so upgrades do not
128
+ // leave both unprefixed and current slash commands in the workspace.
130
129
  function legacyPaths({ agent, workspace }) {
131
130
  switch (agent) {
132
131
  case "claude-code":
@@ -138,6 +137,8 @@ function legacyPaths({ agent, workspace }) {
138
137
  return [
139
138
  join(workspace, ".pi/prompts/setup.md"),
140
139
  join(workspace, ".pi/prompts/doctor.md"),
140
+ join(workspace, ".pi/prompts/setup-agent-fleet.md"),
141
+ join(workspace, ".pi/prompts/doctor-agent-fleet.md"),
141
142
  ];
142
143
  case "opencode":
143
144
  return [
@@ -173,8 +174,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
173
174
  );
174
175
  }
175
176
 
176
- // Clean up pre-0.3.0 file names if present — they were renamed to
177
- // *-agent-fleet so they don't collide with other slash commands.
177
+ // Clean up superseded file names so old and current commands never coexist.
178
178
  for (const oldPath of legacyPaths({ agent, workspace })) {
179
179
  if (!existsSync(oldPath) && !isSymlink(oldPath)) continue;
180
180
  if (dryRun) {
@@ -205,7 +205,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
205
205
 
206
206
  // Always replace — the bootstrap is installer scaffolding, not user
207
207
  // data. If we left it stale, an upgraded package would still hand off
208
- // to the old /setup-agent-fleet command. Step 6 of guided-workspace-setup explicitly
208
+ // to an old setup command. Step 6 of guided-workspace-setup explicitly
209
209
  // never offers these files in the install menu, so we are the only
210
210
  // mechanism that refreshes them.
211
211
  if (existsSync(item.dest) || isSymlink(item.dest)) {
@@ -248,7 +248,7 @@ export function bootstrap({ agent, sourceRoot, workspace, method, dryRun = false
248
248
  * Remove every bootstrap artifact this module knows how to write. Called
249
249
  * by guided-workspace-setup at the end of Step 10 unless the user chose
250
250
  * to keep the installer commands. After cleanup, the only way back to
251
- * /setup-agent-fleet is to re-run `npx @chankov/agent-fleet init`.
251
+ * the setup command is to re-run `npx @chankov/agent-fleet init`.
252
252
  *
253
253
  * The same `agent` value must be supplied that was used at bootstrap time —
254
254
  * we don't have a tracking file, so we delete based on the plan map.
package/bin/lib/doctor.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Doctor scan — deterministic preflight extracted from
2
2
  // guided-workspace-setup Step 5. Both `agent-fleet doctor` (CLI) and the
3
- // `/doctor-agent-fleet` slash command call into this so behaviour cannot drift.
3
+ // Runtime-specific Agent Fleet doctor slash commands call into this so behaviour cannot drift.
4
4
  //
5
5
  // Three classes of findings:
6
6
  // 1. Broken symlinks — links whose source has been moved, renamed, or deleted
@@ -101,7 +101,7 @@ sessions are recycled (fresh spawn instead of `-c` resume) after `session-recycl
101
101
  or ≥60% measured context — resumed sessions otherwise re-bill their accumulated context on
102
102
  every model call. Configured under `## agent-hub` (`mode`, `max-dispatches-per-turn`,
103
103
  `max-research-per-turn`, `turn-wall-time-s`, `agent-turn-timeout-s`, `session-recycle-runs`);
104
- switched live with `/hub-mode`.
104
+ switched live with `/af-hub-mode`.
105
105
 
106
106
  On top of the mode sit three qualitative guardrails. **Task triage**: the dispatcher
107
107
  classifies each turn via the `set_task_tier` tool (`trivial`/`small`/`feature`/`project`)
@@ -111,10 +111,10 @@ observed in-flight from the JSON event stream — deterministic rules (out-of-sc
111
111
  against the declared `scope` globs, tool-call loops, consecutive failures, tool-call cap)
112
112
  escalate to a one-shot cheap LLM judge whose DRIFTING/STUCK verdict terminates the run as
113
113
  `drift_stop` (exit 125, partial output preserved); enabled per hub/agent/dispatch
114
- (`watchdog` key, `/watchdog`, `watchdog` param). **Dynamic teams**: `/agents-add`,
115
- `/agents-drop`, `/agents-save` restructure the roster live (the system prompt rebuilds
114
+ (`watchdog` key, `/af-watchdog`, `watchdog` param). **Dynamic teams**: `/af-agents-add`,
115
+ `/af-agents-drop`, `/af-agents-save` restructure the roster live (the system prompt rebuilds
116
116
  every turn), and the gated `team_adjust` tool lets the dispatcher itself adjust the roster
117
- outside fast mode, with user notification. `/hub-report` accounts each turn's dispatches,
117
+ outside fast mode, with user notification. `/af-hub-report` accounts each turn's dispatches,
118
118
  tokens (billed = input + cacheRead + cacheWrite), recycles, drift stops, and refusals.
119
119
 
120
120
  ## Runtime stack (tools the fleet sits on)