@chankov/agent-fleet 2.0.7 → 2.0.8

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 (619) hide show
  1. package/{hermes → .pi/agent-fleet/hermes}/README.md +7 -7
  2. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/activity.py +2 -2
  3. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_registry.py +2 -2
  4. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/coms_send.py +1 -1
  5. package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/watch.py +2 -2
  6. package/{hermes → .pi/agent-fleet/hermes}/skills/hub-conductor/SKILL.md +1 -1
  7. package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/SKILL.md +3 -3
  8. package/{hooks → .pi/agent-fleet/hooks}/coms-stop-hook.mjs +2 -2
  9. package/{scripts → .pi/agent-fleet/scripts}/claude-code-preflight.ts +1 -1
  10. package/{scripts → .pi/agent-fleet/scripts}/coms-claude-bridge.ts +6 -6
  11. package/{scripts → .pi/agent-fleet/scripts}/coms-cli.ts +1 -1
  12. package/{scripts → .pi/agent-fleet/scripts}/coms-hermes-bridge.ts +1 -1
  13. package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-read.py +5 -3
  14. package/{scripts → .pi/agent-fleet/scripts}/fleet.ts +1 -1
  15. package/{scripts → .pi/agent-fleet/scripts}/flow.ts +1 -1
  16. package/{scripts → .pi/agent-fleet/scripts}/lib/claude-bridge-core.ts +2 -2
  17. package/{scripts → .pi/agent-fleet/scripts}/lib/coms-envelope.ts +1 -1
  18. package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-transport.ts +1 -1
  19. package/{scripts → .pi/agent-fleet/scripts}/lib/herdr-layout.ts +3 -3
  20. package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-bridge-core.ts +1 -1
  21. package/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  22. package/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  23. package/{scripts → .pi/agent-fleet/scripts}/lib/hermes-monitor-model.ts +1 -1
  24. package/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  25. package/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  26. package/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  27. package/{scripts → .pi/agent-fleet/scripts}/lib/monitor-env.ts +1 -1
  28. package/{scripts → .pi/agent-fleet/scripts}/lib/peer-launch.ts +3 -3
  29. package/{scripts → .pi/agent-fleet/scripts}/lib/persona-banner.ts +1 -1
  30. package/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  31. package/{scripts → .pi/agent-fleet/scripts}/lib/runtime-dependencies.js +1 -1
  32. package/{scripts → .pi/agent-fleet/scripts}/lib/spawn-stagger.ts +1 -1
  33. package/{scripts → .pi/agent-fleet/scripts}/lib/team-project.ts +1 -1
  34. package/{scripts → .pi/agent-fleet/scripts}/lib/team-snapshot.ts +2 -2
  35. package/{scripts → .pi/agent-fleet/scripts}/peer-banner.ts +5 -4
  36. package/{scripts → .pi/agent-fleet/scripts}/peer-launch.ts +7 -9
  37. package/{scripts → .pi/agent-fleet/scripts}/team-snapshot.ts +5 -5
  38. package/{scripts → .pi/agent-fleet/scripts}/team-up.ts +6 -6
  39. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/agent-phase.ts +3 -3
  40. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/envelopes.ts +1 -1
  41. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-profile.ts +1 -1
  42. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/personas.ts +2 -2
  43. package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/trace.ts +1 -1
  44. package/.pi/agents/peers.yaml +3 -1
  45. package/.pi/harnesses/agent-hub/README.md +1 -1
  46. package/.pi/harnesses/agent-hub/config/agents.ts +5 -1
  47. package/.pi/harnesses/agent-hub/debate-command.ts +1 -1
  48. package/.pi/harnesses/agent-hub/index.ts +19 -19
  49. package/.pi/harnesses/agent-hub/package.json +1 -1
  50. package/.pi/harnesses/agent-hub/peer-spawn-plan.ts +1 -1
  51. package/.pi/harnesses/agent-hub/tools/fleet-tools.ts +3 -5
  52. package/.pi/harnesses/agent-hub/tools/herdr-executors.ts +2 -2
  53. package/.pi/harnesses/ask-user-remote/index.ts +2 -2
  54. package/.pi/harnesses/coms/package.json +1 -1
  55. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  56. package/.pi/harnesses/lib/spawned-peers.js +1 -1
  57. package/.pi/prompts/af-constraints.md +31 -0
  58. package/.versions/2.0.8/.pi/agent-fleet/hermes/README.md +347 -0
  59. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  60. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  61. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  62. package/.versions/2.0.8/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  63. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  64. package/.versions/2.0.8/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  65. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  66. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  67. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  68. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  69. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  70. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  71. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  72. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  73. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  74. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  75. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  76. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  77. package/.versions/2.0.8/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  78. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  79. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  80. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  81. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  82. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  83. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  84. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  85. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  86. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  87. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  88. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  89. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  90. package/.versions/2.0.8/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  91. package/.versions/2.0.8/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  92. package/.versions/2.0.8/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  93. package/.versions/2.0.8/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  94. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  95. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  96. package/.versions/2.0.8/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  97. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  98. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  99. package/.versions/2.0.8/.pi/agent-fleet/scripts/fleet.ts +216 -0
  100. package/.versions/2.0.8/.pi/agent-fleet/scripts/flow.ts +137 -0
  101. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  102. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  103. package/.versions/2.0.8/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  104. package/.versions/2.0.8/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  105. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  106. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  107. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  108. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  109. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  110. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  111. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  112. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  113. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  114. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  115. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  116. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  117. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  118. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  119. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  120. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  121. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  122. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  123. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  124. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  125. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  126. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  127. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  128. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  129. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  130. package/.versions/2.0.8/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  131. package/.versions/2.0.8/.pi/agent-fleet/scripts/package-lock.json +35 -0
  132. package/.versions/2.0.8/.pi/agent-fleet/scripts/package.json +9 -0
  133. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  134. package/.versions/2.0.8/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  135. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  136. package/.versions/2.0.8/.pi/agent-fleet/scripts/team-up.ts +378 -0
  137. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  138. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  139. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  140. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  141. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  142. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  143. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  144. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  145. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  146. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  147. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  148. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  149. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  150. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  151. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  152. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  153. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  154. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  155. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  156. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  157. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  158. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  159. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  160. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  161. package/.versions/2.0.8/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  162. package/.versions/2.0.8/.pi/agents/dispatch-policy.yaml +32 -0
  163. package/.versions/2.0.8/.pi/agents/model-profiles.yaml +83 -0
  164. package/.versions/2.0.8/.pi/agents/peers.yaml +147 -0
  165. package/.versions/2.0.8/.pi/agents/teams.yaml +41 -0
  166. package/.versions/2.0.8/.pi/agents/voices.yaml +13 -0
  167. package/.versions/2.0.8/.pi/damage-control-rules.yaml +297 -0
  168. package/.versions/2.0.8/.pi/extensions/btw/README.md +120 -0
  169. package/.versions/2.0.8/.pi/extensions/btw/index.ts +914 -0
  170. package/.versions/2.0.8/.pi/extensions/btw/package.json +6 -0
  171. package/.versions/2.0.8/.pi/extensions/btw/state.js +179 -0
  172. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  173. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  174. package/.versions/2.0.8/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  175. package/.versions/2.0.8/.pi/extensions/compact-and-continue/README.md +42 -0
  176. package/.versions/2.0.8/.pi/extensions/compact-and-continue/index.ts +120 -0
  177. package/.versions/2.0.8/.pi/extensions/compact-and-continue/package.json +6 -0
  178. package/.versions/2.0.8/.pi/extensions/mcp-bridge/README.md +46 -0
  179. package/.versions/2.0.8/.pi/extensions/mcp-bridge/index.ts +206 -0
  180. package/.versions/2.0.8/.pi/extensions/mcp-bridge/package.json +6 -0
  181. package/.versions/2.0.8/.pi/extensions/package-lock.json +1175 -0
  182. package/.versions/2.0.8/.pi/extensions/package.json +9 -0
  183. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/README.md +205 -0
  184. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/config.ts +198 -0
  185. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  186. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/index.ts +248 -0
  187. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/package.json +6 -0
  188. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  189. package/.versions/2.0.8/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  190. package/.versions/2.0.8/.pi/harnesses/agent-hub/README.md +1203 -0
  191. package/.versions/2.0.8/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  192. package/.versions/2.0.8/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  193. package/.versions/2.0.8/.pi/harnesses/agent-hub/artifacts.js +146 -0
  194. package/.versions/2.0.8/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  195. package/.versions/2.0.8/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  196. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  197. package/.versions/2.0.8/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  198. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  199. package/.versions/2.0.8/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  200. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  201. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  202. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  203. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  204. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  205. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  206. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  207. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  208. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  209. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  210. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  211. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  212. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  213. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  214. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  215. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  216. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  217. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  218. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  219. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  220. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  221. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  222. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  223. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  224. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  225. package/.versions/2.0.8/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  226. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  227. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  228. package/.versions/2.0.8/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  229. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  230. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  231. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  232. package/.versions/2.0.8/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  233. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  234. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  235. package/.versions/2.0.8/.pi/harnesses/agent-hub/context-window.js +106 -0
  236. package/.versions/2.0.8/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  237. package/.versions/2.0.8/.pi/harnesses/agent-hub/delegate.ts +446 -0
  238. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  239. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  240. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  241. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  242. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  243. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  244. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  245. package/.versions/2.0.8/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  246. package/.versions/2.0.8/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  247. package/.versions/2.0.8/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  248. package/.versions/2.0.8/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  249. package/.versions/2.0.8/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  250. package/.versions/2.0.8/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  251. package/.versions/2.0.8/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  252. package/.versions/2.0.8/.pi/harnesses/agent-hub/footer.ts +30 -0
  253. package/.versions/2.0.8/.pi/harnesses/agent-hub/helpers.ts +266 -0
  254. package/.versions/2.0.8/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  255. package/.versions/2.0.8/.pi/harnesses/agent-hub/index.ts +2151 -0
  256. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  257. package/.versions/2.0.8/.pi/harnesses/agent-hub/input/shortcuts.ts +18 -0
  258. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  259. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  260. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  261. package/.versions/2.0.8/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  262. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  263. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  264. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  265. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  266. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  267. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  268. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  269. package/.versions/2.0.8/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  270. package/.versions/2.0.8/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  271. package/.versions/2.0.8/.pi/harnesses/agent-hub/package.json +7 -0
  272. package/.versions/2.0.8/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  273. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  274. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  275. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  276. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  277. package/.versions/2.0.8/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  278. package/.versions/2.0.8/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  279. package/.versions/2.0.8/.pi/harnesses/agent-hub/presentation.ts +48 -0
  280. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  281. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  282. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  283. package/.versions/2.0.8/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  284. package/.versions/2.0.8/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  285. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  286. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  287. package/.versions/2.0.8/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  288. package/.versions/2.0.8/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  289. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-contract.js +293 -0
  290. package/.versions/2.0.8/.pi/harnesses/agent-hub/return-extract.js +75 -0
  291. package/.versions/2.0.8/.pi/harnesses/agent-hub/review-findings.js +102 -0
  292. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-budget.js +537 -0
  293. package/.versions/2.0.8/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  294. package/.versions/2.0.8/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  295. package/.versions/2.0.8/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  296. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-health.js +110 -0
  297. package/.versions/2.0.8/.pi/harnesses/agent-hub/session-start.ts +42 -0
  298. package/.versions/2.0.8/.pi/harnesses/agent-hub/spawn.ts +404 -0
  299. package/.versions/2.0.8/.pi/harnesses/agent-hub/timeline.ts +54 -0
  300. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  301. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  302. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  303. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  304. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  305. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  306. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  307. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  308. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  309. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  310. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  311. package/.versions/2.0.8/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  312. package/.versions/2.0.8/.pi/harnesses/agent-hub/types.ts +63 -0
  313. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  314. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  315. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  316. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +125 -0
  317. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/grid.ts +42 -0
  318. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  319. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  320. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  321. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/running-strip.ts +139 -0
  322. package/.versions/2.0.8/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  323. package/.versions/2.0.8/.pi/harnesses/agent-hub/version.ts +42 -0
  324. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  325. package/.versions/2.0.8/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  326. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/README.md +59 -0
  327. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/index.ts +558 -0
  328. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  329. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  330. package/.versions/2.0.8/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  331. package/.versions/2.0.8/.pi/harnesses/coms/README.md +100 -0
  332. package/.versions/2.0.8/.pi/harnesses/coms/index.ts +282 -0
  333. package/.versions/2.0.8/.pi/harnesses/coms/package.json +7 -0
  334. package/.versions/2.0.8/.pi/harnesses/coms/version.ts +42 -0
  335. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/README.md +135 -0
  336. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/index.ts +541 -0
  337. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/package.json +7 -0
  338. package/.versions/2.0.8/.pi/harnesses/damage-control-continue/version.ts +42 -0
  339. package/.versions/2.0.8/.pi/harnesses/lib/coms-core-io.ts +385 -0
  340. package/.versions/2.0.8/.pi/harnesses/lib/coms-core.ts +577 -0
  341. package/.versions/2.0.8/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  342. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  343. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  344. package/.versions/2.0.8/.pi/harnesses/lib/context-budget-view.ts +107 -0
  345. package/.versions/2.0.8/.pi/harnesses/lib/context-budget.ts +114 -0
  346. package/.versions/2.0.8/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  347. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  348. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  349. package/.versions/2.0.8/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  350. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-ops.ts +161 -0
  351. package/.versions/2.0.8/.pi/harnesses/lib/fleet-dashboard-view.ts +148 -0
  352. package/.versions/2.0.8/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  353. package/.versions/2.0.8/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  354. package/.versions/2.0.8/.pi/harnesses/lib/fleet-panel.ts +34 -0
  355. package/.versions/2.0.8/.pi/harnesses/lib/fleet-read-model.ts +131 -0
  356. package/.versions/2.0.8/.pi/harnesses/lib/fleet-selection.ts +24 -0
  357. package/.versions/2.0.8/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  358. package/.versions/2.0.8/.pi/harnesses/lib/herdr-client.ts +472 -0
  359. package/.versions/2.0.8/.pi/harnesses/lib/herdr-presence.ts +399 -0
  360. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  361. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  362. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  363. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  364. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  365. package/.versions/2.0.8/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  366. package/.versions/2.0.8/.pi/harnesses/lib/spawned-peers.js +190 -0
  367. package/.versions/2.0.8/.pi/harnesses/lib/update-check.ts +222 -0
  368. package/.versions/2.0.8/.pi/harnesses/package-lock.json +2039 -0
  369. package/.versions/2.0.8/.pi/harnesses/package.json +10 -0
  370. package/.versions/2.0.8/.pi/prompts/af-build.md +24 -0
  371. package/.versions/2.0.8/.pi/prompts/af-code-simplify.md +22 -0
  372. package/.versions/2.0.8/.pi/prompts/af-constraints.md +31 -0
  373. package/.versions/2.0.8/.pi/prompts/af-plan.md +17 -0
  374. package/.versions/2.0.8/.pi/prompts/af-review.md +16 -0
  375. package/.versions/2.0.8/.pi/prompts/af-set-hermes-telegram.md +15 -0
  376. package/.versions/2.0.8/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  377. package/.versions/2.0.8/.pi/prompts/af-ship.md +17 -0
  378. package/.versions/2.0.8/.pi/prompts/af-spec.md +15 -0
  379. package/.versions/2.0.8/.pi/prompts/af-test.md +19 -0
  380. package/.versions/2.0.8/.pi/skills/bowser/SKILL.md +145 -0
  381. package/.versions/2.0.8/.version +1 -0
  382. package/.versions/2.0.8/agents/architect.md +25 -0
  383. package/.versions/2.0.8/agents/bowser.md +28 -0
  384. package/.versions/2.0.8/agents/builder.md +56 -0
  385. package/.versions/2.0.8/agents/code-reviewer.md +210 -0
  386. package/.versions/2.0.8/agents/deep-researcher.md +33 -0
  387. package/.versions/2.0.8/agents/documenter.md +23 -0
  388. package/.versions/2.0.8/agents/orchestrator.md +23 -0
  389. package/.versions/2.0.8/agents/plan-reviewer.md +84 -0
  390. package/.versions/2.0.8/agents/planner.md +106 -0
  391. package/.versions/2.0.8/agents/releaser.md +25 -0
  392. package/.versions/2.0.8/agents/researcher.md +31 -0
  393. package/.versions/2.0.8/agents/security-auditor.md +168 -0
  394. package/.versions/2.0.8/agents/test-engineer.md +154 -0
  395. package/.versions/2.0.8/agents/web-debugger.md +44 -0
  396. package/.versions/2.0.8/agents/web-performance-auditor.md +194 -0
  397. package/.versions/2.0.8/bin/catalog/harness-runtime-closure.json +32 -0
  398. package/.versions/2.0.8/codex/fleet-session-client/SKILL.md +34 -0
  399. package/.versions/2.0.8/codex/fleet-session-client.zip +0 -0
  400. package/.versions/2.0.8/docs/ARCHITECTURE.md +416 -0
  401. package/.versions/2.0.8/docs/agent-fleet-setup.md +568 -0
  402. package/.versions/2.0.8/docs/claude-code-coms-bridge.md +134 -0
  403. package/.versions/2.0.8/docs/codex-session-bridge.md +219 -0
  404. package/.versions/2.0.8/docs/coms-hermes-bridge.md +188 -0
  405. package/.versions/2.0.8/docs/getting-started.md +126 -0
  406. package/.versions/2.0.8/docs/npm-install.md +356 -0
  407. package/.versions/2.0.8/docs/pi-extensions.md +446 -0
  408. package/.versions/2.0.8/docs/pi-setup.md +76 -0
  409. package/.versions/2.0.8/docs/skill-anatomy.md +150 -0
  410. package/.versions/2.0.8/install-manifest.json +2991 -0
  411. package/.versions/2.0.8/justfile +247 -0
  412. package/.versions/2.0.8/manifest-meta.json +970 -0
  413. package/.versions/2.0.8/references/accessibility-checklist.md +160 -0
  414. package/.versions/2.0.8/references/communication-contract.md +26 -0
  415. package/.versions/2.0.8/references/definition-of-done.md +67 -0
  416. package/.versions/2.0.8/references/fleet-coordination-patterns.md +171 -0
  417. package/.versions/2.0.8/references/observability-checklist.md +92 -0
  418. package/.versions/2.0.8/references/orchestration-patterns.md +370 -0
  419. package/.versions/2.0.8/references/performance-checklist.md +236 -0
  420. package/.versions/2.0.8/references/prompting-patterns.md +380 -0
  421. package/.versions/2.0.8/references/security-checklist.md +245 -0
  422. package/.versions/2.0.8/references/testing-patterns.md +235 -0
  423. package/.versions/2.0.8/references/workflow-authoring.md +304 -0
  424. package/.versions/2.0.8/skills/_internal/grilling.md +59 -0
  425. package/.versions/2.0.8/skills/browser-testing-with-devtools/SKILL.md +351 -0
  426. package/.versions/2.0.8/skills/code-review-and-quality/SKILL.md +396 -0
  427. package/.versions/2.0.8/skills/compound-learning/SKILL.md +137 -0
  428. package/.versions/2.0.8/skills/constraint-driven-development/SKILL.md +338 -0
  429. package/.versions/2.0.8/skills/constraint-driven-development/references/floor-guard.md +99 -0
  430. package/.versions/2.0.8/skills/context-engineering/SKILL.md +341 -0
  431. package/.versions/2.0.8/skills/deprecation-and-migration/SKILL.md +247 -0
  432. package/.versions/2.0.8/skills/designing-agents/SKILL.md +394 -0
  433. package/.versions/2.0.8/skills/designing-agents/pi-harness-authoring.md +222 -0
  434. package/.versions/2.0.8/skills/drafting-workflows/SKILL.md +143 -0
  435. package/.versions/2.0.8/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  436. package/.versions/2.0.8/skills/frontend-ui-engineering/SKILL.md +328 -0
  437. package/.versions/2.0.8/skills/git-workflow-and-versioning/SKILL.md +316 -0
  438. package/.versions/2.0.8/skills/idea-refine/SKILL.md +182 -0
  439. package/.versions/2.0.8/skills/idea-refine/examples.md +238 -0
  440. package/.versions/2.0.8/skills/idea-refine/frameworks.md +99 -0
  441. package/.versions/2.0.8/skills/idea-refine/refinement-criteria.md +113 -0
  442. package/.versions/2.0.8/skills/idea-refine/scripts/idea-refine.sh +15 -0
  443. package/.versions/2.0.8/skills/incremental-implementation/SKILL.md +302 -0
  444. package/.versions/2.0.8/skills/interview-me/SKILL.md +226 -0
  445. package/.versions/2.0.8/skills/orchestration-verification/SKILL.md +181 -0
  446. package/.versions/2.0.8/skills/peer-coms/SKILL.md +90 -0
  447. package/.versions/2.0.8/skills/performance-optimization/SKILL.md +496 -0
  448. package/.versions/2.0.8/skills/planning-and-task-breakdown/SKILL.md +289 -0
  449. package/.versions/2.0.8/skills/security-and-hardening/SKILL.md +524 -0
  450. package/.versions/2.0.8/skills/spec-driven-development/SKILL.md +295 -0
  451. package/.versions/2.0.8/skills/using-agent-skills/SKILL.md +198 -0
  452. package/.versions/2.0.8/vendor/agent-skills-upstream/LICENSE +21 -0
  453. package/.versions/2.0.8/vendor/agent-skills-upstream/README.md +430 -0
  454. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  455. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  456. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  457. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  458. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  459. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  460. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  461. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  462. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  463. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  464. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  465. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  466. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  467. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  468. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  469. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  470. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  471. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  472. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  473. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  474. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  475. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  476. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  477. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  478. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  479. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  480. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  481. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  482. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  483. package/.versions/2.0.8/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  484. package/CHANGELOG.md +39 -0
  485. package/README.md +10 -9
  486. package/bin/catalog/harness-runtime-closure.json +23 -22
  487. package/bin/cli.js +24 -1
  488. package/bin/lib/apply.js +6 -2
  489. package/bin/lib/detect-agent.js +1 -1
  490. package/bin/lib/doctor.js +3 -3
  491. package/bin/lib/manifest.js +23 -16
  492. package/bin/lib/path-boundaries.js +96 -0
  493. package/bin/lib/personas.js +15 -2
  494. package/bin/lib/set-hermes-telegram.js +2 -2
  495. package/bin/lib/set-hermes-watchdog.js +1 -1
  496. package/bin/lib/state.js +5 -1
  497. package/bin/lib/verify.js +43 -5
  498. package/bin/snapshot-version.js +6 -6
  499. package/codex/fleet-session-client/SKILL.md +3 -3
  500. package/docs/ARCHITECTURE.md +29 -20
  501. package/docs/MIGRATION-agent-fleet.md +11 -7
  502. package/docs/agent-fleet-setup.md +9 -2
  503. package/docs/claude-code-coms-bridge.md +10 -9
  504. package/docs/codex-session-bridge.md +18 -18
  505. package/docs/coms-hermes-bridge.md +6 -6
  506. package/docs/hermes-watchdog-supervisor.md +1 -1
  507. package/docs/npm-install.md +30 -1
  508. package/docs/pi-extensions.md +6 -6
  509. package/docs/workflows.md +9 -5
  510. package/install-manifest.json +202 -97
  511. package/justfile +19 -19
  512. package/manifest-meta.json +50 -38
  513. package/package.json +26 -26
  514. package/references/observability-checklist.md +1 -0
  515. package/references/performance-checklist.md +83 -0
  516. package/references/prompting-patterns.md +1 -1
  517. package/references/security-checklist.md +85 -19
  518. package/references/testing-patterns.md +12 -13
  519. package/references/workflow-authoring.md +5 -5
  520. package/skills/code-review-and-quality/SKILL.md +17 -2
  521. package/skills/constraint-driven-development/SKILL.md +338 -0
  522. package/skills/constraint-driven-development/references/floor-guard.md +99 -0
  523. package/skills/context-engineering/SKILL.md +52 -2
  524. package/skills/deprecation-and-migration/SKILL.md +42 -1
  525. package/skills/designing-agents/SKILL.md +12 -12
  526. package/skills/drafting-workflows/SKILL.md +6 -6
  527. package/skills/drafting-workflows/scripts/make-workflow.ts +3 -3
  528. package/skills/frontend-ui-engineering/SKILL.md +2 -2
  529. package/skills/git-workflow-and-versioning/SKILL.md +1 -1
  530. package/skills/incremental-implementation/SKILL.md +13 -9
  531. package/skills/peer-coms/SKILL.md +4 -4
  532. package/skills/performance-optimization/SKILL.md +152 -6
  533. package/skills/planning-and-task-breakdown/SKILL.md +32 -8
  534. package/skills/security-and-hardening/SKILL.md +84 -21
  535. package/skills/spec-driven-development/SKILL.md +41 -2
  536. package/skills/using-agent-skills/SKILL.md +3 -2
  537. package/vendor/agent-skills-upstream/README.md +427 -8
  538. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +73 -0
  539. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +2 -2
  540. package/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  541. package/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  542. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +49 -1
  543. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +4 -4
  544. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +1 -1
  545. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +12 -2
  546. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +3 -3
  547. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +1 -1
  548. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +1 -1
  549. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +9 -9
  550. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +36 -1
  551. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +151 -5
  552. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +32 -9
  553. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +64 -7
  554. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +26 -6
  555. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +23 -1
  556. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +42 -3
  557. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +18 -3
  558. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +3 -2
  559. package/scripts/lib/hermes-monitor-events.ts +0 -1
  560. package/scripts/lib/hermes-monitor-herdr.ts +0 -2
  561. package/scripts/lib/hermes-monitor-registry.ts +0 -2
  562. package/scripts/lib/hermes-monitor-socket.ts +0 -2
  563. package/scripts/lib/hermes-monitor-store.ts +0 -2
  564. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/plugin.js +0 -0
  565. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-herdr/presentation.js +0 -0
  566. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/plugin.js +0 -0
  567. /package/{hermes → .pi/agent-fleet/hermes}/desktop-plugins/agent-fleet-monitor/state.js +0 -0
  568. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/herdr_source.py +0 -0
  569. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/manifest.json +0 -0
  570. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/plugin_api.py +0 -0
  571. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/sessions.py +0 -0
  572. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/dashboard/tasks.py +0 -0
  573. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-herdr/plugin.yaml +0 -0
  574. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/adapter.py +0 -0
  575. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/dist/index.js +0 -0
  576. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/manifest.json +0 -0
  577. /package/{hermes → .pi/agent-fleet/hermes}/plugins/agent-fleet-monitor/dashboard/plugin_api.py +0 -0
  578. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-liaison/SKILL.md +0 -0
  579. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/manifest.json +0 -0
  580. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog.py +0 -0
  581. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_actions.py +0 -0
  582. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_contract.py +0 -0
  583. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_delivery.py +0 -0
  584. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_engine.py +0 -0
  585. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_judgment.py +0 -0
  586. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_recovery.py +0 -0
  587. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_state.py +0 -0
  588. /package/{hermes → .pi/agent-fleet/hermes}/skills/hub-watchdog/scripts/watchdog_transport.py +0 -0
  589. /package/{scripts → .pi/agent-fleet/scripts}/fleet-codex-client.ts +0 -0
  590. /package/{scripts → .pi/agent-fleet/scripts}/hermes-watchdog-capability-probe.ts +0 -0
  591. /package/{scripts → .pi/agent-fleet/scripts}/lib/fake-herdr-server.ts +0 -0
  592. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-catalog.ts +0 -0
  593. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-operations.ts +0 -0
  594. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-codex-session.ts +0 -0
  595. /package/{scripts → .pi/agent-fleet/scripts}/lib/fleet-command.ts +0 -0
  596. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-command.ts +0 -0
  597. /package/{scripts → .pi/agent-fleet/scripts}/lib/flow-maintenance.ts +0 -0
  598. /package/{scripts → .pi/agent-fleet/scripts}/package-lock.json +0 -0
  599. /package/{scripts → .pi/agent-fleet/scripts}/package.json +0 -0
  600. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/changes.ts +0 -0
  601. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/debate.ts +0 -0
  602. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/env.ts +0 -0
  603. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/gates.ts +0 -0
  604. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/git.ts +0 -0
  605. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/merge.ts +0 -0
  606. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/model-visibility.ts +0 -0
  607. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/permissions.ts +0 -0
  608. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/poll.ts +0 -0
  609. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/quality.ts +0 -0
  610. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/run.ts +0 -0
  611. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/voices.ts +0 -0
  612. /package/{scripts → .pi/agent-fleet/scripts}/workflows/lib/writer-lease.ts +0 -0
  613. /package/{scripts → .pi/agent-fleet/scripts}/workflows/tsconfig.json +0 -0
  614. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-build-test.ts +0 -0
  615. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-debate.ts +0 -0
  616. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-document.ts +0 -0
  617. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-poll.ts +0 -0
  618. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-quality.ts +0 -0
  619. /package/{scripts → .pi/agent-fleet/scripts}/workflows/wf-scout.ts +0 -0
