@chankov/agent-fleet 0.0.9 → 0.0.10

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 (354) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +12 -7
  2. package/.claude/commands/setup-agent-fleet.md +7 -15
  3. package/.opencode/commands/af-doctor-agent-fleet.md +12 -7
  4. package/.opencode/commands/af-setup-agent-fleet.md +8 -6
  5. package/.pi/extensions/agent-fleet-update-check/README.md +2 -3
  6. package/.pi/extensions/btw/README.md +2 -2
  7. package/.pi/extensions/chrome-devtools-mcp/README.md +3 -6
  8. package/.pi/extensions/compact-and-continue/README.md +3 -3
  9. package/.pi/extensions/mcp-bridge/README.md +1 -1
  10. package/.pi/harnesses/agent-hub/README.md +139 -10
  11. package/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  12. package/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  13. package/.pi/harnesses/agent-hub/index.ts +448 -39
  14. package/.pi/harnesses/agent-hub/package.json +1 -1
  15. package/.pi/harnesses/agent-hub/review-findings.js +102 -0
  16. package/.pi/harnesses/agent-hub/run-budget.js +302 -4
  17. package/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  18. package/.pi/harnesses/coms/package.json +1 -1
  19. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  20. package/.pi/prompts/af-doctor-agent-fleet.md +13 -6
  21. package/.pi/prompts/af-setup-agent-fleet.md +7 -15
  22. package/.versions/0.0.10/.claude/commands/build.md +44 -0
  23. package/.versions/0.0.10/.claude/commands/code-simplify.md +22 -0
  24. package/.versions/0.0.10/.claude/commands/design-agent.md +14 -0
  25. package/.versions/0.0.10/.claude/commands/doctor-agent-fleet.md +22 -0
  26. package/.versions/0.0.10/.claude/commands/orchestrate.md +112 -0
  27. package/.versions/0.0.10/.claude/commands/plan.md +16 -0
  28. package/.versions/0.0.10/.claude/commands/prime.md +22 -0
  29. package/.versions/0.0.10/.claude/commands/review.md +16 -0
  30. package/.versions/0.0.10/.claude/commands/set-hermes-telegram.md +15 -0
  31. package/.versions/0.0.10/.claude/commands/set-hermes-watchdog.md +6 -0
  32. package/.versions/0.0.10/.claude/commands/setup-agent-fleet.md +17 -0
  33. package/.versions/0.0.10/.claude/commands/ship.md +72 -0
  34. package/.versions/0.0.10/.claude/commands/spec.md +15 -0
  35. package/.versions/0.0.10/.claude/commands/test.md +19 -0
  36. package/.versions/0.0.10/.claude/commands/webperf.md +32 -0
  37. package/.versions/0.0.10/.claude/orchestrate-teams.yaml +24 -0
  38. package/.versions/0.0.10/.opencode/commands/af-build.md +17 -0
  39. package/.versions/0.0.10/.opencode/commands/af-code-simplify.md +16 -0
  40. package/.versions/0.0.10/.opencode/commands/af-compound.md +16 -0
  41. package/.versions/0.0.10/.opencode/commands/af-design-agent.md +15 -0
  42. package/.versions/0.0.10/.opencode/commands/af-doctor-agent-fleet.md +22 -0
  43. package/.versions/0.0.10/.opencode/commands/af-orchestrate.md +112 -0
  44. package/.versions/0.0.10/.opencode/commands/af-plan.md +16 -0
  45. package/.versions/0.0.10/.opencode/commands/af-prime.md +22 -0
  46. package/.versions/0.0.10/.opencode/commands/af-review.md +15 -0
  47. package/.versions/0.0.10/.opencode/commands/af-set-hermes-telegram.md +15 -0
  48. package/.versions/0.0.10/.opencode/commands/af-set-hermes-watchdog.md +6 -0
  49. package/.versions/0.0.10/.opencode/commands/af-setup-agent-fleet.md +17 -0
  50. package/.versions/0.0.10/.opencode/commands/af-ship.md +16 -0
  51. package/.versions/0.0.10/.opencode/commands/af-spec.md +16 -0
  52. package/.versions/0.0.10/.opencode/commands/af-test.md +21 -0
  53. package/.versions/0.0.10/.opencode/commands/af-webperf.md +32 -0
  54. package/.versions/0.0.10/.opencode/orchestrate-teams.yaml +24 -0
  55. package/.versions/0.0.10/.pi/agents/dispatch-policy.yaml +32 -0
  56. package/.versions/0.0.10/.pi/agents/model-profiles.yaml +27 -0
  57. package/.versions/0.0.10/.pi/agents/peers.yaml +142 -0
  58. package/.versions/0.0.10/.pi/agents/teams.yaml +41 -0
  59. package/.versions/0.0.10/.pi/damage-control-rules.yaml +297 -0
  60. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/README.md +57 -0
  61. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  62. package/.versions/0.0.10/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  63. package/.versions/0.0.10/.pi/extensions/btw/README.md +118 -0
  64. package/.versions/0.0.10/.pi/extensions/btw/index.ts +917 -0
  65. package/.versions/0.0.10/.pi/extensions/btw/package.json +6 -0
  66. package/.versions/0.0.10/.pi/extensions/btw/state.js +179 -0
  67. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  68. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  69. package/.versions/0.0.10/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  70. package/.versions/0.0.10/.pi/extensions/compact-and-continue/README.md +42 -0
  71. package/.versions/0.0.10/.pi/extensions/compact-and-continue/index.ts +120 -0
  72. package/.versions/0.0.10/.pi/extensions/compact-and-continue/package.json +6 -0
  73. package/.versions/0.0.10/.pi/extensions/mcp-bridge/README.md +46 -0
  74. package/.versions/0.0.10/.pi/extensions/mcp-bridge/index.ts +206 -0
  75. package/.versions/0.0.10/.pi/extensions/mcp-bridge/package.json +6 -0
  76. package/.versions/0.0.10/.pi/extensions/package-lock.json +1143 -0
  77. package/.versions/0.0.10/.pi/extensions/package.json +9 -0
  78. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/README.md +201 -0
  79. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/config.ts +198 -0
  80. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  81. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/index.ts +248 -0
  82. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/package.json +6 -0
  83. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  84. package/.versions/0.0.10/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  85. package/.versions/0.0.10/.pi/harnesses/agent-hub/README.md +1001 -0
  86. package/.versions/0.0.10/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  87. package/.versions/0.0.10/.pi/harnesses/agent-hub/artifacts.js +146 -0
  88. package/.versions/0.0.10/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  89. package/.versions/0.0.10/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  90. package/.versions/0.0.10/.pi/harnesses/agent-hub/context-window.js +106 -0
  91. package/.versions/0.0.10/.pi/harnesses/agent-hub/delegate.ts +435 -0
  92. package/.versions/0.0.10/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  93. package/.versions/0.0.10/.pi/harnesses/agent-hub/drift-watchdog.js +211 -0
  94. package/.versions/0.0.10/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  95. package/.versions/0.0.10/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  96. package/.versions/0.0.10/.pi/harnesses/agent-hub/footer.ts +31 -0
  97. package/.versions/0.0.10/.pi/harnesses/agent-hub/helpers.ts +248 -0
  98. package/.versions/0.0.10/.pi/harnesses/agent-hub/index.ts +9111 -0
  99. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  100. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  101. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  102. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  103. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  104. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  105. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  106. package/.versions/0.0.10/.pi/harnesses/agent-hub/monitor-session-bridge.ts +257 -0
  107. package/.versions/0.0.10/.pi/harnesses/agent-hub/package.json +7 -0
  108. package/.versions/0.0.10/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  109. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-retention.js +34 -0
  110. package/.versions/0.0.10/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  111. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-contract.js +293 -0
  112. package/.versions/0.0.10/.pi/harnesses/agent-hub/return-extract.js +75 -0
  113. package/.versions/0.0.10/.pi/harnesses/agent-hub/review-findings.js +102 -0
  114. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-budget.js +479 -0
  115. package/.versions/0.0.10/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  116. package/.versions/0.0.10/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  117. package/.versions/0.0.10/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  118. package/.versions/0.0.10/.pi/harnesses/agent-hub/session-health.js +110 -0
  119. package/.versions/0.0.10/.pi/harnesses/agent-hub/spawn.ts +354 -0
  120. package/.versions/0.0.10/.pi/harnesses/agent-hub/version.ts +42 -0
  121. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/README.md +19 -0
  122. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/index.ts +321 -0
  123. package/.versions/0.0.10/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  124. package/.versions/0.0.10/.pi/harnesses/coms/README.md +100 -0
  125. package/.versions/0.0.10/.pi/harnesses/coms/index.ts +1767 -0
  126. package/.versions/0.0.10/.pi/harnesses/coms/package.json +7 -0
  127. package/.versions/0.0.10/.pi/harnesses/coms/version.ts +42 -0
  128. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/README.md +124 -0
  129. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/index.ts +536 -0
  130. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/package.json +7 -0
  131. package/.versions/0.0.10/.pi/harnesses/damage-control-continue/version.ts +42 -0
  132. package/.versions/0.0.10/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  133. package/.versions/0.0.10/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  134. package/.versions/0.0.10/.pi/harnesses/lib/herdr-client.ts +472 -0
  135. package/.versions/0.0.10/.pi/harnesses/lib/herdr-presence.ts +399 -0
  136. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  137. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  138. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  139. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  140. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  141. package/.versions/0.0.10/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  142. package/.versions/0.0.10/.pi/harnesses/lib/spawned-peers.js +190 -0
  143. package/.versions/0.0.10/.pi/harnesses/package-lock.json +35 -0
  144. package/.versions/0.0.10/.pi/harnesses/package.json +9 -0
  145. package/.versions/0.0.10/.pi/prompts/af-build.md +24 -0
  146. package/.versions/0.0.10/.pi/prompts/af-code-simplify.md +22 -0
  147. package/.versions/0.0.10/.pi/prompts/af-doctor-agent-fleet.md +22 -0
  148. package/.versions/0.0.10/.pi/prompts/af-plan.md +16 -0
  149. package/.versions/0.0.10/.pi/prompts/af-review.md +16 -0
  150. package/.versions/0.0.10/.pi/prompts/af-set-hermes-telegram.md +15 -0
  151. package/.versions/0.0.10/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  152. package/.versions/0.0.10/.pi/prompts/af-setup-agent-fleet.md +19 -0
  153. package/.versions/0.0.10/.pi/prompts/af-ship.md +17 -0
  154. package/.versions/0.0.10/.pi/prompts/af-spec.md +15 -0
  155. package/.versions/0.0.10/.pi/prompts/af-test.md +19 -0
  156. package/.versions/0.0.10/.pi/skills/bowser/SKILL.md +145 -0
  157. package/.versions/0.0.10/.version +1 -0
  158. package/.versions/0.0.10/agents/architect.md +24 -0
  159. package/.versions/0.0.10/agents/bowser.md +27 -0
  160. package/.versions/0.0.10/agents/builder.md +54 -0
  161. package/.versions/0.0.10/agents/code-reviewer.md +208 -0
  162. package/.versions/0.0.10/agents/deep-researcher.md +32 -0
  163. package/.versions/0.0.10/agents/documenter.md +18 -0
  164. package/.versions/0.0.10/agents/orchestrator.md +72 -0
  165. package/.versions/0.0.10/agents/plan-reviewer.md +83 -0
  166. package/.versions/0.0.10/agents/planner.md +70 -0
  167. package/.versions/0.0.10/agents/releaser.md +24 -0
  168. package/.versions/0.0.10/agents/researcher.md +28 -0
  169. package/.versions/0.0.10/agents/security-auditor.md +167 -0
  170. package/.versions/0.0.10/agents/test-engineer.md +153 -0
  171. package/.versions/0.0.10/agents/web-debugger.md +43 -0
  172. package/.versions/0.0.10/agents/web-performance-auditor.md +193 -0
  173. package/.versions/0.0.10/codex/CONDUCTOR.md +148 -0
  174. package/.versions/0.0.10/docs/ARCHITECTURE.md +303 -0
  175. package/.versions/0.0.10/docs/agent-fleet-setup.md +377 -0
  176. package/.versions/0.0.10/docs/claude-code-coms-bridge.md +109 -0
  177. package/.versions/0.0.10/docs/codex-remote-conductor.md +170 -0
  178. package/.versions/0.0.10/docs/coms-hermes-bridge.md +189 -0
  179. package/.versions/0.0.10/docs/getting-started.md +254 -0
  180. package/.versions/0.0.10/docs/npm-install.md +514 -0
  181. package/.versions/0.0.10/docs/opencode-setup.md +281 -0
  182. package/.versions/0.0.10/docs/pi-extensions.md +363 -0
  183. package/.versions/0.0.10/docs/pi-setup.md +571 -0
  184. package/.versions/0.0.10/docs/skill-anatomy.md +150 -0
  185. package/.versions/0.0.10/hermes/README.md +347 -0
  186. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  187. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  188. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  189. package/.versions/0.0.10/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  190. package/.versions/0.0.10/hermes/gates/gate-o-capability.md +8 -0
  191. package/.versions/0.0.10/hermes/gates/gate-o-validator-fixtures.json +1 -0
  192. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +770 -0
  193. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  194. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  195. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  196. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  197. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  198. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  199. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  200. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  201. package/.versions/0.0.10/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  202. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  203. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  204. package/.versions/0.0.10/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  205. package/.versions/0.0.10/hermes/skills/hub-conductor/SKILL.md +84 -0
  206. package/.versions/0.0.10/hermes/skills/hub-liaison/SKILL.md +84 -0
  207. package/.versions/0.0.10/hermes/skills/hub-watchdog/SKILL.md +76 -0
  208. package/.versions/0.0.10/hermes/skills/hub-watchdog/manifest.json +1 -0
  209. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  210. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  211. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  212. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  213. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  214. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  215. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  216. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  217. package/.versions/0.0.10/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  218. package/.versions/0.0.10/hermes/watchdog-tests/__init__.py +0 -0
  219. package/.versions/0.0.10/hooks/SIMPLIFY-IGNORE.md +90 -0
  220. package/.versions/0.0.10/hooks/coms-stop-hook.mjs +84 -0
  221. package/.versions/0.0.10/hooks/hooks.json +14 -0
  222. package/.versions/0.0.10/hooks/session-start.sh +74 -0
  223. package/.versions/0.0.10/hooks/simplify-ignore.sh +302 -0
  224. package/.versions/0.0.10/install-manifest.json +3615 -0
  225. package/.versions/0.0.10/justfile +254 -0
  226. package/.versions/0.0.10/manifest-meta.json +472 -0
  227. package/.versions/0.0.10/references/accessibility-checklist.md +160 -0
  228. package/.versions/0.0.10/references/definition-of-done.md +67 -0
  229. package/.versions/0.0.10/references/fleet-coordination-patterns.md +151 -0
  230. package/.versions/0.0.10/references/observability-checklist.md +91 -0
  231. package/.versions/0.0.10/references/orchestration-patterns.md +370 -0
  232. package/.versions/0.0.10/references/performance-checklist.md +153 -0
  233. package/.versions/0.0.10/references/prompting-patterns.md +380 -0
  234. package/.versions/0.0.10/references/security-checklist.md +179 -0
  235. package/.versions/0.0.10/references/testing-patterns.md +236 -0
  236. package/.versions/0.0.10/scripts/codex-conductor.ts +41 -0
  237. package/.versions/0.0.10/scripts/codex-remote-control.ts +167 -0
  238. package/.versions/0.0.10/scripts/coms-claude-bridge.ts +401 -0
  239. package/.versions/0.0.10/scripts/coms-cli.ts +484 -0
  240. package/.versions/0.0.10/scripts/coms-hermes-bridge.ts +413 -0
  241. package/.versions/0.0.10/scripts/fleet.ts +168 -0
  242. package/.versions/0.0.10/scripts/hermes-monitor-capability-runner.ts +25 -0
  243. package/.versions/0.0.10/scripts/hermes-monitor-scenario.ts +474 -0
  244. package/.versions/0.0.10/scripts/hermes-watchdog-capability-probe.ts +45 -0
  245. package/.versions/0.0.10/scripts/install-hermes-plugin.sh +180 -0
  246. package/.versions/0.0.10/scripts/lib/claude-bridge-core.ts +165 -0
  247. package/.versions/0.0.10/scripts/lib/codex-conductor.ts +88 -0
  248. package/.versions/0.0.10/scripts/lib/codex-remote-control.ts +480 -0
  249. package/.versions/0.0.10/scripts/lib/coms-envelope.ts +582 -0
  250. package/.versions/0.0.10/scripts/lib/fake-herdr-server.ts +88 -0
  251. package/.versions/0.0.10/scripts/lib/fleet-command.ts +111 -0
  252. package/.versions/0.0.10/scripts/lib/herdr-layout.ts +281 -0
  253. package/.versions/0.0.10/scripts/lib/hermes-bridge-core.ts +241 -0
  254. package/.versions/0.0.10/scripts/lib/hermes-monitor-events.ts +1 -0
  255. package/.versions/0.0.10/scripts/lib/hermes-monitor-herdr.ts +2 -0
  256. package/.versions/0.0.10/scripts/lib/hermes-monitor-model.ts +3 -0
  257. package/.versions/0.0.10/scripts/lib/hermes-monitor-registry.ts +2 -0
  258. package/.versions/0.0.10/scripts/lib/hermes-monitor-socket.ts +2 -0
  259. package/.versions/0.0.10/scripts/lib/hermes-monitor-store.ts +2 -0
  260. package/.versions/0.0.10/scripts/lib/monitor-env.ts +120 -0
  261. package/.versions/0.0.10/scripts/lib/peer-launch.ts +314 -0
  262. package/.versions/0.0.10/scripts/lib/persona-banner.ts +62 -0
  263. package/.versions/0.0.10/scripts/lib/spawn-stagger.ts +101 -0
  264. package/.versions/0.0.10/scripts/lib/team-project.ts +193 -0
  265. package/.versions/0.0.10/scripts/lib/team-snapshot.ts +147 -0
  266. package/.versions/0.0.10/scripts/peer-banner.ts +40 -0
  267. package/.versions/0.0.10/scripts/peer-launch.ts +259 -0
  268. package/.versions/0.0.10/scripts/team-snapshot.ts +237 -0
  269. package/.versions/0.0.10/scripts/team-up.ts +360 -0
  270. package/.versions/0.0.10/skills/_internal/grilling.md +11 -0
  271. package/.versions/0.0.10/skills/browser-testing-with-devtools/SKILL.md +351 -0
  272. package/.versions/0.0.10/skills/code-review-and-quality/SKILL.md +381 -0
  273. package/.versions/0.0.10/skills/compound-learning/SKILL.md +137 -0
  274. package/.versions/0.0.10/skills/context-engineering/SKILL.md +291 -0
  275. package/.versions/0.0.10/skills/deprecation-and-migration/SKILL.md +206 -0
  276. package/.versions/0.0.10/skills/designing-agents/SKILL.md +394 -0
  277. package/.versions/0.0.10/skills/designing-agents/pi-harness-authoring.md +222 -0
  278. package/.versions/0.0.10/skills/frontend-ui-engineering/SKILL.md +328 -0
  279. package/.versions/0.0.10/skills/git-workflow-and-versioning/SKILL.md +316 -0
  280. package/.versions/0.0.10/skills/guided-workspace-setup/SKILL.md +226 -0
  281. package/.versions/0.0.10/skills/guided-workspace-setup/companion-manifest.json +38 -0
  282. package/.versions/0.0.10/skills/idea-refine/SKILL.md +182 -0
  283. package/.versions/0.0.10/skills/idea-refine/examples.md +238 -0
  284. package/.versions/0.0.10/skills/idea-refine/frameworks.md +99 -0
  285. package/.versions/0.0.10/skills/idea-refine/refinement-criteria.md +113 -0
  286. package/.versions/0.0.10/skills/idea-refine/scripts/idea-refine.sh +15 -0
  287. package/.versions/0.0.10/skills/incremental-implementation/SKILL.md +287 -0
  288. package/.versions/0.0.10/skills/interview-me/SKILL.md +226 -0
  289. package/.versions/0.0.10/skills/orchestration-verification/SKILL.md +181 -0
  290. package/.versions/0.0.10/skills/peer-coms/SKILL.md +90 -0
  291. package/.versions/0.0.10/skills/performance-optimization/SKILL.md +350 -0
  292. package/.versions/0.0.10/skills/planning-and-task-breakdown/SKILL.md +254 -0
  293. package/.versions/0.0.10/skills/security-and-hardening/SKILL.md +461 -0
  294. package/.versions/0.0.10/skills/spec-driven-development/SKILL.md +257 -0
  295. package/.versions/0.0.10/skills/using-agent-skills/SKILL.md +199 -0
  296. package/.versions/0.0.10/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
  297. package/.versions/0.0.10/vendor/agent-skills-upstream/LICENSE +21 -0
  298. package/.versions/0.0.10/vendor/agent-skills-upstream/README.md +11 -0
  299. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  300. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  301. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  302. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  303. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  304. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  305. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  306. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  307. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  308. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  309. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  310. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  311. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  312. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  313. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  314. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  315. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  316. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  317. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  318. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  319. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  320. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  321. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  322. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  323. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  324. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  325. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  326. package/.versions/0.0.10/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  327. package/CHANGELOG.md +103 -0
  328. package/README.md +22 -5
  329. package/agents/code-reviewer.md +4 -0
  330. package/agents/orchestrator.md +7 -1
  331. package/agents/plan-reviewer.md +22 -1
  332. package/bin/build-manifest.js +68 -0
  333. package/bin/cli.js +679 -49
  334. package/bin/lib/apply.js +641 -0
  335. package/bin/lib/manifest.js +731 -0
  336. package/bin/lib/merge-forms.js +106 -0
  337. package/bin/lib/plan.js +569 -0
  338. package/bin/lib/state.js +213 -0
  339. package/bin/lib/verify.js +576 -0
  340. package/bin/snapshot-version.js +5 -0
  341. package/docs/ARCHITECTURE.md +52 -11
  342. package/docs/agent-fleet-setup.md +59 -48
  343. package/docs/getting-started.md +29 -6
  344. package/docs/npm-install.md +208 -31
  345. package/docs/opencode-setup.md +32 -0
  346. package/docs/pi-extensions.md +17 -10
  347. package/docs/pi-setup.md +164 -69
  348. package/install-manifest.json +3615 -0
  349. package/manifest-meta.json +472 -0
  350. package/package.json +8 -3
  351. package/skills/browser-testing-with-devtools/SKILL.md +3 -4
  352. package/skills/guided-workspace-setup/SKILL.md +172 -490
  353. package/skills/planning-and-task-breakdown/SKILL.md +18 -0
  354. package/skills/spec-driven-development/SKILL.md +12 -0
