@chankov/agent-fleet 0.0.5 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (314) hide show
  1. package/.pi/extensions/agent-fleet-update-check/README.md +4 -4
  2. package/.pi/extensions/btw/README.md +10 -10
  3. package/.pi/extensions/btw/index.ts +11 -11
  4. package/.pi/extensions/chrome-devtools-mcp/README.md +2 -2
  5. package/.pi/extensions/chrome-devtools-mcp/index.ts +1 -0
  6. package/.pi/extensions/compact-and-continue/README.md +2 -2
  7. package/.pi/extensions/pi-voice-stt/README.md +7 -7
  8. package/.pi/extensions/pi-voice-stt/index.ts +4 -4
  9. package/.pi/harnesses/agent-hub/README.md +58 -58
  10. package/.pi/harnesses/agent-hub/backend-policy.js +1 -1
  11. package/.pi/harnesses/agent-hub/delegate.ts +3 -3
  12. package/.pi/harnesses/agent-hub/drift-watchdog.js +1 -1
  13. package/.pi/harnesses/agent-hub/index.ts +248 -248
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/run-budget.js +1 -1
  16. package/.pi/harnesses/coms/README.md +2 -2
  17. package/.pi/harnesses/coms/index.ts +13 -13
  18. package/.pi/harnesses/coms/package.json +1 -1
  19. package/.pi/harnesses/damage-control-continue/README.md +9 -9
  20. package/.pi/harnesses/damage-control-continue/index.ts +11 -11
  21. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  22. package/.pi/prompts/{doctor-agent-fleet.md → af-doctor-agent-fleet.md} +1 -1
  23. package/.pi/prompts/{setup-agent-fleet.md → af-setup-agent-fleet.md} +1 -1
  24. package/.versions/0.0.6/.claude/commands/build.md +44 -0
  25. package/.versions/0.0.6/.claude/commands/code-simplify.md +22 -0
  26. package/.versions/0.0.6/.claude/commands/design-agent.md +14 -0
  27. package/.versions/0.0.6/.claude/commands/doctor-agent-fleet.md +17 -0
  28. package/.versions/0.0.6/.claude/commands/orchestrate.md +112 -0
  29. package/.versions/0.0.6/.claude/commands/plan.md +16 -0
  30. package/.versions/0.0.6/.claude/commands/prime.md +22 -0
  31. package/.versions/0.0.6/.claude/commands/review.md +16 -0
  32. package/.versions/0.0.6/.claude/commands/set-hermes-telegram.md +15 -0
  33. package/.versions/0.0.6/.claude/commands/setup-agent-fleet.md +25 -0
  34. package/.versions/0.0.6/.claude/commands/ship.md +72 -0
  35. package/.versions/0.0.6/.claude/commands/spec.md +15 -0
  36. package/.versions/0.0.6/.claude/commands/test.md +19 -0
  37. package/.versions/0.0.6/.claude/commands/webperf.md +32 -0
  38. package/.versions/0.0.6/.claude/orchestrate-teams.yaml +24 -0
  39. package/.versions/0.0.6/.opencode/commands/af-build.md +17 -0
  40. package/.versions/0.0.6/.opencode/commands/af-code-simplify.md +16 -0
  41. package/.versions/0.0.6/.opencode/commands/af-compound.md +16 -0
  42. package/.versions/0.0.6/.opencode/commands/af-design-agent.md +15 -0
  43. package/.versions/0.0.6/.opencode/commands/af-doctor-agent-fleet.md +17 -0
  44. package/.versions/0.0.6/.opencode/commands/af-orchestrate.md +112 -0
  45. package/.versions/0.0.6/.opencode/commands/af-plan.md +16 -0
  46. package/.versions/0.0.6/.opencode/commands/af-prime.md +22 -0
  47. package/.versions/0.0.6/.opencode/commands/af-review.md +15 -0
  48. package/.versions/0.0.6/.opencode/commands/af-set-hermes-telegram.md +15 -0
  49. package/.versions/0.0.6/.opencode/commands/af-setup-agent-fleet.md +15 -0
  50. package/.versions/0.0.6/.opencode/commands/af-ship.md +16 -0
  51. package/.versions/0.0.6/.opencode/commands/af-spec.md +16 -0
  52. package/.versions/0.0.6/.opencode/commands/af-test.md +21 -0
  53. package/.versions/0.0.6/.opencode/commands/af-webperf.md +32 -0
  54. package/.versions/0.0.6/.opencode/orchestrate-teams.yaml +24 -0
  55. package/.versions/0.0.6/.pi/agents/dispatch-policy.yaml +32 -0
  56. package/.versions/0.0.6/.pi/agents/model-profiles.yaml +20 -0
  57. package/.versions/0.0.6/.pi/agents/peers.yaml +146 -0
  58. package/.versions/0.0.6/.pi/agents/teams.yaml +39 -0
  59. package/.versions/0.0.6/.pi/damage-control-rules.yaml +297 -0
  60. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  61. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  62. package/.versions/0.0.6/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  63. package/.versions/0.0.6/.pi/extensions/btw/README.md +118 -0
  64. package/.versions/0.0.6/.pi/extensions/btw/index.ts +917 -0
  65. package/.versions/0.0.6/.pi/extensions/btw/package.json +6 -0
  66. package/.versions/0.0.6/.pi/extensions/btw/state.js +179 -0
  67. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  68. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  69. package/.versions/0.0.6/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  70. package/.versions/0.0.6/.pi/extensions/compact-and-continue/README.md +42 -0
  71. package/.versions/0.0.6/.pi/extensions/compact-and-continue/index.ts +120 -0
  72. package/.versions/0.0.6/.pi/extensions/compact-and-continue/package.json +6 -0
  73. package/.versions/0.0.6/.pi/extensions/mcp-bridge/README.md +46 -0
  74. package/.versions/0.0.6/.pi/extensions/mcp-bridge/index.ts +206 -0
  75. package/.versions/0.0.6/.pi/extensions/mcp-bridge/package.json +6 -0
  76. package/.versions/0.0.6/.pi/extensions/package-lock.json +1143 -0
  77. package/.versions/0.0.6/.pi/extensions/package.json +9 -0
  78. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/README.md +201 -0
  79. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/config.ts +198 -0
  80. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  81. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/index.ts +248 -0
  82. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/package.json +6 -0
  83. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  84. package/.versions/0.0.6/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  85. package/.versions/0.0.6/.pi/harnesses/agent-hub/README.md +798 -0
  86. package/.versions/0.0.6/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  87. package/.versions/0.0.6/.pi/harnesses/agent-hub/artifacts.js +92 -0
  88. package/.versions/0.0.6/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  89. package/.versions/0.0.6/.pi/harnesses/agent-hub/delegate.ts +386 -0
  90. package/.versions/0.0.6/.pi/harnesses/agent-hub/drift-watchdog.js +165 -0
  91. package/.versions/0.0.6/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  92. package/.versions/0.0.6/.pi/harnesses/agent-hub/footer.ts +29 -0
  93. package/.versions/0.0.6/.pi/harnesses/agent-hub/helpers.ts +214 -0
  94. package/.versions/0.0.6/.pi/harnesses/agent-hub/index.ts +8045 -0
  95. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  96. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  97. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  98. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  99. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  100. package/.versions/0.0.6/.pi/harnesses/agent-hub/monitor-session-bridge.ts +11 -0
  101. package/.versions/0.0.6/.pi/harnesses/agent-hub/package.json +7 -0
  102. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-retention.js +34 -0
  103. package/.versions/0.0.6/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  104. package/.versions/0.0.6/.pi/harnesses/agent-hub/return-contract.js +215 -0
  105. package/.versions/0.0.6/.pi/harnesses/agent-hub/run-budget.js +155 -0
  106. package/.versions/0.0.6/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  107. package/.versions/0.0.6/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  108. package/.versions/0.0.6/.pi/harnesses/agent-hub/spawn.ts +246 -0
  109. package/.versions/0.0.6/.pi/harnesses/agent-hub/version.ts +18 -0
  110. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/README.md +19 -0
  111. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/index.ts +321 -0
  112. package/.versions/0.0.6/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  113. package/.versions/0.0.6/.pi/harnesses/coms/README.md +92 -0
  114. package/.versions/0.0.6/.pi/harnesses/coms/index.ts +1745 -0
  115. package/.versions/0.0.6/.pi/harnesses/coms/package.json +7 -0
  116. package/.versions/0.0.6/.pi/harnesses/coms/version.ts +18 -0
  117. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/README.md +117 -0
  118. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/index.ts +536 -0
  119. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/package.json +7 -0
  120. package/.versions/0.0.6/.pi/harnesses/damage-control-continue/version.ts +18 -0
  121. package/.versions/0.0.6/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  122. package/.versions/0.0.6/.pi/harnesses/lib/herdr-client.ts +458 -0
  123. package/.versions/0.0.6/.pi/harnesses/lib/herdr-presence.ts +288 -0
  124. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  125. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-model.ts +9 -0
  126. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  127. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-socket.ts +118 -0
  128. package/.versions/0.0.6/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  129. package/.versions/0.0.6/.pi/harnesses/package-lock.json +35 -0
  130. package/.versions/0.0.6/.pi/harnesses/package.json +9 -0
  131. package/.versions/0.0.6/.pi/prompts/af-build.md +24 -0
  132. package/.versions/0.0.6/.pi/prompts/af-code-simplify.md +22 -0
  133. package/.versions/0.0.6/.pi/prompts/af-doctor-agent-fleet.md +15 -0
  134. package/.versions/0.0.6/.pi/prompts/af-plan.md +16 -0
  135. package/.versions/0.0.6/.pi/prompts/af-review.md +16 -0
  136. package/.versions/0.0.6/.pi/prompts/af-set-hermes-telegram.md +15 -0
  137. package/.versions/0.0.6/.pi/prompts/af-setup-agent-fleet.md +27 -0
  138. package/.versions/0.0.6/.pi/prompts/af-ship.md +17 -0
  139. package/.versions/0.0.6/.pi/prompts/af-spec.md +15 -0
  140. package/.versions/0.0.6/.pi/prompts/af-test.md +19 -0
  141. package/.versions/0.0.6/.pi/skills/bowser/SKILL.md +145 -0
  142. package/.versions/0.0.6/.version +1 -0
  143. package/.versions/0.0.6/agents/architect.md +23 -0
  144. package/.versions/0.0.6/agents/bowser.md +26 -0
  145. package/.versions/0.0.6/agents/builder.md +53 -0
  146. package/.versions/0.0.6/agents/code-reviewer.md +205 -0
  147. package/.versions/0.0.6/agents/deep-researcher.md +31 -0
  148. package/.versions/0.0.6/agents/documenter.md +18 -0
  149. package/.versions/0.0.6/agents/orchestrator.md +54 -0
  150. package/.versions/0.0.6/agents/plan-reviewer.md +60 -0
  151. package/.versions/0.0.6/agents/planner.md +69 -0
  152. package/.versions/0.0.6/agents/releaser.md +24 -0
  153. package/.versions/0.0.6/agents/researcher.md +28 -0
  154. package/.versions/0.0.6/agents/security-auditor.md +166 -0
  155. package/.versions/0.0.6/agents/test-engineer.md +151 -0
  156. package/.versions/0.0.6/agents/web-debugger.md +42 -0
  157. package/.versions/0.0.6/agents/web-performance-auditor.md +192 -0
  158. package/.versions/0.0.6/codex/CONDUCTOR.md +148 -0
  159. package/.versions/0.0.6/docs/ARCHITECTURE.md +210 -0
  160. package/.versions/0.0.6/docs/agent-fleet-setup.md +366 -0
  161. package/.versions/0.0.6/docs/claude-code-coms-bridge.md +103 -0
  162. package/.versions/0.0.6/docs/codex-remote-conductor.md +170 -0
  163. package/.versions/0.0.6/docs/coms-hermes-bridge.md +179 -0
  164. package/.versions/0.0.6/docs/getting-started.md +183 -0
  165. package/.versions/0.0.6/docs/npm-install.md +337 -0
  166. package/.versions/0.0.6/docs/opencode-setup.md +249 -0
  167. package/.versions/0.0.6/docs/pi-extensions.md +293 -0
  168. package/.versions/0.0.6/docs/pi-setup.md +476 -0
  169. package/.versions/0.0.6/docs/skill-anatomy.md +150 -0
  170. package/.versions/0.0.6/hermes/README.md +231 -0
  171. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  172. package/.versions/0.0.6/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  173. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-cap.test.py +15 -0
  174. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-discovery.test.py +19 -0
  175. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-envelope.test.py +13 -0
  176. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-forged-owner.test.py +11 -0
  177. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-lease-list.test.py +9 -0
  178. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-multihub.test.py +17 -0
  179. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter-output.test.py +34 -0
  180. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +151 -0
  181. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/adapter.test.py +39 -0
  182. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  183. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin-api-validation.test.py +12 -0
  184. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  185. package/.versions/0.0.6/hermes/plugins/agent-fleet-monitor/dashboard/review-live-wiring.red.test.py +22 -0
  186. package/.versions/0.0.6/hermes/skills/hub-conductor/SKILL.md +84 -0
  187. package/.versions/0.0.6/hermes/skills/hub-liaison/SKILL.md +84 -0
  188. package/.versions/0.0.6/hooks/SIMPLIFY-IGNORE.md +90 -0
  189. package/.versions/0.0.6/hooks/coms-stop-hook.mjs +73 -0
  190. package/.versions/0.0.6/hooks/hooks.json +14 -0
  191. package/.versions/0.0.6/hooks/session-start.sh +74 -0
  192. package/.versions/0.0.6/hooks/simplify-ignore.sh +302 -0
  193. package/.versions/0.0.6/justfile +245 -0
  194. package/.versions/0.0.6/references/accessibility-checklist.md +160 -0
  195. package/.versions/0.0.6/references/definition-of-done.md +67 -0
  196. package/.versions/0.0.6/references/fleet-coordination-patterns.md +151 -0
  197. package/.versions/0.0.6/references/observability-checklist.md +91 -0
  198. package/.versions/0.0.6/references/orchestration-patterns.md +370 -0
  199. package/.versions/0.0.6/references/performance-checklist.md +153 -0
  200. package/.versions/0.0.6/references/prompting-patterns.md +380 -0
  201. package/.versions/0.0.6/references/security-checklist.md +179 -0
  202. package/.versions/0.0.6/references/testing-patterns.md +236 -0
  203. package/.versions/0.0.6/scripts/codex-conductor.ts +41 -0
  204. package/.versions/0.0.6/scripts/codex-remote-control.ts +167 -0
  205. package/.versions/0.0.6/scripts/coms-claude-bridge.ts +286 -0
  206. package/.versions/0.0.6/scripts/coms-cli.ts +484 -0
  207. package/.versions/0.0.6/scripts/coms-hermes-bridge.ts +413 -0
  208. package/.versions/0.0.6/scripts/fleet.ts +141 -0
  209. package/.versions/0.0.6/scripts/hermes-monitor-capability-runner.ts +25 -0
  210. package/.versions/0.0.6/scripts/hermes-monitor-scenario.ts +7 -0
  211. package/.versions/0.0.6/scripts/lib/claude-bridge-core.ts +100 -0
  212. package/.versions/0.0.6/scripts/lib/codex-conductor.ts +88 -0
  213. package/.versions/0.0.6/scripts/lib/codex-remote-control.ts +480 -0
  214. package/.versions/0.0.6/scripts/lib/coms-envelope.ts +539 -0
  215. package/.versions/0.0.6/scripts/lib/fake-herdr-server.ts +88 -0
  216. package/.versions/0.0.6/scripts/lib/fleet-command.ts +109 -0
  217. package/.versions/0.0.6/scripts/lib/herdr-layout.ts +263 -0
  218. package/.versions/0.0.6/scripts/lib/hermes-bridge-core.ts +241 -0
  219. package/.versions/0.0.6/scripts/lib/hermes-monitor-herdr.ts +2 -0
  220. package/.versions/0.0.6/scripts/lib/hermes-monitor-model.ts +3 -0
  221. package/.versions/0.0.6/scripts/lib/hermes-monitor-registry.ts +2 -0
  222. package/.versions/0.0.6/scripts/lib/hermes-monitor-socket.ts +2 -0
  223. package/.versions/0.0.6/scripts/lib/hermes-monitor-store.ts +2 -0
  224. package/.versions/0.0.6/scripts/lib/persona-banner.ts +62 -0
  225. package/.versions/0.0.6/scripts/lib/spawn-stagger.ts +101 -0
  226. package/.versions/0.0.6/scripts/lib/team-project.ts +191 -0
  227. package/.versions/0.0.6/scripts/lib/team-snapshot.ts +147 -0
  228. package/.versions/0.0.6/scripts/peer-banner.ts +40 -0
  229. package/.versions/0.0.6/scripts/team-snapshot.ts +237 -0
  230. package/.versions/0.0.6/scripts/team-up.ts +351 -0
  231. package/.versions/0.0.6/skills/_internal/grilling.md +11 -0
  232. package/.versions/0.0.6/skills/browser-testing-with-devtools/SKILL.md +352 -0
  233. package/.versions/0.0.6/skills/code-review-and-quality/SKILL.md +381 -0
  234. package/.versions/0.0.6/skills/compound-learning/SKILL.md +137 -0
  235. package/.versions/0.0.6/skills/context-engineering/SKILL.md +291 -0
  236. package/.versions/0.0.6/skills/deprecation-and-migration/SKILL.md +206 -0
  237. package/.versions/0.0.6/skills/designing-agents/SKILL.md +394 -0
  238. package/.versions/0.0.6/skills/designing-agents/pi-harness-authoring.md +222 -0
  239. package/.versions/0.0.6/skills/frontend-ui-engineering/SKILL.md +328 -0
  240. package/.versions/0.0.6/skills/git-workflow-and-versioning/SKILL.md +316 -0
  241. package/.versions/0.0.6/skills/guided-workspace-setup/SKILL.md +544 -0
  242. package/.versions/0.0.6/skills/guided-workspace-setup/companion-manifest.json +35 -0
  243. package/.versions/0.0.6/skills/idea-refine/SKILL.md +182 -0
  244. package/.versions/0.0.6/skills/idea-refine/examples.md +238 -0
  245. package/.versions/0.0.6/skills/idea-refine/frameworks.md +99 -0
  246. package/.versions/0.0.6/skills/idea-refine/refinement-criteria.md +113 -0
  247. package/.versions/0.0.6/skills/idea-refine/scripts/idea-refine.sh +15 -0
  248. package/.versions/0.0.6/skills/incremental-implementation/SKILL.md +287 -0
  249. package/.versions/0.0.6/skills/interview-me/SKILL.md +226 -0
  250. package/.versions/0.0.6/skills/orchestration-verification/SKILL.md +181 -0
  251. package/.versions/0.0.6/skills/peer-coms/SKILL.md +90 -0
  252. package/.versions/0.0.6/skills/performance-optimization/SKILL.md +350 -0
  253. package/.versions/0.0.6/skills/planning-and-task-breakdown/SKILL.md +236 -0
  254. package/.versions/0.0.6/skills/security-and-hardening/SKILL.md +461 -0
  255. package/.versions/0.0.6/skills/spec-driven-development/SKILL.md +245 -0
  256. package/.versions/0.0.6/skills/using-agent-skills/SKILL.md +199 -0
  257. package/.versions/0.0.6/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  258. package/.versions/0.0.6/vendor/agent-skills-upstream/LICENSE +21 -0
  259. package/.versions/0.0.6/vendor/agent-skills-upstream/README.md +11 -0
  260. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  261. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  262. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  263. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  264. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  265. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  266. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  267. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  268. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  269. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  270. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  271. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  272. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  273. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  274. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  275. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  276. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  277. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  278. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  279. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  280. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  281. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  282. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  283. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  284. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  285. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  286. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  287. package/.versions/0.0.6/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  288. package/CHANGELOG.md +6 -0
  289. package/README.md +24 -23
  290. package/agents/documenter.md +1 -1
  291. package/agents/releaser.md +1 -1
  292. package/bin/cli.js +20 -20
  293. package/bin/lib/bootstrap.js +16 -16
  294. package/bin/lib/doctor.js +1 -1
  295. package/docs/ARCHITECTURE.md +4 -4
  296. package/docs/agent-fleet-setup.md +11 -11
  297. package/docs/coms-hermes-bridge.md +8 -8
  298. package/docs/npm-install.md +21 -21
  299. package/docs/pi-extensions.md +7 -7
  300. package/docs/pi-setup.md +51 -47
  301. package/hermes/README.md +1 -1
  302. package/package.json +1 -1
  303. package/references/fleet-coordination-patterns.md +2 -2
  304. package/skills/browser-testing-with-devtools/SKILL.md +1 -1
  305. package/skills/compound-learning/SKILL.md +3 -3
  306. package/skills/guided-workspace-setup/SKILL.md +16 -14
  307. /package/.pi/prompts/{build.md → af-build.md} +0 -0
  308. /package/.pi/prompts/{code-simplify.md → af-code-simplify.md} +0 -0
  309. /package/.pi/prompts/{plan.md → af-plan.md} +0 -0
  310. /package/.pi/prompts/{review.md → af-review.md} +0 -0
  311. /package/.pi/prompts/{set-hermes-telegram.md → af-set-hermes-telegram.md} +0 -0
  312. /package/.pi/prompts/{ship.md → af-ship.md} +0 -0
  313. /package/.pi/prompts/{spec.md → af-spec.md} +0 -0
  314. /package/.pi/prompts/{test.md → af-test.md} +0 -0