@@ -0,0 +1,99 @@
1
+ # Floor guard: reference implementation
2
+
3
+ Every numbered dimension in `CONSTRAINTS.md` maps to a de facto tool (Step 4). The **floor** does not: it is a diff-scoped check for the five moves in Step 6, and without a shipped reference every agent invents its own, so two runs (or a Python repo and a Go one) produce two different guards. That is the exact non-determinism this skill exists to remove.
4
+
5
+ This is the reference. Adapt the patterns to your stack; keep the contract identical.
6
+
7
+ ## Contract
8
+
9
+ - **Input:** the diff between the merge base and the working tree (added *and* removed lines, plus untracked files). A guard that reads only `git diff` misses new files and staged-but-uncommitted work.
10
+ - **Detects the five Step 6 moves:** a weakened threshold in `CONSTRAINTS.md`, a test made easier (`.skip`, a deleted test file, an assertion removed from a test that stayed), a silenced checker (a new suppression comment), unfinished work (a stub or empty `catch`), a new Exceptions row.
11
+ - **Exit codes:** `0` clean, `1` at least one floor violation (block the change), `2` the guard could not run (no merge base, not a git repo). Never let a `2` read as a `0`.
12
+ - **Reports the rule and the location, never the matched secret value.** Redaction is not optional (Step 4).
13
+ - **Tightening is silent, loosening is loud:** only surfaces moves that lower the bar.
14
+
15
+ ## Reference (Node, ~stack-agnostic patterns)
16
+
17
+ ```js
18
+ #!/usr/bin/env node
19
+ // floor-guard.mjs — diff-scoped enforcement of the CONSTRAINTS.md floor.
20
+ // Usage: node floor-guard.mjs [--base <ref>] (default base: origin/main)
21
+ import { execFileSync } from 'node:child_process';
22
+
23
+ const base = (() => {
24
+ const i = process.argv.indexOf('--base');
25
+ return i > -1 ? process.argv[i + 1] : 'origin/main';
26
+ })();
27
+
28
+ const git = (args) => {
29
+ try { return execFileSync('git', args, { encoding: 'utf8' }); }
30
+ catch { return null; }
31
+ };
32
+
33
+ // Merge base; bail to exit 2 rather than pretending a shallow/rootless clone is clean.
34
+ const mergeBase = git(['merge-base', base, 'HEAD'])?.trim();
35
+ if (!mergeBase) { console.error('floor-guard: no merge base against ' + base); process.exit(2); }
36
+
37
+ // Unified diff plus untracked files (git diff alone cannot see new files).
38
+ const tracked = git(['diff', '--unified=0', mergeBase, '--']) ?? '';
39
+ const untracked = (git(['ls-files', '--others', '--exclude-standard']) ?? '')
40
+ .split('\n').filter(Boolean)
41
+ .map((f) => git(['diff', '--no-index', '--unified=0', '/dev/null', f]) ?? '')
42
+ .join('\n');
43
+ const diff = tracked + '\n' + untracked;
44
+
45
+ const added = [], removed = [];
46
+ let file = '';
47
+ for (const line of diff.split('\n')) {
48
+ if (line.startsWith('+++ ')) file = line.slice(6);
49
+ else if (line.startsWith('+') && !line.startsWith('+++')) added.push({ file, text: line.slice(1) });
50
+ else if (line.startsWith('-') && !line.startsWith('---')) removed.push({ file, text: line.slice(1) });
51
+ }
52
+
53
+ const findings = [];
54
+ const flag = (rule, f, text) => findings.push({ rule, file: f, text: text.trim().slice(0, 120) });
55
+
56
+ // 1. Silenced checker — extend this list for your ecosystem.
57
+ const SUPPRESSIONS = /@ts-ignore|@ts-nocheck|eslint-disable|biome-ignore|# *noqa|# *type: *ignore|istanbul ignore|nosemgrep|gitleaks:allow|Stryker disable/;
58
+ // 4. Unfinished work.
59
+ const STUBS = /throw new (Error|NotImplemented).*[Nn]ot implemented|catch\s*\(\w*\)\s*\{\s*\}|catch\s*\{\s*\}|\bTODO\b|\bpass\s*# *stub/;
60
+ // 2. A test made easier (added skips).
61
+ const SKIPS = /\.(skip|todo)\b|\bxit\(|\bxdescribe\(|@pytest\.mark\.skip|t\.Skip\(/;
62
+
63
+ for (const { file, text } of added) {
64
+ if (SUPPRESSIONS.test(text)) flag('silenced-checker', file, text);
65
+ if (STUBS.test(text)) flag('unfinished-work', file, text);
66
+ if (SKIPS.test(text)) flag('test-made-easier', file, text);
67
+ if (/CONSTRAINTS\.md$/.test(file) && /^\| *(W|E)\d+ *\|/.test(text)) flag('new-exception', file, text);
68
+ }
69
+
70
+ // 2b. Assertion removed from a test file that still exists.
71
+ for (const { file, text } of removed) {
72
+ if (/\.(test|spec)\.|_test\.|test_/.test(file) && /\b(expect|assert|should)\b/.test(text)) {
73
+ flag('assertion-removed', file, text);
74
+ }
75
+ }
76
+
77
+ // 1b/2c. Weakened threshold: a number in CONSTRAINTS.md that went down, or a floor bullet deleted.
78
+ const nums = (s) => (s.match(/\d+(\.\d+)?/g) || []).map(Number);
79
+ const removedConstraints = removed.filter((l) => /CONSTRAINTS\.md$/.test(l.file));
80
+ const addedConstraints = added.filter((l) => /CONSTRAINTS\.md$/.test(l.file));
81
+ for (const r of removedConstraints) {
82
+ const a = addedConstraints.find((x) => x.text.split(/[|:]/)[0] === r.text.split(/[|:]/)[0]);
83
+ if (a && nums(a.text).some((n, i) => nums(r.text)[i] !== undefined && n < nums(r.text)[i])) {
84
+ flag('threshold-lowered', r.file, r.text + ' -> ' + a.text);
85
+ }
86
+ }
87
+
88
+ if (findings.length === 0) { console.log('floor-guard: clean'); process.exit(0); }
89
+ console.error('floor-guard: ' + findings.length + ' floor violation(s):');
90
+ for (const f of findings) console.error(` [${f.rule}] ${f.file}: ${f.text}`);
91
+ console.error('\nEach is a move that lowers the bar. Fix the code, or route it through a tracked exception.');
92
+ process.exit(1);
93
+ ```
94
+
95
+ ## Adapting it
96
+
97
+ - **Patterns are the only stack-specific part.** Add your language's suppression and stub forms to the three regexes; the diff plumbing, the CONSTRAINTS.md checks, and the exit codes stay as-is.
98
+ - **A `.constraintsignore`** (one glob per line) lets you exempt a path the guard would otherwise flag; check each added line's file against it before flagging, so a genuine exception is a tracked file rather than a loosened rule.
99
+ - **This is a starting point, not a finished tool.** It is deliberately regex-shallow: it catches the cheap-road-to-green moves agents actually make, not a determined human hiding a change. That is the right trade for a check that runs on every diff. Once you outgrow it, move to a real runner (Escalation Path level 3).
@@ -39,7 +39,7 @@ Structure context from most persistent to most transient:
39
39
 
