@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,169 @@
1
+ # Getting Started with agent-fleet
2
+
3
+ agent-fleet works with any AI coding agent that accepts Markdown instructions. This guide covers the universal approach. For tool-specific setup, see the dedicated guides.
4
+
5
+ ## How Skills Work
6
+
7
+ Each skill is a Markdown file (`SKILL.md`) that describes a specific engineering workflow. When loaded into an agent's context, the agent follows the workflow — including verification steps, anti-patterns to avoid, and exit criteria.
8
+
9
+ **Skills are not reference docs.** They're step-by-step processes the agent follows.
10
+
11
+ ## Install path — which one fits you?
12
+
13
+ | Audience | Path | Why |
14
+ |---|---|---|
15
+ | **Most users** — you want to use the skills in your projects | `npx @chankov/agent-fleet init` | One command; semver updates; cross-platform; no source dir to babysit. See [docs/npm-install.md](npm-install.md). |
16
+ | **Claude Code users** — you live in Claude Code and want plugin-managed updates | `/plugin marketplace add chankov/agent-fleet` | Best UX inside Claude Code; marketplace handles the lifecycle. |
17
+ | **Skill authors / contributors** — you want to edit the skills and have changes flow into every connected workspace | `git clone` + `symlink` mode in `/setup-agent-fleet` | Edit-in-place; every connected workspace sees the change instantly. |
18
+
19
+ All three converge on the same `guided-workspace-setup` skill — they only differ in how the source files reach your workspace. None is being deprecated.
20
+
21
+ ## Quick Start (Any Agent)
22
+
23
+ ### 1. Clone the repository
24
+
25
+ ```bash
26
+ git clone https://github.com/chankov/agent-fleet.git
27
+ ```
28
+
29
+ > Skip this step if you installed via npm — the package contents are already
30
+ > in `node_modules/agent-fleet/`. Use that path wherever this guide refers to
31
+ > "the agent-fleet repo."
32
+
33
+ ### 2. Choose a skill
34
+
35
+ Browse the `skills/` directory. Each subdirectory contains a `SKILL.md` with:
36
+ - **When to use** — triggers that indicate this skill applies
37
+ - **Process** — step-by-step workflow
38
+ - **Verification** — how to confirm the work is done
39
+ - **Common rationalizations** — excuses the agent might use to skip steps
40
+ - **Red flags** — signs the skill is being violated
41
+
42
+ ### 3. Load the skill into your agent
43
+
44
+ Copy the relevant `SKILL.md` content into your agent's system prompt, rules file, or conversation. The most common approaches:
45
+
46
+ **System prompt:** Paste the skill content at the start of the session.
47
+
48
+ **Rules file:** Add skill content to your project's rules file (CLAUDE.md, AGENTS.md, etc.).
49
+
50
+ **Conversation:** Reference the skill when giving instructions: "Follow the test-driven-development process for this change."
51
+
52
+ ### 4. Use the meta-skill for discovery
53
+
54
+ Start with the `using-agent-skills` skill loaded. It contains a flowchart that maps task types to the appropriate skill.
55
+
56
+ ## Recommended Setup
57
+
58
+ ### Minimal (Start here)
59
+
60
+ Load three essential skills into your rules file:
61
+
62
+ 1. **spec-driven-development** — For defining what to build
63
+ 2. **test-driven-development** — For proving it works
64
+ 3. **code-review-and-quality** — For verifying quality before merge
65
+
66
+ These three cover the most critical quality gaps in AI-assisted development.
67
+
68
+ ### Full Lifecycle
69
+
70
+ For comprehensive coverage, load skills by phase:
71
+
72
+ ```
73
+ Starting a project: spec-driven-development → planning-and-task-breakdown
74
+ During development: incremental-implementation + test-driven-development
75
+ Before merge: code-review-and-quality + security-and-hardening
76
+ Before deploy: shipping-and-launch
77
+ ```
78
+
79
+ ### Context-Aware Loading
80
+
81
+ Don't load all skills at once — it wastes context. Load skills relevant to the current task:
82
+
83
+ - Working on UI? Load `frontend-ui-engineering`
84
+ - Debugging? Load `debugging-and-error-recovery`
85
+ - Setting up CI? Load `ci-cd-and-automation`
86
+
87
+ ## Skill Anatomy
88
+
89
+ Every skill follows the same structure:
90
+
91
+ ```
92
+ YAML frontmatter (name, description)
93
+ ├── Overview — What this skill does
94
+ ├── When to Use — Triggers and conditions
95
+ ├── Core Process — Step-by-step workflow
96
+ ├── Examples — Code samples and patterns
97
+ ├── Common Rationalizations — Excuses and rebuttals
98
+ ├── Red Flags — Signs the skill is being violated
99
+ └── Verification — Exit criteria checklist
100
+ ```
101
+
102
+ See [skill-anatomy.md](skill-anatomy.md) for the full specification.
103
+
104
+ ## Using Agents
105
+
106
+ The `agents/` directory contains pre-configured agent personas:
107
+
108
+ | Agent | Purpose |
109
+ |-------|---------|
110
+ | `code-reviewer.md` | Five-axis code review (read-only) |
111
+ | `test-engineer.md` | Test strategy and writing |
112
+ | `security-auditor.md` | Vulnerability detection (read-only) |
113
+ | `web-performance-auditor.md` | Core Web Vitals & performance audit (read-only, via `/webperf`) |
114
+ | `planner.md` | Numbered implementation plans (read-only) |
115
+ | `plan-reviewer.md` | Critiques and validates plans (read-only) |
116
+ | `builder.md` | Implements an approved plan |
117
+ | `documenter.md` | READMEs and inline docs |
118
+
119
+ Load an agent definition when you need specialized review. For example, ask your coding agent to "review this change using the code-reviewer agent persona" and provide the agent definition.
120
+
121
+ ## Using Commands
122
+
123
+ The `.claude/commands/` directory contains slash commands for Claude Code:
124
+
125
+ | Command | Skill Invoked |
126
+ |---------|---------------|
127
+ | `/setup-agent-fleet` | guided-workspace-setup |
128
+ | `/spec` | spec-driven-development |
129
+ | `/plan` | planning-and-task-breakdown |
130
+ | `/build` | incremental-implementation + test-driven-development |
131
+ | `/build auto` | planning-and-task-breakdown → incremental-implementation + test-driven-development (whole plan, one approval) |
132
+ | `/test` | test-driven-development |
133
+ | `/review` | code-review-and-quality |
134
+ | `/code-simplify` | code-simplification |
135
+ | `/ship` | shipping-and-launch |
136
+ | `/webperf` | web-performance-auditor (specialist agent, web apps only) |
137
+
138
+ ## Using References
139
+
140
+ The `references/` directory contains supplementary checklists:
141
+
142
+ | Reference | Use With |
143
+ |-----------|----------|
144
+ | `testing-patterns.md` | test-driven-development |
145
+ | `performance-checklist.md` | performance-optimization |
146
+ | `security-checklist.md` | security-and-hardening |
147
+ | `accessibility-checklist.md` | frontend-ui-engineering |
148
+ | `definition-of-done.md` | incremental-implementation, planning-and-task-breakdown |
149
+ | `observability-checklist.md` | observability-and-instrumentation |
150
+ | `orchestration-patterns.md` | orchestration-verification, designing-agents |
151
+ | `prompting-patterns.md` | context-engineering |
152
+
153
+ Load a reference when you need detailed patterns beyond what the skill covers.
154
+
155
+ ## Spec and task artifacts
156
+
157
+ The `/spec` and `/plan` commands create working artifacts (`SPEC.md`, `tasks/plan.md`, `tasks/todo.md`). Treat them as **living documents** while the work is in progress:
158
+
159
+ - Keep them in version control during development so the human and the agent have a shared source of truth.
160
+ - Update them when scope or decisions change.
161
+ - If your repo doesn’t want these files long‑term, delete them before merge or add the folder to `.gitignore` — the workflow doesn’t require them to be permanent.
162
+
163
+ ## Tips
164
+
165
+ 1. **Start with spec-driven-development** for any non-trivial work
166
+ 2. **Always load test-driven-development** when writing code
167
+ 3. **Don't skip verification steps** — they're the whole point
168
+ 4. **Load skills selectively** — more context isn't always better
169
+ 5. **Use the agents for review** — different perspectives catch different issues
@@ -0,0 +1,335 @@
1
+ # npm install path
2
+
3
+ The `@chankov/agent-fleet` package ships every skill, persona, slash command,
4
+ and pi extension as installable content, plus a thin CLI that hands off to the
5
+ LLM-driven `guided-workspace-setup` skill. The CLI never writes installable
6
+ artifacts on its own — that decision (and the conversation around it) belongs
7
+ to the coding agent.
8
+
9
+ ## Package name vs CLI name
10
+
11
+ | | Name |
12
+ |---|---|
13
+ | **npm package** (use this for `npm install` and the first `npx`) | `@chankov/agent-fleet` |
14
+ | **CLI binary** (the command the package ships) | `agent-fleet` |
15
+
16
+ The package is published under the `@chankov` npm scope to guarantee identity —
17
+ only [Nikolay Chankov](https://www.npmjs.com/~chankov) can publish to that
18
+ scope. The CLI binary stays the short name `agent-fleet` because that's what
19
+ goes on `PATH` after install.
20
+
21
+ So:
22
+
23
+ - First time / one-shot: `npx @chankov/agent-fleet <cmd>` — npx resolves the
24
+ scoped package and runs its bin.
25
+ - After a project / global install: `npx agent-fleet <cmd>` works too,
26
+ because the bin is named `agent-fleet`.
27
+
28
+ ## Quick start
29
+
30
+ ### Guided workspace setup
31
+
32
+ ```bash
33
+ # In the workspace you want to configure:
34
+ npx @chankov/agent-fleet init
35
+ # Then open your coding agent in this directory and run:
36
+ # /setup-agent-fleet
37
+ ```
38
+
39
+ That's it. `npx` fetches the package, the CLI detects your coding agent and
40
+ prints the next-step command, and `/setup-agent-fleet` runs the full guided install
41
+ inside your agent.
42
+
43
+ ### First-class pi package
44
+
45
+ For pi users who want package-native loading instead of copied/symlinked setup artifacts:
46
+
47
+ ```bash
48
+ # Project-scoped; writes .pi/settings.json
49
+ pi install -l npm:@chankov/agent-fleet
50
+
51
+ # Or global for every pi session
52
+ pi install npm:@chankov/agent-fleet
53
+ ```
54
+
55
+ The pi package manifest exposes this repo's skills, pi runtime skills, lifecycle prompts, and bundled `pi-ask-user` resources. The bundled companion provides the `ask_user` tool and `ask-user` skill without a separate `pi-ask-user` install.
56
+
57
+ It intentionally does not auto-expose this repo's own `.pi/extensions` or harness directories; install those through guided setup or the pi setup docs so their runtime dependencies are handled explicitly. `pi-codex-image-gen` is also not bundled or required; guided setup may offer it as an optional suggested external npm/pi package when package installation is available, and installs it only if selected (`pi install -l npm:pi-codex-image-gen`). Minimal setup works without it.
58
+
59
+ ## Commands
60
+
61
+ ### `npx @chankov/agent-fleet init`
62
+
63
+ Materializes the package, **bootstraps the installer artifacts** into the
64
+ workspace (so the agent has a `/setup-agent-fleet` and `/doctor-agent-fleet` command to invoke),
65
+ and hands off to `/setup-agent-fleet`.
66
+
67
+ What `init` writes per agent:
68
+
69
+ | Agent | Files written to the workspace |
70
+ |---|---|
71
+ | `claude-code` | `.claude/commands/setup-agent-fleet.md`, `.claude/commands/doctor-agent-fleet.md`, `.claude/skills/guided-workspace-setup/SKILL.md` |
72
+ | `pi` | `.pi/prompts/setup-agent-fleet.md`, `.pi/prompts/doctor-agent-fleet.md`, `.pi/skills/guided-workspace-setup/SKILL.md` |
73
+ | `opencode` | `.opencode/commands/af-setup-agent-fleet.md`, `.opencode/commands/af-doctor-agent-fleet.md`, `.opencode/skills/guided-workspace-setup/SKILL.md` |
74
+
75
+ These are **just the plumbing** — the slash commands, plus the skill they
76
+ invoke. The actual catalogue (spec-driven-development, code-reviewer,
77
+ test-engineer, pi extensions, …) is picked by you inside `/setup-agent-fleet`. Re-run
78
+ `init` to refresh the plumbing after a package upgrade; bootstrap files
79
+ are always overwritten because they're scaffolding, not user data.
80
+
81
+ After `/setup-agent-fleet` finishes its install pass, **the bootstrap files
82
+ are removed by default** so they don't clutter your agent's slash-command
83
+ list. Re-run `npx @chankov/agent-fleet init` whenever you want
84
+ `/setup-agent-fleet` back. To keep them in place across runs, reply `keep`
85
+ to the Step 9 confirmation prompt — the skill will record
86
+ `keep-installer: true` in `.ai/agent-fleet-setup.md`.
87
+
88
+ ### How the skill finds the source package
89
+
90
+ `init` writes one extra file alongside the bootstrap: `.ai/.agent-fleet-bootstrap.json`.
91
+ This is the **authoritative** record of where the npm package lives:
92
+
93
+ ```json
94
+ {
95
+ "sourceRoot": "/home/you/.npm/_npx/<hash>/node_modules/@chankov/agent-fleet",
96
+ "version": "0.3.0",
97
+ "agent": "pi",
98
+ "method": "copy",
99
+ "bootstrappedAt": "2026-05-24T..."
100
+ }
101
+ ```
102
+
103
+ When `/setup-agent-fleet` runs inside your agent, it reads this marker
104
+ *first* to find the source package. This matters on dev machines where you
105
+ may also have a git clone of `agent-fleet` elsewhere — the marker prevents
106
+ the skill from accidentally using that clone instead of the version the
107
+ user just installed via npm.
108
+
109
+ If the marker is missing or its `sourceRoot` no longer exists (e.g. npx
110
+ cleaned its cache), the skill **asks you explicitly** for the path. It
111
+ never scans your filesystem for other agent-fleet repos — that would
112
+ silently pick up forks, stale checkouts, or dev clones that aren't what
113
+ you installed.
114
+
115
+ The marker is removed by the same Step 10b cleanup that removes the
116
+ slash commands.
117
+
118
+ | Flag | Default | Purpose |
119
+ |------|---------|---------|
120
+ | `--agent <claude-code\|opencode\|pi>` | auto-detect | Skip the agent prompt |
121
+ | `--method <copy\|symlink>` | `copy` | Default install method passed to the skill |
122
+ | `--workspace <path>` | `cwd` | Target workspace |
123
+ | `--launch` | off | Shell into the coding agent after init (best effort) |
124
+
125
+ ```bash
126
+ npx @chankov/agent-fleet init --agent claude-code
127
+ npx @chankov/agent-fleet init --workspace ~/projects/foo --method symlink
128
+ ```
129
+
130
+ ### `npx @chankov/agent-fleet doctor`
131
+
132
+ Deterministic preflight scan — walks every install-target directory, lists
133
+ broken symlinks and stale persona references, and offers fixes. Same scan
134
+ that `/doctor-agent-fleet` runs inside the agent.
135
+
136
+ | Flag | Default | Purpose |
137
+ |------|---------|---------|
138
+ | `--workspace <path>` | `cwd` | Target workspace |
139
+ | `--dry-run` | off | Show findings; do not apply |
140
+ | `--yes` / `-y` | off | Apply all suggested fixes without prompting |
141
+
142
+ ```bash
143
+ npx @chankov/agent-fleet doctor --workspace ~/projects/foo --dry-run
144
+ npx @chankov/agent-fleet doctor -y
145
+ ```
146
+
147
+ ### `npx @chankov/agent-fleet update`
148
+
149
+ Reads the workspace's `.ai/agent-fleet-setup.md`, compares the recorded
150
+ package version against the installed package version, and **re-installs the
151
+ `/setup-agent-fleet` command** so it is always available after an update.
152
+ `guided-workspace-setup` removes the installer command at the end of a run by
153
+ default (Step 10b), so a workspace that has completed setup once would
154
+ otherwise have no command to hand off to. The actual diff-aware refresh then
155
+ runs inside the coding agent via `/setup-agent-fleet`.
156
+
157
+ The agent and install method are recovered from the bootstrap marker written
158
+ at init time; if that marker was cleaned up too, `update` auto-detects the
159
+ agent (and prompts only when the workspace has more than one agent dir).
160
+ Override with `--agent` / `--method`, or preview with `--dry-run`.
161
+
162
+ ```bash
163
+ # Upgrade the package itself first, then check the delta:
164
+ npm install -g @chankov/agent-fleet@latest
165
+ npx agent-fleet update --workspace .
166
+ # /setup-agent-fleet is now back in your workspace — open your agent and run
167
+ # it to review per-artifact diffs.
168
+ ```
169
+
170
+ ### `npx @chankov/agent-fleet transform-persona`
171
+
172
+ Generates per-agent subagent definitions from the canonical personas in
173
+ `agents/*.md`. `pi` gets the canonical file unchanged; `claude-code` and
174
+ `opencode` get a transformed copy — `tools`/`model` translated to the target's
175
+ vocabulary (`read→Read`, `find/ls→Glob`, `claude-opus-*→opus`, …; `mode:
176
+ subagent` + tool denials for OpenCode), agent-hub-only frontmatter dropped,
177
+ body untouched. pi-only personas (`bowser`, `orchestrator`) are refused for
178
+ other agents. This is what
179
+ `/setup-agent-fleet` runs during apply; transformed installs are always
180
+ copies (never symlinks), recorded with `transformed: true`.
181
+
182
+ | Flag | Default | Purpose |
183
+ |------|---------|---------|
184
+ | `--agent <claude-code\|opencode\|pi>` | — (required) | Target agent |
185
+ | `--list` | off | Print the availability matrix (persona → target path) |
186
+ | `--all` | off | Transform every available persona |
187
+ | `--workspace <path>` | — | Write into `<path>`; omit to print to stdout |
188
+ | `--dry-run` | off | With `--workspace`: show what would be written |
189
+
190
+ ```bash
191
+ npx @chankov/agent-fleet transform-persona --list --agent claude-code
192
+ npx @chankov/agent-fleet transform-persona --agent claude-code code-reviewer
193
+ npx @chankov/agent-fleet transform-persona --agent opencode --all --workspace .
194
+ ```
195
+
196
+ ## Versioning
197
+
198
+ The package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html):
199
+
200
+ | Change | Bump |
201
+ |---|---|
202
+ | Skill removed, renamed, or its documented workflow changes; persona retired; command removed; install-record schema breakage | **major** |
203
+ | New skill, new persona, new command, new option in an existing skill | **minor** |
204
+ | Wording fix, doctor scan improvement, CLI bug fix | **patch** |
205
+
206
+ ### Pinning
207
+
208
+ To pin a workspace to a specific version, install the package as a project
209
+ dependency instead of using `npx`:
210
+
211
+ ```bash
212
+ npm install --save-dev @chankov/agent-fleet@0.0.1
213
+ npx agent-fleet init # resolves to the pinned 0.0.1
214
+ ```
215
+
216
+ Or pin globally:
217
+
218
+ ```bash
219
+ npm install -g @chankov/agent-fleet@0.0.1
220
+ ```
221
+
222
+ ### What "update" actually changes
223
+
224
+ The package update is just `npm`'s usual upgrade. The interesting part runs
225
+ inside the agent: `guided-workspace-setup` reads the `version:` line from
226
+ `.ai/agent-fleet-setup.md`, computes the delta against the current package
227
+ version, and surfaces per-artifact `Status` based on a three-way diff:
228
+
229
+ | Status | Means |
230
+ |---|---|
231
+ | `installed · upgrade available` | Source changed upstream; user copy still matches the old source → clean refresh |
232
+ | `installed · conflicting upgrade` | Source changed upstream AND user modified the copy → three-way diff shown, write requires explicit consent |
233
+ | `installed · removed upstream` | Artifact gone in the new version → proposed for deletion (subject to the removal-scope rule) |
234
+ | `not installed · new in this version` | New artifact added in the new version → offered, marked `★` if recommended |
235
+
236
+ The diff is sourced from `.versions/<recorded-version>/` inside the package —
237
+ a snapshot the release pipeline writes for every published version.
238
+
239
+ ## Other install paths
240
+
241
+ npm is the recommended path for most users. The other two stay supported:
242
+
243
+ - **[Claude Code plugin marketplace](../README.md#quick-start)** — best UX
244
+ inside Claude Code. Same skills, marketplace-managed updates.
245
+ - **Git clone + symlinks** — best for skill authors and contributors. Clone
246
+ the repo, run `/setup-agent-fleet` from there, choose `symlink` in Step 8. Updates
247
+ flow through `git pull`. Symlinks need Developer Mode on Windows.
248
+
249
+ All three paths converge on the same `guided-workspace-setup` skill — the
250
+ difference is only in how the source files reach the workspace.
251
+
252
+ ## CI usage
253
+
254
+ `npx @chankov/agent-fleet init` is interactive by default (it prompts for
255
+ the agent when detection is ambiguous). For CI, pass `--agent` explicitly:
256
+
257
+ ```bash
258
+ npx --yes @chankov/agent-fleet@latest init --agent claude-code --method copy --workspace .
259
+ ```
260
+
261
+ `doctor` accepts `--yes` for non-interactive repair. Note that the
262
+ LLM-driven `/setup-agent-fleet` flow is not CI-runnable by design — confirmation gates
263
+ exist precisely so a human approves every write.
264
+
265
+ ## Receiving update notifications
266
+
267
+ Three independent mechanisms surface "a new version is published" without
268
+ you having to remember to check. All three share a single cache at
269
+ `$XDG_CACHE_HOME/agent-fleet/latest-version.json` (24h TTL) so the
270
+ registry is hit at most once per day.
271
+
272
+ ### 1. CLI update-notifier (always on)
273
+
274
+ Every `npx @chankov/agent-fleet <cmd>` invocation runs a fast cache read
275
+ on entry. If the cached latest version exceeds the running CLI version, a
276
+ banner prints to stderr before the command output:
277
+
278
+ ```
279
+ ┌──────────────────────────────────────────────────────────────┐
280
+ │ agent-fleet update available: 0.1.0 → 0.2.0 │
281
+ │ Run: npx @chankov/agent-fleet@latest update │
282
+ │ Releases: https://github.com/chankov/agent-fleet/releases │
283
+ └──────────────────────────────────────────────────────────────┘
284
+ ```
285
+
286
+ If the cache is stale, a detached background process refreshes it for the
287
+ *next* invocation — the current run is never blocked.
288
+
289
+ ### 2. Claude Code session-start hook
290
+
291
+ When `hooks/session-start.sh` is installed (offered in Group 18 of `/setup-agent-fleet`),
292
+ every new Claude Code session runs the check with a 3-second wall-clock cap.
293
+ If an upgrade is available, the banner is injected into the session context
294
+ so Claude can mention it on its first turn — e.g. *"Note: agent-fleet 0.2.0
295
+ is available; want me to apply it via `/setup-agent-fleet`?"*
296
+
297
+ ### 3. pi extension (`agent-fleet-update-check`)
298
+
299
+ When installed (offered in Group 10 of `/setup-agent-fleet`), the extension fires on the
300
+ first `agent_start` event of each pi session and emits a `ctx.ui.notify`
301
+ message in the pi UI if a newer version is published. Reads the same cache
302
+ as the CLI — no double-fetching.
303
+
304
+ ### Opting out
305
+
306
+ Any of these environment variables disables all three:
307
+
308
+ ```bash
309
+ export AGENT_SKILLS_NO_UPDATE_CHECK=1 # agent-fleet-specific
310
+ export NO_UPDATE_NOTIFIER=1 # conventional, also honoured
311
+ # CI=true is auto-detected — banners never appear in CI logs
312
+ ```
313
+
314
+ ### Forcing a manual check
315
+
316
+ ```bash
317
+ # Block on a single registry fetch; print the banner if outdated
318
+ npx @chankov/agent-fleet check-update
319
+
320
+ # Bypass the cache entirely
321
+ rm ~/.cache/agent-fleet/latest-version.json
322
+ npx @chankov/agent-fleet check-update
323
+ ```
324
+
325
+ ## Troubleshooting
326
+
327
+ - **"Could not auto-detect your coding agent."** Pass `--agent` or run
328
+ `init` from a workspace that already has one of `.claude/`, `.opencode/`,
329
+ or `.pi/`.
330
+ - **`update` says "no install record".** Run `init` once first; the install
331
+ record is what `update` reads.
332
+ - **The version-aware menu shows `(snapshot missing)`.** The recorded version
333
+ is older than the snapshot retention in this package. The skill falls back
334
+ to "treat installed copy as canonical" — refresh manually if you want to
335
+ reset the baseline.