@@ -6,7 +6,7 @@ A pi extension that surfaces an "update available" banner once per session when
6
6
 
7
7
  On the first `agent_start` event of a pi session, the extension:
8
8
 
9
- 1. Reads `version:` from `.ai/agent-fleet-setup.md` in the current working directory. If the record is missing (workspace was never set up via `/setup-agent-fleet`), the check is skipped.
9
+ 1. Reads `version:` from `.ai/agent-fleet-setup.md` in the current working directory. If the record is missing (workspace was never set up via `/af-setup-agent-fleet`), the check is skipped.
10
10
  2. Reads the cached latest version from `$XDG_CACHE_HOME/agent-fleet/latest-version.json` (falling back to `~/.cache/agent-fleet/`).
11
11
  3. If the cache is older than 24 hours or absent, fetches the latest version from the npm registry with a 3-second timeout.
12
12
  4. If the published version is greater than the recorded version, emits an `info`-level notification via `ctx.ui.notify`.
@@ -16,7 +16,7 @@ The check runs **once per session** and is bounded to a single network call. It
16
16
  ## When the banner fires
17
17
 
18
18
  ```
19
- agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest update" then /setup-agent-fleet to apply.
19
+ agent-fleet update available: 0.1.0 → 0.2.0. Run "npx @chankov/agent-fleet@latest update" then /af-setup-agent-fleet to apply.
20
20
  ```