40
40
  Create a rules file that persists across sessions. This is the highest-leverage context you can provide.
41
41
 
42
- When phrasing rules, agent prompts, or any instruction an agent will read, consult `references/prompting-patterns.md` before writing — it captures Anthropic and OpenAI guidance on positive instructions, explaining *why*, eliminating contradictions, and avoiding aggressive emphasis.
42
+ When phrasing rules, agent prompts, or any instruction an agent will read, consult `../../references/prompting-patterns.md` before writing — it captures Anthropic and OpenAI guidance on positive instructions, explaining *why*, eliminating contradictions, and avoiding aggressive emphasis.
43
43
 
44
44
  **CLAUDE.md** (for Claude Code):
45
45
  ```markdown
@@ -120,6 +120,8 @@ Long conversations accumulate stale context. Manage this:
120
120
  - **Summarize progress** when context is getting long: "So far we've completed X, Y, Z. Now working on W."
121
121
  - **Compact deliberately** — if the tool supports it, compact/summarize before critical work
122
122
 
123
+ For the proactive discipline that makes these last resorts unnecessary — what to cut first, what to protect, and when to start — see **Context Budget Management** below.
124
+
123
125
  ## Context Packing Strategies
124
126
 
125
127
  ### The Brain Dump
@@ -179,6 +181,51 @@ Key files: validation.ts, errors.ts, db.ts
179
181
 
180
182
  Load only the relevant section when working on a specific area.
181
183
 
184
+ ## Context Budget Management
185
+
186
+ The context window is not a filing cabinet — it's a working desk. As a session runs, conversation history, tool output, and exploration accumulate. Most of it becomes deadweight. Budget proactively: waiting until the window is full causes abrupt quality drops; managing regularly keeps the agent coherent through long tasks.
187
+
188
+ **Start trimming at 75% capacity, not 100%.** By the time the window is genuinely full, the model's attention is already fragmented across too many signals. The 75% threshold gives room to compress gracefully rather than cut desperately mid-task.
189
+
190
+ > In a Fleet session the `compact-and-continue` pi extension performs the mechanical half of this automatically. It does not decide *what* is worth keeping — the judgement below still belongs to the agent.
191
+
192
+ ### What to cut first
193
+
194
+ | Content | When to cut |
195
+ |---|---|
196
+ | Past failed attempts and their error output | Once you've moved past them — keep the conclusion, not the journey |
197
+ | Verbose tool output (long `find` results, full file listings) | After you've extracted what you needed |
198
+ | Conversational back-and-forth | As soon as the decision is reached |
199
+ | Earlier drafts of code that were replaced | Immediately on replacement — the current file is the record |
200
+
201
+ ### What to protect until the end
202
+
203
+ - The original task definition and key constraints
204
+ - The current error message or failing test output you are actively debugging
205
+ - The file currently being edited, or its most recent version
206
+ - Any hard constraints the agent has been asked to enforce (auth rules, naming conventions, etc.)
207
+
208
+ ### Compress before dropping
209
+
210
+ Summarizing beats deleting. Before removing a long stretch of exploration, reduce it to one sentence capturing the conclusion:
211
+
212
+ ```
213
+ Before: [8 messages debugging a failing import — various attempts, error logs, dead ends]
214
+ After: "Import issue traced to a circular dependency in src/lib/db.ts —
215
+ resolved by moving the shared type to src/types/index.ts."
216
+ ```
217
+
218
+ The detail is gone; the decision is preserved. If the detail turns out to matter, the summary is a breadcrumb for re-investigation.
219
+
220
+ ### Order for recency
221
+
222
+ Put the most task-critical content **last** in context. Models recall content at the start and end of the window more reliably than the middle (the lost-in-the-middle effect — Liu et al., 2023). Keep stable rules and specs at the start; put the active task material last, closest to the generation point:
223
+
224
+ ```
225
+ ← session start generation point →
226
+ [background: rules, specs, architecture] [working: current file, error, task]
227
+ ```
228
+
182
229
  ## MCP Integrations
183
230
 
184
231
  For richer context, use Model Context Protocol servers:
@@ -262,6 +309,7 @@ This catches wrong directions before you've built on them. It's a 30-second inve
262
309
  | Missing examples | Agent invents a new style instead of following yours | Include one example of the pattern to follow |
263
310
  | Implicit knowledge | Agent doesn't know project-specific rules | Write it down in rules files — if it's not written, it doesn't exist |
264
311
  | Silent confusion | Agent guesses when it should ask | Surface ambiguity explicitly using the confusion management patterns above |
312
+ | Context cliff | Waiting until the window is full before managing it — attention fragments and output quality drops abruptly at the limit | Start trimming at 75% capacity; compress rather than cut |
265
313
 
266
314
  ## Common Rationalizations
267
315
 
@@ -277,7 +325,7 @@ This catches wrong directions before you've built on them. It's a 30-second inve
277
325
  - Agent output doesn't match project conventions
278
326
  - Agent invents APIs or imports that don't exist
279
327
  - Agent re-implements utilities that already exist in the codebase
280
- - Agent quality degrades as the conversation gets longer
328
+ - Agent quality degrades mid-task as the conversation grows — failed attempts, replaced drafts, and verbose tool output are not being trimmed
281
329
  - No rules file exists in the project
282
330
  - External data files or config treated as trusted instructions without verification
283
331
 
@@ -289,3 +337,5 @@ After setting up context, confirm:
289
337
  - [ ] Agent output follows the patterns shown in the rules file
290
338
  - [ ] Agent references actual project files and APIs (not hallucinated ones)
291
339
  - [ ] Context is refreshed when switching between major tasks
340
+ - [ ] During long sessions, context is actively managed: failed attempts and replaced drafts removed, live error and task definition protected
341
+ - [ ] Task-critical content (current error, active constraint) is positioned last in context, not buried under background material
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: deprecation-and-migration
3
- description: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.
3
+ description: Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.
4
4
  ---
5
5
 
6
6
  # Deprecation and Migration
@@ -161,6 +161,34 @@ function getTaskService(userId: string): TaskService {
161
161
  }
162
162
  ```
