@chankov/agent-fleet 0.0.1

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 (419) hide show
  1. package/.claude/commands/build.md +44 -0
  2. package/.claude/commands/code-simplify.md +22 -0
  3. package/.claude/commands/design-agent.md +14 -0
  4. package/.claude/commands/doctor-agent-fleet.md +17 -0
  5. package/.claude/commands/orchestrate.md +112 -0
  6. package/.claude/commands/plan.md +16 -0
  7. package/.claude/commands/prime.md +22 -0
  8. package/.claude/commands/review.md +16 -0
  9. package/.claude/commands/setup-agent-fleet.md +25 -0
  10. package/.claude/commands/ship.md +72 -0
  11. package/.claude/commands/spec.md +15 -0
  12. package/.claude/commands/test.md +19 -0
  13. package/.claude/commands/webperf.md +32 -0
  14. package/.claude/orchestrate-teams.yaml +24 -0
  15. package/.opencode/commands/af-build.md +17 -0
  16. package/.opencode/commands/af-code-simplify.md +16 -0
  17. package/.opencode/commands/af-compound.md +16 -0
  18. package/.opencode/commands/af-design-agent.md +15 -0
  19. package/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  20. package/.opencode/commands/af-orchestrate.md +112 -0
  21. package/.opencode/commands/af-plan.md +16 -0
  22. package/.opencode/commands/af-prime.md +22 -0
  23. package/.opencode/commands/af-review.md +15 -0
  24. package/.opencode/commands/af-setup-agent-fleet.md +15 -0
  25. package/.opencode/commands/af-ship.md +16 -0
  26. package/.opencode/commands/af-spec.md +16 -0
  27. package/.opencode/commands/af-test.md +21 -0
  28. package/.opencode/commands/af-webperf.md +32 -0
  29. package/.opencode/orchestrate-teams.yaml +24 -0
  30. package/.pi/agents/dispatch-policy.yaml +32 -0
  31. package/.pi/agents/model-profiles.yaml +20 -0
  32. package/.pi/agents/peers.yaml +142 -0
  33. package/.pi/agents/teams.yaml +39 -0
  34. package/.pi/damage-control-rules.yaml +297 -0
  35. package/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  36. package/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  37. package/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  38. package/.pi/extensions/btw/README.md +118 -0
  39. package/.pi/extensions/btw/index.ts +917 -0
  40. package/.pi/extensions/btw/package.json +6 -0
  41. package/.pi/extensions/btw/state.js +179 -0
  42. package/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  43. package/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  44. package/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  45. package/.pi/extensions/compact-and-continue/README.md +42 -0
  46. package/.pi/extensions/compact-and-continue/index.ts +120 -0
  47. package/.pi/extensions/compact-and-continue/package.json +6 -0
  48. package/.pi/extensions/mcp-bridge/README.md +46 -0
  49. package/.pi/extensions/mcp-bridge/index.ts +206 -0
  50. package/.pi/extensions/mcp-bridge/package.json +6 -0
  51. package/.pi/extensions/package-lock.json +1143 -0
  52. package/.pi/extensions/package.json +9 -0
  53. package/.pi/extensions/pi-voice-stt/README.md +201 -0
  54. package/.pi/extensions/pi-voice-stt/config.ts +198 -0
  55. package/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  56. package/.pi/extensions/pi-voice-stt/index.ts +248 -0
  57. package/.pi/extensions/pi-voice-stt/package.json +6 -0
  58. package/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  59. package/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  60. package/.pi/harnesses/agent-hub/README.md +562 -0
  61. package/.pi/harnesses/agent-hub/artifacts.js +92 -0
  62. package/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  63. package/.pi/harnesses/agent-hub/delegate.ts +363 -0
  64. package/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  65. package/.pi/harnesses/agent-hub/helpers.ts +165 -0
  66. package/.pi/harnesses/agent-hub/index.ts +7098 -0
  67. package/.pi/harnesses/agent-hub/package.json +6 -0
  68. package/.pi/harnesses/agent-hub/return-contract.js +215 -0
  69. package/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  70. package/.pi/harnesses/agent-hub/spawn.ts +179 -0
  71. package/.pi/harnesses/ask-user-remote/README.md +10 -0
  72. package/.pi/harnesses/ask-user-remote/index.ts +253 -0
  73. package/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  74. package/.pi/harnesses/coms/README.md +71 -0
  75. package/.pi/harnesses/coms/index.ts +1743 -0
  76. package/.pi/harnesses/coms/package.json +6 -0
  77. package/.pi/harnesses/damage-control/README.md +65 -0
  78. package/.pi/harnesses/damage-control/index.ts +250 -0
  79. package/.pi/harnesses/damage-control/package.json +6 -0
  80. package/.pi/harnesses/damage-control/shared.ts +183 -0
  81. package/.pi/harnesses/damage-control-continue/README.md +116 -0
  82. package/.pi/harnesses/damage-control-continue/index.ts +522 -0
  83. package/.pi/harnesses/damage-control-continue/package.json +6 -0
  84. package/.pi/harnesses/lib/herdr-client.ts +458 -0
  85. package/.pi/harnesses/lib/herdr-presence.ts +288 -0
  86. package/.pi/harnesses/package-lock.json +35 -0
  87. package/.pi/harnesses/package.json +9 -0
  88. package/.pi/prompts/build.md +24 -0
  89. package/.pi/prompts/code-simplify.md +22 -0
  90. package/.pi/prompts/doctor-agent-fleet.md +15 -0
  91. package/.pi/prompts/plan.md +16 -0
  92. package/.pi/prompts/review.md +16 -0
  93. package/.pi/prompts/setup-agent-fleet.md +27 -0
  94. package/.pi/prompts/ship.md +17 -0
  95. package/.pi/prompts/spec.md +15 -0
  96. package/.pi/prompts/test.md +19 -0
  97. package/.pi/skills/bowser/SKILL.md +145 -0
  98. package/.versions/0.0.1/.claude/commands/build.md +44 -0
  99. package/.versions/0.0.1/.claude/commands/code-simplify.md +22 -0
  100. package/.versions/0.0.1/.claude/commands/design-agent.md +14 -0
  101. package/.versions/0.0.1/.claude/commands/doctor-agent-fleet.md +17 -0
  102. package/.versions/0.0.1/.claude/commands/orchestrate.md +112 -0
  103. package/.versions/0.0.1/.claude/commands/plan.md +16 -0
  104. package/.versions/0.0.1/.claude/commands/prime.md +22 -0
  105. package/.versions/0.0.1/.claude/commands/review.md +16 -0
  106. package/.versions/0.0.1/.claude/commands/setup-agent-fleet.md +25 -0
  107. package/.versions/0.0.1/.claude/commands/ship.md +72 -0
  108. package/.versions/0.0.1/.claude/commands/spec.md +15 -0
  109. package/.versions/0.0.1/.claude/commands/test.md +19 -0
  110. package/.versions/0.0.1/.claude/commands/webperf.md +32 -0
  111. package/.versions/0.0.1/.claude/orchestrate-teams.yaml +24 -0
  112. package/.versions/0.0.1/.opencode/commands/af-build.md +17 -0
  113. package/.versions/0.0.1/.opencode/commands/af-code-simplify.md +16 -0
  114. package/.versions/0.0.1/.opencode/commands/af-compound.md +16 -0
  115. package/.versions/0.0.1/.opencode/commands/af-design-agent.md +15 -0
  116. package/.versions/0.0.1/.opencode/commands/af-doctor-agent-fleet.md +15 -0
  117. package/.versions/0.0.1/.opencode/commands/af-orchestrate.md +112 -0
  118. package/.versions/0.0.1/.opencode/commands/af-plan.md +16 -0
  119. package/.versions/0.0.1/.opencode/commands/af-prime.md +22 -0
  120. package/.versions/0.0.1/.opencode/commands/af-review.md +15 -0
  121. package/.versions/0.0.1/.opencode/commands/af-setup-agent-fleet.md +15 -0
  122. package/.versions/0.0.1/.opencode/commands/af-ship.md +16 -0
  123. package/.versions/0.0.1/.opencode/commands/af-spec.md +16 -0
  124. package/.versions/0.0.1/.opencode/commands/af-test.md +21 -0
  125. package/.versions/0.0.1/.opencode/commands/af-webperf.md +32 -0
  126. package/.versions/0.0.1/.opencode/orchestrate-teams.yaml +24 -0
  127. package/.versions/0.0.1/.pi/agents/dispatch-policy.yaml +32 -0
  128. package/.versions/0.0.1/.pi/agents/model-profiles.yaml +20 -0
  129. package/.versions/0.0.1/.pi/agents/peers.yaml +142 -0
  130. package/.versions/0.0.1/.pi/agents/teams.yaml +39 -0
  131. package/.versions/0.0.1/.pi/damage-control-rules.yaml +297 -0
  132. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/README.md +58 -0
  133. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/index.ts +161 -0
  134. package/.versions/0.0.1/.pi/extensions/agent-fleet-update-check/package.json +6 -0
  135. package/.versions/0.0.1/.pi/extensions/btw/README.md +118 -0
  136. package/.versions/0.0.1/.pi/extensions/btw/index.ts +917 -0
  137. package/.versions/0.0.1/.pi/extensions/btw/package.json +6 -0
  138. package/.versions/0.0.1/.pi/extensions/btw/state.js +179 -0
  139. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/README.md +58 -0
  140. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/index.ts +92 -0
  141. package/.versions/0.0.1/.pi/extensions/chrome-devtools-mcp/package.json +6 -0
  142. package/.versions/0.0.1/.pi/extensions/compact-and-continue/README.md +42 -0
  143. package/.versions/0.0.1/.pi/extensions/compact-and-continue/index.ts +120 -0
  144. package/.versions/0.0.1/.pi/extensions/compact-and-continue/package.json +6 -0
  145. package/.versions/0.0.1/.pi/extensions/mcp-bridge/README.md +46 -0
  146. package/.versions/0.0.1/.pi/extensions/mcp-bridge/index.ts +206 -0
  147. package/.versions/0.0.1/.pi/extensions/mcp-bridge/package.json +6 -0
  148. package/.versions/0.0.1/.pi/extensions/package-lock.json +1143 -0
  149. package/.versions/0.0.1/.pi/extensions/package.json +9 -0
  150. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/README.md +201 -0
  151. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/config.ts +198 -0
  152. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/examples/stt.json +35 -0
  153. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/index.ts +248 -0
  154. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/package.json +6 -0
  155. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/providers.ts +214 -0
  156. package/.versions/0.0.1/.pi/extensions/pi-voice-stt/recorder.ts +158 -0
  157. package/.versions/0.0.1/.pi/harnesses/agent-hub/README.md +562 -0
  158. package/.versions/0.0.1/.pi/harnesses/agent-hub/artifacts.js +92 -0
  159. package/.versions/0.0.1/.pi/harnesses/agent-hub/backend-policy.js +153 -0
  160. package/.versions/0.0.1/.pi/harnesses/agent-hub/delegate.ts +363 -0
  161. package/.versions/0.0.1/.pi/harnesses/agent-hub/evidence-rules.js +96 -0
  162. package/.versions/0.0.1/.pi/harnesses/agent-hub/helpers.ts +165 -0
  163. package/.versions/0.0.1/.pi/harnesses/agent-hub/index.ts +7098 -0
  164. package/.versions/0.0.1/.pi/harnesses/agent-hub/package.json +6 -0
  165. package/.versions/0.0.1/.pi/harnesses/agent-hub/return-contract.js +215 -0
  166. package/.versions/0.0.1/.pi/harnesses/agent-hub/scope-gate.js +103 -0
  167. package/.versions/0.0.1/.pi/harnesses/agent-hub/spawn.ts +179 -0
  168. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/README.md +10 -0
  169. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/index.ts +253 -0
  170. package/.versions/0.0.1/.pi/harnesses/ask-user-remote/race-core.js +106 -0
  171. package/.versions/0.0.1/.pi/harnesses/coms/README.md +71 -0
  172. package/.versions/0.0.1/.pi/harnesses/coms/index.ts +1743 -0
  173. package/.versions/0.0.1/.pi/harnesses/coms/package.json +6 -0
  174. package/.versions/0.0.1/.pi/harnesses/damage-control/README.md +65 -0
  175. package/.versions/0.0.1/.pi/harnesses/damage-control/index.ts +250 -0
  176. package/.versions/0.0.1/.pi/harnesses/damage-control/package.json +6 -0
  177. package/.versions/0.0.1/.pi/harnesses/damage-control/shared.ts +183 -0
  178. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/README.md +116 -0
  179. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/index.ts +522 -0
  180. package/.versions/0.0.1/.pi/harnesses/damage-control-continue/package.json +6 -0
  181. package/.versions/0.0.1/.pi/harnesses/lib/herdr-client.ts +458 -0
  182. package/.versions/0.0.1/.pi/harnesses/lib/herdr-presence.ts +288 -0
  183. package/.versions/0.0.1/.pi/harnesses/package-lock.json +35 -0
  184. package/.versions/0.0.1/.pi/harnesses/package.json +9 -0
  185. package/.versions/0.0.1/.pi/prompts/build.md +24 -0
  186. package/.versions/0.0.1/.pi/prompts/code-simplify.md +22 -0
  187. package/.versions/0.0.1/.pi/prompts/doctor-agent-fleet.md +15 -0
  188. package/.versions/0.0.1/.pi/prompts/plan.md +16 -0
  189. package/.versions/0.0.1/.pi/prompts/review.md +16 -0
  190. package/.versions/0.0.1/.pi/prompts/setup-agent-fleet.md +27 -0
  191. package/.versions/0.0.1/.pi/prompts/ship.md +17 -0
  192. package/.versions/0.0.1/.pi/prompts/spec.md +15 -0
  193. package/.versions/0.0.1/.pi/prompts/test.md +19 -0
  194. package/.versions/0.0.1/.pi/skills/bowser/SKILL.md +145 -0
  195. package/.versions/0.0.1/.version +1 -0
  196. package/.versions/0.0.1/agents/architect.md +21 -0
  197. package/.versions/0.0.1/agents/bowser.md +25 -0
  198. package/.versions/0.0.1/agents/builder.md +52 -0
  199. package/.versions/0.0.1/agents/code-reviewer.md +205 -0
  200. package/.versions/0.0.1/agents/deep-researcher.md +31 -0
  201. package/.versions/0.0.1/agents/documenter.md +16 -0
  202. package/.versions/0.0.1/agents/orchestrator.md +43 -0
  203. package/.versions/0.0.1/agents/plan-reviewer.md +60 -0
  204. package/.versions/0.0.1/agents/planner.md +69 -0
  205. package/.versions/0.0.1/agents/releaser.md +22 -0
  206. package/.versions/0.0.1/agents/researcher.md +28 -0
  207. package/.versions/0.0.1/agents/security-auditor.md +166 -0
  208. package/.versions/0.0.1/agents/test-engineer.md +144 -0
  209. package/.versions/0.0.1/agents/web-debugger.md +42 -0
  210. package/.versions/0.0.1/agents/web-performance-auditor.md +192 -0
  211. package/.versions/0.0.1/hooks/SIMPLIFY-IGNORE.md +90 -0
  212. package/.versions/0.0.1/hooks/coms-stop-hook.mjs +73 -0
  213. package/.versions/0.0.1/hooks/hooks.json +14 -0
  214. package/.versions/0.0.1/hooks/session-start.sh +74 -0
  215. package/.versions/0.0.1/hooks/simplify-ignore.sh +302 -0
  216. package/.versions/0.0.1/justfile +143 -0
  217. package/.versions/0.0.1/references/accessibility-checklist.md +160 -0
  218. package/.versions/0.0.1/references/definition-of-done.md +67 -0
  219. package/.versions/0.0.1/references/fleet-coordination-patterns.md +151 -0
  220. package/.versions/0.0.1/references/observability-checklist.md +91 -0
  221. package/.versions/0.0.1/references/orchestration-patterns.md +370 -0
  222. package/.versions/0.0.1/references/performance-checklist.md +153 -0
  223. package/.versions/0.0.1/references/prompting-patterns.md +380 -0
  224. package/.versions/0.0.1/references/security-checklist.md +179 -0
  225. package/.versions/0.0.1/references/testing-patterns.md +236 -0
  226. package/.versions/0.0.1/scripts/coms-claude-bridge.ts +286 -0
  227. package/.versions/0.0.1/scripts/coms-cli.ts +372 -0
  228. package/.versions/0.0.1/scripts/coms-hermes-bridge.ts +399 -0
  229. package/.versions/0.0.1/scripts/lib/claude-bridge-core.ts +100 -0
  230. package/.versions/0.0.1/scripts/lib/coms-envelope.ts +494 -0
  231. package/.versions/0.0.1/scripts/lib/herdr-layout.ts +235 -0
  232. package/.versions/0.0.1/scripts/lib/hermes-bridge-core.ts +238 -0
  233. package/.versions/0.0.1/scripts/lib/persona-banner.ts +62 -0
  234. package/.versions/0.0.1/scripts/lib/team-project.ts +75 -0
  235. package/.versions/0.0.1/scripts/lib/team-snapshot.ts +146 -0
  236. package/.versions/0.0.1/scripts/peer-banner.ts +40 -0
  237. package/.versions/0.0.1/scripts/team-snapshot.ts +221 -0
  238. package/.versions/0.0.1/scripts/team-up.ts +245 -0
  239. package/.versions/0.0.1/skills/_internal/grilling.md +11 -0
  240. package/.versions/0.0.1/skills/browser-testing-with-devtools/SKILL.md +352 -0
  241. package/.versions/0.0.1/skills/code-review-and-quality/SKILL.md +381 -0
  242. package/.versions/0.0.1/skills/compound-learning/SKILL.md +137 -0
  243. package/.versions/0.0.1/skills/context-engineering/SKILL.md +291 -0
  244. package/.versions/0.0.1/skills/deprecation-and-migration/SKILL.md +206 -0
  245. package/.versions/0.0.1/skills/designing-agents/SKILL.md +394 -0
  246. package/.versions/0.0.1/skills/designing-agents/pi-harness-authoring.md +209 -0
  247. package/.versions/0.0.1/skills/frontend-ui-engineering/SKILL.md +328 -0
  248. package/.versions/0.0.1/skills/git-workflow-and-versioning/SKILL.md +316 -0
  249. package/.versions/0.0.1/skills/guided-workspace-setup/SKILL.md +506 -0
  250. package/.versions/0.0.1/skills/idea-refine/SKILL.md +182 -0
  251. package/.versions/0.0.1/skills/idea-refine/examples.md +238 -0
  252. package/.versions/0.0.1/skills/idea-refine/frameworks.md +99 -0
  253. package/.versions/0.0.1/skills/idea-refine/refinement-criteria.md +113 -0
  254. package/.versions/0.0.1/skills/idea-refine/scripts/idea-refine.sh +15 -0
  255. package/.versions/0.0.1/skills/incremental-implementation/SKILL.md +287 -0
  256. package/.versions/0.0.1/skills/interview-me/SKILL.md +226 -0
  257. package/.versions/0.0.1/skills/orchestration-verification/SKILL.md +181 -0
  258. package/.versions/0.0.1/skills/peer-coms/SKILL.md +81 -0
  259. package/.versions/0.0.1/skills/performance-optimization/SKILL.md +350 -0
  260. package/.versions/0.0.1/skills/planning-and-task-breakdown/SKILL.md +236 -0
  261. package/.versions/0.0.1/skills/security-and-hardening/SKILL.md +461 -0
  262. package/.versions/0.0.1/skills/spec-driven-development/SKILL.md +245 -0
  263. package/.versions/0.0.1/skills/using-agent-skills/SKILL.md +199 -0
  264. package/.versions/0.0.1/vendor/agent-skills-upstream/LICENSE +21 -0
  265. package/.versions/0.0.1/vendor/agent-skills-upstream/README.md +11 -0
  266. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  267. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  268. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  269. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  270. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  271. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  272. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  273. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  274. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  275. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  276. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  277. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  278. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  279. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  280. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  281. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  282. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  283. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  284. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  285. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  286. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  287. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  288. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  289. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  290. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  291. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  292. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  293. package/.versions/0.0.1/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
  294. package/CHANGELOG.md +65 -0
  295. package/LICENSE +21 -0
  296. package/README.md +458 -0
  297. package/agents/architect.md +21 -0
  298. package/agents/bowser.md +25 -0
  299. package/agents/builder.md +52 -0
  300. package/agents/code-reviewer.md +205 -0
  301. package/agents/deep-researcher.md +31 -0
  302. package/agents/documenter.md +16 -0
  303. package/agents/orchestrator.md +43 -0
  304. package/agents/plan-reviewer.md +60 -0
  305. package/agents/planner.md +69 -0
  306. package/agents/releaser.md +22 -0
  307. package/agents/researcher.md +28 -0
  308. package/agents/security-auditor.md +166 -0
  309. package/agents/test-engineer.md +144 -0
  310. package/agents/web-debugger.md +42 -0
  311. package/agents/web-performance-auditor.md +192 -0
  312. package/bin/cli.js +633 -0
  313. package/bin/force-patch-changesets.js +44 -0
  314. package/bin/lib/bootstrap.js +323 -0
  315. package/bin/lib/detect-agent.js +49 -0
  316. package/bin/lib/doctor.js +302 -0
  317. package/bin/lib/transform-persona.js +180 -0
  318. package/bin/lib/update-notifier.js +195 -0
  319. package/bin/lib/validate-overrides.js +229 -0
  320. package/bin/snapshot-version.js +91 -0
  321. package/docs/agent-fleet-setup.md +355 -0
  322. package/docs/claude-code-coms-bridge.md +93 -0
  323. package/docs/getting-started.md +169 -0
  324. package/docs/npm-install.md +335 -0
  325. package/docs/opencode-setup.md +248 -0
  326. package/docs/pi-extensions.md +237 -0
  327. package/docs/pi-setup.md +455 -0
  328. package/docs/skill-anatomy.md +150 -0
  329. package/hooks/SIMPLIFY-IGNORE.md +90 -0
  330. package/hooks/coms-stop-hook.mjs +73 -0
  331. package/hooks/hooks.json +14 -0
  332. package/hooks/session-start.sh +74 -0
  333. package/hooks/simplify-ignore.sh +302 -0
  334. package/justfile +143 -0
  335. package/node_modules/pi-ask-user/LICENSE +21 -0
  336. package/node_modules/pi-ask-user/README.md +156 -0
  337. package/node_modules/pi-ask-user/index.ts +1795 -0
  338. package/node_modules/pi-ask-user/package.json +51 -0
  339. package/node_modules/pi-ask-user/single-select-layout.ts +203 -0
  340. package/node_modules/pi-ask-user/skills/ask-user/SKILL.md +162 -0
  341. package/node_modules/pi-ask-user/skills/ask-user/references/ask-user-skill-extension-spec.md +96 -0
  342. package/package.json +121 -0
  343. package/references/accessibility-checklist.md +160 -0
  344. package/references/definition-of-done.md +67 -0
  345. package/references/fleet-coordination-patterns.md +151 -0
  346. package/references/observability-checklist.md +91 -0
  347. package/references/orchestration-patterns.md +370 -0
  348. package/references/performance-checklist.md +153 -0
  349. package/references/prompting-patterns.md +380 -0
  350. package/references/security-checklist.md +179 -0
  351. package/references/testing-patterns.md +236 -0
  352. package/scripts/coms-claude-bridge.ts +286 -0
  353. package/scripts/coms-cli.ts +372 -0
  354. package/scripts/coms-hermes-bridge.ts +399 -0
  355. package/scripts/lib/claude-bridge-core.ts +100 -0
  356. package/scripts/lib/coms-envelope.ts +494 -0
  357. package/scripts/lib/herdr-layout.ts +235 -0
  358. package/scripts/lib/hermes-bridge-core.ts +238 -0
  359. package/scripts/lib/persona-banner.ts +62 -0
  360. package/scripts/lib/team-project.ts +75 -0
  361. package/scripts/lib/team-snapshot.ts +146 -0
  362. package/scripts/peer-banner.ts +40 -0
  363. package/scripts/team-snapshot.ts +221 -0
  364. package/scripts/team-up.ts +245 -0
  365. package/skills/_internal/grilling.md +11 -0
  366. package/skills/browser-testing-with-devtools/SKILL.md +352 -0
  367. package/skills/code-review-and-quality/SKILL.md +381 -0
  368. package/skills/compound-learning/SKILL.md +137 -0
  369. package/skills/context-engineering/SKILL.md +291 -0
  370. package/skills/deprecation-and-migration/SKILL.md +206 -0
  371. package/skills/designing-agents/SKILL.md +394 -0
  372. package/skills/designing-agents/pi-harness-authoring.md +209 -0
  373. package/skills/frontend-ui-engineering/SKILL.md +328 -0
  374. package/skills/git-workflow-and-versioning/SKILL.md +316 -0
  375. package/skills/guided-workspace-setup/SKILL.md +506 -0
  376. package/skills/idea-refine/SKILL.md +182 -0
  377. package/skills/idea-refine/examples.md +238 -0
  378. package/skills/idea-refine/frameworks.md +99 -0
  379. package/skills/idea-refine/refinement-criteria.md +113 -0
  380. package/skills/idea-refine/scripts/idea-refine.sh +15 -0
  381. package/skills/incremental-implementation/SKILL.md +287 -0
  382. package/skills/interview-me/SKILL.md +226 -0
  383. package/skills/orchestration-verification/SKILL.md +181 -0
  384. package/skills/peer-coms/SKILL.md +81 -0
  385. package/skills/performance-optimization/SKILL.md +350 -0
  386. package/skills/planning-and-task-breakdown/SKILL.md +236 -0
  387. package/skills/security-and-hardening/SKILL.md +461 -0
  388. package/skills/spec-driven-development/SKILL.md +245 -0
  389. package/skills/using-agent-skills/SKILL.md +199 -0
  390. package/vendor/agent-skills-upstream/LICENSE +21 -0
  391. package/vendor/agent-skills-upstream/README.md +11 -0
  392. package/vendor/agent-skills-upstream/skills/api-and-interface-design/SKILL.md +294 -0
  393. package/vendor/agent-skills-upstream/skills/browser-testing-with-devtools/SKILL.md +317 -0
  394. package/vendor/agent-skills-upstream/skills/ci-cd-and-automation/SKILL.md +390 -0
  395. package/vendor/agent-skills-upstream/skills/code-review-and-quality/SKILL.md +396 -0
  396. package/vendor/agent-skills-upstream/skills/code-simplification/SKILL.md +331 -0
  397. package/vendor/agent-skills-upstream/skills/context-engineering/SKILL.md +289 -0
  398. package/vendor/agent-skills-upstream/skills/debugging-and-error-recovery/SKILL.md +300 -0
  399. package/vendor/agent-skills-upstream/skills/deprecation-and-migration/SKILL.md +247 -0
  400. package/vendor/agent-skills-upstream/skills/documentation-and-adrs/SKILL.md +278 -0
  401. package/vendor/agent-skills-upstream/skills/doubt-driven-development/SKILL.md +243 -0
  402. package/vendor/agent-skills-upstream/skills/frontend-ui-engineering/SKILL.md +328 -0
  403. package/vendor/agent-skills-upstream/skills/git-workflow-and-versioning/SKILL.md +355 -0
  404. package/vendor/agent-skills-upstream/skills/idea-refine/SKILL.md +178 -0
  405. package/vendor/agent-skills-upstream/skills/idea-refine/examples.md +238 -0
  406. package/vendor/agent-skills-upstream/skills/idea-refine/frameworks.md +99 -0
  407. package/vendor/agent-skills-upstream/skills/idea-refine/refinement-criteria.md +113 -0
  408. package/vendor/agent-skills-upstream/skills/idea-refine/scripts/idea-refine.sh +15 -0
  409. package/vendor/agent-skills-upstream/skills/incremental-implementation/SKILL.md +249 -0
  410. package/vendor/agent-skills-upstream/skills/interview-me/SKILL.md +225 -0
  411. package/vendor/agent-skills-upstream/skills/observability-and-instrumentation/SKILL.md +203 -0
  412. package/vendor/agent-skills-upstream/skills/performance-optimization/SKILL.md +350 -0
  413. package/vendor/agent-skills-upstream/skills/planning-and-task-breakdown/SKILL.md +234 -0
  414. package/vendor/agent-skills-upstream/skills/security-and-hardening/SKILL.md +467 -0
  415. package/vendor/agent-skills-upstream/skills/shipping-and-launch/SKILL.md +310 -0
  416. package/vendor/agent-skills-upstream/skills/source-driven-development/SKILL.md +194 -0
  417. package/vendor/agent-skills-upstream/skills/spec-driven-development/SKILL.md +206 -0
  418. package/vendor/agent-skills-upstream/skills/test-driven-development/SKILL.md +383 -0
  419. package/vendor/agent-skills-upstream/skills/using-agent-skills/SKILL.md +191 -0