21
21
 
22
22
  The banner appears in pi's UI notification area — the same surface used by other extensions for non-fatal status. It does not block, prompt, or modify any file. The user decides when to act on it.
@@ -33,7 +33,7 @@ Every error path silently aborts. Update checks must never disrupt a session.
33
33
 
34
34
  ## Install
35
35
 
36
- Installed via `/setup-agent-fleet` as part of Group 10 — pi extensions. Or symlink manually:
36
+ Installed via `/af-setup-agent-fleet` as part of Group 10 — pi extensions. Or symlink manually:
37
37
 
38
38
  ```bash
39
39
  ln -s /path/to/@chankov/agent-fleet/.pi/extensions/agent-fleet-update-check \
@@ -54,5 +54,5 @@ The check honours three environment variables (any of them disables it):
54
54
 
55
55
  - The check runs once per pi session; restarting pi triggers a new check.
56
56
  - The cache file is shared with the CLI (`agent-fleet check-update`) so both update paths benefit from a single fetch per 24h window.
57
- - If the install record is *pre-versioning* (no `version:` line), the check is skipped — there's no recorded baseline to compare against. Run `/setup-agent-fleet` once to stamp the current version.
57
+ - If the install record is *pre-versioning* (no `version:` line), the check is skipped — there's no recorded baseline to compare against. Run `/af-setup-agent-fleet` once to stamp the current version.
58
58
  - The extension only reads; it never writes the install record itself.
@@ -1,12 +1,12 @@
1
1
  # btw
2
2
 
3
- A pi extension that adds a single prompt command, `/btw`, plus an `Alt+'`
3
+ A pi extension that adds a single prompt command, `/af-btw`, plus an `Alt+'`
4
4
  shortcut, for spinning off a **side task** that inherits the full context of the
5
5
  current session and streams into a live modal — modeled on Claude Code's `/btw`.
6
6
 
7
7
  ## What it does
8
8
 
9
- `/btw <task>` forks the current session into an **in-process sub-session** and
9
+ `/af-btw <task>` forks the current session into an **in-process sub-session** and
10
10
  opens a modal over it:
11
11
 
12
12
  1. **Forks the session** — `SessionManager.forkFrom` writes the current