163
163
 
164
+ ### Database Schema Migrations (Expand/Contract)
165
+
166
+ A schema change is the riskiest migration because the data is the one thing you cannot roll back by reverting a deploy. The failure mode is coupling the schema change to the code change: rename a column in the same release that starts using the new name, and during the rollout window — when old and new code run at once — one of them is querying a column that doesn't exist. The fix is to **never change a column in place**. Migrate in additive phases so old and new code are both valid at every step.
167
+
168
+ ```
169
+ EXPAND ──────────────→ MIGRATE ──────────────→ CONTRACT
170
+ add the new column, backfill existing rows, once no code reads the
171
+ nullable, alongside dual-write old+new from old column, drop it in
172
+ the old one the app a later, separate deploy
173
+ ```
174
+
175
+ **Worked example — renaming `name` to `full_name`:**
176
+
177
+ 1. **Expand.** Add `full_name` as nullable. Deploy. (Old code ignores it; nothing breaks.)
178
+ 2. **Dual-write.** App writes both `name` and `full_name` on every insert/update. Deploy.
179
+ 3. **Backfill.** Copy `name → full_name` for existing rows, in batches, so you don't lock the table.
180
+ 4. **Switch reads.** Point the app at `full_name`, keep writing both. Deploy and bake.
181
+ 5. **Contract.** Stop writing `name`, then — in a *separate, later* deploy — drop the column.
182
+
183
+ Each step is independently deployable and reversible: if step 4 misbehaves, roll the code back and `full_name` is still being populated. Treat each phase as a thin vertical slice — see the `incremental-implementation` skill.
184
+
185
+ **Rules:**
186
+ - **Additive first, destructive last and alone.** Adds (new nullable column, new table, new index) are safe in any deploy; drops and renames get their own deploy *after* no code references the old shape.
187
+ - **Every migration has a tested down path.** A migration you can't reverse is a deploy you can't roll back. Write and run the `down` before merging.
188
+ - **Backfill in batches, off the hot path.** A single `UPDATE` over millions of rows locks the table; chunk it and throttle.
189
+ - **Build large indexes without blocking writes** (e.g. Postgres `CREATE INDEX CONCURRENTLY`).
190
+ - **Decouple from code by feature flag** when the cutover is risky, exactly as in the Feature Flag Migration pattern above.
191
+
164
192
  ## Zombie Code
