@chankov/agent-fleet 0.0.4 → 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 (614) hide show
  1. package/.claude/commands/set-hermes-telegram.md +15 -0
  2. package/.opencode/commands/af-set-hermes-telegram.md +15 -0
  3. package/.pi/agents/dispatch-policy.yaml +1 -1
  4. package/.pi/agents/peers.yaml +4 -4
  5. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  6. package/.pi/extensions/btw/README.md +10 -10
  7. package/.pi/extensions/btw/index.ts +11 -11
  8. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -3
  9. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  10. package/.pi/extensions/compact-and-continue/README.md +2 -2
  11. package/.pi/extensions/mcp-bridge/README.md +1 -1
  12. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  13. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  14. package/.pi/harnesses/agent-hub/README.md +84 -84
  15. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  16. package/.pi/harnesses/agent-hub/delegate.ts +3 -3
  17. package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
  18. package/.pi/harnesses/agent-hub/index.ts +254 -254
  19. package/.pi/harnesses/agent-hub/monitor-lifecycle.ts +1 -1
  20. package/.pi/harnesses/agent-hub/monitor-publisher.ts +3 -3
  21. package/.pi/harnesses/agent-hub/monitor-session-bridge.ts +1 -1
  22. package/.pi/harnesses/agent-hub/package.json +1 -1
  23. package/.pi/harnesses/agent-hub/run-budget.js +1 -1
  24. package/.pi/harnesses/ask-user-remote/README.md +1 -0
  25. package/.pi/harnesses/ask-user-remote/index.ts +36 -8
  26. package/.pi/harnesses/coms/README.md +7 -7
  27. package/.pi/harnesses/coms/index.ts +13 -13
  28. package/.pi/harnesses/coms/package.json +1 -1
  29. package/.pi/harnesses/damage-control-continue/README.md +16 -16
  30. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  31. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  32. package/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  33. package/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  34. package/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  35. package/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  36. package/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  37. package/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  38. package/.pi/prompts/af-set-hermes-telegram.md +15 -0
  39. package/.pi/prompts/af-setup-agent-fleet.md +27 -0
  40. package/.versions/0.0.5/.claude/commands/build.md +44 -0
  41. package/.versions/0.0.5/.claude/commands/code-simplify.md +22 -0
  42. package/.versions/0.0.5/.claude/commands/design-agent.md +14 -0
  43. package/.versions/0.0.5/.claude/commands/doctor-agent-fleet.md +17 -0
  44. package/.versions/0.0.5/.claude/commands/orchestrate.md +112 -0
  45. package/.versions/0.0.5/.claude/commands/plan.md +16 -0
  46. package/.versions/0.0.5/.claude/commands/prime.md +22 -0
  47. package/.versions/0.0.5/.claude/commands/review.md +16 -0
  48. package/.versions/0.0.5/.claude/commands/set-hermes-telegram.md +15 -0
  49. package/.versions/0.0.5/.claude/commands/setup-agent-fleet.md +25 -0
  50. package/.versions/0.0.5/.claude/commands/ship.md +72 -0
  51. package/.versions/0.0.5/.claude/commands/spec.md +15 -0
  52. package/.versions/0.0.5/.claude/commands/test.md +19 -0
  53. package/.versions/0.0.5/.claude/commands/webperf.md +32 -0
  54. package/.versions/0.0.5/.claude/orchestrate-teams.yaml +24 -0
  55. package/.versions/0.0.5/.opencode/commands/af-build.md +17 -0
  56. package/.versions/0.0.5/.opencode/commands/af-code-simplify.md +16 -0
  57. package/.versions/0.0.5/.opencode/commands/af-compound.md +16 -0
  58. package/.versions/0.0.5/.opencode/commands/af-design-agent.md +15 -0
  59. package/.versions/0.0.5/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  60. package/.versions/0.0.5/.opencode/commands/af-orchestrate.md +112 -0
  61. package/.versions/0.0.5/.opencode/commands/af-plan.md +16 -0
  62. package/.versions/0.0.5/.opencode/commands/af-prime.md +22 -0
  63. package/.versions/0.0.5/.opencode/commands/af-review.md +15 -0
  64. package/.versions/0.0.5/.opencode/commands/af-set-hermes-telegram.md +15 -0
  65. package/.versions/0.0.5/.opencode/commands/af-setup-agent-fleet.md +15 -0
  66. package/.versions/0.0.5/.opencode/commands/af-ship.md +16 -0
  67. package/.versions/0.0.5/.opencode/commands/af-spec.md +16 -0
  68. package/.versions/0.0.5/.opencode/commands/af-test.md +21 -0
  69. package/.versions/0.0.5/.opencode/commands/af-webperf.md +32 -0
  70. package/.versions/0.0.5/.opencode/orchestrate-teams.yaml +24 -0
  71. package/.versions/0.0.5/.pi/agents/dispatch-policy.yaml +32 -0
  72. package/.versions/0.0.5/.pi/agents/model-profiles.yaml +20 -0
  73. package/.versions/0.0.5/.pi/agents/peers.yaml +146 -0
  74. package/.versions/0.0.5/.pi/agents/teams.yaml +39 -0
  75. package/.versions/0.0.5/.pi/damage-control-rules.yaml +297 -0
  76. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  77. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  78. package/.versions/0.0.5/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  79. package/.versions/0.0.5/.pi/extensions/btw/README.md +118 -0
  80. package/.versions/0.0.5/.pi/extensions/btw/index.ts +917 -0
  81. package/.versions/0.0.5/.pi/extensions/btw/package.json +6 -0
  82. package/.versions/0.0.5/.pi/extensions/btw/state.js +179 -0
  83. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  84. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  85. package/.versions/0.0.5/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  86. package/.versions/0.0.5/.pi/extensions/compact-and-continue/README.md +42 -0
  87. package/.versions/0.0.5/.pi/extensions/compact-and-continue/index.ts +120 -0
  88. package/.versions/0.0.5/.pi/extensions/compact-and-continue/package.json +6 -0
  89. package/.versions/0.0.5/.pi/extensions/mcp-bridge/README.md +46 -0
  90. package/.versions/0.0.5/.pi/extensions/mcp-bridge/index.ts +206 -0
  91. package/.versions/0.0.5/.pi/extensions/mcp-bridge/package.json +6 -0
  92. package/.versions/0.0.5/.pi/extensions/package-lock.json +1143 -0
  93. package/.versions/0.0.5/.pi/extensions/package.json +9 -0
  94. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/README.md +201 -0
  95. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/config.ts +198 -0
  96. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  97. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/index.ts +248 -0
  98. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/package.json +6 -0
  99. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  100. package/.versions/0.0.5/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  101. package/.versions/0.0.5/.pi/harnesses/agent-hub/README.md +798 -0
  102. package/.versions/0.0.5/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  103. package/.versions/0.0.5/.pi/harnesses/agent-hub/artifacts.js +92 -0
  104. package/.versions/0.0.5/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  105. package/.versions/0.0.5/.pi/harnesses/agent-hub/delegate.ts +386 -0
  106. package/.versions/0.0.5/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  107. package/.versions/0.0.5/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  108. package/.versions/0.0.5/.pi/harnesses/agent-hub/footer.ts +29 -0
  109. package/.versions/0.0.5/.pi/harnesses/agent-hub/helpers.ts +214 -0
  110. package/.versions/0.0.5/.pi/harnesses/agent-hub/index.ts +8045 -0
  111. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  112. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  113. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  114. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  115. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  116. package/.versions/0.0.5/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  117. package/.versions/0.0.5/.pi/harnesses/agent-hub/package.json +7 -0
  118. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-retention.js +34 -0
  119. package/.versions/0.0.5/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  120. package/.versions/0.0.5/.pi/harnesses/agent-hub/return-contract.js +215 -0
  121. package/.versions/0.0.5/.pi/harnesses/agent-hub/run-budget.js +155 -0
  122. package/.versions/0.0.5/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  123. package/.versions/0.0.5/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  124. package/.versions/0.0.5/.pi/harnesses/agent-hub/spawn.ts +246 -0
  125. package/.versions/0.0.5/.pi/harnesses/agent-hub/version.ts +18 -0
  126. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/README.md +19 -0
  127. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/index.ts +321 -0
  128. package/.versions/0.0.5/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  129. package/.versions/0.0.5/.pi/harnesses/coms/README.md +92 -0
  130. package/.versions/0.0.5/.pi/harnesses/coms/index.ts +1745 -0
  131. package/.versions/0.0.5/.pi/harnesses/coms/package.json +7 -0
  132. package/.versions/0.0.5/.pi/harnesses/coms/version.ts +18 -0
  133. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/README.md +117 -0
  134. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/index.ts +536 -0
  135. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/package.json +7 -0
  136. package/.versions/0.0.5/.pi/harnesses/damage-control-continue/version.ts +18 -0
  137. package/.versions/0.0.5/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  138. package/.versions/0.0.5/.pi/harnesses/lib/herdr-client.ts +458 -0
  139. package/.versions/0.0.5/.pi/harnesses/lib/herdr-presence.ts +288 -0
  140. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  141. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  142. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  143. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  144. package/.versions/0.0.5/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  145. package/.versions/0.0.5/.pi/harnesses/package-lock.json +35 -0
  146. package/.versions/0.0.5/.pi/harnesses/package.json +9 -0
  147. package/.versions/0.0.5/.pi/prompts/build.md +24 -0
  148. package/.versions/0.0.5/.pi/prompts/code-simplify.md +22 -0
  149. package/.versions/0.0.5/.pi/prompts/plan.md +16 -0
  150. package/.versions/0.0.5/.pi/prompts/review.md +16 -0
  151. package/.versions/0.0.5/.pi/prompts/set-hermes-telegram.md +15 -0
  152. package/.versions/0.0.5/.pi/prompts/ship.md +17 -0
  153. package/.versions/0.0.5/.pi/prompts/spec.md +15 -0
  154. package/.versions/0.0.5/.pi/prompts/test.md +19 -0
  155. package/.versions/0.0.5/.pi/skills/bowser/SKILL.md +145 -0
  156. package/.versions/0.0.5/.version +1 -0
  157. package/.versions/0.0.5/agents/architect.md +23 -0
  158. package/.versions/0.0.5/agents/bowser.md +26 -0
  159. package/.versions/0.0.5/agents/builder.md +53 -0
  160. package/.versions/0.0.5/agents/code-reviewer.md +205 -0
  161. package/.versions/0.0.5/agents/deep-researcher.md +31 -0
  162. package/.versions/0.0.5/agents/documenter.md +18 -0
  163. package/.versions/0.0.5/agents/orchestrator.md +54 -0
  164. package/.versions/0.0.5/agents/plan-reviewer.md +60 -0
  165. package/.versions/0.0.5/agents/planner.md +69 -0
  166. package/.versions/0.0.5/agents/releaser.md +24 -0
  167. package/.versions/0.0.5/agents/researcher.md +28 -0
  168. package/.versions/0.0.5/agents/security-auditor.md +166 -0
  169. package/.versions/0.0.5/agents/test-engineer.md +151 -0
  170. package/.versions/0.0.5/agents/web-debugger.md +42 -0
  171. package/.versions/0.0.5/agents/web-performance-auditor.md +192 -0
  172. package/.versions/0.0.5/codex/CONDUCTOR.md +148 -0
  173. package/.versions/0.0.5/docs/ARCHITECTURE.md +210 -0
  174. package/.versions/0.0.5/docs/agent-fleet-setup.md +366 -0
  175. package/.versions/0.0.5/docs/claude-code-coms-bridge.md +103 -0
  176. package/.versions/0.0.5/docs/codex-remote-conductor.md +170 -0
  177. package/.versions/0.0.5/docs/coms-hermes-bridge.md +179 -0
  178. package/.versions/0.0.5/docs/getting-started.md +183 -0
  179. package/.versions/0.0.5/docs/npm-install.md +337 -0
  180. package/.versions/0.0.5/docs/opencode-setup.md +249 -0
  181. package/.versions/0.0.5/docs/pi-extensions.md +293 -0
  182. package/.versions/0.0.5/docs/pi-setup.md +472 -0
  183. package/.versions/0.0.5/docs/skill-anatomy.md +150 -0
  184. package/.versions/0.0.5/hermes/README.md +231 -0
  185. package/.versions/0.0.5/hermes/skills/hub-conductor/SKILL.md +84 -0
  186. package/.versions/0.0.5/hermes/skills/hub-liaison/SKILL.md +84 -0
  187. package/.versions/0.0.5/hooks/SIMPLIFY-IGNORE.md +90 -0
  188. package/.versions/0.0.5/hooks/coms-stop-hook.mjs +73 -0
  189. package/.versions/0.0.5/hooks/hooks.json +14 -0
  190. package/.versions/0.0.5/hooks/session-start.sh +74 -0
  191. package/.versions/0.0.5/hooks/simplify-ignore.sh +302 -0
  192. package/.versions/0.0.5/justfile +245 -0
  193. package/.versions/0.0.5/references/accessibility-checklist.md +160 -0
  194. package/.versions/0.0.5/references/definition-of-done.md +67 -0
  195. package/.versions/0.0.5/references/fleet-coordination-patterns.md +151 -0
  196. package/.versions/0.0.5/references/observability-checklist.md +91 -0
  197. package/.versions/0.0.5/references/orchestration-patterns.md +370 -0
  198. package/.versions/0.0.5/references/performance-checklist.md +153 -0
  199. package/.versions/0.0.5/references/prompting-patterns.md +380 -0
  200. package/.versions/0.0.5/references/security-checklist.md +179 -0
  201. package/.versions/0.0.5/references/testing-patterns.md +236 -0
  202. package/.versions/0.0.5/scripts/codex-conductor.ts +41 -0
  203. package/.versions/0.0.5/scripts/codex-remote-control.ts +167 -0
  204. package/.versions/0.0.5/scripts/coms-claude-bridge.ts +286 -0
  205. package/.versions/0.0.5/scripts/coms-cli.ts +484 -0
  206. package/.versions/0.0.5/scripts/coms-hermes-bridge.ts +413 -0
  207. package/.versions/0.0.5/scripts/fleet.ts +141 -0
  208. package/.versions/0.0.5/scripts/hermes-monitor-capability-runner.ts +25 -0
  209. package/.versions/0.0.5/scripts/hermes-monitor-scenario.ts +7 -0
  210. package/.versions/0.0.5/scripts/lib/claude-bridge-core.ts +100 -0
  211. package/.versions/0.0.5/scripts/lib/codex-conductor.ts +88 -0
  212. package/.versions/0.0.5/scripts/lib/codex-remote-control.ts +480 -0
  213. package/.versions/0.0.5/scripts/lib/coms-envelope.ts +539 -0
  214. package/.versions/0.0.5/scripts/lib/fake-herdr-server.ts +88 -0
  215. package/.versions/0.0.5/scripts/lib/fleet-command.ts +109 -0
  216. package/.versions/0.0.5/scripts/lib/herdr-layout.ts +263 -0
  217. package/.versions/0.0.5/scripts/lib/hermes-bridge-core.ts +241 -0
  218. package/.versions/0.0.5/scripts/lib/hermes-monitor-herdr.ts +2 -0
  219. package/.versions/0.0.5/scripts/lib/hermes-monitor-model.ts +3 -0
  220. package/.versions/0.0.5/scripts/lib/hermes-monitor-registry.ts +2 -0
  221. package/.versions/0.0.5/scripts/lib/hermes-monitor-socket.ts +2 -0
  222. package/.versions/0.0.5/scripts/lib/hermes-monitor-store.ts +2 -0
  223. package/.versions/0.0.5/scripts/lib/persona-banner.ts +62 -0
  224. package/.versions/0.0.5/scripts/lib/spawn-stagger.ts +101 -0
  225. package/.versions/0.0.5/scripts/lib/team-project.ts +191 -0
  226. package/.versions/0.0.5/scripts/lib/team-snapshot.ts +147 -0
  227. package/.versions/0.0.5/scripts/peer-banner.ts +40 -0
  228. package/.versions/0.0.5/scripts/team-snapshot.ts +237 -0
  229. package/.versions/0.0.5/scripts/team-up.ts +351 -0
  230. package/.versions/0.0.5/skills/_internal/grilling.md +11 -0
  231. package/.versions/0.0.5/skills/browser-testing-with-devtools/SKILL.md +352 -0
  232. package/.versions/0.0.5/skills/code-review-and-quality/SKILL.md +381 -0
  233. package/.versions/0.0.5/skills/compound-learning/SKILL.md +137 -0
  234. package/.versions/0.0.5/skills/context-engineering/SKILL.md +291 -0
  235. package/.versions/0.0.5/skills/deprecation-and-migration/SKILL.md +206 -0
  236. package/.versions/0.0.5/skills/designing-agents/SKILL.md +394 -0
  237. package/.versions/0.0.5/skills/designing-agents/pi-harness-authoring.md +222 -0
  238. package/.versions/0.0.5/skills/frontend-ui-engineering/SKILL.md +328 -0
  239. package/.versions/0.0.5/skills/git-workflow-and-versioning/SKILL.md +316 -0
  240. package/.versions/0.0.5/skills/guided-workspace-setup/SKILL.md +542 -0
  241. package/.versions/0.0.5/skills/guided-workspace-setup/companion-manifest.json +35 -0
  242. package/.versions/0.0.5/skills/idea-refine/SKILL.md +182 -0
  243. package/.versions/0.0.5/skills/idea-refine/examples.md +238 -0
  244. package/.versions/0.0.5/skills/idea-refine/frameworks.md +99 -0
  245. package/.versions/0.0.5/skills/idea-refine/refinement-criteria.md +113 -0
  246. package/.versions/0.0.5/skills/idea-refine/scripts/idea-refine.sh +15 -0
  247. package/.versions/0.0.5/skills/incremental-implementation/SKILL.md +287 -0
  248. package/.versions/0.0.5/skills/interview-me/SKILL.md +226 -0
  249. package/.versions/0.0.5/skills/orchestration-verification/SKILL.md +181 -0
  250. package/.versions/0.0.5/skills/peer-coms/SKILL.md +90 -0
  251. package/.versions/0.0.5/skills/performance-optimization/SKILL.md +350 -0
  252. package/.versions/0.0.5/skills/planning-and-task-breakdown/SKILL.md +236 -0
  253. package/.versions/0.0.5/skills/security-and-hardening/SKILL.md +461 -0
  254. package/.versions/0.0.5/skills/spec-driven-development/SKILL.md +245 -0
  255. package/.versions/0.0.5/skills/using-agent-skills/SKILL.md +199 -0
  256. package/.versions/0.0.5/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  257. package/.versions/0.0.5/vendor/agent-skills-upstream/LICENSE +21 -0
  258. package/.versions/0.0.5/vendor/agent-skills-upstream/README.md +11 -0
  259. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  260. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  261. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  262. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  263. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  264. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  265. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  266. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  267. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  268. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  269. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  270. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  271. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  272. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  273. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  274. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  275. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  276. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  277. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  278. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  279. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  280. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  281. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  282. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  283. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  284. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  285. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  286. package/.versions/0.0.5/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  287. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  288. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  289. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  290. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  291. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  292. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  293. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  294. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  295. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  296. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  297. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  298. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  299. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  300. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  301. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  302. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  303. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  304. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  305. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  306. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  307. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  308. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  309. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  310. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  311. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  312. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  313. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  314. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  315. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  316. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  317. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  318. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  319. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  320. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  321. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  322. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  323. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  324. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  325. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  326. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  327. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  328. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  329. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  330. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  331. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  332. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  333. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  334. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  335. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  336. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  337. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  338. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  339. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  340. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  341. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  342. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  343. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  344. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  345. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  346. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  347. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  348. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  349. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  350. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  351. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  352. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  353. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  354. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  355. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  356. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  357. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  358. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  359. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  360. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  361. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  362. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  363. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  364. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  365. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  366. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  367. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  368. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  369. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  370. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  371. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  372. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  373. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  374. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  375. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  376. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  377. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  378. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  379. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  380. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  381. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  382. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  383. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  384. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  385. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  386. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  387. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  388. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  389. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  390. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  391. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  392. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  393. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  394. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  395. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  396. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  397. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  398. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  399. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  400. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  401. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  402. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  403. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  404. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  405. package/.versions/0.0.6/.version +1 -0
  406. package/.versions/0.0.6/agents/architect.md +23 -0
  407. package/.versions/0.0.6/agents/bowser.md +26 -0
  408. package/.versions/0.0.6/agents/builder.md +53 -0
  409. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  410. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  411. package/.versions/0.0.6/agents/documenter.md +18 -0
  412. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  413. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  414. package/.versions/0.0.6/agents/planner.md +69 -0
  415. package/.versions/0.0.6/agents/releaser.md +24 -0
  416. package/.versions/0.0.6/agents/researcher.md +28 -0
  417. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  418. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  419. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  420. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  421. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  422. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  423. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  424. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  425. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  426. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  427. package/.versions/0.0.6/docs/getting-started.md +183 -0
  428. package/.versions/0.0.6/docs/npm-install.md +337 -0
  429. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  430. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  431. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  432. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  433. package/.versions/0.0.6/hermes/README.md +231 -0
  434. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  435. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  436. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  437. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  438. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  439. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  440. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  441. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  442. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  443. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  444. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  445. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  446. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  447. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  448. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  449. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  450. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  451. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  452. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  453. package/.versions/0.0.6/hooks/hooks.json +14 -0
  454. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  455. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  456. package/.versions/0.0.6/justfile +245 -0
  457. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  458. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  459. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  460. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  461. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  462. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  463. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  464. package/.versions/0.0.6/references/security-checklist.md +179 -0
  465. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  466. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  467. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  468. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  469. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  470. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  471. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  472. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  473. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  474. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  475. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  476. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  477. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  478. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  479. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  480. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  481. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  482. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  483. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  484. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  485. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  486. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  487. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  488. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  489. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  490. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  491. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  492. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  493. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  494. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  495. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  496. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  497. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  498. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  499. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  500. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  501. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  502. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  503. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  504. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  505. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  506. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  507. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  508. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  509. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  510. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  511. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  512. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  513. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  514. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  515. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  516. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  517. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  518. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  519. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  520. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  521. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  522. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  523. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  524. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  525. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  526. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  527. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  528. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  529. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  530. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  531. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  532. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  533. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  534. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  535. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  536. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  537. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  538. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  539. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  540. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  541. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  542. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  543. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  544. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  545. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  546. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  547. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  548. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  549. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  550. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  551. package/CHANGELOG.md +15 -0
  552. package/README.md +38 -36
  553. package/agents/documenter.md +1 -1
  554. package/agents/releaser.md +1 -1
  555. package/bin/cli.js +103 -21
  556. package/bin/lib/bootstrap.js +16 -16
  557. package/bin/lib/doctor.js +1 -1
  558. package/bin/lib/set-hermes-telegram.js +323 -0
  559. package/docs/ARCHITECTURE.md +8 -8
  560. package/docs/agent-fleet-setup.md +12 -12
  561. package/docs/claude-code-coms-bridge.md +4 -4
  562. package/docs/codex-remote-conductor.md +12 -12
  563. package/docs/coms-hermes-bridge.md +62 -4
  564. package/docs/getting-started.md +4 -4
  565. package/docs/npm-install.md +21 -21
  566. package/docs/opencode-setup.md +1 -0
  567. package/docs/pi-extensions.md +36 -31
  568. package/docs/pi-setup.md +66 -53
  569. package/hermes/README.md +14 -11
  570. package/justfile +141 -152
  571. package/package.json +6 -3
  572. package/references/fleet-coordination-patterns.md +3 -3
  573. package/scripts/coms-hermes-bridge.ts +18 -8
  574. package/scripts/fleet.ts +141 -0
  575. package/scripts/lib/fleet-command.ts +109 -0
  576. package/scripts/lib/hermes-bridge-core.ts +5 -2
  577. package/scripts/lib/hermes-monitor-herdr.ts +2 -28
  578. package/scripts/lib/hermes-monitor-model.ts +3 -9
  579. package/scripts/lib/hermes-monitor-registry.ts +2 -6
  580. package/scripts/lib/hermes-monitor-socket.ts +2 -118
  581. package/scripts/lib/hermes-monitor-store.ts +2 -31
  582. package/scripts/lib/team-project.ts +10 -3
  583. package/scripts/team-snapshot.ts +4 -5
  584. package/scripts/team-up.ts +24 -6
  585. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  586. package/skills/compound-learning/SKILL.md +3 -3
  587. package/skills/guided-workspace-setup/SKILL.md +27 -18
  588. package/skills/guided-workspace-setup/companion-manifest.json +3 -1
  589. package/skills/peer-coms/SKILL.md +1 -1
  590. package/hermes/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -10
  591. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  592. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  593. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  594. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  595. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  596. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  597. /package/.pi/prompts/{test.md → af-test.md} +0 -0
  598. /package/{.pi → .versions/0.0.5/.pi}/prompts/doctor-agent-fleet.md +0 -0
  599. /package/{.pi → .versions/0.0.5/.pi}/prompts/setup-agent-fleet.md +0 -0
  600. /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  601. /package/{hermes → .versions/0.0.5/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  602. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +0 -0
  603. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +0 -0
  604. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +0 -0
  605. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +0 -0
  606. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +0 -0
  607. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +0 -0
  608. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +0 -0
  609. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  610. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.test.py +0 -0
  611. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  612. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +0 -0
  613. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  614. /package/{hermes → .versions/0.0.5/hermes}/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +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,20 @@
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
+
9
+ ## 0.0.5
10
+
11
+ ### Patch Changes
12
+
13
+ - fb50bef: Add `/set-hermes-telegram` (`/af-set-hermes-telegram` on OpenCode) and the deterministic `agent-fleet set-hermes-telegram` CLI. It installs/status-checks the profile-scoped `hub-liaison` skill with drift protection, atomic backup/replacement, tool and gateway verification, and explicit restart control, then starts or stops the Telegram `ask_user` bridge in a dedicated pane in the current Herdr workspace. Bridge sends are pinned to the verified Hermes profile instead of relying on the sticky default.
14
+ - fb50bef: Add `just fleet` as the unified Pi runtime entry point. Fleet Core now guarantees Damage Control Continue, local/remote `ask_user`, Speech-to-Text, Compact & Continue, BTW, and update checks across the default session, Hub, standalone coms peers, and Herdr Pi peers. Add composable `peer`, `hub`, `team`, conductor, lifecycle, browser, and extension-discovery modes behind a single public Just recipe; the former Hub, team, coms, and conductor recipe aliases are removed.
15
+ - aa5630c: Fix symlinked Agent Hub launches after package-only updates. The hub monitor runtime now ships atomically under the shared harness library, and `ask-user-remote` canonicalizes its own package path before loading the bundled `pi-ask-user` dependency.
16
+ - d0e1914: Hoist MCP extension runtime dependencies into the published package so symlinked `chrome-devtools-mcp` peers can resolve the SDK from their real npm package path. Add package-surface regression coverage and strengthen setup/runtime verification guidance.
17
+
3
18
  ## 0.0.4
4
19
 
5
20
  ### Patch Changes
package/README.md CHANGED
@@ -37,27 +37,29 @@ 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
- just hub # guarded multi-agent dispatcher
43
- just hub-team docs # hub + a whole peer team in one tiled herdr workspace
42
+ just fleet # guarded Pi + STT and core utilities
43
+ just fleet hub # guarded multi-agent dispatcher
44
+ just fleet team docs # hub + guarded peers in one tiled herdr workspace
44
45
  ```
45
46
 
46
47
  ### Claude Code / OpenCode
47
48
 
48
49
  ```bash
49
50
  npx @chankov/agent-fleet init
50
- # then open your coding agent in this directory and run:
51
- # /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
52
54
  ```
53
55
 
54
- 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.
55
57
 
56
58
  | CLI command | What it does |
57
59
  |---|---|
58
- | `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 |
59
61
  | `npx @chankov/agent-fleet doctor` | Scan for broken symlinks and stale persona refs |
60
- | `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 |
61
63
  | `npx @chankov/agent-fleet transform-persona` | Generate per-agent subagent files from the canonical personas |
62
64
 
63
65
  <details>
@@ -94,13 +96,13 @@ The optional Codex Remote-Control conductor is verified on Linux with Codex CLI
94
96
 
95
97
  ```bash
96
98
  cd /path/to/agent-fleet
97
- just conductor-codex-setup docs --project af # once per configured context
98
- just conductor-codex-pair # interactive; never capture the code
99
- just conductor-codex-start
100
- just hub-team docs --project af # hub + peers Codex can reach
99
+ just fleet conductor codex setup docs --project af # once per configured context
100
+ just fleet conductor codex pair # interactive; never capture the code
101
+ just fleet conductor codex start
102
+ just fleet team docs --project af # hub + peers Codex can reach
101
103
  ```
102
104
 
103
- In ChatGPT Android, open the paired Remote Control host and use the managed external workspace at `$HOME/.local/state/agent-fleet/codex-conductor/workspace`. Do not start a local `codex` process for the Android flow, and do not also launch `conductor-codex docs` when `hub-team docs` already owns the same peers.
105
+ In ChatGPT Android, open the paired Remote Control host and use the managed external workspace at `$HOME/.local/state/agent-fleet/codex-conductor/workspace`. Do not start a local `codex` process for the Android flow, and do not also launch `just fleet conductor codex docs` when `just fleet team docs` already owns the same peers.
104
106
 
105
107
  Lifecycle, approval flow, examples, recovery, and security boundaries: **[Codex Remote-Control conductor runbook](docs/codex-remote-conductor.md)**.
106
108
 
@@ -120,17 +122,17 @@ What makes it different is what it **doesn't** put in front of the dispatcher LL
120
122
 
121
123
  ![agent-hub compact view with the btw side-session](docs/assets/agent-hub-compact.png)
122
124
 
123
- 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.
124
126
 
125
127
  ```bash
126
- just hub # guarded dispatcher + research + coms + orchestrator persona
127
- just hub-solo # same, without the coms layer
128
+ just fleet hub # guarded dispatcher + research + coms + orchestrator persona
129
+ just fleet hub --solo # same, without the coms layer
128
130
 
129
131
  # fleet recipes (need a running herdr server — https://herdr.dev)
130
- just team-up full # spawn addressable peers into a tiled herdr workspace
131
- just hub-team docs # hub + a whole team in ONE workspace
132
- just team-down docs # snapshot + close cleanly
133
- just team-resume docs # rebuild the grid; pi peers continue their conversations
132
+ just fleet team full --no-hub # guarded addressable peers in a tiled workspace
133
+ just fleet team docs # hub + guarded peers in ONE workspace
134
+ just fleet down docs # snapshot + close cleanly
135
+ just fleet resume docs # rebuild the grid; pi peers continue their conversations
134
136
  ```
135
137
 
136
138
  Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the full dispatch loop, coms layer, configuration) · [fleet hierarchy](docs/ARCHITECTURE.md#fleet-hierarchy) · [pi extension catalog](docs/pi-extensions.md) · [Claude Code coms bridge](docs/claude-code-coms-bridge.md) · [Hermes bridge](docs/coms-hermes-bridge.md) · [Hermes integration screenshots](hermes/README.md#integration-in-action).
@@ -145,23 +147,23 @@ Deep dive: [agent-hub harness README](.pi/harnesses/agent-hub/README.md) (the fu
145
147
  │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │ QA │ ───▶ │ Go │
146
148
  │Refine│ │ PRD │ │ Impl │ │Debug │ │ Gate │ │ Live │
147
149
  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘
148
- /spec /plan /build /test /review /ship
150
+ spec plan build test review ship
149
151
  ```
150
152
 
151
- 10 slash commands map to the development lifecycle; each activates the right skills automatically:
152
-
153
- | What you're doing | Command | Key principle |
154
- |-------------------|---------|---------------|
155
- | Define what to build | `/spec` | Spec before code |
156
- | Plan how to build it | `/plan` | Small, atomic tasks |
157
- | Build incrementally | `/build` | One slice at a time (`/build auto` runs the whole plan in one approved pass) |
158
- | Prove it works | `/test` | Tests are proof |
159
- | Review before merge | `/review` | Improve code health |
160
- | Audit web performance | `/webperf` | Measure before you optimize |
161
- | Simplify the code | `/code-simplify` | Clarity over cleverness |
162
- | Ship to production | `/ship` | Faster is safer |
163
- | Orchestrate a team | `/orchestrate` | Main session drives a config-defined subagent roster (claude-code/opencode; pi uses agent-hub) |
164
- | 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 |
165
167
 
166
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`.
167
169
 
@@ -182,7 +184,7 @@ Full catalog with descriptions and triggers: **[docs/skills-catalog.md](docs/ski
182
184
 
183
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`.
184
186
 
185
- 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`.
186
188
 
187
189
  Full roster, skill hooks, install matrix, and team composition: **[docs/agents.md](docs/agents.md)**.
188
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,10 +2,11 @@
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
+ // set-hermes-telegram install/inspect the liaison and start/stop its bridge
9
10
  //
10
11
  // The CLI itself never decides which skills to install or what to overwrite —
11
12
  // that is the job of the guided-workspace-setup skill, run by the user's
@@ -25,6 +26,7 @@ import { listPersonas, transformPersona } from "./lib/transform-persona.js";
25
26
  import { detectAgent, agentLabel, AGENTS } from "./lib/detect-agent.js";
26
27
  import { checkAndNotify } from "./lib/update-notifier.js";
27
28
  import { bootstrap, cleanupInstaller, readBootstrapMarker } from "./lib/bootstrap.js";
29
+ import { setHermesTelegram } from "./lib/set-hermes-telegram.js";
28
30
 
29
31
  const __dirname = dirname(fileURLToPath(import.meta.url));
30
32
  const pkgRoot = resolve(__dirname, "..");
@@ -54,6 +56,9 @@ const parsed = (() => {
54
56
  method: { type: "string" },
55
57
  workspace: { type: "string" },
56
58
  yes: { type: "boolean", short: "y" },
59
+ profile: { type: "string" },
60
+ force: { type: "boolean" },
61
+ restart: { type: "boolean" },
57
62
  "dry-run": { type: "boolean" },
58
63
  launch: { type: "boolean" },
59
64
  all: { type: "boolean" },
@@ -91,11 +96,58 @@ switch (sub) {
91
96
  case "check-update": await cmdCheckUpdate(); break;
92
97
  case "cleanup-installer": await cmdCleanupInstaller(); break;
93
98
  case "transform-persona": await cmdTransformPersona(); break;
94
- default: fail(`unknown command: ${sub}\n\nRun "agent-fleet --help" for usage.`);
99
+ case "set-hermes-telegram": await cmdSetHermesTelegram(); break;
100
+ default: fail(`unknown command: ${sub}\n\nRun "agent-fleet --help" for usage.`);
95
101
  }
96
102
 
97
103
  // ── commands ──────────────────────────────────────────────────────────────
98
104
 
105
+ async function cmdSetHermesTelegram() {
106
+ try {
107
+ const result = await setHermesTelegram({
108
+ positionals: parsed.positionals,
109
+ profile: opts.profile,
110
+ force: opts.force,
111
+ restart: opts.restart,
112
+ currentPaneId: process.env.HERDR_PANE_ID,
113
+ packageRoot: pkgRoot,
114
+ env: process.env,
115
+ });
116
+ if (result.action === "status") {
117
+ console.log(`Hermes Telegram status (${result.profile})`);
118
+ console.log(` profile: ${result.profilePath}`);
119
+ console.log(` gateway: ${result.gatewayRunning ? "running" : "stopped"}`);
120
+ console.log(` hub-liaison: ${result.skillState}, ${result.skillEnabled ? "enabled" : "disabled"}`);
121
+ console.log(` Telegram tools: terminal=${result.tools.terminal ? "enabled" : "disabled"}, file=${result.tools.file ? "enabled" : "disabled"}`);
122
+ console.log(` ready: ${result.ready ? "yes" : "no"}`);
123
+ } else if (result.action === "install") {
124
+ console.log(`✓ hub-liaison is ${result.skillState} in Hermes profile ${result.profile}.`);
125
+ console.log(` ${result.changed ? "installed packaged Agent Fleet copy" : "no skill files changed"}`);
126
+ if (result.backupDir) console.log(` backup: ${result.backupDir}`);
127
+ console.log(` gateway: ${result.gatewayRunning ? "running" : "stopped"}`);
128
+ console.log(` Telegram tools: terminal=${result.tools.terminal ? "enabled" : "disabled"}, file=${result.tools.file ? "enabled" : "disabled"}`);
129
+ if (!result.skillEnabled) console.log(` action required: enable hub-liaison with: hermes --profile ${result.profile} skills config`);
130
+ if (!result.tools.terminal || !result.tools.file) console.log(` action required: hermes --profile ${result.profile} tools enable --platform telegram terminal file`);
131
+ if (!result.gatewayRunning) console.log(` action required: hermes --profile ${result.profile} gateway start`);
132
+ if (result.restarted) console.log(" gateway restarted by explicit --restart");
133
+ else if (result.restartRequired) console.log(` restart required: hermes --profile ${result.profile} gateway restart`);
134
+ console.log(` ready: ${result.ready && (!result.restartRequired || result.restarted) ? "yes" : "pending actions above"}`);
135
+ } else if (result.action === "on") {
136
+ console.log(`✓ Hermes Telegram bridge is on: ${result.target}`);
137
+ console.log(` project: ${result.project}`);
138
+ console.log(` Hermes profile: ${result.hermesProfile}`);
139
+ console.log(` workspace: ${result.workspaceId}`);
140
+ console.log(` pane: ${result.paneId} (hermes-bridge)`);
141
+ } else if (result.closedPaneIds.length > 0) {
142
+ console.log(`✓ Hermes Telegram bridge is off in ${result.workspaceId} (closed ${result.closedPaneIds.join(", ")}).`);
143
+ } else {
144
+ console.log(`✓ Hermes Telegram bridge is already off in ${result.workspaceId}.`);
145
+ }
146
+ } catch (err) {
147
+ fail(err instanceof Error ? err.message : String(err));
148
+ }
149
+ }
150
+
99
151
  async function cmdInit() {
100
152
  await mustBeDirectory(workspace, "workspace");
101
153
 
@@ -113,10 +165,9 @@ async function cmdInit() {
113
165
  }
114
166
 
115
167
  // Bootstrap the installer artifacts (setup + doctor + the skill they invoke).
116
- // Without this, the agent has no /setup-agent-fleet command to hand off to — the
117
- // /setup-agent-fleet command is itself one of the files this writes. The rest of the
118
- // catalogue (skills, personas, etc.) is the job of /setup-agent-fleet running inside
119
- // 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.
120
171
  printSection("Bootstrap installer");
121
172
  const { written, skipped, removed, warnings } = bootstrap({
122
173
  agent,
@@ -204,7 +255,7 @@ async function cmdDoctor() {
204
255
  `\n✓ Doctor finished — repaired ${repaired}, deleted ${deleted}, skipped ${skipped}.`,
205
256
  );
206
257
  console.log(
207
- "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.",
208
259
  );
209
260
  }
210
261
 
@@ -217,7 +268,7 @@ async function cmdUpdate() {
217
268
 
218
269
  // npm itself does the package upgrade. The CLI's job here is to read the
219
270
  // workspace's install record, surface the version delta, re-install the
220
- // /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
221
272
  // refresh.
222
273
  const recordPath = join(workspace, ".ai", "agent-fleet-setup.md");
223
274
  if (!existsSync(recordPath)) {
@@ -233,11 +284,11 @@ async function cmdUpdate() {
233
284
  console.log(`Installed package: v${current}`);
234
285
  console.log();
235
286
 
236
- // 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
237
288
  // after the update. guided-workspace-setup removes these at the end of a
238
289
  // run by default (Step 10b / cleanupInstaller), so a workspace that has
239
290
  // completed setup once no longer has the command — and `update` used to
240
- // 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
241
292
  // longer existed. The marker recovers the agent/method from init time; if
242
293
  // it was cleaned up too, fall back to detection (and prompt if ambiguous).
243
294
  const marker = readBootstrapMarker(workspace);
@@ -272,7 +323,7 @@ async function cmdUpdate() {
272
323
  console.log(` ✗ skipped: ${relative(workspace, f.dest)} — ${f.error}`);
273
324
  }
274
325
 
275
- const setupCmd = agent === "opencode" ? "/af-setup-agent-fleet" : "/setup-agent-fleet";
326
+ const setupCmd = agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
276
327
 
277
328
  printSection("Next step");
278
329
  if (recorded === current) {
@@ -418,7 +469,7 @@ async function chooseAgent(supplied) {
418
469
  function printHandoff({ agent, method, workspace, source, version }) {
419
470
  const rel = relative(process.cwd(), workspace) || ".";
420
471
  const setupCmd =
421
- agent === "opencode" ? "/af-setup-agent-fleet" : "/setup-agent-fleet";
472
+ agent === "claude-code" ? "/setup-agent-fleet" : "/af-setup-agent-fleet";
422
473
  const lines = [
423
474
  `agent-fleet v${version} is ready.`,
424
475
  "",
@@ -465,7 +516,8 @@ function tryLaunch(agent, cwd) {
465
516
  const r = spawnSync(cmd, [], { cwd, stdio: "inherit" });
466
517
  if (r.error) {
467
518
  console.log(`(could not launch ${cmd}: ${r.error.message})`);
468
- 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}.`);
469
521
  }
