@chankov/agent-fleet 2.0.8 → 2.0.9

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 (453) hide show
  1. package/.pi/harnesses/agent-hub/README.md +20 -6
  2. package/.pi/harnesses/agent-hub/footer.ts +1 -1
  3. package/.pi/harnesses/agent-hub/index.ts +47 -66
  4. package/.pi/harnesses/agent-hub/input/shortcuts.ts +2 -0
  5. package/.pi/harnesses/agent-hub/package.json +1 -1
  6. package/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  7. package/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +16 -42
  8. package/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  9. package/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  10. package/.pi/harnesses/agent-hub/ui/grid.ts +145 -33
  11. package/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -139
  12. package/.pi/harnesses/coms/package.json +1 -1
  13. package/.pi/harnesses/damage-control-continue/package.json +1 -1
  14. package/.pi/harnesses/lib/fleet-dashboard-ops.ts +17 -0
  15. package/.pi/harnesses/lib/fleet-dashboard-view.ts +22 -36
  16. package/.pi/harnesses/lib/fleet-read-model.ts +109 -27
  17. package/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  18. package/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  19. package/.versions/2.0.9/.pi/agent-fleet/hermes/README.md +347 -0
  20. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/plugin.js +1291 -0
  21. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-herdr/presentation.js +672 -0
  22. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/plugin.js +19 -0
  23. package/.versions/2.0.9/.pi/agent-fleet/hermes/desktop-plugins/agent-fleet-monitor/state.js +10 -0
  24. package/.versions/2.0.9/.pi/agent-fleet/hermes/gates/gate-o-capability.md +8 -0
  25. package/.versions/2.0.9/.pi/agent-fleet/hermes/gates/gate-o-validator-fixtures.json +1 -0
  26. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/activity.py +773 -0
  27. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_registry.py +134 -0
  28. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/coms_send.py +350 -0
  29. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/herdr_source.py +193 -0
  30. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/manifest.json +4 -0
  31. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/plugin_api.py +444 -0
  32. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/sessions.py +205 -0
  33. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/tasks.py +300 -0
  34. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/dashboard/watch.py +819 -0
  35. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-herdr/plugin.yaml +8 -0
  36. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/adapter.py +139 -0
  37. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/manifest.json +11 -0
  38. package/.versions/2.0.9/.pi/agent-fleet/hermes/plugins/agent-fleet-monitor/dashboard/plugin_api.py +50 -0
  39. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-conductor/SKILL.md +84 -0
  40. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-liaison/SKILL.md +84 -0
  41. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/SKILL.md +76 -0
  42. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/manifest.json +1 -0
  43. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog.py +249 -0
  44. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_actions.py +124 -0
  45. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_contract.py +76 -0
  46. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_delivery.py +10 -0
  47. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_engine.py +128 -0
  48. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_judgment.py +41 -0
  49. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_recovery.py +103 -0
  50. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_state.py +163 -0
  51. package/.versions/2.0.9/.pi/agent-fleet/hermes/skills/hub-watchdog/scripts/watchdog_transport.py +138 -0
  52. package/.versions/2.0.9/.pi/agent-fleet/hermes/watchdog-tests/__init__.py +0 -0
  53. package/.versions/2.0.9/.pi/agent-fleet/hooks/coms-stop-hook.mjs +84 -0
  54. package/.versions/2.0.9/.pi/agent-fleet/scripts/claude-code-preflight.ts +70 -0
  55. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-claude-bridge.ts +411 -0
  56. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-cli.ts +425 -0
  57. package/.versions/2.0.9/.pi/agent-fleet/scripts/coms-hermes-bridge.ts +413 -0
  58. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet-codex-client.ts +69 -0
  59. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet-codex-read.py +148 -0
  60. package/.versions/2.0.9/.pi/agent-fleet/scripts/fleet.ts +216 -0
  61. package/.versions/2.0.9/.pi/agent-fleet/scripts/flow.ts +137 -0
  62. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-monitor-capability-runner.ts +25 -0
  63. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-monitor-scenario.ts +474 -0
  64. package/.versions/2.0.9/.pi/agent-fleet/scripts/hermes-watchdog-capability-probe.ts +45 -0
  65. package/.versions/2.0.9/.pi/agent-fleet/scripts/install-hermes-plugin.sh +180 -0
  66. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/claude-bridge-core.ts +210 -0
  67. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/coms-envelope.ts +582 -0
  68. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fake-herdr-server.ts +88 -0
  69. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-catalog.ts +63 -0
  70. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-operations.ts +190 -0
  71. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-session.ts +166 -0
  72. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-codex-transport.ts +124 -0
  73. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/fleet-command.ts +252 -0
  74. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/flow-command.ts +93 -0
  75. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/flow-maintenance.ts +230 -0
  76. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/herdr-layout.ts +281 -0
  77. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-bridge-core.ts +241 -0
  78. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-events.ts +1 -0
  79. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-herdr.ts +2 -0
  80. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-model.ts +3 -0
  81. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-registry.ts +2 -0
  82. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-socket.ts +2 -0
  83. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/hermes-monitor-store.ts +2 -0
  84. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/monitor-env.ts +146 -0
  85. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/peer-launch.ts +318 -0
  86. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/persona-banner.ts +62 -0
  87. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/persona-dirs.ts +25 -0
  88. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/runtime-dependencies.js +124 -0
  89. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/spawn-stagger.ts +101 -0
  90. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/team-project.ts +178 -0
  91. package/.versions/2.0.9/.pi/agent-fleet/scripts/lib/team-snapshot.ts +147 -0
  92. package/.versions/2.0.9/.pi/agent-fleet/scripts/package-lock.json +35 -0
  93. package/.versions/2.0.9/.pi/agent-fleet/scripts/package.json +9 -0
  94. package/.versions/2.0.9/.pi/agent-fleet/scripts/peer-banner.ts +41 -0
  95. package/.versions/2.0.9/.pi/agent-fleet/scripts/peer-launch.ts +283 -0
  96. package/.versions/2.0.9/.pi/agent-fleet/scripts/team-snapshot.ts +237 -0
  97. package/.versions/2.0.9/.pi/agent-fleet/scripts/team-up.ts +378 -0
  98. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/agent-phase.ts +133 -0
  99. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/changes.ts +61 -0
  100. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/debate.ts +149 -0
  101. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/env.ts +34 -0
  102. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/envelopes.ts +169 -0
  103. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/gates.ts +81 -0
  104. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/git.ts +96 -0
  105. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/merge.ts +95 -0
  106. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/model-profile.ts +22 -0
  107. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/model-visibility.ts +92 -0
  108. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/permissions.ts +130 -0
  109. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/personas.ts +57 -0
  110. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/poll.ts +86 -0
  111. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/quality.ts +64 -0
  112. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/run.ts +108 -0
  113. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/trace.ts +34 -0
  114. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/voices.ts +128 -0
  115. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/lib/writer-lease.ts +112 -0
  116. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/tsconfig.json +22 -0
  117. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-build-test.ts +61 -0
  118. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-debate.ts +87 -0
  119. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-document.ts +50 -0
  120. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-poll.ts +95 -0
  121. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-quality.ts +20 -0
  122. package/.versions/2.0.9/.pi/agent-fleet/scripts/workflows/wf-scout.ts +38 -0
  123. package/.versions/2.0.9/.pi/agents/dispatch-policy.yaml +32 -0
  124. package/.versions/2.0.9/.pi/agents/model-profiles.yaml +83 -0
  125. package/.versions/2.0.9/.pi/agents/peers.yaml +147 -0
  126. package/.versions/2.0.9/.pi/agents/teams.yaml +41 -0
  127. package/.versions/2.0.9/.pi/agents/voices.yaml +13 -0
  128. package/.versions/2.0.9/.pi/damage-control-rules.yaml +297 -0
  129. package/.versions/2.0.9/.pi/extensions/btw/README.md +120 -0
  130. package/.versions/2.0.9/.pi/extensions/btw/index.ts +914 -0
  131. package/.versions/2.0.9/.pi/extensions/btw/package.json +6 -0
  132. package/.versions/2.0.9/.pi/extensions/btw/state.js +179 -0
  133. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/README.md +55 -0
  134. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/index.ts +93 -0
  135. package/.versions/2.0.9/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  136. package/.versions/2.0.9/.pi/extensions/compact-and-continue/README.md +42 -0
  137. package/.versions/2.0.9/.pi/extensions/compact-and-continue/index.ts +120 -0
  138. package/.versions/2.0.9/.pi/extensions/compact-and-continue/package.json +6 -0
  139. package/.versions/2.0.9/.pi/extensions/mcp-bridge/README.md +46 -0
  140. package/.versions/2.0.9/.pi/extensions/mcp-bridge/index.ts +206 -0
  141. package/.versions/2.0.9/.pi/extensions/mcp-bridge/package.json +6 -0
  142. package/.versions/2.0.9/.pi/extensions/package-lock.json +1175 -0
  143. package/.versions/2.0.9/.pi/extensions/package.json +9 -0
  144. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/README.md +205 -0
  145. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/config.ts +198 -0
  146. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  147. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/index.ts +248 -0
  148. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/package.json +6 -0
  149. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  150. package/.versions/2.0.9/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  151. package/.versions/2.0.9/.pi/harnesses/agent-hub/README.md +1217 -0
  152. package/.versions/2.0.9/.pi/harnesses/agent-hub/acceptance.ts +62 -0
  153. package/.versions/2.0.9/.pi/harnesses/agent-hub/access-approval.ts +135 -0
  154. package/.versions/2.0.9/.pi/harnesses/agent-hub/artifacts.js +146 -0
  155. package/.versions/2.0.9/.pi/harnesses/agent-hub/assertion-ledger.js +58 -0
  156. package/.versions/2.0.9/.pi/harnesses/agent-hub/backend-policy.js +174 -0
  157. package/.versions/2.0.9/.pi/harnesses/agent-hub/budget-continuation.ts +13 -0
  158. package/.versions/2.0.9/.pi/harnesses/agent-hub/budget-recovery.ts +97 -0
  159. package/.versions/2.0.9/.pi/harnesses/agent-hub/capability-confirmation.ts +47 -0
  160. package/.versions/2.0.9/.pi/harnesses/agent-hub/capability-packs.ts +180 -0
  161. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-model-thinking.ts +10 -0
  162. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-model.ts +10 -0
  163. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agent-models-substitute.ts +10 -0
  164. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-add.ts +9 -0
  165. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-drop.ts +9 -0
  166. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-history.ts +9 -0
  167. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-kill.ts +10 -0
  168. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-list.ts +9 -0
  169. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-restart.ts +10 -0
  170. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-save.ts +9 -0
  171. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/agents-team.ts +9 -0
  172. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/budget-continue.ts +10 -0
  173. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/compound.ts +9 -0
  174. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/coms.ts +9 -0
  175. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/context-command.ts +9 -0
  176. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/context.ts +43 -0
  177. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/debate.ts +9 -0
  178. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/dispatch-policy.ts +9 -0
  179. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/handoff.ts +10 -0
  180. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/hub-report.ts +9 -0
  181. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/models.ts +10 -0
  182. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/poll.ts +9 -0
  183. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/retry.ts +10 -0
  184. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/watchdog.ts +9 -0
  185. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/work-mode.ts +29 -0
  186. package/.versions/2.0.9/.pi/harnesses/agent-hub/commands/zoom.ts +10 -0
  187. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/agents.ts +177 -0
  188. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/model-profiles.ts +216 -0
  189. package/.versions/2.0.9/.pi/harnesses/agent-hub/config/overrides.ts +153 -0
  190. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/agent-state.ts +30 -0
  191. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/assertions-artifacts.ts +213 -0
  192. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/budgets.ts +202 -0
  193. package/.versions/2.0.9/.pi/harnesses/agent-hub/context/hub-state.ts +40 -0
  194. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-budget-snapshot.ts +105 -0
  195. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-pressure.ts +191 -0
  196. package/.versions/2.0.9/.pi/harnesses/agent-hub/context-window.js +106 -0
  197. package/.versions/2.0.9/.pi/harnesses/agent-hub/debate-command.ts +176 -0
  198. package/.versions/2.0.9/.pi/harnesses/agent-hub/delegate.ts +446 -0
  199. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-coms.ts +237 -0
  200. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-core.ts +27 -0
  201. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-complete.ts +154 -0
  202. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-prepare.ts +156 -0
  203. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-spawn.ts +193 -0
  204. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native-types.ts +230 -0
  205. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-native.ts +213 -0
  206. package/.versions/2.0.9/.pi/harnesses/agent-hub/dispatch-observability.ts +225 -0
  207. package/.versions/2.0.9/.pi/harnesses/agent-hub/docs-lane.js +122 -0
  208. package/.versions/2.0.9/.pi/harnesses/agent-hub/drift-watchdog.js +218 -0
  209. package/.versions/2.0.9/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  210. package/.versions/2.0.9/.pi/harnesses/agent-hub/execution-evidence.ts +80 -0
  211. package/.versions/2.0.9/.pi/harnesses/agent-hub/external-blocker.js +85 -0
  212. package/.versions/2.0.9/.pi/harnesses/agent-hub/fixtures/registration-surface.json +57 -0
  213. package/.versions/2.0.9/.pi/harnesses/agent-hub/footer.ts +30 -0
  214. package/.versions/2.0.9/.pi/harnesses/agent-hub/helpers.ts +266 -0
  215. package/.versions/2.0.9/.pi/harnesses/agent-hub/hub-state-audit.js +64 -0
  216. package/.versions/2.0.9/.pi/harnesses/agent-hub/index.ts +2132 -0
  217. package/.versions/2.0.9/.pi/harnesses/agent-hub/input/completions.ts +76 -0
  218. package/.versions/2.0.9/.pi/harnesses/agent-hub/input/shortcuts.ts +20 -0
  219. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/context-pressure.ts +123 -0
  220. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/monitor-session.ts +104 -0
  221. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/session-orchestration.ts +143 -0
  222. package/.versions/2.0.9/.pi/harnesses/agent-hub/lifecycle/turn-handlers.ts +74 -0
  223. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-control.ts +9 -0
  224. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-invoke-journal.ts +131 -0
  225. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-invoke.ts +92 -0
  226. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-lifecycle.ts +13 -0
  227. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-publisher.ts +59 -0
  228. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-recovery.ts +3 -0
  229. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-runtime.ts +3 -0
  230. package/.versions/2.0.9/.pi/harnesses/agent-hub/monitor-session-bridge.ts +266 -0
  231. package/.versions/2.0.9/.pi/harnesses/agent-hub/no-progress.ts +76 -0
  232. package/.versions/2.0.9/.pi/harnesses/agent-hub/package.json +7 -0
  233. package/.versions/2.0.9/.pi/harnesses/agent-hub/peer-spawn-plan.ts +116 -0
  234. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/models.ts +153 -0
  235. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/profile-activation.ts +62 -0
  236. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/profile-runtime.ts +120 -0
  237. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/roster.ts +94 -0
  238. package/.versions/2.0.9/.pi/harnesses/agent-hub/policy/work-mode.ts +119 -0
  239. package/.versions/2.0.9/.pi/harnesses/agent-hub/poll-command.ts +176 -0
  240. package/.versions/2.0.9/.pi/harnesses/agent-hub/presentation.ts +48 -0
  241. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/context.ts +47 -0
  242. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/fragments.ts +115 -0
  243. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/session-start.ts +90 -0
  244. package/.versions/2.0.9/.pi/harnesses/agent-hub/prompts/system-prompt.ts +112 -0
  245. package/.versions/2.0.9/.pi/harnesses/agent-hub/provider-semaphore.js +138 -0
  246. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/controls.ts +74 -0
  247. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/runtime.ts +192 -0
  248. package/.versions/2.0.9/.pi/harnesses/agent-hub/research/spawn-run.ts +156 -0
  249. package/.versions/2.0.9/.pi/harnesses/agent-hub/research-watchdog.ts +40 -0
  250. package/.versions/2.0.9/.pi/harnesses/agent-hub/return-contract.js +293 -0
  251. package/.versions/2.0.9/.pi/harnesses/agent-hub/return-extract.js +75 -0
  252. package/.versions/2.0.9/.pi/harnesses/agent-hub/review-findings.js +102 -0
  253. package/.versions/2.0.9/.pi/harnesses/agent-hub/run-budget.js +537 -0
  254. package/.versions/2.0.9/.pi/harnesses/agent-hub/run-namespace.js +87 -0
  255. package/.versions/2.0.9/.pi/harnesses/agent-hub/safety-routing.ts +22 -0
  256. package/.versions/2.0.9/.pi/harnesses/agent-hub/scope-gate.js +123 -0
  257. package/.versions/2.0.9/.pi/harnesses/agent-hub/session-health.js +110 -0
  258. package/.versions/2.0.9/.pi/harnesses/agent-hub/session-start.ts +42 -0
  259. package/.versions/2.0.9/.pi/harnesses/agent-hub/spawn.ts +404 -0
  260. package/.versions/2.0.9/.pi/harnesses/agent-hub/timeline.ts +54 -0
  261. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/action-executors.ts +149 -0
  262. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/coms-tools.ts +139 -0
  263. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/context.ts +134 -0
  264. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/dispatch-agent.ts +82 -0
  265. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/dispatch-execution.ts +273 -0
  266. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/execution-orchestration.ts +22 -0
  267. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/fleet-tools.ts +200 -0
  268. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/herdr-executors.ts +86 -0
  269. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/set-task-tier.ts +29 -0
  270. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/spawn-research.ts +62 -0
  271. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/team-adjust.ts +29 -0
  272. package/.versions/2.0.9/.pi/harnesses/agent-hub/tools/verification-contract.ts +77 -0
  273. package/.versions/2.0.9/.pi/harnesses/agent-hub/types.ts +63 -0
  274. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/activity-dots.ts +16 -0
  275. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/context-budget.ts +86 -0
  276. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/detail-panel.ts +178 -0
  277. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-actions.ts +76 -0
  278. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-dashboard.ts +99 -0
  279. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-editor.ts +44 -0
  280. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/fleet-source.ts +157 -0
  281. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/grid.ts +154 -0
  282. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/history-store.ts +137 -0
  283. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/history.ts +234 -0
  284. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/pool.ts +103 -0
  285. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/running-strip.ts +2 -0
  286. package/.versions/2.0.9/.pi/harnesses/agent-hub/ui/zoom.ts +204 -0
  287. package/.versions/2.0.9/.pi/harnesses/agent-hub/version.ts +42 -0
  288. package/.versions/2.0.9/.pi/harnesses/agent-hub/work-mode-controls.ts +56 -0
  289. package/.versions/2.0.9/.pi/harnesses/agent-hub/work-mode.ts +167 -0
  290. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/README.md +59 -0
  291. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/index.ts +558 -0
  292. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/questions.ts +161 -0
  293. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/race-core.js +124 -0
  294. package/.versions/2.0.9/.pi/harnesses/ask-user-remote/runtime-ask.ts +43 -0
  295. package/.versions/2.0.9/.pi/harnesses/coms/README.md +100 -0
  296. package/.versions/2.0.9/.pi/harnesses/coms/index.ts +282 -0
  297. package/.versions/2.0.9/.pi/harnesses/coms/package.json +7 -0
  298. package/.versions/2.0.9/.pi/harnesses/coms/version.ts +42 -0
  299. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/README.md +135 -0
  300. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/index.ts +541 -0
  301. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/package.json +7 -0
  302. package/.versions/2.0.9/.pi/harnesses/damage-control-continue/version.ts +42 -0
  303. package/.versions/2.0.9/.pi/harnesses/lib/coms-core-io.ts +385 -0
  304. package/.versions/2.0.9/.pi/harnesses/lib/coms-core.ts +577 -0
  305. package/.versions/2.0.9/.pi/harnesses/lib/coms-registry-entry.ts +94 -0
  306. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-child-prompt.ts +180 -0
  307. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-hub-prompt.ts +114 -0
  308. package/.versions/2.0.9/.pi/harnesses/lib/context-budget-view.ts +107 -0
  309. package/.versions/2.0.9/.pi/harnesses/lib/context-budget.ts +114 -0
  310. package/.versions/2.0.9/.pi/harnesses/lib/damage-control-shared.ts +197 -0
  311. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/context-budget-profiles.json +11 -0
  312. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/hub-prompt-operator.legacy.txt +73 -0
  313. package/.versions/2.0.9/.pi/harnesses/lib/fixtures/hub-prompt-orchestrator.legacy.txt +73 -0
  314. package/.versions/2.0.9/.pi/harnesses/lib/fleet-dashboard-ops.ts +178 -0
  315. package/.versions/2.0.9/.pi/harnesses/lib/fleet-dashboard-view.ts +134 -0
  316. package/.versions/2.0.9/.pi/harnesses/lib/fleet-detail-view.ts +247 -0
  317. package/.versions/2.0.9/.pi/harnesses/lib/fleet-overlay.ts +26 -0
  318. package/.versions/2.0.9/.pi/harnesses/lib/fleet-panel.ts +34 -0
  319. package/.versions/2.0.9/.pi/harnesses/lib/fleet-read-model.ts +213 -0
  320. package/.versions/2.0.9/.pi/harnesses/lib/fleet-selection.ts +24 -0
  321. package/.versions/2.0.9/.pi/harnesses/lib/fleet-strip-controller.ts +74 -0
  322. package/.versions/2.0.9/.pi/harnesses/lib/fleet-strip-view.ts +132 -0
  323. package/.versions/2.0.9/.pi/harnesses/lib/fleet-transcript-store.ts +244 -0
  324. package/.versions/2.0.9/.pi/harnesses/lib/herdr-client.ts +472 -0
  325. package/.versions/2.0.9/.pi/harnesses/lib/herdr-presence.ts +399 -0
  326. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-events.ts +136 -0
  327. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-herdr.ts +28 -0
  328. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-model.ts +18 -0
  329. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-registry.ts +6 -0
  330. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-socket.ts +163 -0
  331. package/.versions/2.0.9/.pi/harnesses/lib/hermes-monitor-store.ts +31 -0
  332. package/.versions/2.0.9/.pi/harnesses/lib/spawned-peers.js +190 -0
  333. package/.versions/2.0.9/.pi/harnesses/lib/update-check.ts +222 -0
  334. package/.versions/2.0.9/.pi/harnesses/package-lock.json +2039 -0
  335. package/.versions/2.0.9/.pi/harnesses/package.json +10 -0
  336. package/.versions/2.0.9/.pi/prompts/af-build.md +24 -0
  337. package/.versions/2.0.9/.pi/prompts/af-code-simplify.md +22 -0
  338. package/.versions/2.0.9/.pi/prompts/af-constraints.md +31 -0
  339. package/.versions/2.0.9/.pi/prompts/af-plan.md +17 -0
  340. package/.versions/2.0.9/.pi/prompts/af-review.md +16 -0
  341. package/.versions/2.0.9/.pi/prompts/af-set-hermes-telegram.md +15 -0
  342. package/.versions/2.0.9/.pi/prompts/af-set-hermes-watchdog.md +6 -0
  343. package/.versions/2.0.9/.pi/prompts/af-ship.md +17 -0
  344. package/.versions/2.0.9/.pi/prompts/af-spec.md +15 -0
  345. package/.versions/2.0.9/.pi/prompts/af-test.md +19 -0
  346. package/.versions/2.0.9/.pi/skills/bowser/SKILL.md +145 -0
  347. package/.versions/2.0.9/.version +1 -0
  348. package/.versions/2.0.9/agents/architect.md +25 -0
  349. package/.versions/2.0.9/agents/bowser.md +28 -0
  350. package/.versions/2.0.9/agents/builder.md +56 -0
  351. package/.versions/2.0.9/agents/code-reviewer.md +210 -0
  352. package/.versions/2.0.9/agents/deep-researcher.md +33 -0
  353. package/.versions/2.0.9/agents/documenter.md +23 -0
  354. package/.versions/2.0.9/agents/orchestrator.md +23 -0
  355. package/.versions/2.0.9/agents/plan-reviewer.md +84 -0
  356. package/.versions/2.0.9/agents/planner.md +106 -0
  357. package/.versions/2.0.9/agents/releaser.md +25 -0
  358. package/.versions/2.0.9/agents/researcher.md +31 -0
  359. package/.versions/2.0.9/agents/security-auditor.md +168 -0
  360. package/.versions/2.0.9/agents/test-engineer.md +154 -0
  361. package/.versions/2.0.9/agents/web-debugger.md +44 -0
  362. package/.versions/2.0.9/agents/web-performance-auditor.md +194 -0
  363. package/.versions/2.0.9/bin/catalog/harness-runtime-closure.json +32 -0
  364. package/.versions/2.0.9/codex/fleet-session-client/SKILL.md +34 -0
  365. package/.versions/2.0.9/codex/fleet-session-client.zip +0 -0
  366. package/.versions/2.0.9/docs/ARCHITECTURE.md +416 -0
  367. package/.versions/2.0.9/docs/agent-fleet-setup.md +568 -0
  368. package/.versions/2.0.9/docs/claude-code-coms-bridge.md +134 -0
  369. package/.versions/2.0.9/docs/codex-session-bridge.md +219 -0
  370. package/.versions/2.0.9/docs/coms-hermes-bridge.md +188 -0
  371. package/.versions/2.0.9/docs/getting-started.md +126 -0
  372. package/.versions/2.0.9/docs/npm-install.md +356 -0
  373. package/.versions/2.0.9/docs/pi-extensions.md +449 -0
  374. package/.versions/2.0.9/docs/pi-setup.md +76 -0
  375. package/.versions/2.0.9/docs/skill-anatomy.md +150 -0
  376. package/.versions/2.0.9/install-manifest.json +2991 -0
  377. package/.versions/2.0.9/justfile +247 -0
  378. package/.versions/2.0.9/manifest-meta.json +970 -0
  379. package/.versions/2.0.9/references/accessibility-checklist.md +160 -0
  380. package/.versions/2.0.9/references/communication-contract.md +26 -0
  381. package/.versions/2.0.9/references/definition-of-done.md +67 -0
  382. package/.versions/2.0.9/references/fleet-coordination-patterns.md +171 -0
  383. package/.versions/2.0.9/references/observability-checklist.md +92 -0
  384. package/.versions/2.0.9/references/orchestration-patterns.md +370 -0
  385. package/.versions/2.0.9/references/performance-checklist.md +236 -0
  386. package/.versions/2.0.9/references/prompting-patterns.md +380 -0
  387. package/.versions/2.0.9/references/security-checklist.md +245 -0
  388. package/.versions/2.0.9/references/testing-patterns.md +235 -0
  389. package/.versions/2.0.9/references/workflow-authoring.md +304 -0
  390. package/.versions/2.0.9/skills/_internal/grilling.md +59 -0
  391. package/.versions/2.0.9/skills/browser-testing-with-devtools/SKILL.md +351 -0
  392. package/.versions/2.0.9/skills/code-review-and-quality/SKILL.md +396 -0
  393. package/.versions/2.0.9/skills/compound-learning/SKILL.md +137 -0
  394. package/.versions/2.0.9/skills/constraint-driven-development/SKILL.md +338 -0
  395. package/.versions/2.0.9/skills/constraint-driven-development/references/floor-guard.md +99 -0
  396. package/.versions/2.0.9/skills/context-engineering/SKILL.md +341 -0
  397. package/.versions/2.0.9/skills/deprecation-and-migration/SKILL.md +247 -0
  398. package/.versions/2.0.9/skills/designing-agents/SKILL.md +394 -0
  399. package/.versions/2.0.9/skills/designing-agents/pi-harness-authoring.md +222 -0
  400. package/.versions/2.0.9/skills/drafting-workflows/SKILL.md +143 -0
  401. package/.versions/2.0.9/skills/drafting-workflows/scripts/make-workflow.ts +177 -0
  402. package/.versions/2.0.9/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/.versions/2.0.9/skills/git-workflow-and-versioning/SKILL.md +316 -0
  404. package/.versions/2.0.9/skills/idea-refine/SKILL.md +182 -0
  405. package/.versions/2.0.9/skills/idea-refine/examples.md +238 -0
  406. package/.versions/2.0.9/skills/idea-refine/frameworks.md +99 -0
  407. package/.versions/2.0.9/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/.versions/2.0.9/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/.versions/2.0.9/skills/incremental-implementation/SKILL.md +302 -0
  410. package/.versions/2.0.9/skills/interview-me/SKILL.md +226 -0
  411. package/.versions/2.0.9/skills/orchestration-verification/SKILL.md +181 -0
  412. package/.versions/2.0.9/skills/peer-coms/SKILL.md +90 -0
  413. package/.versions/2.0.9/skills/performance-optimization/SKILL.md +496 -0
  414. package/.versions/2.0.9/skills/planning-and-task-breakdown/SKILL.md +289 -0
  415. package/.versions/2.0.9/skills/security-and-hardening/SKILL.md +524 -0
  416. package/.versions/2.0.9/skills/spec-driven-development/SKILL.md +295 -0
  417. package/.versions/2.0.9/skills/using-agent-skills/SKILL.md +198 -0
  418. package/.versions/2.0.9/vendor/agent-skills-upstream/LICENSE +21 -0
  419. package/.versions/2.0.9/vendor/agent-skills-upstream/README.md +430 -0
  420. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +367 -0
  421. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  422. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  423. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  424. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  425. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/constraint-driven-development/SKILL.md +311 -0
  426. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/constraint-driven-development/references/floor-guard.md +99 -0
  427. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +337 -0
  428. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  429. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  430. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +288 -0
  431. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  432. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  433. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  434. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  435. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  436. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  437. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  438. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  439. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  440. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  441. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +238 -0
  442. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +496 -0
  443. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +257 -0
  444. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +524 -0
  445. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +330 -0
  446. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +216 -0
  447. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +245 -0
  448. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +398 -0
  449. package/.versions/2.0.9/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +192 -0
  450. package/CHANGELOG.md +24 -0
  451. package/docs/pi-extensions.md +3 -0
  452. package/install-manifest.json +1 -1
  453. package/package.json +34 -12