165
193
 
166
194
  Zombie code is code that nobody owns but everybody depends on. It's not actively maintained, has no clear owner, and accumulates security vulnerabilities and compatibility issues. Signs:
@@ -183,6 +211,9 @@ Zombie code is code that nobody owns but everybody depends on. It's not actively
183
211
  | "We'll deprecate it after we finish the new system" | Deprecation planning starts at design time. By the time the new system is done, you'll have new priorities. Plan now. |
184
212
  | "Users will migrate on their own" | They won't. Provide tooling, documentation, and incentives — or do the migration yourself (the Churn Rule). |
185
213
  | "We can maintain both systems indefinitely" | Two systems doing the same thing is double the maintenance, testing, documentation, and onboarding cost. |
214
+ | "Just rename the column, it's one line" | During the rollout, old and new code run together — one will query a column that no longer exists. Expand/contract, never rename in place. |
215
+ | "I'll add the column and drop the old one in the same migration" | That couples a safe add to a destructive drop. Drops get their own deploy, after no code references the old shape. |
216
+ | "We'll write the rollback if we need it" | A migration with no down path is a deploy you can't reverse. Write and run the `down` before merging. |
186
217
 
187
218
  ## Red Flags
188
219
 
@@ -193,6 +224,9 @@ Zombie code is code that nobody owns but everybody depends on. It's not actively
193
224
  - New features added to a deprecated system (invest in the replacement instead)