470
522
  }
471
523
 
@@ -530,7 +582,7 @@ function printHelp(sub) {
530
582
  if (sub === "init") {
531
583
  console.log(`agent-fleet init [options]
532
584
 
533
- 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.
534
586
 
535
587
  Options:
536
588
  --agent <claude-code|opencode|pi> Skip the agent auto-detection
@@ -574,16 +626,44 @@ Examples:
574
626
  agent-fleet transform-persona --list --agent claude-code
575
627
  agent-fleet transform-persona --agent claude-code code-reviewer
576
628
  agent-fleet transform-persona --agent opencode --all --workspace ~/projects/foo
629
+ `);
630
+ return;
631
+ }
632
+ if (sub === "set-hermes-telegram") {
633
+ console.log(`agent-fleet set-hermes-telegram <action> [arguments] [options]
634
+
635
+ Actions:
636
+ install Atomically install/reconcile the packaged hub-liaison skill
637
+ status Inspect gateway, skill drift/enabled state, and Telegram tools
638
+ on <id[:topic]> Start a ready bridge in a new pane in this Herdr workspace
639
+ off <id[:topic]> Stop bridge panes in this Herdr workspace
640
+
641
+ Options:
642
+ --profile <name> Hermes gateway profile; auto-detect only when exactly one runs
643
+ --force Back up and replace a drifted installed skill
644
+ --restart Explicitly restart a running gateway after install
645
+ -h, --help Show this help
646
+
647
+ The on action fails closed unless hub-liaison is current and enabled, the
648
+ profile gateway is running, and Telegram terminal/file tools are enabled.
649
+ No action sends a test Telegram message.
650
+
651
+ Examples:
652
+ agent-fleet set-hermes-telegram status --profile default
653
+ agent-fleet set-hermes-telegram install --profile default
654
+ agent-fleet set-hermes-telegram install --profile default --force --restart
655
+ agent-fleet set-hermes-telegram on 7883056502:1735 --profile default
656
+ agent-fleet set-hermes-telegram off 7883056502:1735
577
657
  `);
578
658
  return;
579
659
  }
580
660
  if (sub === "update") {
581
661
  console.log(`agent-fleet update [options]
582
662
 
583
- Surface the version delta and re-install the /setup-agent-fleet command so
584
- it is always present after an update (guided-workspace-setup removes it at
585
- the end of a run by default). The actual diff-aware refresh then runs inside
586
- 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.
587
667
 
588
668
  Options:
589
669
  --agent <claude-code|opencode|pi> Override the agent (default: marker → auto-detect)
@@ -604,14 +684,15 @@ Usage:
604
684
  npx agent-fleet <command> [options]
605
685
 
606
686
  Commands:
607
- init Bootstrap installer files + hand off to /setup-agent-fleet
687
+ init Bootstrap installer files + hand off to the setup workflow
608
688
  doctor Scan for broken symlinks and stale persona references
609
- update Surface the version delta + hand off to /setup-agent-fleet
689
+ update Surface the version delta + hand off to the setup workflow
610
690
  check-update One-line registry check (used by session hooks; safe to script)
611
691
  cleanup-installer Remove the installer slash commands from a workspace (used
612
692
  by the skill at end of setup; safe to run by hand)
613
693
  transform-persona Generate per-agent subagent files from the canonical
614
694
  agents/*.md personas (used by the setup skill during apply)
695
+ set-hermes-telegram Install/status the liaison and start/stop its Herdr bridge
615
696
 
616
697
  Options:
617
698
  -v, --version Print the package version
@@ -622,6 +703,7 @@ Examples:
622
703
  npx agent-fleet init --agent claude-code --method copy
623
704
  npx agent-fleet doctor --workspace ~/projects/foo
624
705
  npx agent-fleet update
706
+ npx agent-fleet set-hermes-telegram on 7883056502:1735
625
707
 
626
708
  Environment:
627
709
  AGENT_SKILLS_NO_UPDATE_CHECK=1 Disable the background update check