@@ -0,0 +1,150 @@
1
+ # Skill Anatomy
2
+
3
+ This document describes the structure and format of agent-fleet skill files. Use this as a guide when contributing new skills or understanding existing ones.
4
+
5
+ ## File Location
6
+
7
+ Every skill lives in its own directory under `skills/`:
8
+
9
+ ```
10
+ skills/
11
+ skill-name/
12
+ SKILL.md # Required: The skill definition
13
+ scripts/ # Optional: Runnable helpers used by the skill workflow
14
+ supporting-file.md # Optional: Reference material loaded on demand
15
+ ```
16
+
17
+ `SKILL.md` is the only required file. Add `scripts/` only when the skill actually ships runnable helpers, and omit the directory entirely for markdown-only skills.
18
+
19
+ ## SKILL.md Format
20
+
21
+ ### Frontmatter (Required)
22
+
23
+ ```yaml
24
+ ---
25
+ name: skill-name-with-hyphens
26
+ description: Guides agents through [task/workflow]. Use when [specific trigger conditions].
27
+ ---
28
+ ```
29
+
30
+ **Rules:**
31
+ - `name`: Lowercase, hyphen-separated. Must match the directory name.
32
+ - `description`: Start with what the skill does in third person, then include one or more clear "Use when" trigger conditions. Include both *what* and *when*. Maximum 1024 characters.
33
+
34
+ **Why this matters:** Agents discover skills by reading descriptions. The description is injected into the system prompt, so it must tell the agent both what the skill provides and when to activate it. Do not summarize the workflow — if the description contains process steps, the agent may follow the summary instead of reading the full skill.
35
+
36
+ ### Standard Sections (Recommended Pattern)
37
+
38
+ The frontmatter contract above is required. The section layout below is a recommended pattern, not a rigid template: equivalent headings are acceptable when they serve the same purpose clearly.
39
+
40
+ ```markdown
41
+ # Skill Title
42
+
43
+ ## Overview
44
+ One-two sentences explaining what this skill does and why it matters.
45
+
46
+ ## When to Use
47
+ - Bullet list of triggering conditions (symptoms, task types)
48
+ - When NOT to use (exclusions)
49
+
50
+ ## [Core Process / The Workflow / Steps]
51
+ The main workflow, broken into numbered steps or phases.
52
+ Include code examples where they help.
53
+ Use flowcharts (ASCII) where decision points exist.
54
+
55
+ ## [Specific Techniques / Patterns]
56
+ Detailed guidance for specific scenarios.
57
+ Code examples, templates, configuration.
58
+
59
+ ## Common Rationalizations
60
+ | Rationalization | Reality |
61
+ |---|---|
62
+ | Excuse agents use to skip steps | Why the excuse is wrong |
63
+
64
+ ## Red Flags
65
+ - Behavioral patterns indicating the skill is being violated
66
+ - Things to watch for during review
67
+
68
+ ## Verification
69
+ After completing the skill's process, confirm:
70
+ - [ ] Checklist of exit criteria
71
+ - [ ] Evidence requirements
72
+ ```
73
+
74
+ ## Section Purposes
75
+
76
+ ### Overview
77
+ The "elevator pitch" for the skill. Should answer: What does this skill do, and why should an agent follow it?
78
+
79
+ ### When to Use
80
+ Helps agents and humans decide if this skill applies to the current task. Include both positive triggers ("Use when X") and negative exclusions ("NOT for Y").
81
+
82
+ ### Core Process
83
+ The heart of the skill. This is the step-by-step workflow the agent follows. Must be specific and actionable — not vague advice.
84
+
85
+ **Good:** "Run `npm test` and verify all tests pass"
86
+ **Bad:** "Make sure the tests work"
87
+
88
+ ### Common Rationalizations
89
+ The most distinctive feature of well-crafted skills. These are excuses agents use to skip important steps, paired with rebuttals. They prevent the agent from rationalizing its way out of following the process.
90
+
91
+ Think of every time an agent has said "I'll add tests later" or "This is simple enough to skip the spec" — those go here with a factual counter-argument.
92
+
93
+ ### Red Flags
94
+ Observable signs that the skill is being violated. Useful during code review and self-monitoring.
95
+
96
+ ### Verification
97
+ The exit criteria. A checklist the agent uses to confirm the skill's process is complete. Every checkbox should be verifiable with evidence (test output, build result, screenshot, etc.).
98
+
99
+ ## Supporting Files
100
+
101
+ Create supporting files only when:
102
+ - Reference material exceeds 100 lines (keep the main SKILL.md focused)
103
+ - Code tools or scripts are needed
104
+ - Checklists are long enough to justify separate files
105
+
106
+ Keep patterns and principles inline when under 50 lines.
107
+
108
+ If a skill does not need runnable helpers, do not create an empty `scripts/` directory just to mirror other skills. Empty directories add noise without changing how the skill works.
109
+
110
+ ## Writing Principles
111
+
112
+ 1. **Process over knowledge.** Skills are workflows, not reference docs. Steps, not facts.
113
+ 2. **Specific over general.** "Run `npm test`" beats "verify the tests".
114
+ 3. **Evidence over assumption.** Every verification checkbox requires proof.
115
+ 4. **Anti-rationalization.** Every skip-worthy step needs a counter-argument in the rationalizations table.
116
+ 5. **Progressive disclosure.** Main SKILL.md is the entry point. Supporting files are loaded only when needed.
117
+ 6. **Token-conscious.** Every section must justify its inclusion. If removing it wouldn't change agent behavior, remove it.
118
+ 7. **Prompting-patterns applied.** Before finalizing a skill, verify its language against `references/prompting-patterns.md` — positive instructions over prohibitions, explain *why* behind non-obvious rules, no ALL-CAPS or reward/punishment language.
119
+
120
+ ## Naming Conventions
121
+
122
+ - Skill directories: `lowercase-hyphen-separated`
123
+ - Skill files: `SKILL.md` (always uppercase)
124
+ - Supporting files: `lowercase-hyphen-separated.md`
125
+ - References: stored in `references/` at the project root, not inside skill directories
126
+
127
+ ## Cross-Skill References
128
+
129
+ Reference other skills by name:
130
+
131
+ ```markdown
132
+ Follow the `test-driven-development` skill for writing tests.
133
+ If the build breaks, use the `debugging-and-error-recovery` skill.
134
+ ```
135
+
136
+ Don't duplicate content between skills — reference and link instead.
137
+
138
+ ## Required vs Recommended
139
+
140
+ Required:
141
+
142
+ - A `skills/<skill-name>/SKILL.md` file
143
+ - Valid YAML frontmatter with `name` and `description`
144
+ - A description that includes both what the skill does and when to use it
145
+
146
+ Recommended:
147
+
148
+ - The standard section flow shown above
149
+ - Equivalent headings such as `How It Works`, `Core Process`, or `Workflow` when they read more naturally for the skill
150
+ - Supporting files only when they keep the main `SKILL.md` focused