194
225
  - Deprecation without measuring current usage
195
226
  - Removing code without verifying zero active consumers
227
+ - A schema change and the code that depends on it shipped in the same deploy
228
+ - A column renamed or dropped in place rather than via expand/contract
229
+ - A migration merged with no tested down path, or a backfill that locks the table
196
230
 
197
231
  ## Verification
198
232
 
@@ -204,3 +238,10 @@ After completing a deprecation:
204
238
  - [ ] Old code, tests, documentation, and configuration are fully removed
205
239
  - [ ] No references to the deprecated system remain in the codebase
206
240
  - [ ] Deprecation notices are removed (they served their purpose)
241
+
242
+ After a database schema migration:
243
+
244
+ - [ ] The change ships in additive phases (expand → backfill → contract), not a single in-place edit
245
+ - [ ] Old and new code are both valid against the schema at every deploy step
246
+ - [ ] Each migration has a tested down path; backfills run in throttled batches
247
+ - [ ] Destructive steps (drop/rename) ship in their own deploy after no code references the old shape
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: designing-agents
3
- description: Designs and writes a focused artifact another agent runs — an agent persona in agents/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
3
+ description: Designs and writes a focused artifact another agent runs — an agent persona in .pi/agents/personas/, a workflow skill in skills/, or a pi session harness in .pi/harnesses/. Use when authoring a reviewer or specialist persona, a repeatable process skill, or a pi extension that reshapes a session — or when rewriting one that is under-specified, overlapping, or being ignored.
4
4
  ---
5
5
 
6
6
  # Designing Agents
@@ -9,7 +9,7 @@ description: Designs and writes a focused artifact another agent runs — an age
9
9
 
10
10
  This repo has three kinds of artifacts that shape how an agent works. Each is authored, versioned, and invoked deliberately:
11
11
 