@@ -28,13 +28,13 @@ opens a modal over it:
28
28
 
29
29
  ## Command & shortcut
30
30
 
31
- - **`/btw <task>`** — start a side task and open its modal.
32
- - **`/btw`** (no args) — reopen the modal on the last-viewed (or most recent) thread.
31
+ - **`/af-btw <task>`** — start a side task and open its modal.
32
+ - **`/af-btw`** (no args) — reopen the modal on the last-viewed (or most recent) thread.
33
33
  - **`Alt+'`** — reopen the modal. (Chosen because it doesn't collide with a pi
34
34
  composer motion the way `Alt+B` does — that's the editor's cursor-word-left. Pick
35
35
  another binding in `index.ts` if your terminal swallows `Alt+'`.)
36
36
 
37
- Once any `/btw` command or `Alt+'` has run in a session, the **agent-hub** harness
37
+ Once any `/af-btw` command or `Alt+'` has run in a session, the **agent-hub** harness
38
38
  footer surfaces an `Alt+' btw` hint next to its `Alt+A view:` hint (via a
39
39
  `globalThis.__btwActivated` flag).
40
40
 
@@ -43,13 +43,13 @@ footer surfaces an `Alt+' btw` hint next to its `Alt+A view:` hint (via a
43
43
  - **Type + Enter** — send a follow-up. Mid-run it *steers* the active turn; when the
44
44
  task is idle it starts a fresh turn.
45
45
  - **Esc** — hide the modal. The task keeps running; you are returned to the main
46
- session. Reopen with `Alt+'` or `/btw`.
46
+ session. Reopen with `Alt+'` or `/af-btw`.
47
47
  - **↑ / ↓** — scroll the transcript (the selected entry expands; tail-follows the
48
48
  newest until you scroll up).
49
49
  - **← / →** — switch between concurrent threads (when more than one is running).
50
50
  - **Ctrl+C** — copy the selected transcript entry.
51
51
 
52
- `/btw` and `Alt+'` are the entire surface — no model-callable tool, no subcommands.
52
+ `/af-btw` and `Alt+'` are the entire surface — no model-callable tool, no subcommands.
53
53
  The agent cannot trigger it; only you can.
54
54
 
55
55
  ## Design constraints (intentional)
@@ -63,7 +63,7 @@ The agent cannot trigger it; only you can.
63
63
  or any other extension. No recursion, no double-bound MCP servers — the same
64
64
  guarantee the old `--no-extensions` child gave.
65
65
  - **Available even while the main agent is streaming.** pi executes extension
66
- commands immediately in `prompt()`, *before* the streaming queue, so `/btw` never
66
+ commands immediately in `prompt()`, *before* the streaming queue, so `/af-btw` never
67
67
  waits for the current turn to finish, and the modal opens right away.
68
68
  - **Never steals the main session's focus.** The modal is a non-capturing overlay
69
69
  that you focus on open and release on `Esc`. Task completion only fires a toast — it
@@ -104,14 +104,14 @@ packages, so no additional `npm install` is needed.
104
104
  `error` toast; the transcript shows the error inline.
105
105
  - **Shutdown.** Running threads are `abort()`ed when the main pi session shuts down —
106
106
  side tasks do not outlive their parent.
107
- - **Concurrency.** Multiple `/btw` runs can be in flight at once; the footer shows
107
+ - **Concurrency.** Multiple `/af-btw` runs can be in flight at once; the footer shows
108
108
  `btw: N running` and `← / →` switches the modal between them.
109
109
  - **Shared process group.** In-process bash from a side task competes with the main
110
110
  session for CPU — heavy side tasks will be felt by the main turn.
111
111
 
112
112
  ## Focused smoke checklist
113
113
 
114
- - Start `/btw <task>`, confirm the modal opens immediately and elapsed time counts the current turn.
114
+ - Start `/af-btw <task>`, confirm the modal opens immediately and elapsed time counts the current turn.
115
115
  - Send a mid-run follow-up, confirm it steers the same turn and produces only one card.
116
116
  - After completion, send an idle follow-up, confirm elapsed time resets and a new card is produced.
117
117
  - Complete more than 12 side-task threads, confirm only terminal history is evicted and running threads remain.
@@ -1,15 +1,15 @@
1
1
  /**
2
- * btw — in-process side tasks for pi with a live modal, modeled on Claude Code's `/btw`.
2
+ * btw — in-process side tasks for pi with a live modal, modeled on Claude Code's `/af-btw`.
3
3
  *
4
- * `/btw <task>` forks the CURRENT session into an in-process sub-session
4
+ * `/af-btw <task>` forks the CURRENT session into an in-process sub-session
5
5
  * (`createAgentSession`) that inherits the full conversation as context, works the
6
6
  * side task in the same cwd, and streams into a modal overlay with its own
7
7
  * transcript + follow-up composer. A compact result card lands in the main
8
8
  * transcript when the session next goes idle.
9
9
  *
10
10
  * Design constraints (all intentional — see .pi/extensions/btw/README.md):
11
- * - Command-only surface. No model-callable tool, no subcommands. `/btw <task>`
12
- * starts a task and opens the modal; `/btw` (no args) or `Alt+'` reopens it.
11
+ * - Command-only surface. No model-callable tool, no subcommands. `/af-btw <task>`
12
+ * starts a task and opens the modal; `/af-btw` (no args) or `Alt+'` reopens it.
13
13
  * - In-process sub-session, NOT a child `pi` process. The fork is a real
14
14
  * `AgentSession` with fixed built-in tools and NO extensions/custom tools (the
15
15
  * sub-session loads no extension runtime → no recursion, mirroring the old
@@ -149,7 +149,7 @@ export default function btwExtension(pi: ExtensionAPI) {
149
149
  // the modal always have a live handle after the original command returned.
150
150
  let latestCtx: ExtensionContext | undefined;
151
151
  // Modal lifecycle: guard against double-open, remember last-viewed thread, and
152
- // expose a handle so a fresh /btw can retarget an already-open modal.
152
+ // expose a handle so a fresh /af-btw can retarget an already-open modal.
153
153
  let modalOpen = false;
154
154
  let lastViewedId: string | undefined;
155
155
  let currentModal: CurrentModalHandle | undefined;
@@ -725,7 +725,7 @@ export default function btwExtension(pi: ExtensionAPI) {
725
725
  }
726
726
  const initial = resolveThreadId(startId, order) ?? mostRecentId();
727
727
  if (!initial) {
728
- ctx.ui.notify("No btw side tasks yet — /btw <task> to start one.", "info");
728
+ ctx.ui.notify("No btw side tasks yet — /af-btw <task> to start one.", "info");
729
729
  return;
730
730
  }
731
731
  modalOpen = true;
@@ -758,7 +758,7 @@ export default function btwExtension(pi: ExtensionAPI) {
758
758
  };
759
759
  bindRender();
760
760
 
761
- // Let a fresh /btw retarget this open modal and keep selection valid when
761
+ // Let a fresh /af-btw retarget this open modal and keep selection valid when
762
762
  // retention/pruning changes the backing thread list.
763
763
  currentModal = {
764
764
  show: (id: string) => {
@@ -811,8 +811,8 @@ export default function btwExtension(pi: ExtensionAPI) {
811
811
  }
812
812
  }
813
813
 
814
- pi.registerCommand("btw", {
815
- description: "Start a side task in a live modal (full session context), or reopen the modal. Usage: /btw [task]",
814
+ pi.registerCommand("af-btw", {
815
+ description: "Start a side task in a live modal (full session context), or reopen the modal. Usage: /af-btw [task]",
816
816
  handler: async (args: string, ctx: ExtensionCommandContext) => {
817
817
  latestCtx = ctx;
818
818
  markBtwActivated();
@@ -821,7 +821,7 @@ export default function btwExtension(pi: ExtensionAPI) {
821
821
  if (threads.size > 0) {
822
822
  await openModal(ctx, lastViewedId);
823
823
  } else {
824
- ctx.ui.notify("Usage: /btw <task> — runs a side task with this session's full context.", "warning");
824
+ ctx.ui.notify("Usage: /af-btw <task> — runs a side task with this session's full context.", "warning");
825
825
  }
826
826
  return;
827
827
  }
@@ -838,7 +838,7 @@ export default function btwExtension(pi: ExtensionAPI) {
838
838
  latestCtx = ctx;
839
839
  markBtwActivated();
840
840
  if (threads.size === 0) {
841
- ctx.ui.notify("No btw side tasks yet — /btw <task> to start one.", "info");
841
+ ctx.ui.notify("No btw side tasks yet — /af-btw <task> to start one.", "info");
842
842
  return;
843
843
  }
844
844
  await openModal(ctx, lastViewedId);
@@ -6,7 +6,7 @@ Built on top of `../mcp-bridge/` — this file is a thin wrapper that supplies C
6
6
 
7
7
  ## What you get
8
8
 
9
- After installing, pi exposes the full Chrome DevTools MCP toolset under the `chrome_devtools__` prefix (e.g. `chrome_devtools__navigate`, `chrome_devtools__click`, etc.). A status command `/chrome_devtools-status` reports whether the bridge connected.
9
+ After installing, pi exposes the full Chrome DevTools MCP toolset under the `chrome_devtools__` prefix (e.g. `chrome_devtools__navigate`, `chrome_devtools__click`, etc.). A status command `/af-chrome-devtools-status` reports whether the bridge connected.
10
10
 
11
11
  This unlocks the workflow described in `skills/browser-testing-with-devtools/` for pi users.
12
12
 
@@ -46,7 +46,7 @@ ln -s /path/to/agent-fleet/.pi/extensions/chrome-devtools-mcp .pi/extensions/chr
46
46
  Run `pi` from the project, then:
47
47
 
48
48
  ```
49
- /chrome_devtools-status
49
+ /af-chrome-devtools-status
50
50
  ```
51
51
 
52
52
  Expect: `Chrome DevTools MCP connected. Registered N tool(s).`
@@ -89,4 +89,5 @@ export default createMcpBridgeExtension({
89
89
  env: buildChromeDevToolsEnv(),
90
90
  stderr: "pipe",
91
91
  labelPrefix: "Chrome DevTools",
92
+ statusCommandName: "af-chrome-devtools-status",
92
93
  });
@@ -16,13 +16,13 @@ This keeps the user in control: compaction never interrupts a tool call mid-flig
16
16
  | `reason` | string | no | Short explanation recorded in tool details. |
17
17
  | `continuationPrompt` | string | no | Self-contained summary of the remaining plan. If provided, pi auto-resumes from this message after compaction. **Do not copy the original prompt verbatim** — restate the next concrete actions. |
18
18
 
19
- The tool does not ask for confirmation. Workflows that need confirmation (e.g. `/build`) must ask the user **before** calling it.
19
+ The tool does not ask for confirmation. Workflows that need confirmation (e.g. `/af-build`) must ask the user **before** calling it.
20
20
 
21
21
  ## When to use
22
22
 
23
23
  Use only when explicitly requested by the user, a skill, or a prompt template. Do not call it pre-emptively or on a hunch that context is "getting long" — pi has its own autocompaction for that.
24
24
 
25
- The canonical usage point in this repo is `/build`: at slice-approval time, the user can pick "Compact & continue" to compact between slices and resume from a summarized remaining plan. See `.pi/prompts/build.md` and `skills/incremental-implementation/SKILL.md`.
25
+ The canonical usage point in this repo is `/af-build`: at slice-approval time, the user can pick "Compact & continue" to compact between slices and resume from a summarized remaining plan. See `.pi/prompts/af-build.md` and `skills/incremental-implementation/SKILL.md`.
26
26
 
27
27
  ## Install
28
28
 
@@ -19,15 +19,15 @@ dependency and no build step — pi loads the TypeScript directly.
19
19
  | **Alt+S** | Start recording; press again to **transcribe and insert** into the prompt |
20
20
  | **Enter** (while recording) | Transcribe and **send** immediately |
21
21
  | **Esc** (while recording) | Cancel — discard the recording |
22
- | `/stt status` | Show config + current state |
23
- | `/stt doctor` | Check `ffmpeg`, provider, and API key |
24
- | `/stt start` · `stop` · `send` · `cancel` | Drive the state machine without the hotkey |
22
+ | `/af-stt status` | Show config + current state |
23
+ | `/af-stt doctor` | Check `ffmpeg`, provider, and API key |
24
+ | `/af-stt start` · `stop` · `send` · `cancel` | Drive the state machine without the hotkey |
25
25
 
26
26
  While recording, a `● REC m:ss` indicator animates in the status bar; during transcription
27
27
  it shows a moving `transcribing…` dot.
28
28
 
29
29
  > The hotkey is bound **only when a provider is configured**. Until then the extension is a
30
- > silent no-op — `/stt doctor` still works to guide setup.
30
+ > silent no-op — `/af-stt doctor` still works to guide setup.
31
31
 
32
32
  ## Requirements
33
33
 
@@ -48,7 +48,7 @@ key is read from the process environment — a gitignored `.env` at the repo roo
48
48
  the `justfile`'s `dotenv-load`. See [`examples/stt.json`](examples/stt.json).
49
49
 
50
50
  > **Guided setup** can write the `.ai/stt.json` + `.env` for you — pick `pi-voice-stt` in
51
- > `/setup-agent-fleet` and answer the provider prompts. See
51
+ > `/af-setup-agent-fleet` and answer the provider prompts. See
52
52
  > [docs/agent-fleet-setup.md](../../../docs/agent-fleet-setup.md).
53
53
 
54
54
  ### Option 1 — Generic OpenAI-compatible endpoint
@@ -97,7 +97,7 @@ export AZURE_SPEECH_KEY="<your-resource-key>"
97
97
  ```
98
98
 
99
99
  The request posts the WAV to
100
- `{endpoint}/stt/speech/recognition/conversation/cognitiveservices/v1?language=<lang>&format=<format>`
100
+ `{endpoint}/af-stt/speech/recognition/conversation/cognitiveservices/v1?language=<lang>&format=<format>`
101
101
  with the `Ocp-Apim-Subscription-Key` header. `format: "detailed"` returns the best
102
102
  `NBest[0].Display`; `"simple"` returns `DisplayText`.
103
103
 
@@ -178,7 +178,7 @@ can be raised.
178
178
 
179
179
  ## Troubleshooting
180
180
 
181
- - **`/stt doctor` says ffmpeg not found** — install ffmpeg or set `capture.ffmpegPath`.
181
+ - **`/af-stt doctor` says ffmpeg not found** — install ffmpeg or set `capture.ffmpegPath`.
182
182
  - **Linux: no audio** — ensure PulseAudio/PipeWire is running; try `capture.input` of a
183
183
  specific source name from `pactl list sources short`.
184
184
  - **Azure `NoMatch`** — the spoken language doesn't match `language`; fix the locale.
@@ -3,7 +3,7 @@
3
3
  // Press Alt+S to start recording, Alt+S again to transcribe and insert the text
4
4
  // into the prompt. While recording, Enter transcribes and sends immediately, and
5
5
  // Esc cancels. The extension is a silent no-op until a provider is configured —
6
- // see README.md and `/stt doctor`.
6
+ // see README.md and `/af-stt doctor`.
7
7
 
8
8
  import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
9
9
  import { matchesKey } from "@mariozechner/pi-tui";
@@ -67,7 +67,7 @@ export default function voiceSttExtension(pi: ExtensionAPI): void {
67
67
  function startRecording(ctx: ExtensionContext): void {
68
68
  if (state !== "idle") return;
69
69
  if (!isConfigured(config)) {
70
- ctx.ui.notify("Voice STT is not configured — run /stt doctor for setup help.", "warning");
70
+ ctx.ui.notify("Voice STT is not configured — run /af-stt doctor for setup help.", "warning");
71
71
  return;
72
72
  }
73
73
 
@@ -142,7 +142,7 @@ export default function voiceSttExtension(pi: ExtensionAPI): void {
142
142
 
143
143
  // ---- commands ----------------------------------------------------------
144
144
 
145
- pi.registerCommand("stt", {
145
+ pi.registerCommand("af-stt", {
146
146
  description: "Voice dictation: status | doctor | start | stop | send | cancel",
147
147
  handler: async (args: string, ctx: ExtensionCommandContext) => {
148
148
  const sub = args.trim().split(/\s+/)[0]?.toLowerCase() || "status";
@@ -167,7 +167,7 @@ export default function voiceSttExtension(pi: ExtensionAPI): void {
167
167
  else cancel(ctx);
168
168
  return;
169
169
  default:
170
- ctx.ui.notify(`Unknown /stt subcommand: ${sub}`, "warning");
170
+ ctx.ui.notify(`Unknown /af-stt subcommand: ${sub}`, "warning");
171
171
  }
172
172
  },
173
173
  });
@@ -6,7 +6,7 @@ first: [`damage-control-continue`](../damage-control-continue/README.md),
6
6
  [`ask-user-remote`](../ask-user-remote/README.md), STT, Compact & Continue, BTW, and the
7
7
  update checker. The dispatcher therefore has guardrails and an `ask_user` handoff tool
8
8
  before `agent-hub` starts. It combines local specialist
9
- orchestration (fixed specialist grid, read-only research helpers, `/zoom`, kill/restart, per-agent
9
+ orchestration (fixed specialist grid, read-only research helpers, `/af-zoom`, kill/restart, per-agent
10
10
  model, dispatcher persona gate) with peer-to-peer collaboration: it can **hand a session off to
11
11
  another main agent** and **use a coms peer as a subagent**.
12
12
 
@@ -50,14 +50,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
50
50
 
51
51
  - **Dispatcher grid** — a live dashboard of fixed specialists from `.pi/agents/teams.yaml`.
52
52
  - **Specialist delegation** — `dispatch_agent` sends writable tasks to configured specialists.
53
- - **Research helpers** — `spawn_research` and `/research` launch read-only helper agents. Two
53
+ - **Research helpers** — `spawn_research` and `/af-research` launch read-only helper agents. Two
54
54
  `kind: research` personas ship by default: `researcher` (fast `gpt-5.3-codex-spark`) for simple
55
55
  reads and `deep-researcher` (`gpt-5.5` / xhigh) for hard, cross-cutting investigation. The
56
56
  orchestrator routes by persona; each persona's model + thinking level is shown in its catalog.
57
57
  Finished helpers are **auto-pruned** so the research row doesn't grow without bound: auto-research
58
58
  pipe helpers disappear as soon as they finish (their findings persist as `findings/*.md` files and
59
59
  their handles are never resumed), while manual/persona helpers keep only the `research-keep` most
60
- recently finished (default 4 — resumable via `/agents-cont rN`; older cards, and their session
60
+ recently finished (default 4 — resumable via `/af-agents-cont rN`; older cards, and their session
61
61
  files, are dropped oldest-first). Set `research-keep: <n>|all` in the overrides file to change
62
62
  the cap. Running helpers are never pruned and `rN` handles are never reused.
63
63
  - **Human handoff path** — `ask_user` is exposed by the `ask-user-remote` wrapper (capturing stock
@@ -87,7 +87,7 @@ Every borrowed idea from another harness passes one test before it lands: *does
87
87
  to `.pi/agent-sessions/artifacts/returns/<agentKey>-run<N>.md`, surfaces only a compact
88
88
  `details.structuredReturn` digest plus `details.returnPath`, and marks contract notices such as
89
89
  missing assertion ids or evidence-less `assertions_proven` entries (demoted to unproven in the
90
- tool text). `details.fullOutput` remains for `/zoom`/compatibility, but dispatcher-visible text is
90
+ tool text). `details.fullOutput` remains for `/af-zoom`/compatibility, but dispatcher-visible text is
91
91
  digest + path oriented. `update_assertion(status: "proven")` validates evidence by assertion tag:
92
92
  test evidence needs a command/test and outcome, `code-grep` needs pattern plus result sample,
93
93
  manual needs user/`ask_user` confirmation, and `runtime-ui` needs an existing artifact path under
@@ -114,49 +114,49 @@ Every borrowed idea from another harness passes one test before it lands: *does
114
114
  notice. This is advisory only: the hub never blocks completion, reverts files, or escalates
115
115
  automatically. Known limitation: concurrent writable dispatches can only be attributed
116
116
  approximately, so overlapping runs are flagged in the notice.
117
- - **Agent controls** — `/zoom` inspects a live agent timeline; `/agents-history` replays the run as a
117
+ - **Agent controls** — `/af-zoom` inspects a live agent timeline; `/af-agents-history` replays the run as a
118
118
  timeline (orchestrator turns, dispatches, research helpers) with per-agent durations, parallel-run
119
119
  markers, and a grand total; kill/restart controls manage running child agents; per-agent `model:`
120
120
  fields select models from team config. The `agents-*` commands address **both target kinds** —
121
- team specialists by persona name, research helpers by `rN` handle (mirroring `/zoom`):
122
- `/agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
121
+ team specialists by persona name, research helpers by `rN` handle (mirroring `/af-zoom`):
122
+ `/af-agents-kill <name|rN|all>` SIGTERMs a specialist (keeping its standing card), while on a
123
123
  research helper it kills **and removes** the card + session — helpers are disposable by design
124
- (`all` clears every helper); `/agents-restart <name|rN>` re-runs the last task fresh (a research
125
- helper must be finished first); `/agents-cont rN <prompt>` resumes a finished helper's session.
126
- The old `/research-rm` and `/research-clear` spellings remain as aliases of the kill semantics,
127
- `/research-cont` of `/agents-cont`.
124
+ (`all` clears every helper); `/af-agents-restart <name|rN>` re-runs the last task fresh (a research
125
+ helper must be finished first); `/af-agents-cont rN <prompt>` resumes a finished helper's session.
126
+ The old `/af-research-rm` and `/af-research-clear` spellings remain as aliases of the kill semantics,
127
+ `/af-research-cont` of `/af-agents-cont`.
128
128
  Restartable team specialists at or above 70% context render
129
129
  their context percentage with a warning marker/color in dashboard and compact views, and their next
130
- `dispatch_agent` result adds a `/agents-restart <persona>` hint. Research helpers are not warned,
130
+ `dispatch_agent` result adds a `/af-agents-restart <persona>` hint. Research helpers are not warned,
131
131
  and the hub never restarts specialists automatically.
132
132
  - **Model switching** — a persona's frontmatter `models:` list declares the models it may switch to
133
- (the default `model:` is implicitly a candidate). `/agent-model <persona>` picks from that list;
133
+ (the default `model:` is implicitly a candidate). `/af-agent-model <persona>` picks from that list;
134
134
  the choice lasts for the session and takes effect on the persona's next dispatch
135
- (`/agents-restart <persona>` applies it immediately). The dot form
136
- `/agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
135
+ (`/af-agents-restart <persona>` applies it immediately). The dot form
136
+ `/af-agent-model <persona>.<role>` switches a delegate sub-role's model instead — its candidates are
137
137
  the role's declared default plus the parent persona's own candidate list; the switch is applied
138
138
  when the parent is next dispatched (it lands in the serialized delegate config, so nested
139
- children inherit it). `/models [profile]` applies a named profile
139
+ children inherit it). `/af-models [profile]` applies a named profile
140
140
  from `.pi/agents/model-profiles.yaml` — a macro over the same declared candidates, validated at
141
141
  session start (a profile with any entry outside a persona's candidates is dropped whole, with an
142
- error); profiles never touch sub-role models — only `/agent-model` reaches those. Nothing
142
+ error); profiles never touch sub-role models — only `/af-agent-model` reaches those. Nothing
143
143
  outside the declared lists is ever selectable. Per project,
144
144
  `model.<persona>:` / `models.<persona>:` keys under `## agent-hub` in
145
145
  `.ai/agent-fleet-overrides.md` replace a persona's default model / candidate list.
146
146
  Research personas (`researcher` / `deep-researcher`, `kind: research`) are switchable the same
147
- way — `/agent-model <persona>` and `/agent-model-thinking <persona>` accept them alongside team
148
- members. Since research helpers are spawned fresh on each `/research` / `spawn_research`, the
149
- switch lands on their next spawn (there is no running instance to `/agents-restart`).
150
- `/agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
147
+ way — `/af-agent-model <persona>` and `/af-agent-model-thinking <persona>` accept them alongside team
148
+ members. Since research helpers are spawned fresh on each `/af-research` / `spawn_research`, the
149
+ switch lands on their next spawn (there is no running instance to `/af-agents-restart`).
150
+ `/af-agent-models-substitute <source> <target>` is the global one-shot form: walks every loaded
151
151
  persona (team + research + orchestrator), and for each whose **current effective model** is
152
152
  `<source>` and whose declared candidates include `<target>`, sets the session override to
153
153
  `<target>`. One-step flow — the dry-run summary (affected vs skipped, with reasons) is shown
154
154
  inline, then the swap is applied immediately and takes effect on each persona's next dispatch
155
- (`/agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
155
+ (`/af-agents-restart` to apply now). It never touches the dispatcher or delegate sub-roles.
156
156
  - **Thinking levels** — each persona's frontmatter `thinking:` sets its pi `--thinking`
157
- reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/agent-model-thinking
157
+ reasoning effort (`off` · `minimal` · `low` · `medium` · `high` · `xhigh`). `/af-agent-model-thinking
158
158
  <persona>` switches it among those six levels for the session; like a model switch it takes effect
159
- on the persona's next dispatch (`/agents-restart <persona>` applies it now), and selecting the
159
+ on the persona's next dispatch (`/af-agents-restart <persona>` applies it now), and selecting the
160
160
  frontmatter default clears the override. The level shows as a short badge after the model
161
161
  everywhere a model is rendered — `gpt-5.5 (xh)` in the dashboard cards and the compact below-editor
162
162
  view (`min`/`low`/`med`/`hi`/`xh`; `off` shows no badge). Per project, a `thinking.<persona>:` key
@@ -175,13 +175,13 @@ Every borrowed idea from another harness passes one test before it lands: *does
175
175
  Concurrent children are always forced read-only. Children stream timeline events through
176
176
  `.pi/agent-sessions/delegations/<persona>/events.jsonl`; the hub tails it and renders nested rows
177
177
  under the parent's card (child id, model, tokens, status),
178
- each openable with `/zoom <child-id>`. Each child also writes its full final output to
178
+ each openable with `/af-zoom <child-id>`. Each child also writes its full final output to
179
179
  `.pi/agent-sessions/delegations/<persona>/results/<childId>.md`; the parent receives only status,
180
180
  a required final `DIGEST:` section (≤30 lines with path:line citations), and the result-file path.
181
181
  If a child omits `DIGEST:`, the parent gets the first ~30 lines plus a no-DIGEST warning and the
182
182
  result path. Spend rolls up: every child row and the parent's subtree
183
183
  total show tokens, and a session-wide `Δ delegated` counter sits in the status line.
184
- `/agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
184
+ `/af-agents-kill` on the parent SIGTERMs its whole process group, so the delegation tree dies with
185
185
  it. `context: fork` is accepted but treated as a summary brief in v1. Per project,
186
186
  `subagents.<persona>.<role>:` and `delegate-depth.<persona>:` keys under `## agent-hub` in
187
187
  `.ai/agent-fleet-overrides.md` replace individual sub-roles / the depth budget. Six personas
@@ -217,14 +217,14 @@ Every borrowed idea from another harness passes one test before it lands: *does
217
217
  `agent-hub` (or plain `coms`) sessions on the same box find each other through per-project registry
218
218
  files and exchange messages over a unix socket (named pipe on Windows).
219
219
 
220
- Inherited `/zoom` behavior in this harness expands the latest event by default. Use `Space` or
220
+ Inherited `/af-zoom` behavior in this harness expands the latest event by default. Use `Space` or
221
221
  `Ctrl+C` to copy the selected row content, and `Q` or `Esc` to close the overlay. The overlay sizes
222
222
  to the terminal and keeps the selected (and last) entry fully visible while you navigate with
223
223
  `↑/↓`.
224
224
 
225
- ### `/agents-history`
225
+ ### `/af-agents-history`
226
226
 
227
- `/agents-history` opens a read-only overlay (same chrome as `/zoom`) that replays the session as an
227
+ `/af-agents-history` opens a read-only overlay (same chrome as `/af-zoom`) that replays the session as an
228
228
  execution **tree**:
229
229
 
230
230
  - **Orchestrator turns** — each dispatcher turn that actually dispatched something is a depth-0 row
@@ -286,11 +286,11 @@ the single model line. Press **`Alt+S`** to start/stop dictation as in a normal
286
286
 
287
287
  In **compact view**, the running-subagents list below the input doubles as a switcher. **`Alt+]`**
288
288
  and **`Alt+[`** move a marker (`›` + highlight) to the next/previous running subagent; **`Alt+\`**
289
- opens the read-only `/zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
289
+ opens the read-only `/af-zoom` overlay on the marked one (`Q`/`Esc` to close). This only changes what
290
290
  you *view* — **the input box always prompts the main session**, and `main` is never a marker target
291
291
  (it is the session under the input, not a subagent). There is no transcript takeover: a subagent's
292
292
  stream is surfaced through the modal zoom overlay, never by replacing the main scrollback. The keys
293
- are inert in dashboard mode (use `/zoom <name>` there).
293
+ are inert in dashboard mode (use `/af-zoom <name>` there).
294
294
 
295
295
  > Terminal note: `Alt+[` emits `ESC [` (a CSI prefix) and may be swallowed by some terminals'
296
296
  > escape parsers; `Alt+]` and `Alt+\` are the reliable pair. `Alt+↑/↓/←/→` are reserved by the pi
@@ -400,7 +400,7 @@ task, most of it re-billed stale specialist context).
400
400
 
401
401
  When a budget is exhausted, `dispatch_agent`/`spawn_research` **refuse** with instructions
402
402
  to summarize and ask the user; the next user message opens a fresh window. Switch modes
403
- live with `/hub-mode fast|standard|strict` (no argument shows the current mode and usage);
403
+ live with `/af-hub-mode fast|standard|strict` (no argument shows the current mode and usage);
404
404
  set the project default and per-axis overrides in the overrides file:
405
405
 
406
406
  ```markdown
@@ -437,7 +437,7 @@ The system prompt ties the tier to the anti-over-engineering rules: a provided p
437
437
  spec (no re-planning), assertions stay ≤3 for trivial/small asks, and "using every persona"
438
438
  is called out as a smell. Two hygiene guards are enforced in code, not prose: a
439
439
  **duplicate-dispatch guard** refuses re-dispatching the same agent with a near-identical
440
- task inside one turn, and every budget/duplicate refusal is counted in `/hub-report`.
440
+ task inside one turn, and every budget/duplicate refusal is counted in `/af-hub-report`.
441
441
 
442
442
  ### Drift watchdog (in-flight observation)
443
443
 
@@ -456,8 +456,8 @@ drives the cards — not post-hoc:
456
456
  corrected, narrowed task — never the same task unchanged.
457
457
 
458
458
  Enablement is dynamic, precedence top to bottom: the `watchdog: true|false` param on a
459
- single `dispatch_agent` call → a per-agent override (`/watchdog builder on|off|clear`) →
460
- the hub-wide setting (`/watchdog on|off|auto`, default `auto`, project default via the
459
+ single `dispatch_agent` call → a per-agent override (`/af-watchdog builder on|off|clear`) →
460
+ the hub-wide setting (`/af-watchdog on|off|auto`, default `auto`, project default via the
461
461
  `watchdog:` overrides key). Read-only research helpers are not monitored — they already
462
462
  run under the per-tool watchdog + turn deadline and cannot write.
463
463
 
@@ -465,15 +465,15 @@ run under the per-tool watchdog + turn deadline and cannot write.
465
465
 
466
466
  Rosters start from `.pi/agents/teams.yaml` but are not frozen there:
467
467
 
468
- - `/agents-add <persona>…` / `/agents-drop <persona>…` — restructure the ACTIVE team
468
+ - `/af-agents-add <persona>…` / `/af-agents-drop <persona>…` — restructure the ACTIVE team
469
469
  live (drop refuses running or last members; session files are kept for re-adding).
470
- - `/agents-save <name>` — persist the current roster as a named team back into
470
+ - `/af-agents-save <name>` — persist the current roster as a named team back into
471
471
  `teams.yaml` (targeted block upsert; comments and other teams untouched).
472
472
  - `team_adjust` — the dispatcher itself may add/drop a persona **with a stated reason**;
473
473
  disabled in fast mode, capped at 8 roster members, and every change is notified to the
474
474
  human. The system prompt is rebuilt each turn, so changes take effect immediately.
475
475
 
476
- ### `/hub-report`
476
+ ### `/af-hub-report`
477
477
 
478
478
  Per-turn cost accounting: dispatches (agent, status, elapsed, billed/output tokens),
479
479
  research runs, session recycles, drift stops, and budget/duplicate refusals — for the
@@ -529,19 +529,19 @@ Each session registers a coms identity at start-up, resolved in this precedence
529
529
 
530
530
  Names are de-duplicated per project (`resolveUniqueName`), so two hubs that both want `architect`
531
531
  become `architect` and `architect-2`. `--explicit` marks a **private** peer — kept out of every
532
- pool by default, so it is neither listed nor reachable until a human opts in with `/coms --all`
532
+ pool by default, so it is neither listed nor reachable until a human opts in with `/af-coms --all`
533
533
  (see [Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)). The registry lives
534
534
  under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runtime.
535
535
 
536
536
  ### Commands & tools (local dispatcher plus coms)
537
537
 
538
- - `/coms` — coms control surface (peer list / status)
539
- - `/handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
540
- - `/compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
538
+ - `/af-coms` — coms control surface (peer list / status)
539
+ - `/af-handoff <peer>` — hand the whole session off to a coms peer (see [Handoff](#handoff))
540
+ - `/af-compound [focus]` — end-of-session **compound-learning pass**: the dispatcher composes a
541
541
  candidate-lessons brief from the session (corrections, recurring findings, root causes),
542
542
  confirms it with the user, then dispatches the `documenter` to land the approved lessons as
543
543
  minimal diffs on the project's `rules:`/`docs:` targets per `skills/compound-learning/SKILL.md`.
544
- Requires the `documenter` persona in the active team; run it before `/handoff` or session end.
544
+ Requires the `documenter` persona in the active team; run it before `/af-handoff` or session end.
545
545
  - `coms_list` — discover the peers in your pool: names, models, live context usage, purpose. Scoped
546
546
  to your project and excluding private peers; the LLM cannot widen it (see
547
547
  [Pool scope is the reach boundary](#pool-scope-is-the-reach-boundary)).
@@ -550,19 +550,19 @@ under `~/.pi/coms/projects/<project>/agents/<name>.json` and is created at runti
550
550
  `PI_COMS_TIMEOUT_MS`)
551
551
  - `coms_get` — **non-blocking** poll of a `msg_id` (status `pending|complete|error`)
552
552
 
553
- `/coms` and `/handoff` tab-complete live peer names **in your pool**.
553
+ `/af-coms` and `/af-handoff` tab-complete live peer names **in your pool**.
554
554
 
555
555
  ### Pool scope is the reach boundary
556
556
 
557
557
  The set of peers shown in the pool widget is the security boundary: **a peer is reachable only if it
558
- is in your pool.** `coms_list`, `coms_send`, and `/handoff` all resolve targets through the same
558
+ is in your pool.** `coms_list`, `coms_send`, and `/af-handoff` all resolve targets through the same
559
559
  `peersInScope()` helper, so the dispatcher can never message a peer it cannot see. Two knobs define
560
560
  the pool, and **both are human-only** — the LLM cannot widen scope to reach more peers:
561
561
 
562
- - **Project** — defaults to your own `identity.project`. A human can retarget with `/coms --project
563
- <name>` (one project) or `/coms --all` (every project). `coms_list`'s own parameters cannot
562
+ - **Project** — defaults to your own `identity.project`. A human can retarget with `/af-coms --project
563
+ <name>` (one project) or `/af-coms --all` (every project). `coms_list`'s own parameters cannot
564
564
  override this; an LLM request for a wider project is clamped back to the current pool and flagged.
565
- - **Explicit (private) peers** — excluded from every pool by default. `/coms --all` opts them in.
565
+ - **Explicit (private) peers** — excluded from every pool by default. `/af-coms --all` opts them in.
566
566
 
567
567
  This closes a cross-project leak where a peer reachable through the mesh was *not* shown in the
568
568
  default project-scoped pool — so it could be messaged without being "connected." Now the reachable
@@ -614,12 +614,12 @@ Semantics:
614
614
  - **Standing context is the point.** Re-dispatches (ASK_USER answers, research resumes) go back to
615
615
  the same peer session, so a Claude Code reviewer keeps its review context across rounds.
616
616
  - **Visibility.** The member's grid card shows a `⇄coms <peer-model>` badge, history entries are
617
- annotated `(coms)`, and `/dispatch-policy` prints the resolved routing per member with live-peer
617
+ annotated `(coms)`, and `/af-dispatch-policy` prints the resolved routing per member with live-peer
618
618
  status.
619
- - **Limitations.** `/agents-kill` on a coms-backed run only abandons the wait — the peer keeps
620
- running in its own pane and cannot be killed from the hub (`/agents-restart` abandons, then
621
- re-dispatches). `/zoom` shows only the final reply (there is no stream), tool counts stay 0, and
622
- context% is a registry snapshot. `/agent-model` overrides apply only to native(-fallback) runs —
619
+ - **Limitations.** `/af-agents-kill` on a coms-backed run only abandons the wait — the peer keeps
620
+ running in its own pane and cannot be killed from the hub (`/af-agents-restart` abandons, then
621
+ re-dispatches). `/af-zoom` shows only the final reply (there is no stream), tool counts stay 0, and
622
+ context% is a registry snapshot. `/af-agent-model` overrides apply only to native(-fallback) runs —
623
623
  the peer's model is set in `peers.yaml`.
624
624
 
625
625
  Missing file = everything native. HOW a peer runs (persona, model, `runner: claude-code`, env) stays
@@ -627,7 +627,7 @@ in `peers.yaml`; this file only decides WHEN the hub prefers a peer over a nativ
627
627
 
628
628
  ### Handoff
629
629
 
630
- `/handoff <peer>` transfers the session to another **main** agent. Following the plan's
630
+ `/af-handoff <peer>` transfers the session to another **main** agent. Following the plan's
631
631
  **decision G1**, it does *not* try to extract a compaction summary; instead it asks the dispatcher
632
632
  LLM to compose a **self-contained brief** ("everything the target needs, assume no shared history"),
633
633
  then `coms_send`s that brief to the peer, `coms_await`s the reply, and relays it back — in the
@@ -636,7 +636,7 @@ sections after the LLM brief: `## Verification ledger (verbatim, machine-appende
636
636
  assertion in canonical ledger form, and `## Artifact index` with artifact paths plus first headings.
637
637
  The target peer must treat the machine-appended ledger as the contract, not the paraphrased brief.
638
638
  The target peer takes over; the source relays the result. There is no raw session copy (pi sessions
639
- aren't portable between live agents). The target must be a peer in your pool — `/handoff` resolves
639
+ aren't portable between live agents). The target must be a peer in your pool — `/af-handoff` resolves
640
640
  through the same [scope boundary](#pool-scope-is-the-reach-boundary) as `coms_send`, so you cannot
641
641
  hand a session to a peer you cannot see.
642
642
 
@@ -652,13 +652,13 @@ The dispatcher persona gate fires *after* coms init, so the identity's `purpose`
652
652
  flag/frontmatter/default and is then reconciled to the chosen persona: `syncComsPurpose()` maps the
653
653
  selected `kind: orchestrator` persona to `"<Name> — <description>"` and re-writes the live registry
654
654
  entry — **unless** `--purpose` was passed explicitly (an explicit flag always wins). Switching or
655
- resetting the persona via `/persona` re-syncs.
655
+ resetting the persona via `/af-persona` re-syncs.
656
656
 
657
657
  ### Graceful degradation
658
658
 
659
659
  If the coms socket can't bind at start-up (`comsReady` stays `false`), the session degrades to a
660
660
  local dispatcher without coms: the `coms_*` tools are withheld from `setActiveTools`, the
661
- `/handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
661
+ `/af-handoff` command refuses with a notice, and the "Peer agents (coms)" prompt section is omitted.
662
662
  Orchestration, research helpers, and the grid keep working.
663
663
 
664
664
  ### Tool surface
@@ -793,6 +793,6 @@ coms purpose/color.
793
793
  `spawn_research` (+ `ask_user`); the system prompt gains a "Peer agents (coms)" section when coms
794
794
  is ready. The persona's `description` drives the coms `purpose` (decision 6 / Phase 6 peer
795
795
  mapping) instead of a static `--purpose`.
796
- - **`/handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
796
+ - **`/af-handoff` uses an LLM-composed brief**, not a compaction-summary extraction (decision G1).
797
797
  - **Clean shutdown** SIGTERMs any running specialist/research children, clears the coms pool
798
798
  widget, and removes the registry entry on `session_shutdown` / SIGINT / SIGTERM.
@@ -147,7 +147,7 @@ export function comsRequiredRefusal(agentName, graceS) {
147
147
  return (
148
148
  `"${agentName}" is configured as coms-required (fallback: none) but no live peer named ` +
149
149
  `"${String(agentName).toLowerCase()}" appeared in the pool within ${graceS}s. ` +
150
- "Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /coms, " +
150
+ "Start it with `just hub-team <team>` / `just team-up <team>`, widen the pool with /af-coms, " +
151
151
  "or set `fallback: native` in .pi/agents/dispatch-policy.yaml."
152
152
  );
153
153
  }