@@ -0,0 +1,302 @@
1
+ #!/bin/bash
2
+ # simplify-ignore.sh — Hook for Read (PreToolUse), Edit|Write (PostToolUse), Stop
3
+ #
4
+ # PreToolUse Read → backs up file, replaces blocks with BLOCK_<hash> in-place
5
+ # PostToolUse Edit → expands placeholders, re-filters so file stays hidden
6
+ # PostToolUse Write → expands placeholders, re-filters so file stays hidden
7
+ # Stop → restores real file content from backup
8
+ #
9
+ # The file on disk ALWAYS has placeholders while the session is active.
10
+ # The real content (with model's changes applied) lives in the backup.
11
+ #
12
+ # Dependencies: jq, shasum or sha1sum (auto-detected)
13
+
14
+ set -euo pipefail
15
+
16
+ if ! command -v jq >/dev/null 2>&1; then
17
+ printf '%s\n' "error: missing jq" >&2; exit 1
18
+ fi
19
+
20
+ CACHE="${CLAUDE_PROJECT_DIR:-.}/.claude/.simplify-ignore-cache"
21
+ if [ -t 0 ]; then INPUT="{}"; else INPUT=$(cat); fi
22
+
23
+ # Parse hook input — trap errors explicitly so set -e doesn't cause
24
+ # a silent exit on malformed JSON, and surface a useful diagnostic.
25
+ parse_error=""
26
+ TOOL_NAME=$(printf '%s' "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || {
27
+ parse_error="failed to parse .tool_name from hook input"
28
+ TOOL_NAME=""
29
+ }
30
+ FILE_PATH=$(printf '%s' "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null) || {
31
+ parse_error="failed to parse .tool_input.file_path from hook input"
32
+ FILE_PATH=""
33
+ }
34
+ if [ -n "$parse_error" ]; then
35
+ printf 'Warning: %s (input: %.120s)\n' "$parse_error" "$INPUT" >&2
36
+ fi
37
+
38
+ hash_cmd() {
39
+ if command -v shasum >/dev/null 2>&1; then shasum
40
+ elif command -v sha1sum >/dev/null 2>&1; then sha1sum
41
+ else printf '%s\n' "error: missing shasum or sha1sum" >&2; exit 1; fi
42
+ }
43
+ file_id() { printf '%s' "$1" | hash_cmd | cut -c1-16; }
44
+ block_hash() { printf '%s' "$1" | hash_cmd | cut -c1-8; }
45
+ # Escape glob metacharacters so ${var/pattern/repl} treats pattern as literal.
46
+ # Needed for Bash 3.2 (macOS) where quotes don't suppress globbing in PE patterns.
47
+ escape_glob() {
48
+ local s="$1"
49
+ s="${s//\\/\\\\}"
50
+ s="${s//\*/\\*}"
51
+ s="${s//\?/\\?}"
52
+ s="${s//\[/\\[}"
53
+ printf '%s' "$s"
54
+ }
55
+
56
+ # ── filter_file: replace simplify-ignore blocks with BLOCK_<hash> placeholders ─
57
+ # Reads $1 (source), writes filtered version to $2 (dest), saves blocks to cache.
58
+ # Returns 0 if blocks were found, 1 if none.
59
+ filter_file() {
60
+ local src="$1" dest="$2" fid="$3"
61
+ : > "$dest"
62
+ rm -f "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
63
+
64
+ local count=0 in_block=0 buf="" reason="" prefix="" suffix=""
65
+
66
+ while IFS= read -r line || [ -n "$line" ]; do
67
+ # Check for start marker (no fork — uses bash case)
68
+ if [ $in_block -eq 0 ]; then
69
+ case "$line" in *simplify-ignore-start*)
70
+ in_block=1
71
+ buf="$line"
72
+ # Extract comment prefix/suffix to preserve language-appropriate syntax
73
+ prefix="${line%%simplify-ignore-start*}"
74
+ suffix=""
75
+ case "$line" in *'*/'*) suffix=" */" ;; *'-->'*) suffix=" -->" ;; esac
76
+ reason=$(printf '%s' "$line" | sed -n 's/.*simplify-ignore-start:[[:space:]]*//p' \
77
+ | sed 's/[[:space:]]*\*\/.*$//' | sed 's/[[:space:]]*-->.*$//' | sed 's/[[:space:]]*$//')
78
+ # Handle single-line block (start + end on same line)
79
+ case "$line" in *simplify-ignore-end*)
80
+ in_block=0
81
+ # Write single-line block immediately and skip to next line
82
+ # to avoid the end-marker check below firing again
83
+ local h; h=$(block_hash "$buf")
84
+ count=$((count + 1))
85
+ printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
86
+ [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
87
+ printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
88
+ printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
89
+ if [ -n "$reason" ]; then
90
+ printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
91
+ else
92
+ printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
93
+ fi
94
+ buf=""; reason=""; prefix=""; suffix=""
95
+ continue
96
+ ;; *)
97
+ continue
98
+ ;;
99
+ esac
100
+ ;; esac
101
+ fi
102
+ # Accumulate block content
103
+ if [ $in_block -eq 1 ]; then
104
+ buf="${buf}
105
+ ${line}"
106
+ fi
107
+ # Check for end marker
108
+ case "$line" in *simplify-ignore-end*)
109
+ if [ $in_block -eq 1 ]; then
110
+ local h; h=$(block_hash "$buf")
111
+ count=$((count + 1))
112
+ printf '%s' "$buf" > "$CACHE/${fid}.block.${h}"
113
+ [ -n "$reason" ] && printf '%s' "$reason" > "$CACHE/${fid}.reason.${h}"
114
+ printf '%s' "$prefix" > "$CACHE/${fid}.prefix.${h}"
115
+ printf '%s' "$suffix" > "$CACHE/${fid}.suffix.${h}"
116
+ if [ -n "$reason" ]; then
117
+ printf '%s\n' "${prefix}BLOCK_${h}: ${reason}${suffix}" >> "$dest"
118
+ else
119
+ printf '%s\n' "${prefix}BLOCK_${h}${suffix}" >> "$dest"
120
+ fi
121
+ in_block=0; buf=""; reason=""; prefix=""; suffix=""
122
+ continue
123
+ fi
124
+ ;;
125
+ esac
126
+ [ $in_block -eq 0 ] && printf '%s\n' "$line" >> "$dest"
127
+ done < "$src"
128
+
129
+ # Unclosed block → flush as-is
130
+ if [ $in_block -eq 1 ] && [ -n "$buf" ]; then
131
+ printf 'Warning: unclosed simplify-ignore-start in %s (block not hidden)\n' "$src" >&2
132
+ printf '%s\n' "$buf" >> "$dest"
133
+ fi
134
+
135
+ # Preserve trailing newline status of source
136
+ if [ -s "$dest" ] && [ -s "$src" ] && [ -n "$(tail -c 1 "$src")" ]; then
137
+ perl -pe 'chomp if eof' "$dest" > "${dest}.nnl" && \
138
+ cat "${dest}.nnl" > "$dest" && rm -f "${dest}.nnl"
139
+ fi
140
+
141
+ [ $count -gt 0 ] && return 0 || return 1
142
+ }
143
+
144
+ # ── Stop: restore all files from backup ───────────────────────────────────────
145
+ if [ -z "$TOOL_NAME" ]; then
146
+ [ -d "$CACHE" ] || exit 0
147
+ for bak in "$CACHE"/*.bak; do
148
+ [ -f "$bak" ] || continue
149
+ fid="${bak##*/}"; fid="${fid%.bak}"
150
+ pathfile="$CACHE/${fid}.path"
151
+ [ -f "$pathfile" ] || { rm -f "$bak"; continue; }
152
+ orig=$(cat "$pathfile")
153
+ if [ -f "$orig" ]; then
154
+ cat "$bak" > "$orig"
155
+ rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
156
+ rmdir "$CACHE/${fid}.lock" 2>/dev/null
157
+ else
158
+ # File was moved/deleted — save backup as .recovered, don't destroy it
159
+ mkdir -p "$(dirname "${orig}.recovered")"
160
+ mv "$bak" "${orig}.recovered"
161
+ rm -f "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
162
+ rmdir "$CACHE/${fid}.lock" 2>/dev/null
163
+ printf 'Warning: %s was moved/deleted. Recovered original to %s.recovered\n' "$orig" "$orig" >&2
164
+ fi
165
+ done
166
+ # Clean orphan locks (created but crash before backup)
167
+ for lockdir in "$CACHE"/*.lock; do
168
+ [ -d "$lockdir" ] || continue
169
+ rmdir "$lockdir" 2>/dev/null
170
+ done
171
+ exit 0
172
+ fi
173
+
174
+ [ -z "$FILE_PATH" ] && exit 0
175
+
176
+ # ── PreToolUse Read: filter in-place ──────────────────────────────────────────
177
+ if [ "$TOOL_NAME" = "Read" ]; then
178
+ [ -f "$FILE_PATH" ] || exit 0
179
+ case "$(basename "$FILE_PATH")" in simplify-ignore*|SIMPLIFY-IGNORE*) exit 0 ;; esac
180
+
181
+ mkdir -p "$CACHE"
182
+ ID=$(file_id "$FILE_PATH")
183
+
184
+ # If backup exists, file is already filtered — skip
185
+ [ -f "$CACHE/${ID}.bak" ] && exit 0
186
+
187
+ grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
188
+
189
+ # Atomic lock: mkdir fails if another session races us
190
+ if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
191
+ # Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
192
+ if [ ! -f "$CACHE/${ID}.bak" ] && \
193
+ [ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
194
+ rmdir "$CACHE/${ID}.lock" 2>/dev/null || true
195
+ mkdir "$CACHE/${ID}.lock" 2>/dev/null || exit 0
196
+ else
197
+ exit 0
198
+ fi
199
+ fi
200
+
201
+ # Back up the original (preserve trailing newline status)
202
+ cp -p "$FILE_PATH" "$CACHE/${ID}.bak" 2>/dev/null || cp "$FILE_PATH" "$CACHE/${ID}.bak"
203
+ printf '%s' "$FILE_PATH" > "$CACHE/${ID}.path"
204
+
205
+ # Filter in-place (cat > preserves inode and permissions)
206
+ FILTERED="$CACHE/${ID}.$$.tmp"
207
+ rm -f "$FILTERED"
208
+ if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
209
+ cat "$FILTERED" > "$FILE_PATH"
210
+ rm -f "$FILTERED"
211
+ else
212
+ rm -f "$FILTERED" "$CACHE/${ID}.bak" "$CACHE/${ID}.path"
213
+ rmdir "$CACHE/${ID}.lock" 2>/dev/null
214
+ fi
215
+ exit 0
216
+ fi
217
+
218
+ # ── PostToolUse Edit|Write: expand, then re-filter ────────────────────────────
219
+ if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
220
+ ID=$(file_id "$FILE_PATH")
221
+ [ -f "$CACHE/${ID}.bak" ] || exit 0
222
+ ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
223
+
224
+ # Expand placeholders, preserving any inline code the model added around them
225
+ EXPANDED="$CACHE/${ID}.$$.expanded"
226
+ rm -f "$EXPANDED"
227
+ while IFS= read -r line || [ -n "$line" ]; do
228
+ case "$line" in *BLOCK_*)
229
+ # Expand all placeholders on this line (supports multiple per line)
230
+ for bf in "$CACHE/${ID}".block.*; do
231
+ [ -f "$bf" ] || continue
232
+ h="${bf##*.}"
233
+ case "$line" in *"BLOCK_${h}"*)
234
+ # Reconstruct the exact placeholder pattern
235
+ bp=""; bs=""; br=""
236
+ [ -f "$CACHE/${ID}.prefix.${h}" ] && bp=$(cat "$CACHE/${ID}.prefix.${h}")
237
+ [ -f "$CACHE/${ID}.suffix.${h}" ] && bs=$(cat "$CACHE/${ID}.suffix.${h}")
238
+ [ -f "$CACHE/${ID}.reason.${h}" ] && br=$(cat "$CACHE/${ID}.reason.${h}")
239
+ if [ -n "$br" ]; then
240
+ placeholder="${bp}BLOCK_${h}: ${br}${bs}"
241
+ else
242
+ placeholder="${bp}BLOCK_${h}${bs}"
243
+ fi
244
+ block_content=$(cat "$bf"; printf x); block_content="${block_content%x}"
245
+ # Escape glob metacharacters (* ? [ \) in the pattern
246
+ esc_placeholder=$(escape_glob "$placeholder")
247
+ # Bash native substitution (// = global replace): replace placeholder, keep surrounding code
248
+ line="${line//$esc_placeholder/$block_content}"
249
+ # Fallback: if model altered the reason text, try without reason
250
+ # (only trigger if BLOCK_hash is still present AND wasn't in the original block content)
251
+ case "$block_content" in *"BLOCK_${h}"*) ;; *)
252
+ case "$line" in *"BLOCK_${h}"*)
253
+ printf 'Warning: placeholder BLOCK_%s was modified by model, using fuzzy match\n' "$h" >&2
254
+ esc_fuzzy=$(escape_glob "${bp}BLOCK_${h}${bs}")
255
+ line="${line//$esc_fuzzy/$block_content}"
256
+ # Last resort: match just the hash token
257
+ case "$line" in *"BLOCK_${h}"*)
258
+ line="${line//BLOCK_${h}/$block_content}"
259
+ ;; esac
260
+ ;; esac
261
+ ;; esac
262
+ ;; esac
263
+ done
264
+ ;; esac
265
+ printf '%s\n' "$line" >> "$EXPANDED"
266
+ done < "$FILE_PATH"
267
+ # Preserve trailing newline status
268
+ if [ -s "$EXPANDED" ] && [ -s "$FILE_PATH" ] && [ -n "$(tail -c 1 "$FILE_PATH")" ]; then
269
+ perl -pe 'chomp if eof' "$EXPANDED" > "${EXPANDED}.nnl" && \
270
+ cat "${EXPANDED}.nnl" > "$EXPANDED" && rm -f "${EXPANDED}.nnl"
271
+ fi
272
+ # Warn if model deleted a protected block entirely
273
+ for bf in "$CACHE/${ID}".block.*; do
274
+ [ -f "$bf" ] || continue
275
+ bh="${bf##*.}"
276
+ # After expansion, blocks appear as original code (simplify-ignore-start).
277
+ # If neither the expanded code nor the placeholder is in EXPANDED, it was deleted.
278
+ if ! grep -qF "BLOCK_${bh}" "$EXPANDED" 2>/dev/null; then
279
+ # Get first line of block to check if it was expanded back
280
+ first_line=$(head -1 "$bf")
281
+ if ! grep -qF "$first_line" "$EXPANDED" 2>/dev/null; then
282
+ printf 'Warning: protected block BLOCK_%s was deleted by model\n' "$bh" >&2
283
+ fi
284
+ fi
285
+ done
286
+ # Preserve inode and permissions
287
+ cat "$EXPANDED" > "$FILE_PATH"
288
+ rm -f "$EXPANDED"
289
+
290
+ # Save expanded version as new backup (this is the "real" file with model's changes)
291
+ cp "$FILE_PATH" "$CACHE/${ID}.bak"
292
+
293
+ # Re-filter in-place so the file on disk stays with placeholders
294
+ FILTERED="$CACHE/${ID}.$$.tmp"
295
+ rm -f "$FILTERED"
296
+ if filter_file "$FILE_PATH" "$FILTERED" "$ID"; then
297
+ cat "$FILTERED" > "$FILE_PATH"
298
+ rm -f "$FILTERED"
299
+ fi
300
+
301
+ exit 0
302
+ fi
@@ -0,0 +1,143 @@
1
+ # Justfile — pi extension harnesses
2
+ #
3
+ # Recipes to launch pi with the harness extensions under .pi/harnesses/.
4
+ # Ported and adapted from disler/pi-vs-claude-code (MIT) — https://github.com/disler/pi-vs-claude-code
5
+ # See docs/pi-extensions.md for the full catalog and the selective-load model.
6
+ #
7
+ # Why .pi/harnesses/ and not .pi/extensions/: pi auto-discovers EVERY directory
8
+ # under .pi/extensions/, so anything placed there loads on every plain `pi` run.
9
+ # Most harnesses are mutually exclusive — they live in .pi/harnesses/ (which pi
10
+ # does NOT auto-discover) and are loaded via `pi -e` below. The supported stack
11
+ # is a damage-control variant before agent-hub (damage-control-continue for the main
12
+ # session), so the hub recipes run with guardrails by default.
13
+ #
14
+ # Everything between the two `agent-fleet:harnesses` sentinels below is a
15
+ # MANAGED REGION: guided-workspace-setup regenerates it from the installed
16
+ # package whenever pi harnesses are installed, refreshed, or retired — so edits
17
+ # inside it are overwritten on upgrade. Put your own recipes OUTSIDE the
18
+ # sentinels (above the opening marker or below the closing one) to keep them.
19
+
20
+ # >>> agent-fleet:harnesses — managed region (regenerated on upgrade; edits inside are overwritten) >>>
21
+ set dotenv-load := true
22
+
23
+ # List all recipes
24
+ default:
25
+ @just --list
26
+
27
+ # ---------------------------------------------------------------- setup
28
+
29
+ # Install the shared runtime dependencies for the pi extensions + harnesses
30
+ install:
31
+ npm install --prefix .pi/extensions
32
+ npm install --prefix .pi/harnesses
33
+
34
+ # Default pi — only the always-on utilities auto-load, no harness
35
+ pi:
36
+ pi
37
+
38
+ # ---------------------------------------------------------------- safety
39
+
40
+ # Damage-control: block destructive tool calls (aborts the turn)
41
+ ext-damage-control:
42
+ pi -e .pi/harnesses/damage-control/index.ts
43
+
44
+ # Damage-control (continue): same rules, but blocks deliver feedback so the agent adapts
45
+ # and keeps working instead of aborting the turn. Default guardrail for the hub main agent.
46
+ ext-damage-control-continue:
47
+ pi -e .pi/harnesses/damage-control-continue/index.ts
48
+
49
+ # ---------------------------------------------------------------- orchestration
50
+
51
+ # Accepts coms identity flags: --name --purpose --project --color --explicit.
52
+ # Loads the orchestrator persona by default (the Verification-Contract dispatcher that owns
53
+ # the acceptance assertions — see skills/orchestration-verification); it is appended only if
54
+ # agents/orchestrator.md is installed, so the hub still launches when it is absent. Override
55
+ # with your own --system-prompt <persona>.md passed after `just hub`.
56
+ # Guarded agent hub: damage-control-continue + remote-capable ask_user + dispatcher grid + research helpers + embedded coms + orchestrator.
57
+ # The main session loads the CONTINUE guardrail (blocks feed back so the dispatcher adapts and keeps going);
58
+ # spawned specialists still inherit the hard-stop damage-control variant (research helpers inherit continue).
59
+ hub *args:
60
+ persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts $persona {{args}}
61
+
62
+ # Agent hub (solo): guarded hub without the coms layer — fixed specialists + research only.
63
+ # Same orchestrator-persona default, remote-capable ask_user, and continue-guardrail main session as `just hub`.
64
+ hub-solo *args:
65
+ persona=""; if [ -f agents/orchestrator.md ]; then persona="--append-system-prompt agents/orchestrator.md"; fi; pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/ask-user-remote/index.ts -e .pi/harnesses/agent-hub/index.ts --solo $persona {{args}}
66
+
67
+ # Internal helper for team-up: launch a reusable coms peer (coms + compact-and-continue + a persona).
68
+ # Prints a colored identity banner (peer name + persona purpose) before pi starts,
69
+ # so every pane announces who lives in it — works in any terminal, herdr or not.
70
+ # Hidden from `just --list` because recipes prefixed with `_` are private.
71
+ _peer persona name="" model="" session="" project="default":
72
+ node --experimental-strip-types scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
73
+
74
+ # Like _peer, but also loads extra always-on extensions (comma-separated names under
75
+ # .pi/extensions/) into the peer process — e.g. a chrome-devtools-mcp browser-debug peer
76
+ # whose `chrome_devtools__*` tools a normal --no-extensions subagent could not get.
77
+ _peer-plus extensions persona name="" model="" session="" project="default":
78
+ node --experimental-strip-types scripts/peer-banner.ts {{persona}} {{name}} 2>/dev/null || true; persona_path="agents/{{persona}}.md"; if [ ! -f "$persona_path" ]; then persona_path=".pi/agents/{{persona}}.md"; fi; extra=""; old_ifs="$IFS"; IFS=','; for x in {{extensions}}; do x="$(echo "$x" | xargs)"; if [ -n "$x" ]; then extra="$extra -e .pi/extensions/$x/index.ts"; fi; done; IFS="$old_ifs"; pi -e .pi/harnesses/coms/index.ts -e .pi/extensions/compact-and-continue/index.ts $extra --project {{project}} --append-system-prompt "$persona_path" {{ if name != "" { "--name " + name } else { "" } }} {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--session " + session } else { "" } }}
79
+
80
+ # Internal helper for team-up: a `runner: claude-code` peer — interactive
81
+ # Claude Code plus its coms bridge (scripts/coms-claude-bridge.ts) in ONE pane.
82
+ # The bridge registers the pane as coms peer <name>; the trailing session
83
+ # positional maps to `claude --resume <id>` for team-resume.
84
+ _claude-peer name model="" session="" project="default":
85
+ node --experimental-strip-types scripts/coms-claude-bridge.ts --name {{name}} --project {{project}} & bridge_pid=$!; trap 'kill $bridge_pid 2>/dev/null' EXIT; claude {{ if model != "" { "--model " + model } else { "" } }} {{ if session != "" { "--resume " + session } else { "" } }}
86
+
87
+ # Team up: spawn every peer of a team from .pi/agents/peers.yaml into a herdr
88
+ # workspace (one tiled pane per peer). Requires a running herdr server.
89
+ # Positional arg: team (defaults to "full"). e.g. just team-up full
90
+ team-up team="full" *args:
91
+ node --experimental-strip-types scripts/team-up.ts --team {{team}} {{args}}
92
+
93
+ # Team up (dry run): print the resolved layout + per-peer commands without touching herdr.
94
+ # e.g. just team-up-dry team="full"
95
+ team-up-dry team="full" *args:
96
+ node --experimental-strip-types scripts/team-up.ts --team {{team}} --dry-run {{args}}
97
+
98
+ # Hub + team in ONE herdr workspace: the guarded hub (`just hub`) in a larger
99
+ # main pane, the team's peers tiled beside it. e.g. just hub-team docs
100
+ hub-team team="full" *args:
101
+ node --experimental-strip-types scripts/team-up.ts --team {{team}} --hub {{args}}
102
+
103
+ # Hub + team (dry run): print the combined layout without touching herdr.
104
+ hub-team-dry team="full" *args:
105
+ node --experimental-strip-types scripts/team-up.ts --team {{team}} --hub --dry-run {{args}}
106
+
107
+ # Hermes conductor + team in ONE herdr workspace: Hermes dev profile in a conductor pane,
108
+ # the team's peers tiled beside it. Hermes delegates via coms-cli and never drives herdr.
109
+ conductor team="full" *args:
110
+ node --experimental-strip-types scripts/team-up.ts --team {{team}} --conductor {{args}}
111
+
112
+ # Hermes conductor + team (dry run): print the combined layout without touching herdr.
113
+ conductor-dry team="full" *args:
114
+ node --experimental-strip-types scripts/team-up.ts --team {{team}} --conductor --dry-run {{args}}
115
+
116
+ # Snapshot a RUNNING team's session refs to ~/.pi/team-snapshots/<team>.json
117
+ # (team keeps running — take one proactively so a crash is resumable).
118
+ team-snapshot team="full" *args:
119
+ node --experimental-strip-types scripts/team-snapshot.ts snapshot {{team}} {{args}}
120
+
121
+ # Snapshot, then close the team workspace cleanly (peers get SIGTERM).
122
+ team-down team="full" *args:
123
+ node --experimental-strip-types scripts/team-snapshot.ts down {{team}} {{args}}
124
+
125
+ # Rebuild a team from its snapshot — each pi peer resumes its previous
126
+ # conversation (`pi --session <ref>`); peers whose ref is gone start fresh.
127
+ team-resume team="full" *args:
128
+ node --experimental-strip-types scripts/team-snapshot.ts resume {{team}} {{args}}
129
+
130
+ # ---------------------------------------------------------------- coms (Pi-to-Pi messaging)
131
+
132
+ # Safe coms: a FULL pi (all auto-discovered local .pi/extensions/ + global extensions and
133
+ # commands) plus damage-control-continue guardrails and the coms peer layer, under a chosen name.
134
+ # Unlike `just hub`, this does NOT pass --no-extensions, so every local-only extension (MCP
135
+ # bridges like chrome-devtools-mcp, project-specific extensions, …) loads into THIS process.
136
+ # Use it as the agent-hub dispatcher/orchestrator peer that needs those local tools: spawned
137
+ # specialists run --no-extensions, so the tools stay scoped here and never leak into subagents.
138
+ # The required `name` becomes this peer's coms identity (--name), so it is discoverable
139
+ # under exactly that name to other coms peers in the project pool.
140
+ # e.g. just safe-coms orchestrator --project proj
141
+ safe-coms name *args:
142
+ pi -e .pi/harnesses/damage-control-continue/index.ts -e .pi/harnesses/coms/index.ts --name {{name}} {{args}}
143
+ # <<< agent-fleet:harnesses <<<
@@ -0,0 +1,160 @@
1
+ # Accessibility Checklist
2
+
3
+ Quick reference for WCAG 2.1 AA compliance. Use alongside the `frontend-ui-engineering` skill.
4
+
5
+ ## Table of Contents
6
+
7
+ - [Essential Checks](#essential-checks)
8
+ - [Common HTML Patterns](#common-html-patterns)
9
+ - [Testing Tools](#testing-tools)
10
+ - [Quick Reference: ARIA Live Regions](#quick-reference-aria-live-regions)
11
+ - [Common Anti-Patterns](#common-anti-patterns)
12
+
13
+ ## Essential Checks
14
+
15
+ ### Keyboard Navigation
16
+ - [ ] All interactive elements focusable via Tab key
17
+ - [ ] Focus order follows visual/logical order
18
+ - [ ] Focus is visible (outline/ring on focused elements)
19
+ - [ ] Custom widgets have keyboard support (Enter to activate, Escape to close)
20
+ - [ ] No keyboard traps (user can always Tab away from a component)
21
+ - [ ] Skip-to-content link at top of page - visible (at least) on keyboard focus
22
+ - [ ] Modals trap focus while open, return focus on close
23
+
24
+ ### Screen Readers
25
+ - [ ] All images have `alt` text (or `alt=""` for decorative images)
26
+ - [ ] All form inputs have associated labels (`<label>` or `aria-label`)
27
+ - [ ] Buttons and links have descriptive text (not "Click here")
28
+ - [ ] Icon-only buttons have `aria-label`
29
+ - [ ] Page has one `<h1>` and headings don't skip levels
30
+ - [ ] Dynamic content changes announced (`aria-live` regions)
31
+ - [ ] Tables have `<th>` headers with scope
32
+
33
+ ### Visual
34
+ - [ ] Text contrast ≥ 4.5:1 (normal text) or ≥ 3:1 (large text, 18px+)
35
+ - [ ] UI components contrast ≥ 3:1 against background
36
+ - [ ] Color is not the only way to convey information
37
+ - [ ] Text resizable to 200% without breaking layout
38
+ - [ ] No content that flashes more than 3 times per second
39
+
40
+ ### Forms
41
+ - [ ] Every input has a visible label
42
+ - [ ] Required fields indicated (not by color alone)
43
+ - [ ] Error messages specific and associated with the field
44
+ - [ ] Error state visible by more than color (icon, text, border)
45
+ - [ ] Form submission errors summarized and focusable
46
+ - [ ] Known fields use autocomplete (for example `type="email" autocomplete="email"`)
47
+
48
+ ### Content
49
+ - [ ] Language declared (`<html lang="en">`)
50
+ - [ ] Page has a descriptive `<title>`
51
+ - [ ] Links distinguish from surrounding text (not by color alone)
52
+ - [ ] Touch targets ≥ 44x44px on mobile
53
+ - [ ] Meaningful empty states (not blank screens)
54
+
55
+ ## Common HTML Patterns
56
+
57
+ ### Buttons vs. Links
58
+
59
+ ```html
60
+ <!-- Use <button> for actions -->
61
+ <button onClick={handleDelete}>Delete Task</button>
62
+
63
+ <!-- Use <a> for navigation -->
64
+ <a href="/tasks/123">View Task</a>
65
+
66
+ <!-- NEVER use div/span as buttons -->
67
+ <div onClick={handleDelete}>Delete</div> <!-- BAD -->
68
+ ```
69
+
70
+ ### Form Labels
71
+
72
+ ```html
73
+ <!-- Explicit label association -->
74
+ <label htmlFor="email">Email address</label>
75
+ <input id="email" type="email" required />
76
+
77
+ <!-- Implicit wrapping -->
78
+ <label>
79
+ Email address
80
+ <input type="email" required />
81
+ </label>
82
+
83
+ <!-- Hidden label (visible label preferred) -->
84
+ <input type="search" aria-label="Search tasks" />
85
+ ```
86
+
87
+ ### ARIA Roles
88
+
89
+ ```html
90
+ <!-- Navigation -->
91
+ <nav aria-label="Main navigation">...</nav>
92
+ <nav aria-label="Footer links">...</nav>
93
+
94
+ <!-- Status messages -->
95
+ <div role="status" aria-live="polite">Task saved</div>
96
+
97
+ <!-- Alert messages -->
98
+ <div role="alert">Error: Title is required</div>
99
+
100
+ <!-- Modal dialogs -->
101
+ <dialog aria-modal="true" aria-labelledby="dialog-title">
102
+ <h2 id="dialog-title">Confirm Delete</h2>
103
+ ...
104
+ </dialog>
105
+
106
+ <!-- Loading states -->
107
+ <div aria-busy="true" aria-label="Loading tasks">
108
+ <Spinner />
109
+ </div>
110
+ ```
111
+
112
+ ### Accessible Lists
113
+
114
+ ```html
115
+ <ul role="list" aria-label="Tasks">
116
+ <li>
117
+ <input type="checkbox" id="task-1" aria-label="Complete: Buy groceries" />
118
+ <label htmlFor="task-1">Buy groceries</label>
119
+ </li>
120
+ </ul>
121
+ ```
122
+
123
+ ## Testing Tools
124
+
125
+ ```bash
126
+ # Automated audit
127
+ npx axe-core # Programmatic accessibility testing
128
+ npx pa11y # CLI accessibility checker
129
+
130
+ # In browser
131
+ # Chrome DevTools → Lighthouse → Accessibility
132
+ # Chrome DevTools → Elements → Accessibility tree
133
+
134
+ # Screen reader testing
135
+ # macOS: VoiceOver (Cmd + F5)
136
+ # Windows: NVDA (free) or JAWS
137
+ # Linux: Orca
138
+ ```
139
+
140
+ ## Quick Reference: ARIA Live Regions
141
+
142
+ | Value | Behavior | Use For |
143
+ |-------|----------|---------|
144
+ | `aria-live="polite"` | Announced at next pause | Status updates, saved confirmations |
145
+ | `aria-live="assertive"` | Announced immediately | Errors, time-sensitive alerts |
146
+ | `role="status"` | Same as `polite` | Status messages |
147
+ | `role="alert"` | Same as `assertive` | Error messages |
148
+
149
+ ## Common Anti-Patterns
150
+
151
+ | Anti-Pattern | Problem | Fix |
152
+ |---|---|---|
153
+ | `div` as button | Not focusable, no keyboard support | Use `<button>` |
154
+ | Missing `alt` text | Images invisible to screen readers | Add descriptive `alt` |
155
+ | Color-only states | Invisible to color-blind users | Add icons, text, or patterns |
156
+ | Autoplaying media | Disorienting, can't be stopped | Add controls, don't autoplay |
157
+ | Custom dropdown with no ARIA | Unusable by keyboard/screen reader | Use native `<select>` or proper ARIA listbox |
158
+ | Removing focus outlines | Users can't see where they are | Style outlines, don't remove them |
159
+ | Empty links/buttons | "Link" announced with no description | Add text or `aria-label` |
160
+ | `tabindex > 0` | Breaks natural tab order | Use `tabindex="0"` or `-1` only |
@@ -0,0 +1,67 @@
1
+ # Definition of Done
2
+
3
+ A standing, project-wide bar that every change must clear before it counts as done. Unlike acceptance criteria, which vary per task and answer "did we build the right thing?", the Definition of Done is the same every time and answers "is this finished to our standard?". Use it as the final gate in `planning-and-task-breakdown`, `incremental-implementation`, and `shipping-and-launch`.
4
+
5
+ ## Definition of Done vs. Acceptance Criteria
6
+
7
+ | | Acceptance Criteria | Definition of Done |
8
+ |---|---|---|
9
+ | Scope | Specific to one task or spec | Applies to every increment |
10
+ | Changes | Different for each item | Fixed and reused |
11
+ | Answers | "Did we build *this thing*?" | "Is it *ready*?" |
12
+ | Owner | Defined when planning the task | Defined once for the project |
13
+ | Example | "User can reset password via email link" | "Tests pass, no regressions, docs updated" |
14
+
15
+ The two are complementary. A task is done only when **its** acceptance criteria are met **and** the standing Definition of Done is satisfied. Skipping either leaves work that looks finished but is not.
16
+
17
+ ## The Standing Checklist
18
+
19
+ Apply this to every change before declaring it done.
20
+
21
+ ### Correctness
22
+ - [ ] All acceptance criteria for the task are met
23
+ - [ ] Code runs and behaves as intended, verified at runtime, not just compiled or typechecked
24
+ - [ ] New behavior is covered by tests that fail without the change and pass with it
25
+ - [ ] Existing tests still pass; no regressions introduced
26
+ - [ ] Edge cases and error paths are handled, not just the happy path
27
+
28
+ ### Quality
29
+ - [ ] Code reveals intent through naming and structure; no comments needed to explain *what* it does
30
+ - [ ] No duplicated business logic
31
+ - [ ] No dead code, debug output, or commented-out blocks left behind
32
+ - [ ] Changes are scoped to the task; no unrelated refactors snuck in
33
+ - [ ] Linting and formatting pass
34
+
35
+ The depth behind these items lives in `code-review-and-quality` (the five-axis review) and `code-simplification` (reducing complexity without changing behavior).
36
+
37
+ ### Integration
38
+ - [ ] Change works with the rest of the system, not just in isolation
39
+ - [ ] Database migrations, config changes, and feature flags are accounted for
40
+ - [ ] Backward compatibility considered for any public interface or API change
41
+
42
+ ### Documentation
43
+ - [ ] Public interfaces, APIs, and user-facing behavior are documented
44
+ - [ ] Architectural decisions worth preserving are recorded (see `documentation-and-adrs`)
45
+ - [ ] Documentation describes the current state in timeless language, not the change history
46
+
47
+ ### Ship-readiness
48
+ - [ ] Security implications reviewed for any untrusted input, auth, or data handling (see `security-and-hardening`)
49
+ - [ ] Observability in place for new critical paths (logs, metrics, traces) (see `observability-and-instrumentation`)
50
+ - [ ] Rollback path exists for anything risky (see `shipping-and-launch`)
51
+ - [ ] The human has reviewed and approved before merge or deploy
52
+
53
+ ## How to Apply
54
+
55
+ - **Per task**: confirm the Correctness and Quality sections before checking the task off.
56
+ - **Per feature**: confirm Integration and Documentation before considering the feature complete.
57
+ - **Per release**: the full checklist is the floor; `shipping-and-launch` adds the deploy-specific gates on top.
58
+
59
+ Tailor the list to the project once, then reuse it unchanged. A Definition of Done that is renegotiated every sprint is not a Definition of Done.
60
+
61
+ ## Red Flags
62
+
63
+ - "It's done, I just haven't run it yet": unverified work is not done.
64
+ - "Tests pass" used as a synonym for done while docs, regressions, or runtime verification are skipped.
65
+ - A different bar applied depending on deadline pressure.
66
+ - Acceptance criteria treated as the whole bar, with no standing quality floor.
67
+ - "Done" declared before human review on changes that need it.