12
- - **Agent personas** live in `agents/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
12
+ - **Agent personas** live in `.pi/agents/personas/<name>.md`. They define a *role* another agent adopts when it needs specialized review, audit, or analysis. Example: `code-reviewer`, `security-auditor`, `test-engineer`.
13
13
  - **Skills** live in `skills/<name>/SKILL.md`. They define a *workflow* — a repeatable process with gated steps, anti-rationalization guardrails, and verification. Example: `spec-driven-development`, `test-driven-development`, `context-engineering`.
14
14
  - **pi harnesses** live in `.pi/harnesses/<name>/`. They define a *session environment* — a TypeScript pi extension that reshapes the whole session: setting UI surfaces, gating tool calls, registering new tools or commands, or orchestrating sub-agents. Example: `agent-hub`, `damage-control-continue`, `coms`.
15
15
 
@@ -17,7 +17,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
17
17
 
18
18
  ## When to Use
19
19
 
20
- - Creating a new persona file in `agents/` (reviewer, auditor, domain specialist)
20
+ - Creating a new persona file in `.pi/agents/personas/` (reviewer, auditor, domain specialist)
21
21
  - Creating a new skill directory in `skills/` (a process, checklist, or workflow)
22
22
  - Creating a new pi harness in `.pi/harnesses/` (a footer, focus gate, safety check, orchestrator, or messaging layer)
23
23
  - An existing persona, skill, or harness is vague, overlaps another, or is being ignored in practice
@@ -32,7 +32,7 @@ Personas and skills are prose that change an agent's *judgment*. A harness is co
32
32
 
33
33
  ## The Workflow
34
34
 
35
- This workflow is abstracted from the three reference personas (`agents/code-reviewer.md`, `agents/security-auditor.md`, `agents/test-engineer.md`), from `docs/skill-anatomy.md`, and from the ported harnesses under `.pi/harnesses/` (catalogued in `docs/pi-extensions.md`). Do not advance to the next step until the current one is settled.
35
+ This workflow is abstracted from the three reference personas (`code-reviewer`, `security-auditor`, `test-engineer`), from `docs/skill-anatomy.md`, and from the ported harnesses under `.pi/harnesses/` (catalogued in `docs/pi-extensions.md`). Do not advance to the next step until the current one is settled.
36
36
 
37
37
  ### 1. Choose the target type
38
38
 
@@ -40,7 +40,7 @@ Ask: is this a *role* the agent should adopt, a *process* it should follow, or a
40
40
 
41
41
  | Target | Choose when | Output |
42
42
  |---|---|---|
43
- | Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) | `agents/<name>.md` |
43
+ | Persona | The agent needs to evaluate or review through a specific lens (correctness, security, test strategy, accessibility, migration safety…) | `.pi/agents/personas/<name>.md` |
44
44
  | Skill | The agent needs to follow a repeatable process with gated steps, verification, and anti-rationalization guards | `skills/<name>/SKILL.md` |
45
45
  | pi harness | The session itself must change — footer, status, a blocking gate on tool calls, a new tool or `/command`, or sub-agent orchestration | `.pi/harnesses/<name>/` (a directory) |
46
46
 
@@ -59,7 +59,7 @@ Do not proceed until the one-sentence purpose is locked. If the requester cannot
59
59
  ### 3. Scan for overlap
60
60
 
61
61
  Read every existing artifact of the target type:
62
- - For a persona: every file under `agents/`.
62
+ - For a persona: every persona file already in the workspace.
63
63
  - For a skill: every `skills/*/SKILL.md` (start with the Quick Reference table in `skills/using-agent-skills/SKILL.md`).
64
64
  - For a harness: the catalog table in `docs/pi-extensions.md`, then the `README.md` of each `.pi/harnesses/*` that looks close.
65
65
 
@@ -103,7 +103,7 @@ This step branches by target type.
103
103
 
104
104
  #### 6a. Persona body (four-block structure)
105
105
 
106
- Used by every persona in `agents/`. See the Persona Template below.
106
+ Used by every installed persona. See the Persona Template below.
107
107
 
108
108
  ```markdown
109
109
  # <Role Heading>
@@ -165,7 +165,7 @@ A harness also has wiring steps that personas and skills do not — step 9 cover
165
165
 
166
166
  ### 7. Apply prompting-patterns
167
167
 
168
- Before finalizing, read `references/prompting-patterns.md` and check the artifact against these sections. This applies to all three types — for a harness, to the prose it injects (system-prompt text, tool descriptions, block reasons), not the TypeScript itself.
168
+ Before finalizing, read `../../references/prompting-patterns.md` and check the artifact against these sections. This applies to all three types — for a harness, to the prose it injects (system-prompt text, tool descriptions, block reasons), not the TypeScript itself.
169
169
 
170
170
  - **§2.2** — Positive instructions, not prohibitions. Rewrite every "don't do X" as "do Y".
171
171
  - **§2.3** — Explain *why* for any non-obvious rule. One short clause is enough.
@@ -185,7 +185,7 @@ Cut every sentence that does not change behavior. Read each rule and ask: "If I
185
185
 
186
186
  ### 9. Write the file(s)
187
187
 
188
- - Persona → `agents/<name>.md`.
188
+ - Persona → `.pi/agents/personas/<name>.md`.
189
189
  - Skill → `skills/<name>/SKILL.md` (create the directory; supporting files only if the skill exceeds ~300 lines or needs separate reference material).
190
190
  - Harness → `.pi/harnesses/<name>/` with `index.ts`, `package.json`, and `README.md`. Then add a `just ext-<name>` recipe to the `justfile` under the matching category header, add a catalog row to `docs/pi-extensions.md`, and add any new runtime dependency to `.pi/harnesses/package.json`. Never place a harness under `.pi/extensions/` — pi auto-discovers that directory and would load every harness at once.
191
191
 
@@ -321,7 +321,7 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
321
321
  | "I'll skip the harness README and catalog row — `index.ts` is the real artifact" | A harness with no row in `docs/pi-extensions.md` is undiscoverable; no agent will load it. The README is its discovery surface — the same role frontmatter plays for a skill. |
322
322
  | "I'll copy an existing artifact and tweak it" | For prose artifacts, copy-paste creates silent duplication and drift — read the existing files to learn the pattern, then write fresh. For a harness, copying the nearest `index.ts` *is* the recommended start; just rename it cleanly and cut what you don't use. |
323
323
  | "I don't need to read prompting-patterns, I know how to write prompts" | Every author thinks this. The reference exists because recurring, measurable mistakes happen anyway. Spend 3 minutes skimming §2 and §6. |
324
- | "I'll add every tool and capability — flexibility is good" | This repo's `agents/*.md` don't declare tools at all; scope creep happens through the prompt body. Skills and harnesses that try to cover many domains lose their force. Bloated artifacts get skimmed. |
324
+ | "I'll add every tool and capability — flexibility is good" | Agent Fleet's own personas don't declare tools at all; scope creep happens through the prompt body. Skills and harnesses that try to cover many domains lose their force. Bloated artifacts get skimmed. |
325
325
  | "The purpose is hard to state in one sentence because it covers a lot" | If you cannot state it in one sentence, the artifact covers too much. Split it or scope it down. |
326
326
  | "I'll leave the rules/steps section light so the artifact can be flexible" | Empty Rules or vague steps become empty behavior. The specifics are what differentiate this artifact from a general agent. |
327
327
  | "My skill is mostly reference material — I'll inline a 200-line checklist" | Reference material belongs in `references/`. Skills are workflows, not reference docs. Move the long content out and cite it. |
@@ -360,13 +360,13 @@ A harness is a directory, not a single file. The `ExtensionAPI` surface, the `in
360
360
 
361
361
  - [ ] Name is kebab-case and matches the file/directory, the `name` field (frontmatter or `package.json`), and the H1 title.
362
362
  - [ ] The discovery surface (description, or README + catalog row) is action-oriented and ends with a concrete trigger.
363
- - [ ] Cross-checked against `references/prompting-patterns.md` §2.2, §2.3, §2.4, §2.5, §3.1, §6.4 — no prohibitions, no contradictions, no ALL-CAPS, role/overview is specific.
363
+ - [ ] Cross-checked against `../../references/prompting-patterns.md` §2.2, §2.3, §2.4, §2.5, §3.1, §6.4 — no prohibitions, no contradictions, no ALL-CAPS, role/overview is specific.
364
364
  - [ ] Scanned against existing files of the same type — no >30% overlap.
365
365
  - [ ] Every sentence, if removed, would visibly change the artifact's behavior.
366
366
 
367
367
  ### Persona-specific checklist
368
368
 
369
- - [ ] File exists at `agents/<name>.md`.
369
+ - [ ] File exists at `.pi/agents/personas/<name>.md`.
370
370
  - [ ] Body has: Role opening paragraph, Framework/Approach, Output Format, Rules.
371
371
  - [ ] Output Format contains a concrete markdown template, not a description of one.
372
372
  - [ ] If the persona classifies findings (Critical / High / etc.), the severity table is present with explicit criteria and required action.
@@ -11,7 +11,7 @@ Draft code-owned workflows by copying a proven flow shape, then edit only the de
11
11
 
12
12
  ## When to Use
13
13
 
14
- - Creating a new `scripts/workflows/wf-*.ts` flow.
14
+ - Creating a new `.pi/agent-fleet/scripts/workflows/wf-*.ts` flow.
15
15
  - Changing a flow's phase order, gates, retries, or acceptance rule.
16
16
  - Translating an operator request into a prompt for an agent phase.
17
17
 
@@ -21,7 +21,7 @@ Do not use this skill to improvise an interactive hub dispatch. `just fleet` rem
21
21
 
22
22
  ### 1. Map, list, and stop
23
23
 
24
- Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
24
+ Read the managed workflow map in `.pi/agent-fleet/docs/workflows.md`, then list every available `.pi/agent-fleet/scripts/workflows/wf-*.ts` with exactly one line containing its name and `Phases:` shape. **Stop and wait for the operator to select or describe the desired flow.**
25
25
 
26
26
  At this point:
27
27
 
@@ -79,7 +79,7 @@ The draft marks only three classes of decisions:
79
79
 
80
80
  Edit the copied phase bodies so the declared shape is real. Remove each TODO only after making that decision. Do not add TODOs for imports, envelope wiring, trace calls, dry-run stubs, or other boilerplate.
81
81
 
82
- For the complete contracts, read `references/workflow-authoring.md`.
82
+ For the complete contracts, read `../../references/workflow-authoring.md`.
83
83
 
84
84
  ### 6. Keep the envelope triad synchronized
85
85
 
@@ -96,9 +96,9 @@ Use existing return-contract vocabulary. A parsed envelope with `status: "fail"`
96
96
  The generator refuses handoff unless both gates pass:
97
97
 
98
98
  ```bash
99
- npx tsc -p scripts/workflows/tsconfig.json --noEmit
99
+ npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit
100
100
  node --experimental-strip-types skills/drafting-workflows/scripts/make-workflow.ts \
101
- --verify-draft scripts/workflows/wf-<name>.ts
101
+ --verify-draft .pi/agent-fleet/scripts/workflows/wf-<name>.ts
102
102
  ```
103
103
 
104
104
  The second command resolves the exact `wf-<name>.ts` entry export used by the flow registry, then executes it with stubbed agent phases and `dryRun: true`; it makes no model call. If either gate fails, the generator deletes the draft and reports the exact failure. Repair the source decision or rerun the generator—never bypass either gate. A handed-off draft is immediately reachable as `just flow <name>`; no central registry edit is required.
@@ -138,6 +138,6 @@ Before presenting a workflow draft, confirm:
138
138
  - [ ] Every agent phase has an explicit persona or call-site writes policy; omission is a startup error, never unrestricted by accident.
139
139
  - [ ] Writes policy and protected paths are enforced around agent phases.
140
140
  - [ ] The generated export is uniquely named for the file and resolves through `just flow <name>`.
141
- - [ ] `npx tsc -p scripts/workflows/tsconfig.json --noEmit` passes.
141
+ - [ ] `npx tsc -p .pi/agent-fleet/scripts/workflows/tsconfig.json --noEmit` passes.
142
142
  - [ ] The generated workflow's stubbed dry run is accepted with zero model calls.
143
143
  - [ ] The exact commands and outcomes are included in the handoff.
@@ -73,7 +73,7 @@ function editDistance(left: PhaseKind[], right: PhaseKind[]): number {
73
73
  }
74
74
 
75
75
  export function selectNearestWorkflow(shapes: WorkflowShape[], requestedPhases: string[]): WorkflowShape {
76
- if (!shapes.length) throw new Error("No scripts/workflows/wf-*.ts sources were found.");
76
+ if (!shapes.length) throw new Error("No .pi/agent-fleet/scripts/workflows/wf-*.ts sources were found.");
77
77
  const requestedKinds = requestedPhases.map(phaseKind);
78
78
  return [...shapes].sort((left, right) => {
79
79
  const leftScore = editDistance(left.kinds, requestedKinds) * 100 + Math.abs(left.kinds.length - requestedKinds.length) * 10;
@@ -118,7 +118,7 @@ export function makeWorkflow(options: {
118
118
  }): { outputPath: string; sourcePath: string; phases: string[] } {
119
119
  if (!SAFE_NAME.test(options.name)) throw new Error(`Invalid workflow name: ${options.name}`);
120
120
  if (RESERVED_FLOW_NAMES.has(options.name)) throw new Error(`Workflow name is reserved for maintenance: ${options.name}`);
121
- const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, "scripts/workflows"));
121
+ const workflowsDir = resolve(options.workflowsDir ?? resolve(options.cwd, ".pi/agent-fleet/scripts/workflows"));
122
122
  const outputPath = resolve(workflowsDir, `wf-${options.name}.ts`);
123
123
  if (existsSync(outputPath)) throw new Error(`Refusing to overwrite existing workflow: ${outputPath}`);
124
124
  const nearest = selectNearestWorkflow(readWorkflowShapes(workflowsDir), options.phases);
@@ -141,7 +141,7 @@ export function makeWorkflow(options: {
141
141
  export async function verifyDraft(path: string, cwd = process.cwd()): Promise<void> {
142
142
  const resolvedPath = resolve(path);
143
143
  const workflowName = basename(resolvedPath).replace(/^wf-/, "").replace(/\.ts$/, "");
144
- const flowModulePath = resolve(cwd, "scripts/flow.ts");
144
+ const flowModulePath = resolve(cwd, ".pi/agent-fleet/scripts/flow.ts");
145
145
  const { resolveWorkflow } = await import(`${pathToFileURL(flowModulePath).href}?verify=${Date.now()}`) as {
146
146
  resolveWorkflow(name: string, workflowsDir?: string): Promise<{ run: (run: unknown, input: { args: string[]; dryRun: boolean; cwd: string }) => Promise<{ accepted: boolean }> } | undefined>;
147
147
  };
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: frontend-ui-engineering
3
- description: Builds production-quality UIs. Use when building or modifying user-facing interfaces. Use when creating components, implementing layouts, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
3
+ description: Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.
4
4
  ---
5
5
 
6
6
  # Frontend UI Engineering
@@ -294,7 +294,7 @@ function useToggleTask() {
294
294
 
295
295
  ## See Also
296
296
 
297
- For detailed accessibility requirements and testing tools, see `references/accessibility-checklist.md`.
297
+ For detailed accessibility requirements and testing tools, see `../../references/accessibility-checklist.md`.
298
298
 
299
299
  ## Common Rationalizations
300
300
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: git-workflow-and-versioning
3
- description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.
3
+ description: Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams.
4
4
  ---
5
5
 
6
6
  # Git Workflow and Versioning
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: incremental-implementation
3
- description: Delivers changes incrementally and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
3
+ description: Delivers changes incrementally in thin, verifiable slices and grills unspecified forks instead of silently picking among them. Use when implementing any feature or change that touches more than one file, or when picking up the next task from a plan. Use when rolling a change out behind a feature flag, when you're about to write a large amount of code at once, or when a task feels too big to land in one step.
4
4
  ---
5
5
 
6
6
  # Incremental Implementation
@@ -226,8 +226,8 @@ When directing an agent to implement incrementally:
226
226
  Start with just the database schema change and the API endpoint.
227
227
  Don't touch the UI yet — we'll do that in the next increment.
228
228
 
229
- After implementing, run `npm test` and `npm run build` to verify
230
- nothing is broken, then present the Standard Slice Summary and
229
+ After implementing, run the repository's test and build commands to
230
+ verify nothing is broken, then present the Standard Slice Summary and
231
231
  wait for my approval before the next slice. Do not stage or
232
232
  commit — I'll handle git manually after reviewing."
233
233
  ```
@@ -236,13 +236,17 @@ Be explicit about what's in scope and what's NOT in scope for each increment.
236
236
 
237
237
  ## Increment Checklist
238
238
 
239
- After each increment, verify:
239
+ After each increment, verify with the repository's own commands. **Where the project
240
+ defines `quality:` under `## workflows` in `.ai/agent-fleet-overrides.md`, that command
241
+ *is* the verification — run it rather than guessing.** Only outside a configured project
242
+ should you discover the stack yourself (see the `test-driven-development` skill's
243
+ *Discover the Stack First* section). Never fall back to an assumed `npm test`.
240
244
 
241
245
  - [ ] The change does one thing and does it completely
242
- - [ ] All existing tests still pass (`npm test`)
243
- - [ ] The build succeeds (`npm run build`)
244
- - [ ] Type checking passes (`npx tsc --noEmit`)
245
- - [ ] Linting passes (`npm run lint`)
246
+ - [ ] All existing tests still pass (the project's `quality:` command, or the repository's test command: `npm test`, `./gradlew test`, `pytest`, ...)
247
+ - [ ] The build succeeds (the repository's build command)
248
+ - [ ] Type checking passes, where the stack has one (`npx tsc --noEmit`, `mypy`, ...)
249
+ - [ ] Linting passes (the repository's lint command)
246
250
  - [ ] The new functionality works as expected
247
251
  - [ ] Unspecified load-bearing forks were grilled (or grilling found none); already-stated requirements were not re-asked
248
252
  - [ ] The Standard Slice Summary was presented to the user
@@ -295,4 +299,4 @@ After completing all increments for a task:
295
299
 
296
300
  ## See Also
297
301
 
298
- Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See `references/definition-of-done.md`.
302
+ Per-increment verification is the local check. Before declaring a task done, apply the project-wide Definition of Done as the final gate, the standing bar every increment clears regardless of the task. See `../../references/definition-of-done.md`.
@@ -30,14 +30,14 @@ yourself** — pane lifecycle (herdr) belongs to the orchestrator and the human.
30
30
  **Discover** who is alive (name, model, purpose):
31
31
 
32
32
  ```bash
33
- node --experimental-strip-types scripts/coms-cli.ts list
33
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts list
34
34
  ```
35
35
 
36
36
  **Ask and wait** (blocking round trip — usually what you want; generous timeout, peers
37
37
  run real turns):
38
38
 
39
39
  ```bash
40
- node --experimental-strip-types scripts/coms-cli.ts send researcher \
40
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send researcher \
41
41
  "Where is the retry logic for outbound webhooks? file:line please" \
42
42
  --await --timeout 300000
43
43
  ```
@@ -45,9 +45,9 @@ node --experimental-strip-types scripts/coms-cli.ts send researcher \
45
45
  **Fire-and-collect** (returns a `msg_id` immediately; a detached waiter holds the reply):
46
46
 
47
47
  ```bash
48
- node --experimental-strip-types scripts/coms-cli.ts send documenter "Draft a README section on X"
48
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts send documenter "Draft a README section on X"
49
49
  # … keep working …
50
- node --experimental-strip-types scripts/coms-cli.ts await <msg_id> --timeout 300000
50
+ node --experimental-strip-types .pi/agent-fleet/scripts/coms-cli.ts await <msg_id> --timeout 300000
51
51
  ```
52
52
 
53
53
  **Answer inbound prompts** by simply replying in the conversation — your final message