@@ -0,0 +1,112 @@
1
+ ---
2
+ description: Orchestrate a config-defined team of subagents — route planner/builder (and more) as a runtime roster, handling NEEDS_RESEARCH and PLAN_FILE handoffs
3
+ ---
4
+
5
+ You are the **orchestrator**. The primary agent drives a team of installed `mode: subagent`
6
+ agents to deliver the task in `$ARGUMENTS`. Subagents cannot nest — **all dispatching is
7
+ yours**.
8
+
9
+ ## Roles
10
+
11
+ | Role | What it does |
12
+ |---|---|
13
+ | `researcher` | Always-available read-only recon. Cites `file:line`. Never edits. |
14
+ | `planner` | Writes a plan doc only; ends with `PLAN_FILE: <path>` or pauses on `NEEDS_RESEARCH:`. |
15
+ | `builder` | Implements in small increments; may pause on `NEEDS_RESEARCH:`. |
16
+ | `plan-reviewer` / `code-reviewer` | Read-only; their whole result is findings (no handoff marker). |
17
+
18
+ ## Step 0 — Resolve the team
19
+
20
+ 1. Read `.opencode/orchestrate-teams.yaml` (a map of team-name → ordered persona list).
21
+ 2. Resolve team + task from `$ARGUMENTS`:
22
+ - Treat the **first token** as a team name **only** when it is a bare single word that
23
+ exactly matches a config key **and** is followed by the rest of the task. To force a
24
+ team explicitly, the user writes `/af-orchestrate team=<name> <task>`. Otherwise the
25
+ team is the first key (`default`) and all of `$ARGUMENTS` is the task.
26
+ - **Fallbacks:** if the config is **absent / empty / fails to parse**, fall back to the
27
+ built-in `planner` + `builder` default and **say which fallback fired** (don't proceed
28
+ silently). If a named team is requested but not found, list the available team keys and
29
+ ask rather than guessing.
30
+ 3. **Validate personas:** each persona in the resolved team must exist in `.opencode/agent/`.
31
+ Skip-with-warning any that don't. If every persona is missing, fall back to the built-in
32
+ default.
33
+ 4. List the resolved team back to the user before dispatching.
34
+
35
+ `researcher` / `deep-researcher` are **always available** even when not listed in the team.
36
+
37
+ ## Step 1 — The team is a roster, not a fixed pipeline
38
+
39
+ The persona list is the set of specialists you may route to; **you decide the order at
40
+ runtime from the task state** (the listed order is only a sensible starting default). So:
41
+
42
+ - **Skip `planner`** when a usable plan already exists (the user passed a `PLAN_FILE` or
43
+ pointed at one) — go straight to `builder`.
44
+ - **Re-dispatch `researcher` at any point** — after `planner`, mid-build — whenever a
45
+ specialist needs a fact checked, not only as a first step.
46
+ - **Loop back to `planner`** if `builder` surfaces that the plan is wrong.
47
+
48
+ Do **not** enforce a hard `researcher → planner → builder` sequence.
49
+
50
+ ## The Verification Contract (applies across every step)
51
+
52
+ Read `skills/orchestration-verification/SKILL.md` before non-trivial work and hold its
53
+ contract for the whole run. Subagents here cannot persist a shared ledger, so **you** keep
54
+ the acceptance assertions in your own working notes and refuse "done" until each is proven.
55
+
56
+ - **Build the assertions first.** Before dispatching `builder` for any non-trivial task,
57
+ convert the request into numbered, tagged assertions (`test` | `runtime-ui` | `code-grep`
58
+ | `manual`, one checkable pass condition each). Pass the relevant assertions **verbatim**
59
+ into each dispatch and advance only on assertions that come back *proven with named
60
+ evidence* — propagation in prose is not verification.
61
+ - **Inventory parity for "behave like X" requests.** When the request is "make X behave like
62
+ existing Y", dispatch `researcher` / `deep-researcher` **first** to enumerate every site
63
+ where the exemplar is special-cased (flags, branches, display, validation, translations,
64
+ fixtures, tests), and turn each site into an assertion covering the *whole* set — otherwise
65
+ the exemplar ships and its siblings are missed.
66
+ - **Require runtime proof for UI assertions.** A `runtime-ui` assertion (visibility,
67
+ placement, "appears in the table") is closed only by an actual runtime observation via
68
+ `browser-testing-with-devtools`, never a static review.
69
+ - **Accept assertion status, not verdicts.** Treat specialist returns as `assertions_proven`
70
+ / `assertions_unproven` / `assertions_failed`; demote any "approved" claim with no named
71
+ evidence to unproven and re-dispatch it.
72
+ - **Reset on "wrong again".** When the user reports a delivered requirement is wrong again,
73
+ treat prior summaries as suspect, rebuild the affected assertions from the **latest**
74
+ correction (re-running the parity inventory for "behave like" cases), then re-dispatch.
75
+
76
+ ## Step 2 — Route to specialists, honouring handoff markers
77
+
78
+ State the chosen next step (and why) before each dispatch, so routing is visible.
79
+
80
+ - `planner` → read its `PLAN_FILE: <path>` and load the plan.
81
+ - `builder` → loop over the plan's `## Task List`, **one task per dispatch**, checking each
82
+ task's acceptance criteria **and the relevant acceptance assertions** before moving on.
83
+ - **Marker-less personas** (`plan-reviewer` / `code-reviewer`) emit no handoff marker —
84
+ their returned report **is** the result; "done" = the report came back, nothing to wait
85
+ for. Fold findings forward; if a `code-reviewer` raised must-fix issues, loop back to
86
+ `builder`.
87
+
88
+ ## Step 3 — NEEDS_RESEARCH dispatch (core)
89
+
90
+ Whenever any persona's result contains one or more `NEEDS_RESEARCH: <question>` lines:
91
+
92
+ 1. Pause that track.
93
+ 2. Dispatch `researcher` (read-only) once per question — in parallel when independent.
94
+ 3. Collect the findings.
95
+ 4. Resume the paused persona by re-dispatching it with the **original task plus the
96
+ findings inlined**.
97
+
98
+ **Never** answer a `NEEDS_RESEARCH` by guessing.
99
+
100
+ ## Step 4 — Reviewer only if present
101
+
102
+ The `default` roster has **no reviewer**. After the final builder task's acceptance criteria
103
+ pass, report completion and **state explicitly that review/verification was not run** and
104
+ which acceptance assertions therefore remain unproven (the user can pick the `full` team or
105
+ run `/af-review`). When the active team *does* include a reviewer, run it as a normal step and
106
+ require it to report parity across sibling cases, not just the exemplar.
107
+
108
+ ## Step 5 — Report
109
+
110
+ Report crisply: **active team**, what changed, which acceptance assertions are **proven (with
111
+ evidence)**, which remain **unproven or failed**, and what's next. Never report "done" while a
112
+ relevant assertion is unproven.
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: Break work into small verifiable tasks with acceptance criteria and dependency ordering
3
+ ---
4
+
5
+ Invoke the `planning-and-task-breakdown` skill via the `skill` tool.
6
+
7
+ Read the existing spec, such as `SPEC.md`, and relevant codebase sections. Then:
8
+
9
+ 1. Enter planning mode: read only, no code changes.
10
+ 2. Identify the dependency graph between components.
11
+ 3. Slice work vertically, with one complete path per task rather than horizontal layers.
12
+ 4. Write tasks with acceptance criteria and verification steps.
13
+ 5. Add checkpoints between phases.
14
+ 6. Present the plan for human review.
15
+
16
+ Save the plan to the location the `planning-and-task-breakdown` skill defines (default `docs/plans/{area}/PLAN-{prd-name}-{phase}.md`, with the task list embedded — no separate todo file; overridable per project via `.ai/agent-fleet-overrides.md`), only after the user confirms the plan should be written.
@@ -0,0 +1,22 @@
1
+ ---
2
+ description: Load foundational context for the agent-fleet repository
3
+ ---
4
+
5
+ # Purpose
6
+
7
+ Orient yourself in **agent-fleet** — a collection of production-grade engineering skills
8
+ for AI coding agents, plus pi extensions, specialist agent personas, and lifecycle
9
+ commands that map to the software development lifecycle.
10
+
11
+ ## Workflow
12
+
13
+ 1. Run `git ls-files` to see the full project file tree
14
+ 2. Read `README.md` and `CLAUDE.md` for the project overview and conventions
15
+ 3. Read `docs/skill-anatomy.md` to learn the required skill format
16
+ 4. Skim `skills/*/SKILL.md` — the core skills, grouped by lifecycle phase
17
+ (Define → Plan → Build → Verify → Review → Ship)
18
+ 5. Read `agents/*.md` — the specialist review personas
19
+ 6. Read `docs/pi-extensions.md`, `.pi/extensions/*/README.md` (always-on utilities), and `.pi/harnesses/*/README.md` (selectable session harnesses)
20
+ 7. Summarize your understanding: purpose, structure, key files, and entry points
21
+
22
+ Do this directly — read the files yourself rather than delegating to subagents.
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Conduct a five-axis code review - correctness, readability, architecture, security, performance
3
+ ---
4
+
5
+ Invoke the `code-review-and-quality` skill via the `skill` tool.
6
+
7
+ Review the current changes, staged changes, or scope specified in `$ARGUMENTS` across these axes:
8
+
9
+ 1. Correctness: Does it match the spec? Are edge cases handled? Are tests adequate?
10
+ 2. Readability: Are names clear? Is the logic straightforward and well organized?
11
+ 3. Architecture: Does it follow existing patterns? Are boundaries clean? Is the abstraction level right?
12
+ 4. Security: Is input validated? Are secrets safe? Is authorization checked? Invoke `security-and-hardening` via the `skill` tool when relevant.
13
+ 5. Performance: Are there N+1 queries, unbounded operations, or avoidable frontend regressions? Invoke `performance-optimization` via the `skill` tool when relevant.
14
+
15
+ Categorize findings as Critical, Important, or Suggestion. Output a structured review with specific file and line references plus fix recommendations.
@@ -0,0 +1,15 @@
1
+ ---
2
+ description: Install/status the Hermes liaison or turn its Telegram ask_user bridge on/off
3
+ argument-hint: "<install|status|on|off> [telegram-id] [--profile NAME] [--force] [--restart]"
4
+ ---
5
+
6
+ Run the deterministic Agent Fleet controller with the arguments from `$ARGUMENTS`. Supported forms are:
7
+
8
+ ```text
9
+ set-hermes-telegram install [--profile NAME] [--force] [--restart]
10
+ set-hermes-telegram status [--profile NAME]
11
+ set-hermes-telegram on <telegram-id[:topic-id]> [--profile NAME]
12
+ set-hermes-telegram off <telegram-id[:topic-id]> [--profile NAME]
13
+ ```
14
+
15
+ Use `node bin/cli.js set-hermes-telegram ...` when the checkout-local CLI exists; otherwise use `npx --no-install agent-fleet set-hermes-telegram ...`. Pass parsed values as separately quoted shell arguments. If neither CLI exists, report that Agent Fleet must be installed or updated. Do not reproduce installation or Herdr lifecycle with ad-hoc commands, do not bypass a `--force` refusal, and do not send a test Telegram message. Return the controller output verbatim.
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: Inspect or safely install the fail-closed Hermes watchdog
3
+ argument-hint: "<status|install|update|uninstall> [--profile NAME] [--force] [--dry-run]"
4
+ ---
5
+
6
+ Ask the user before every write or `--force`. Use the deterministic watchdog installer only; status is read-only, stopped profiles require explicit `--profile`, and the controller never changes Hermes services, starts a watcher, or changes unrelated permissions. Gate O remains unproven and fail-closed: no live origin delivery, steering, surgical, or out-of-turn chat claim.
@@ -0,0 +1,17 @@
1
+ ---
2
+ description: Guided setup — install agent-fleet artifacts into a workspace for a chosen coding agent
3
+ ---
4
+
5
+ Invoke the `guided-workspace-setup` skill via the `skill` tool and follow it.
6
+
7
+ Run the guided install for a target workspace. If the user passed a workspace path, use it; otherwise ask. Confirm the coding agent (`opencode` here unless the user says otherwise).
8
+
9
+ The skill is a front-end over the `agent-fleet` CLI's installer engine: `verify --json` supplies the menu (groups, profiles, per-item state), and `install` / `upgrade` / `uninstall` / `doctor --fix` do every write. **Do not copy, symlink, or delete an install target yourself** — the CLI records ownership in `.ai/agent-fleet-state.json`, and anything written by hand is invisible to every later run. Personas land in `.opencode/agent/<name>.md` as generated files; the CLI handles that too. Artifacts install as copies; never ask copy-vs-symlink and never pass `--method`.
10
+
11
+ Two things are yours rather than the CLI's: drafting `.ai/agent-fleet-overrides.md` from a scan of the project, and the `pi-voice-stt` provider Q&A (pi workspaces only).
12
+
13
+ With a native select widget, open with the Express question backed by the manifest's profiles, then run group screens only on `Custom`, with drill-ins behind `Customise`. Without one, print a compact table and take a text reply. Option titles carry `<name> ★ [state]`; descriptions say what picking it does in plain words. Leaving an installed item unpicked keeps it — removal is its own explicit screen and runs `uninstall`. Cancel is a no-op everywhere except the final confirmation.
14
+
15
+ If `verify` reports findings or broken items, offer `doctor --fix` before the menu — a broken workspace makes the menu lie about what is installed.
16
+
17
+ Print the plan as compact action-grouped lines and wait for explicit confirmation before anything is written. Exit `3` from the CLI means conflicts: show the `.new` files it wrote and let the user decide — never pick a side for them. Relay `operator` and `external` steps verbatim; the CLI performs neither, and neither do you.
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: Run the pre-launch checklist and prepare for production deployment
3
+ ---
4
+
5
+ Invoke the `shipping-and-launch` skill via the `skill` tool.
6
+
7
+ Run through the complete pre-launch checklist:
8
+
9
+ 1. Code quality: tests pass, build clean, lint clean, no stray TODOs or console logs.
10
+ 2. Security: dependency audit checked, no secrets in code, auth in place, headers configured where applicable.
11
+ 3. Performance: Core Web Vitals or relevant performance checks are acceptable, no N+1 queries, images and bundles are reasonable.
12
+ 4. Accessibility: keyboard navigation works, screen reader semantics are acceptable, contrast is adequate.
13
+ 5. Infrastructure: environment variables are set, migrations are ready, monitoring is configured.
14
+ 6. Documentation: README is current, ADRs are written when needed, changelog is updated when relevant.
15
+
16
+ Report any failing checks and help resolve them before deployment. Define the rollback plan before proceeding.
@@ -0,0 +1,16 @@
1
+ ---
2
+ description: Start spec-driven development by writing a structured specification before code
3
+ ---
4
+
5
+ Invoke the `spec-driven-development` skill via the `skill` tool.
6
+
7
+ Begin by understanding what the user wants to build. Ask clarifying questions about:
8
+
9
+ 1. The objective and target users.
10
+ 2. Core features and acceptance criteria.
11
+ 3. Tech stack preferences and constraints.
12
+ 4. Known boundaries: what to always do, ask first about, and never do.
13
+
14
+ Then generate a structured spec covering objective, commands, project structure, code style, testing strategy, and boundaries.
15
+
16
+ Confirm with the user before saving, then save the spec to the location the `spec-driven-development` skill defines (default `docs/prds/{area}/PRD{n}-{topic}.md`; overridable per project via `.ai/agent-fleet-overrides.md`).
@@ -0,0 +1,21 @@
1
+ ---
2
+ description: Run a TDD workflow - write failing tests, implement, verify
3
+ ---
4
+
5
+ Invoke the `test-driven-development` skill via the `skill` tool.
6
+
7
+ For new features:
8
+
9
+ 1. Write tests that describe the expected behavior and confirm they fail.
10
+ 2. Implement the code to make them pass.
11
+ 3. Refactor while keeping tests green.
12
+
13
+ For bug fixes, use the Prove-It pattern:
14
+
15
+ 1. Write a test that reproduces the bug and must fail.
16
+ 2. Confirm the test fails.
17
+ 3. Implement the fix.
18
+ 4. Confirm the test passes.
19
+ 5. Run the relevant full test suite for regressions.
20
+
21
+ For browser-related issues, also invoke `browser-testing-with-devtools` via the `skill` tool to verify with Chrome DevTools MCP.
@@ -0,0 +1,32 @@
1
+ ---
2
+ description: Run a web performance audit via the web-performance-auditor subagent
3
+ ---
4
+
5
+ `/webperf` targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
6
+
7
+ ## Determine the mode
8
+
9
+ **Deep mode** - activate when any of these is available:
10
+ - A Lighthouse JSON report file (e.g. `npx lighthouse <url> --output json --output-path ./report.json`, or `npx -p chrome-devtools-mcp chrome-devtools lighthouse_audit --output-format=json` from the Chrome DevTools MCP CLI)
11
+ - A PageSpeed Insights JSON response (includes Lighthouse + CrUX)
12
+ - A CrUX API response (requires `CRUX_API_KEY` or `GOOGLE_API_KEY`)
13
+ - A DevTools performance trace
14
+ - A live URL plus the `chrome-devtools` MCP server configured in the harness (the agent can capture metrics directly via `lighthouse_audit` and `performance_*` tools)
15
+ - The Chrome DevTools MCP CLI invoked locally (via `npx -p chrome-devtools-mcp chrome-devtools <tool>` or after `npm i -g chrome-devtools-mcp`) - the user runs commands like `chrome-devtools lighthouse_audit --output-format=json` and passes the JSON output to the agent
16
+
17
+ **Quick mode** - default when none of the above are available. The agent scans source code for structural anti-patterns and labels every finding as `potential impact`.
18
+
19
+ ## Run the audit
20
+
21
+ Delegate to the `web-performance-auditor` subagent (mention `@web-performance-auditor`). Pass it explicitly:
22
+
23
+ - The files, components, or diff under review
24
+ - Any artifact paths (Lighthouse JSON, PSI JSON, CrUX response, trace) or pasted JSON content
25
+ - The target URL or page name when known
26
+ - A note on which mode you expect (Quick or Deep), so the agent surfaces missing inputs if Deep was intended
27
+
28
+ The subagent returns a scorecard (only populated with sourced values), a ranked list of findings, positive observations, and proactive recommendations.
29
+
30
+ ## Output
31
+
32
+ Return the full audit report to the user. No synthesis or merge step is needed - this is a single-subagent command.
@@ -0,0 +1,24 @@
1
+ # Teams for /orchestrate. The main session reads this file and routes the
2
+ # named team as a ROSTER (runtime-decided order), not a fixed pipeline.
3
+ #
4
+ # Rules the /orchestrate command relies on:
5
+ # 1. First key is the default team (used when no team argument is given).
6
+ # 2. researcher / deep-researcher are NOT listed — they are always available
7
+ # out-of-band for NEEDS_RESEARCH dispatch (mirrors pi's spawn_research).
8
+ # 3. Every listed persona must exist in .opencode/agent/ or it is skipped with
9
+ # a warning.
10
+ #
11
+ # Switch at runtime: /orchestrate <team> "<task>" (parallels pi's /agents-team).
12
+
13
+ default:
14
+ - planner
15
+ - builder
16
+
17
+ full:
18
+ - planner
19
+ - plan-reviewer
20
+ - builder
21
+ - code-reviewer
22
+
23
+ hotfix:
24
+ - builder
@@ -0,0 +1,32 @@
1
+ # Backend routing for the agent-hub dispatcher (dispatch_agent). Decided at
2
+ # DISPATCH time, never at team activation — the hub and its peers boot in
3
+ # parallel (`just fleet team <team>`), so a member's coms peer may register
4
+ # after the session starts.
5
+ #
6
+ # default: native | coms — coms substitutes ANY active-team member that has
7
+ # a live same-name peer in the coms pool
8
+ # grace_s: <seconds> — how long a `fallback: none` member polls the pool
9
+ # for its peer before the dispatch is refused
10
+ # substitutions:
11
+ # <member>: — team-member/persona name (case-insensitive)
12
+ # prefer: native|coms — bare member block defaults to coms
13
+ # fallback: native|none — none = coms-required (refuse when no live peer)
14
+ # timeout_s: <seconds> — per-member reply timeout (default PI_COMS_TIMEOUT_MS)
15
+ #
16
+ # Missing file = everything native (no behavior change). This file is an
17
+ # orchestration decision; HOW each peer runs (model, runner: claude-code, env)
18
+ # stays in peers.yaml.
19
+
20
+ default: native
21
+ grace_s: 30
22
+
23
+ substitutions:
24
+ plan-reviewer:
25
+ prefer: coms
26
+ fallback: native
27
+ code-reviewer:
28
+ prefer: coms
29
+ fallback: native
30
+ documenter:
31
+ prefer: coms
32
+ fallback: native
@@ -0,0 +1,27 @@
1
+ # Named model profiles for /models — each entry must be one of the persona's
2
+ # declared candidates (frontmatter `model:` + `models:` list). A profile with
3
+ # any invalid entry is dropped whole at session start, with an error notify.
4
+ #
5
+ # Profiles only switch the personas they list; everyone else keeps their
6
+ # current model. They never touch delegate-children (`subagents:`) models.
7
+ mix-max:
8
+ code-reviewer: github-copilot/claude-opus-5
9
+ builder: openai-codex/gpt-5.6-sol
10
+ planner: github-copilot/claude-fable-5
11
+ plan-reviewer: openai-codex/gpt-5.6-sol
12
+ security-auditor: xai/grok-4.5
13
+ test-engineer: xai/grok-4.5
14
+ sol:
15
+ code-reviewer: openai-codex/gpt-5.6-sol
16
+ builder: openai-codex/gpt-5.6-sol
17
+ planner: openai-codex/gpt-5.6-sol
18
+ plan-reviewer: openai-codex/gpt-5.6-sol
19
+ security-auditor: openai-codex/gpt-5.6-sol
20
+ test-engineer: openai-codex/gpt-5.6-sol
21
+ terra:
22
+ code-reviewer: openai-codex/gpt-5.6-terra
23
+ builder: openai-codex/gpt-5.6-terra
24
+ planner: openai-codex/gpt-5.6-terra
25
+ plan-reviewer: openai-codex/gpt-5.6-terra
26
+ security-auditor: openai-codex/gpt-5.6-terra
27
+ test-engineer: openai-codex/gpt-5.6-terra
@@ -0,0 +1,142 @@
1
+ # Reusable coms peers, grouped into named teams (parallels teams.yaml).
2
+ #
3
+ # `just fleet team <name> --no-hub` spawns each peer in its own Herdr pane
4
+ # (requires a running herdr server — https://herdr.dev),
5
+ # using the hidden `_peer` helper (guarded Fleet Core + coms + the persona).
6
+ #
7
+ # A team is NOT required to launch a single peer: `just fleet peer <name>` puts
8
+ # one peer (pi or `--runner claude-code`) in its own pane — splitting the current
9
+ # pane inside Herdr, else creating a one-pane workspace, or `--here` for the
10
+ # calling terminal. A name declared below keeps its runner/model/extensions/
11
+ # env_file; an undeclared name works too.
12
+ #
13
+ # Each peer entry:
14
+ # name — coms identity (the addressable peer name); overrides persona frontmatter
15
+ # persona — file under agents/ (without .md); its body is the role, its
16
+ # frontmatter `description`/`color` become the coms purpose/color
17
+ # model — optional pi --model spec (e.g. anthropic/claude-opus-4-7); omit to
18
+ # inherit pi's default model
19
+ # extensions — optional comma-separated extension names under .pi/extensions/ to
20
+ # load into this peer (routes it through `_peer-plus`). Use for a
21
+ # chrome-devtools-mcp browser-debug peer whose `chrome_devtools__*`
22
+ # tools a --no-extensions subagent could not get.
23
+ # env_file — optional repo-relative KEY=VALUE file (no shell evaluation) injected
24
+ # into the peer's pane env by herdr before the command runs. Must exist
25
+ # at spawn or team-up refuses. Values are redacted in --dry-run output.
26
+ # Pair with the gitignored `.env` convention from guided setup
27
+ # (docs/agent-fleet-setup.md).
28
+ # runner — optional; "claude-code" spawns interactive Claude Code + its coms
29
+ # bridge in the pane instead of a pi peer (persona not required;
30
+ # model maps to `claude --model`). Example:
31
+ # - name: claude-main
32
+ # runner: claude-code
33
+ # model: opus
34
+
35
+ # Hub-only workspace: `just fleet team base --project <name>` creates a Herdr
36
+ # workspace containing only the guarded hub, with no reusable coms peer panes.
37
+ base:
38
+
39
+ full:
40
+ - name: web-debugger
41
+ persona: web-debugger
42
+ model: openai-codex/gpt-5.6-terra
43
+ extensions: chrome-devtools-mcp
44
+ - name: documenter
45
+ persona: documenter
46
+ model: openai-codex/gpt-5.6-terra
47
+ - name: researcher
48
+ persona: researcher
49
+ model: openai-codex/gpt-5.6-luna
50
+
51
+ web:
52
+ - name: web-debugger
53
+ persona: web-debugger
54
+ model: openai-codex/gpt-5.6-terra
55
+ extensions: chrome-devtools-mcp
56
+
57
+ docs:
58
+ - name: documenter
59
+ persona: documenter
60
+ model: openai-codex/gpt-5.6-terra
61
+ - name: researcher
62
+ persona: researcher
63
+ model: openai-codex/gpt-5.6-luna
64
+
65
+ # Mirrored from .pi/agents/teams.yaml for `just fleet team <team>`.
66
+ default:
67
+ - name: code-reviewer
68
+ runner: claude-code
69
+ - name: web-debugger
70
+ persona: web-debugger
71
+ model: openai-codex/gpt-5.6-terra
72
+ extensions: chrome-devtools-mcp
73
+
74
+ debug:
75
+ - name: test-engineer
76
+ persona: test-engineer
77
+ model: openai-codex/gpt-5.6-terra
78
+ - name: builder
79
+ persona: builder
80
+ model: openai-codex/gpt-5.6-terra
81
+ - name: code-reviewer
82
+ runner: claude-code
83
+
84
+ frontend:
85
+ - name: planner
86
+ persona: planner
87
+ model: openai-codex/gpt-5.6-sol
88
+ - name: builder
89
+ persona: builder
90
+ model: openai-codex/gpt-5.6-terra
91
+ - name: bowser
92
+ persona: bowser
93
+ model: openai-codex/gpt-5.6-luna
94
+ - name: code-reviewer
95
+ runner: claude-code
96
+
97
+ security:
98
+ - name: security-auditor
99
+ persona: security-auditor
100
+ model: openai-codex/gpt-5.6-sol
101
+ - name: builder
102
+ persona: builder
103
+ model: openai-codex/gpt-5.6-terra
104
+ - name: test-engineer
105
+ persona: test-engineer
106
+ model: openai-codex/gpt-5.6-terra
107
+ - name: code-reviewer
108
+ runner: claude-code
109
+
110
+ hotfix:
111
+ - name: builder
112
+ persona: builder
113
+ model: openai-codex/gpt-5.6-terra
114
+ - name: code-reviewer
115
+ runner: claude-code
116
+
117
+ release:
118
+ - name: releaser
119
+ persona: releaser
120
+ model: openai-codex/gpt-5.6-terra
121
+ - name: documenter
122
+ persona: documenter
123
+ model: openai-codex/gpt-5.6-terra
124
+
125
+ info:
126
+ - name: documenter
127
+ persona: documenter
128
+ model: openai-codex/gpt-5.3-codex-spark
129
+ - name: code-reviewer
130
+ runner: claude-code
131
+
132
+ review:
133
+ - name: plan-reviewer
134
+ runner: claude-code
135
+ - name: code-reviewer
136
+ runner: claude-code
137
+
138
+ plan:
139
+ - name: planner
140
+ runner: claude-code
141
+ - name: code-reviewer
142
+ runner: claude-code
@@ -0,0 +1,41 @@
1
+ # The first team is activated at startup. Switch with: /agents-team
2
+ # researcher / deep-researcher are not listed — they are always available through spawn_research.
3
+
4
+ default:
5
+ - builder
6
+ - test-engineer
7
+ - code-reviewer
8
+ - documenter
9
+
10
+ plan:
11
+ - planner
12
+ - plan-reviewer
13
+
14
+ debug:
15
+ - test-engineer
16
+ - builder
17
+ - code-reviewer
18
+
19
+ frontend:
20
+ - planner
21
+ - builder
22
+ - bowser
23
+ - code-reviewer
24
+
25
+ security:
26
+ - security-auditor
27
+ - builder
28
+ - test-engineer
29
+ - code-reviewer
30
+
31
+ hotfix:
32
+ - builder
33
+ - code-reviewer
34
+
35
+ release:
36
+ - releaser
37
+ - documenter
38
+
39
+ info:
40
+ - documenter
41
+ - code-reviewer