@lvlup-sw/exarchos 2.5.0 → 2.6.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 (554) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/AGENTS.md +1 -1
  3. package/README.md +24 -1
  4. package/commands/dogfood.md +31 -0
  5. package/commands/oneshot.md +178 -0
  6. package/commands/prune.md +90 -0
  7. package/dist/exarchos.js +286 -280
  8. package/package.json +7 -3
  9. package/skills/{cleanup → claude/cleanup}/SKILL.md +6 -0
  10. package/skills/{delegation → claude/delegation}/SKILL.md +50 -29
  11. package/skills/{delegation → claude/delegation}/references/troubleshooting.md +2 -2
  12. package/skills/claude/dogfood/SKILL.md +235 -0
  13. package/skills/claude/dogfood/references/report-template.md +109 -0
  14. package/skills/claude/dogfood/references/root-cause-patterns.md +227 -0
  15. package/skills/claude/oneshot-workflow/SKILL.md +468 -0
  16. package/skills/claude/oneshot-workflow/references/choice-state.md +65 -0
  17. package/skills/claude/prune-workflows/SKILL.md +290 -0
  18. package/skills/claude/prune-workflows/references/safeguards.md +74 -0
  19. package/skills/{quality-review → claude/quality-review}/SKILL.md +2 -0
  20. package/skills/{shepherd → claude/shepherd}/SKILL.md +4 -0
  21. package/skills/{spec-review → claude/spec-review}/SKILL.md +2 -0
  22. package/skills/{synthesis → claude/synthesis}/SKILL.md +40 -0
  23. package/skills/{workflow-state → claude/workflow-state}/SKILL.md +40 -4
  24. package/skills/{workflow-state → claude/workflow-state}/references/phase-transitions.md +22 -0
  25. package/skills/codex/brainstorming/SKILL.md +182 -0
  26. package/skills/codex/brainstorming/references/design-template.md +107 -0
  27. package/skills/codex/brainstorming/references/worked-example.md +58 -0
  28. package/skills/codex/cleanup/SKILL.md +169 -0
  29. package/skills/codex/cleanup/references/merge-verification.md +40 -0
  30. package/skills/codex/debug/SKILL.md +247 -0
  31. package/skills/codex/debug/references/hotfix-track.md +105 -0
  32. package/skills/codex/debug/references/investigation-checklist.md +217 -0
  33. package/skills/codex/debug/references/rca-template.md +150 -0
  34. package/skills/codex/debug/references/state-schema.md +294 -0
  35. package/skills/codex/debug/references/thorough-track.md +171 -0
  36. package/skills/codex/debug/references/triage-questions.md +155 -0
  37. package/skills/codex/debug/references/troubleshooting.md +47 -0
  38. package/skills/codex/delegation/SKILL.md +353 -0
  39. package/skills/codex/delegation/references/adaptive-orchestration.md +31 -0
  40. package/skills/codex/delegation/references/agent-teams-saga.md +254 -0
  41. package/skills/codex/delegation/references/fix-mode.md +118 -0
  42. package/skills/codex/delegation/references/fixer-prompt.md +174 -0
  43. package/skills/codex/delegation/references/implementer-prompt.md +401 -0
  44. package/skills/codex/delegation/references/parallel-strategy.md +124 -0
  45. package/skills/codex/delegation/references/pbt-patterns.md +172 -0
  46. package/skills/codex/delegation/references/pr-fixes-mode.md +155 -0
  47. package/skills/codex/delegation/references/rationalization-refutation.md +15 -0
  48. package/skills/codex/delegation/references/state-management.md +84 -0
  49. package/skills/codex/delegation/references/testing-patterns.md +146 -0
  50. package/skills/codex/delegation/references/troubleshooting.md +109 -0
  51. package/skills/codex/delegation/references/worked-example.md +104 -0
  52. package/skills/codex/delegation/references/workflow-steps.md +131 -0
  53. package/skills/codex/delegation/references/worktree-enforcement.md +71 -0
  54. package/skills/codex/dogfood/SKILL.md +235 -0
  55. package/skills/codex/dogfood/references/report-template.md +109 -0
  56. package/skills/codex/dogfood/references/root-cause-patterns.md +227 -0
  57. package/skills/codex/git-worktrees/SKILL.md +193 -0
  58. package/skills/codex/git-worktrees/references/commands-reference.md +78 -0
  59. package/skills/codex/implementation-planning/SKILL.md +289 -0
  60. package/skills/codex/implementation-planning/references/plan-document-template.md +42 -0
  61. package/skills/codex/implementation-planning/references/rationalization-refutation.md +13 -0
  62. package/skills/codex/implementation-planning/references/spec-tracing-guide.md +51 -0
  63. package/skills/codex/implementation-planning/references/task-template.md +63 -0
  64. package/skills/codex/implementation-planning/references/testing-strategy-guide.md +109 -0
  65. package/skills/codex/implementation-planning/references/worked-example.md +76 -0
  66. package/skills/codex/oneshot-workflow/SKILL.md +468 -0
  67. package/skills/codex/oneshot-workflow/references/choice-state.md +65 -0
  68. package/skills/codex/prune-workflows/SKILL.md +290 -0
  69. package/skills/codex/prune-workflows/references/safeguards.md +74 -0
  70. package/skills/codex/quality-review/SKILL.md +371 -0
  71. package/skills/codex/quality-review/references/auto-transition.md +47 -0
  72. package/skills/codex/quality-review/references/axiom-integration.md +135 -0
  73. package/skills/codex/quality-review/references/code-quality-checklist.md +171 -0
  74. package/skills/codex/quality-review/references/convergence-and-verdict.md +48 -0
  75. package/skills/codex/quality-review/references/gate-execution.md +60 -0
  76. package/skills/codex/quality-review/references/rationalization-refutation.md +13 -0
  77. package/skills/codex/quality-review/references/review-report-template.md +65 -0
  78. package/skills/codex/quality-review/references/security-checklist.md +79 -0
  79. package/skills/codex/quality-review/references/typescript-standards.md +24 -0
  80. package/skills/codex/refactor/SKILL.md +196 -0
  81. package/skills/codex/refactor/references/brief-template.md +81 -0
  82. package/skills/codex/refactor/references/doc-update-checklist.md +113 -0
  83. package/skills/codex/refactor/references/explore-checklist.md +79 -0
  84. package/skills/codex/refactor/references/overhaul-track.md +194 -0
  85. package/skills/codex/refactor/references/phases/auto-chain.md +267 -0
  86. package/skills/codex/refactor/references/phases/brief.md +176 -0
  87. package/skills/codex/refactor/references/phases/explore.md +132 -0
  88. package/skills/codex/refactor/references/phases/overhaul-delegate.md +136 -0
  89. package/skills/codex/refactor/references/phases/overhaul-plan.md +312 -0
  90. package/skills/codex/refactor/references/phases/overhaul-review.md +304 -0
  91. package/skills/codex/refactor/references/phases/polish-implement.md +347 -0
  92. package/skills/codex/refactor/references/phases/polish-validate.md +218 -0
  93. package/skills/codex/refactor/references/phases/update-docs.md +234 -0
  94. package/skills/codex/refactor/references/polish-track.md +152 -0
  95. package/skills/codex/shepherd/SKILL.md +251 -0
  96. package/skills/codex/shepherd/references/assess-checklist.md +170 -0
  97. package/skills/codex/shepherd/references/escalation-criteria.md +53 -0
  98. package/skills/codex/shepherd/references/fix-strategies.md +289 -0
  99. package/skills/codex/shepherd/references/gate-event-emission.md +47 -0
  100. package/skills/codex/shepherd/references/shepherd-event-schemas.md +56 -0
  101. package/skills/codex/spec-review/SKILL.md +294 -0
  102. package/skills/codex/spec-review/references/rationalization-refutation.md +13 -0
  103. package/skills/codex/spec-review/references/review-checklist.md +79 -0
  104. package/skills/codex/spec-review/references/worked-example.md +72 -0
  105. package/skills/codex/synthesis/SKILL.md +217 -0
  106. package/skills/codex/synthesis/references/github-native-stacking.md +135 -0
  107. package/skills/codex/synthesis/references/merge-ordering.md +50 -0
  108. package/skills/codex/synthesis/references/pr-descriptions.md +87 -0
  109. package/skills/codex/synthesis/references/synthesis-steps.md +145 -0
  110. package/skills/codex/synthesis/references/troubleshooting.md +115 -0
  111. package/skills/codex/workflow-state/SKILL.md +254 -0
  112. package/skills/codex/workflow-state/references/mcp-tool-reference.md +89 -0
  113. package/skills/codex/workflow-state/references/phase-transitions.md +206 -0
  114. package/skills/copilot/brainstorming/SKILL.md +182 -0
  115. package/skills/copilot/brainstorming/references/design-template.md +107 -0
  116. package/skills/copilot/brainstorming/references/worked-example.md +58 -0
  117. package/skills/copilot/cleanup/SKILL.md +169 -0
  118. package/skills/copilot/cleanup/references/merge-verification.md +40 -0
  119. package/skills/copilot/debug/SKILL.md +247 -0
  120. package/skills/copilot/debug/references/hotfix-track.md +105 -0
  121. package/skills/copilot/debug/references/investigation-checklist.md +217 -0
  122. package/skills/copilot/debug/references/rca-template.md +150 -0
  123. package/skills/copilot/debug/references/state-schema.md +294 -0
  124. package/skills/copilot/debug/references/thorough-track.md +171 -0
  125. package/skills/copilot/debug/references/triage-questions.md +155 -0
  126. package/skills/copilot/debug/references/troubleshooting.md +47 -0
  127. package/skills/copilot/delegation/SKILL.md +345 -0
  128. package/skills/copilot/delegation/references/adaptive-orchestration.md +31 -0
  129. package/skills/copilot/delegation/references/agent-teams-saga.md +254 -0
  130. package/skills/copilot/delegation/references/fix-mode.md +118 -0
  131. package/skills/copilot/delegation/references/fixer-prompt.md +174 -0
  132. package/skills/copilot/delegation/references/implementer-prompt.md +401 -0
  133. package/skills/copilot/delegation/references/parallel-strategy.md +124 -0
  134. package/skills/copilot/delegation/references/pbt-patterns.md +172 -0
  135. package/skills/copilot/delegation/references/pr-fixes-mode.md +155 -0
  136. package/skills/copilot/delegation/references/rationalization-refutation.md +15 -0
  137. package/skills/copilot/delegation/references/state-management.md +84 -0
  138. package/skills/copilot/delegation/references/testing-patterns.md +146 -0
  139. package/skills/copilot/delegation/references/troubleshooting.md +109 -0
  140. package/skills/copilot/delegation/references/worked-example.md +104 -0
  141. package/skills/copilot/delegation/references/workflow-steps.md +131 -0
  142. package/skills/copilot/delegation/references/worktree-enforcement.md +71 -0
  143. package/skills/copilot/dogfood/SKILL.md +235 -0
  144. package/skills/copilot/dogfood/references/report-template.md +109 -0
  145. package/skills/copilot/dogfood/references/root-cause-patterns.md +227 -0
  146. package/skills/copilot/git-worktrees/SKILL.md +193 -0
  147. package/skills/copilot/git-worktrees/references/commands-reference.md +78 -0
  148. package/skills/copilot/implementation-planning/SKILL.md +289 -0
  149. package/skills/copilot/implementation-planning/references/plan-document-template.md +42 -0
  150. package/skills/copilot/implementation-planning/references/rationalization-refutation.md +13 -0
  151. package/skills/copilot/implementation-planning/references/spec-tracing-guide.md +51 -0
  152. package/skills/copilot/implementation-planning/references/task-template.md +63 -0
  153. package/skills/copilot/implementation-planning/references/testing-strategy-guide.md +109 -0
  154. package/skills/copilot/implementation-planning/references/worked-example.md +76 -0
  155. package/skills/copilot/oneshot-workflow/SKILL.md +468 -0
  156. package/skills/copilot/oneshot-workflow/references/choice-state.md +65 -0
  157. package/skills/copilot/prune-workflows/SKILL.md +290 -0
  158. package/skills/copilot/prune-workflows/references/safeguards.md +74 -0
  159. package/skills/copilot/quality-review/SKILL.md +371 -0
  160. package/skills/copilot/quality-review/references/auto-transition.md +47 -0
  161. package/skills/copilot/quality-review/references/axiom-integration.md +135 -0
  162. package/skills/copilot/quality-review/references/code-quality-checklist.md +171 -0
  163. package/skills/copilot/quality-review/references/convergence-and-verdict.md +48 -0
  164. package/skills/copilot/quality-review/references/gate-execution.md +60 -0
  165. package/skills/copilot/quality-review/references/rationalization-refutation.md +13 -0
  166. package/skills/copilot/quality-review/references/review-report-template.md +65 -0
  167. package/skills/copilot/quality-review/references/security-checklist.md +79 -0
  168. package/skills/copilot/quality-review/references/typescript-standards.md +24 -0
  169. package/skills/copilot/refactor/SKILL.md +196 -0
  170. package/skills/copilot/refactor/references/brief-template.md +81 -0
  171. package/skills/copilot/refactor/references/doc-update-checklist.md +113 -0
  172. package/skills/copilot/refactor/references/explore-checklist.md +79 -0
  173. package/skills/copilot/refactor/references/overhaul-track.md +194 -0
  174. package/skills/copilot/refactor/references/phases/auto-chain.md +267 -0
  175. package/skills/copilot/refactor/references/phases/brief.md +176 -0
  176. package/skills/copilot/refactor/references/phases/explore.md +132 -0
  177. package/skills/copilot/refactor/references/phases/overhaul-delegate.md +136 -0
  178. package/skills/copilot/refactor/references/phases/overhaul-plan.md +312 -0
  179. package/skills/copilot/refactor/references/phases/overhaul-review.md +304 -0
  180. package/skills/copilot/refactor/references/phases/polish-implement.md +347 -0
  181. package/skills/copilot/refactor/references/phases/polish-validate.md +218 -0
  182. package/skills/copilot/refactor/references/phases/update-docs.md +234 -0
  183. package/skills/copilot/refactor/references/polish-track.md +152 -0
  184. package/skills/copilot/shepherd/SKILL.md +251 -0
  185. package/skills/copilot/shepherd/references/assess-checklist.md +170 -0
  186. package/skills/copilot/shepherd/references/escalation-criteria.md +53 -0
  187. package/skills/copilot/shepherd/references/fix-strategies.md +289 -0
  188. package/skills/copilot/shepherd/references/gate-event-emission.md +47 -0
  189. package/skills/copilot/shepherd/references/shepherd-event-schemas.md +56 -0
  190. package/skills/copilot/spec-review/SKILL.md +294 -0
  191. package/skills/copilot/spec-review/references/rationalization-refutation.md +13 -0
  192. package/skills/copilot/spec-review/references/review-checklist.md +79 -0
  193. package/skills/copilot/spec-review/references/worked-example.md +72 -0
  194. package/skills/copilot/synthesis/SKILL.md +217 -0
  195. package/skills/copilot/synthesis/references/github-native-stacking.md +135 -0
  196. package/skills/copilot/synthesis/references/merge-ordering.md +50 -0
  197. package/skills/copilot/synthesis/references/pr-descriptions.md +87 -0
  198. package/skills/copilot/synthesis/references/synthesis-steps.md +145 -0
  199. package/skills/copilot/synthesis/references/troubleshooting.md +115 -0
  200. package/skills/copilot/workflow-state/SKILL.md +254 -0
  201. package/skills/copilot/workflow-state/references/mcp-tool-reference.md +89 -0
  202. package/skills/copilot/workflow-state/references/phase-transitions.md +206 -0
  203. package/skills/cursor/brainstorming/SKILL.md +182 -0
  204. package/skills/cursor/brainstorming/references/design-template.md +107 -0
  205. package/skills/cursor/brainstorming/references/worked-example.md +58 -0
  206. package/skills/cursor/cleanup/SKILL.md +169 -0
  207. package/skills/cursor/cleanup/references/merge-verification.md +40 -0
  208. package/skills/cursor/debug/SKILL.md +247 -0
  209. package/skills/cursor/debug/references/hotfix-track.md +105 -0
  210. package/skills/cursor/debug/references/investigation-checklist.md +217 -0
  211. package/skills/cursor/debug/references/rca-template.md +150 -0
  212. package/skills/cursor/debug/references/state-schema.md +294 -0
  213. package/skills/cursor/debug/references/thorough-track.md +171 -0
  214. package/skills/cursor/debug/references/triage-questions.md +155 -0
  215. package/skills/cursor/debug/references/troubleshooting.md +47 -0
  216. package/skills/cursor/delegation/SKILL.md +351 -0
  217. package/skills/cursor/delegation/references/adaptive-orchestration.md +31 -0
  218. package/skills/cursor/delegation/references/agent-teams-saga.md +254 -0
  219. package/skills/cursor/delegation/references/fix-mode.md +118 -0
  220. package/skills/cursor/delegation/references/fixer-prompt.md +174 -0
  221. package/skills/cursor/delegation/references/implementer-prompt.md +401 -0
  222. package/skills/cursor/delegation/references/parallel-strategy.md +124 -0
  223. package/skills/cursor/delegation/references/pbt-patterns.md +172 -0
  224. package/skills/cursor/delegation/references/pr-fixes-mode.md +155 -0
  225. package/skills/cursor/delegation/references/rationalization-refutation.md +15 -0
  226. package/skills/cursor/delegation/references/state-management.md +84 -0
  227. package/skills/cursor/delegation/references/testing-patterns.md +146 -0
  228. package/skills/cursor/delegation/references/troubleshooting.md +109 -0
  229. package/skills/cursor/delegation/references/worked-example.md +104 -0
  230. package/skills/cursor/delegation/references/workflow-steps.md +131 -0
  231. package/skills/cursor/delegation/references/worktree-enforcement.md +71 -0
  232. package/skills/cursor/dogfood/SKILL.md +235 -0
  233. package/skills/cursor/dogfood/references/report-template.md +109 -0
  234. package/skills/cursor/dogfood/references/root-cause-patterns.md +227 -0
  235. package/skills/cursor/git-worktrees/SKILL.md +193 -0
  236. package/skills/cursor/git-worktrees/references/commands-reference.md +78 -0
  237. package/skills/cursor/implementation-planning/SKILL.md +289 -0
  238. package/skills/cursor/implementation-planning/references/plan-document-template.md +42 -0
  239. package/skills/cursor/implementation-planning/references/rationalization-refutation.md +13 -0
  240. package/skills/cursor/implementation-planning/references/spec-tracing-guide.md +51 -0
  241. package/skills/cursor/implementation-planning/references/task-template.md +63 -0
  242. package/skills/cursor/implementation-planning/references/testing-strategy-guide.md +109 -0
  243. package/skills/cursor/implementation-planning/references/worked-example.md +76 -0
  244. package/skills/cursor/oneshot-workflow/SKILL.md +468 -0
  245. package/skills/cursor/oneshot-workflow/references/choice-state.md +65 -0
  246. package/skills/cursor/prune-workflows/SKILL.md +290 -0
  247. package/skills/cursor/prune-workflows/references/safeguards.md +74 -0
  248. package/skills/cursor/quality-review/SKILL.md +371 -0
  249. package/skills/cursor/quality-review/references/auto-transition.md +47 -0
  250. package/skills/cursor/quality-review/references/axiom-integration.md +135 -0
  251. package/skills/cursor/quality-review/references/code-quality-checklist.md +171 -0
  252. package/skills/cursor/quality-review/references/convergence-and-verdict.md +48 -0
  253. package/skills/cursor/quality-review/references/gate-execution.md +60 -0
  254. package/skills/cursor/quality-review/references/rationalization-refutation.md +13 -0
  255. package/skills/cursor/quality-review/references/review-report-template.md +65 -0
  256. package/skills/cursor/quality-review/references/security-checklist.md +79 -0
  257. package/skills/cursor/quality-review/references/typescript-standards.md +24 -0
  258. package/skills/cursor/refactor/SKILL.md +196 -0
  259. package/skills/cursor/refactor/references/brief-template.md +81 -0
  260. package/skills/cursor/refactor/references/doc-update-checklist.md +113 -0
  261. package/skills/cursor/refactor/references/explore-checklist.md +79 -0
  262. package/skills/cursor/refactor/references/overhaul-track.md +194 -0
  263. package/skills/cursor/refactor/references/phases/auto-chain.md +267 -0
  264. package/skills/cursor/refactor/references/phases/brief.md +176 -0
  265. package/skills/cursor/refactor/references/phases/explore.md +132 -0
  266. package/skills/cursor/refactor/references/phases/overhaul-delegate.md +136 -0
  267. package/skills/cursor/refactor/references/phases/overhaul-plan.md +312 -0
  268. package/skills/cursor/refactor/references/phases/overhaul-review.md +304 -0
  269. package/skills/cursor/refactor/references/phases/polish-implement.md +347 -0
  270. package/skills/cursor/refactor/references/phases/polish-validate.md +218 -0
  271. package/skills/cursor/refactor/references/phases/update-docs.md +234 -0
  272. package/skills/cursor/refactor/references/polish-track.md +152 -0
  273. package/skills/cursor/shepherd/SKILL.md +251 -0
  274. package/skills/cursor/shepherd/references/assess-checklist.md +170 -0
  275. package/skills/cursor/shepherd/references/escalation-criteria.md +53 -0
  276. package/skills/cursor/shepherd/references/fix-strategies.md +289 -0
  277. package/skills/cursor/shepherd/references/gate-event-emission.md +47 -0
  278. package/skills/cursor/shepherd/references/shepherd-event-schemas.md +56 -0
  279. package/skills/cursor/spec-review/SKILL.md +294 -0
  280. package/skills/cursor/spec-review/references/rationalization-refutation.md +13 -0
  281. package/skills/cursor/spec-review/references/review-checklist.md +79 -0
  282. package/skills/cursor/spec-review/references/worked-example.md +72 -0
  283. package/skills/cursor/synthesis/SKILL.md +217 -0
  284. package/skills/cursor/synthesis/references/github-native-stacking.md +135 -0
  285. package/skills/cursor/synthesis/references/merge-ordering.md +50 -0
  286. package/skills/cursor/synthesis/references/pr-descriptions.md +87 -0
  287. package/skills/cursor/synthesis/references/synthesis-steps.md +145 -0
  288. package/skills/cursor/synthesis/references/troubleshooting.md +115 -0
  289. package/skills/cursor/workflow-state/SKILL.md +254 -0
  290. package/skills/cursor/workflow-state/references/mcp-tool-reference.md +89 -0
  291. package/skills/cursor/workflow-state/references/phase-transitions.md +206 -0
  292. package/skills/generic/brainstorming/SKILL.md +182 -0
  293. package/skills/generic/brainstorming/references/design-template.md +107 -0
  294. package/skills/generic/brainstorming/references/worked-example.md +58 -0
  295. package/skills/generic/cleanup/SKILL.md +169 -0
  296. package/skills/generic/cleanup/references/merge-verification.md +40 -0
  297. package/skills/generic/debug/SKILL.md +247 -0
  298. package/skills/generic/debug/references/hotfix-track.md +105 -0
  299. package/skills/generic/debug/references/investigation-checklist.md +217 -0
  300. package/skills/generic/debug/references/rca-template.md +150 -0
  301. package/skills/generic/debug/references/state-schema.md +294 -0
  302. package/skills/generic/debug/references/thorough-track.md +171 -0
  303. package/skills/generic/debug/references/triage-questions.md +155 -0
  304. package/skills/generic/debug/references/troubleshooting.md +47 -0
  305. package/skills/generic/delegation/SKILL.md +345 -0
  306. package/skills/generic/delegation/references/adaptive-orchestration.md +31 -0
  307. package/skills/generic/delegation/references/agent-teams-saga.md +254 -0
  308. package/skills/generic/delegation/references/fix-mode.md +118 -0
  309. package/skills/generic/delegation/references/fixer-prompt.md +174 -0
  310. package/skills/generic/delegation/references/implementer-prompt.md +401 -0
  311. package/skills/generic/delegation/references/parallel-strategy.md +124 -0
  312. package/skills/generic/delegation/references/pbt-patterns.md +172 -0
  313. package/skills/generic/delegation/references/pr-fixes-mode.md +155 -0
  314. package/skills/generic/delegation/references/rationalization-refutation.md +15 -0
  315. package/skills/generic/delegation/references/state-management.md +84 -0
  316. package/skills/generic/delegation/references/testing-patterns.md +146 -0
  317. package/skills/generic/delegation/references/troubleshooting.md +109 -0
  318. package/skills/generic/delegation/references/worked-example.md +104 -0
  319. package/skills/generic/delegation/references/workflow-steps.md +131 -0
  320. package/skills/generic/delegation/references/worktree-enforcement.md +71 -0
  321. package/skills/generic/dogfood/SKILL.md +235 -0
  322. package/skills/generic/dogfood/references/report-template.md +109 -0
  323. package/skills/generic/dogfood/references/root-cause-patterns.md +227 -0
  324. package/skills/generic/git-worktrees/SKILL.md +193 -0
  325. package/skills/generic/git-worktrees/references/commands-reference.md +78 -0
  326. package/skills/generic/implementation-planning/SKILL.md +289 -0
  327. package/skills/generic/implementation-planning/references/plan-document-template.md +42 -0
  328. package/skills/generic/implementation-planning/references/rationalization-refutation.md +13 -0
  329. package/skills/generic/implementation-planning/references/spec-tracing-guide.md +51 -0
  330. package/skills/generic/implementation-planning/references/task-template.md +63 -0
  331. package/skills/generic/implementation-planning/references/testing-strategy-guide.md +109 -0
  332. package/skills/generic/implementation-planning/references/worked-example.md +76 -0
  333. package/skills/generic/oneshot-workflow/SKILL.md +468 -0
  334. package/skills/generic/oneshot-workflow/references/choice-state.md +65 -0
  335. package/skills/generic/prune-workflows/SKILL.md +290 -0
  336. package/skills/generic/prune-workflows/references/safeguards.md +74 -0
  337. package/skills/generic/quality-review/SKILL.md +371 -0
  338. package/skills/generic/quality-review/references/auto-transition.md +47 -0
  339. package/skills/generic/quality-review/references/axiom-integration.md +135 -0
  340. package/skills/generic/quality-review/references/code-quality-checklist.md +171 -0
  341. package/skills/generic/quality-review/references/convergence-and-verdict.md +48 -0
  342. package/skills/generic/quality-review/references/gate-execution.md +60 -0
  343. package/skills/generic/quality-review/references/rationalization-refutation.md +13 -0
  344. package/skills/generic/quality-review/references/review-report-template.md +65 -0
  345. package/skills/generic/quality-review/references/security-checklist.md +79 -0
  346. package/skills/generic/quality-review/references/typescript-standards.md +24 -0
  347. package/skills/generic/refactor/SKILL.md +196 -0
  348. package/skills/generic/refactor/references/brief-template.md +81 -0
  349. package/skills/generic/refactor/references/doc-update-checklist.md +113 -0
  350. package/skills/generic/refactor/references/explore-checklist.md +79 -0
  351. package/skills/generic/refactor/references/overhaul-track.md +194 -0
  352. package/skills/generic/refactor/references/phases/auto-chain.md +267 -0
  353. package/skills/generic/refactor/references/phases/brief.md +176 -0
  354. package/skills/generic/refactor/references/phases/explore.md +132 -0
  355. package/skills/generic/refactor/references/phases/overhaul-delegate.md +136 -0
  356. package/skills/generic/refactor/references/phases/overhaul-plan.md +312 -0
  357. package/skills/generic/refactor/references/phases/overhaul-review.md +304 -0
  358. package/skills/generic/refactor/references/phases/polish-implement.md +347 -0
  359. package/skills/generic/refactor/references/phases/polish-validate.md +218 -0
  360. package/skills/generic/refactor/references/phases/update-docs.md +234 -0
  361. package/skills/generic/refactor/references/polish-track.md +152 -0
  362. package/skills/generic/shepherd/SKILL.md +251 -0
  363. package/skills/generic/shepherd/references/assess-checklist.md +170 -0
  364. package/skills/generic/shepherd/references/escalation-criteria.md +53 -0
  365. package/skills/generic/shepherd/references/fix-strategies.md +289 -0
  366. package/skills/generic/shepherd/references/gate-event-emission.md +47 -0
  367. package/skills/generic/shepherd/references/shepherd-event-schemas.md +56 -0
  368. package/skills/generic/spec-review/SKILL.md +294 -0
  369. package/skills/generic/spec-review/references/rationalization-refutation.md +13 -0
  370. package/skills/generic/spec-review/references/review-checklist.md +79 -0
  371. package/skills/generic/spec-review/references/worked-example.md +72 -0
  372. package/skills/generic/synthesis/SKILL.md +217 -0
  373. package/skills/generic/synthesis/references/github-native-stacking.md +135 -0
  374. package/skills/generic/synthesis/references/merge-ordering.md +50 -0
  375. package/skills/generic/synthesis/references/pr-descriptions.md +87 -0
  376. package/skills/generic/synthesis/references/synthesis-steps.md +145 -0
  377. package/skills/generic/synthesis/references/troubleshooting.md +115 -0
  378. package/skills/generic/workflow-state/SKILL.md +254 -0
  379. package/skills/generic/workflow-state/references/mcp-tool-reference.md +89 -0
  380. package/skills/generic/workflow-state/references/phase-transitions.md +206 -0
  381. package/skills/opencode/brainstorming/SKILL.md +182 -0
  382. package/skills/opencode/brainstorming/references/design-template.md +107 -0
  383. package/skills/opencode/brainstorming/references/worked-example.md +58 -0
  384. package/skills/opencode/cleanup/SKILL.md +169 -0
  385. package/skills/opencode/cleanup/references/merge-verification.md +40 -0
  386. package/skills/opencode/debug/SKILL.md +247 -0
  387. package/skills/opencode/debug/references/hotfix-track.md +105 -0
  388. package/skills/opencode/debug/references/investigation-checklist.md +217 -0
  389. package/skills/opencode/debug/references/rca-template.md +150 -0
  390. package/skills/opencode/debug/references/state-schema.md +294 -0
  391. package/skills/opencode/debug/references/thorough-track.md +171 -0
  392. package/skills/opencode/debug/references/triage-questions.md +155 -0
  393. package/skills/opencode/debug/references/troubleshooting.md +47 -0
  394. package/skills/opencode/delegation/SKILL.md +353 -0
  395. package/skills/opencode/delegation/references/adaptive-orchestration.md +31 -0
  396. package/skills/opencode/delegation/references/agent-teams-saga.md +254 -0
  397. package/skills/opencode/delegation/references/fix-mode.md +118 -0
  398. package/skills/opencode/delegation/references/fixer-prompt.md +174 -0
  399. package/skills/opencode/delegation/references/implementer-prompt.md +401 -0
  400. package/skills/opencode/delegation/references/parallel-strategy.md +124 -0
  401. package/skills/opencode/delegation/references/pbt-patterns.md +172 -0
  402. package/skills/opencode/delegation/references/pr-fixes-mode.md +155 -0
  403. package/skills/opencode/delegation/references/rationalization-refutation.md +15 -0
  404. package/skills/opencode/delegation/references/state-management.md +84 -0
  405. package/skills/opencode/delegation/references/testing-patterns.md +146 -0
  406. package/skills/opencode/delegation/references/troubleshooting.md +109 -0
  407. package/skills/opencode/delegation/references/worked-example.md +104 -0
  408. package/skills/opencode/delegation/references/workflow-steps.md +131 -0
  409. package/skills/opencode/delegation/references/worktree-enforcement.md +71 -0
  410. package/skills/opencode/dogfood/SKILL.md +235 -0
  411. package/skills/opencode/dogfood/references/report-template.md +109 -0
  412. package/skills/opencode/dogfood/references/root-cause-patterns.md +227 -0
  413. package/skills/opencode/git-worktrees/SKILL.md +193 -0
  414. package/skills/opencode/git-worktrees/references/commands-reference.md +78 -0
  415. package/skills/opencode/implementation-planning/SKILL.md +289 -0
  416. package/skills/opencode/implementation-planning/references/plan-document-template.md +42 -0
  417. package/skills/opencode/implementation-planning/references/rationalization-refutation.md +13 -0
  418. package/skills/opencode/implementation-planning/references/spec-tracing-guide.md +51 -0
  419. package/skills/opencode/implementation-planning/references/task-template.md +63 -0
  420. package/skills/opencode/implementation-planning/references/testing-strategy-guide.md +109 -0
  421. package/skills/opencode/implementation-planning/references/worked-example.md +76 -0
  422. package/skills/opencode/oneshot-workflow/SKILL.md +468 -0
  423. package/skills/opencode/oneshot-workflow/references/choice-state.md +65 -0
  424. package/skills/opencode/prune-workflows/SKILL.md +290 -0
  425. package/skills/opencode/prune-workflows/references/safeguards.md +74 -0
  426. package/skills/opencode/quality-review/SKILL.md +371 -0
  427. package/skills/opencode/quality-review/references/auto-transition.md +47 -0
  428. package/skills/opencode/quality-review/references/axiom-integration.md +135 -0
  429. package/skills/opencode/quality-review/references/code-quality-checklist.md +171 -0
  430. package/skills/opencode/quality-review/references/convergence-and-verdict.md +48 -0
  431. package/skills/opencode/quality-review/references/gate-execution.md +60 -0
  432. package/skills/opencode/quality-review/references/rationalization-refutation.md +13 -0
  433. package/skills/opencode/quality-review/references/review-report-template.md +65 -0
  434. package/skills/opencode/quality-review/references/security-checklist.md +79 -0
  435. package/skills/opencode/quality-review/references/typescript-standards.md +24 -0
  436. package/skills/opencode/refactor/SKILL.md +196 -0
  437. package/skills/opencode/refactor/references/brief-template.md +81 -0
  438. package/skills/opencode/refactor/references/doc-update-checklist.md +113 -0
  439. package/skills/opencode/refactor/references/explore-checklist.md +79 -0
  440. package/skills/opencode/refactor/references/overhaul-track.md +194 -0
  441. package/skills/opencode/refactor/references/phases/auto-chain.md +267 -0
  442. package/skills/opencode/refactor/references/phases/brief.md +176 -0
  443. package/skills/opencode/refactor/references/phases/explore.md +132 -0
  444. package/skills/opencode/refactor/references/phases/overhaul-delegate.md +136 -0
  445. package/skills/opencode/refactor/references/phases/overhaul-plan.md +312 -0
  446. package/skills/opencode/refactor/references/phases/overhaul-review.md +304 -0
  447. package/skills/opencode/refactor/references/phases/polish-implement.md +347 -0
  448. package/skills/opencode/refactor/references/phases/polish-validate.md +218 -0
  449. package/skills/opencode/refactor/references/phases/update-docs.md +234 -0
  450. package/skills/opencode/refactor/references/polish-track.md +152 -0
  451. package/skills/opencode/shepherd/SKILL.md +251 -0
  452. package/skills/opencode/shepherd/references/assess-checklist.md +170 -0
  453. package/skills/opencode/shepherd/references/escalation-criteria.md +53 -0
  454. package/skills/opencode/shepherd/references/fix-strategies.md +289 -0
  455. package/skills/opencode/shepherd/references/gate-event-emission.md +47 -0
  456. package/skills/opencode/shepherd/references/shepherd-event-schemas.md +56 -0
  457. package/skills/opencode/spec-review/SKILL.md +294 -0
  458. package/skills/opencode/spec-review/references/rationalization-refutation.md +13 -0
  459. package/skills/opencode/spec-review/references/review-checklist.md +79 -0
  460. package/skills/opencode/spec-review/references/worked-example.md +72 -0
  461. package/skills/opencode/synthesis/SKILL.md +217 -0
  462. package/skills/opencode/synthesis/references/github-native-stacking.md +135 -0
  463. package/skills/opencode/synthesis/references/merge-ordering.md +50 -0
  464. package/skills/opencode/synthesis/references/pr-descriptions.md +87 -0
  465. package/skills/opencode/synthesis/references/synthesis-steps.md +145 -0
  466. package/skills/opencode/synthesis/references/troubleshooting.md +115 -0
  467. package/skills/opencode/workflow-state/SKILL.md +254 -0
  468. package/skills/opencode/workflow-state/references/mcp-tool-reference.md +89 -0
  469. package/skills/opencode/workflow-state/references/phase-transitions.md +206 -0
  470. package/dist/node_modules/electron/index.js +0 -1
  471. package/dist/node_modules/electron/package.json +0 -1
  472. package/dist/node_modules/playwright-core/index.js +0 -1
  473. package/dist/node_modules/playwright-core/package.json +0 -1
  474. package/skills/shared/prompts/context-reading.md +0 -66
  475. package/skills/shared/prompts/report-format.md +0 -54
  476. package/skills/shared/prompts/tdd-requirements.md +0 -39
  477. package/skills/shared/references/coding-standards.md +0 -46
  478. package/skills/shared/references/mcp-tool-guidance.md +0 -39
  479. package/skills/shared/references/skill-path-resolution.md +0 -10
  480. package/skills/shared/references/tdd.md +0 -58
  481. package/skills/shared/references/telemetry-awareness.md +0 -9
  482. /package/skills/{brainstorming → claude/brainstorming}/SKILL.md +0 -0
  483. /package/skills/{brainstorming → claude/brainstorming}/references/design-template.md +0 -0
  484. /package/skills/{brainstorming → claude/brainstorming}/references/worked-example.md +0 -0
  485. /package/skills/{cleanup → claude/cleanup}/references/merge-verification.md +0 -0
  486. /package/skills/{debug → claude/debug}/SKILL.md +0 -0
  487. /package/skills/{debug → claude/debug}/references/hotfix-track.md +0 -0
  488. /package/skills/{debug → claude/debug}/references/investigation-checklist.md +0 -0
  489. /package/skills/{debug → claude/debug}/references/rca-template.md +0 -0
  490. /package/skills/{debug → claude/debug}/references/state-schema.md +0 -0
  491. /package/skills/{debug → claude/debug}/references/thorough-track.md +0 -0
  492. /package/skills/{debug → claude/debug}/references/triage-questions.md +0 -0
  493. /package/skills/{debug → claude/debug}/references/troubleshooting.md +0 -0
  494. /package/skills/{delegation → claude/delegation}/references/adaptive-orchestration.md +0 -0
  495. /package/skills/{delegation → claude/delegation}/references/agent-teams-saga.md +0 -0
  496. /package/skills/{delegation → claude/delegation}/references/fix-mode.md +0 -0
  497. /package/skills/{delegation → claude/delegation}/references/fixer-prompt.md +0 -0
  498. /package/skills/{delegation → claude/delegation}/references/implementer-prompt.md +0 -0
  499. /package/skills/{delegation → claude/delegation}/references/parallel-strategy.md +0 -0
  500. /package/skills/{delegation → claude/delegation}/references/pbt-patterns.md +0 -0
  501. /package/skills/{delegation → claude/delegation}/references/pr-fixes-mode.md +0 -0
  502. /package/skills/{delegation → claude/delegation}/references/rationalization-refutation.md +0 -0
  503. /package/skills/{delegation → claude/delegation}/references/state-management.md +0 -0
  504. /package/skills/{delegation → claude/delegation}/references/testing-patterns.md +0 -0
  505. /package/skills/{delegation → claude/delegation}/references/worked-example.md +0 -0
  506. /package/skills/{delegation → claude/delegation}/references/workflow-steps.md +0 -0
  507. /package/skills/{delegation → claude/delegation}/references/worktree-enforcement.md +0 -0
  508. /package/skills/{git-worktrees → claude/git-worktrees}/SKILL.md +0 -0
  509. /package/skills/{git-worktrees → claude/git-worktrees}/references/commands-reference.md +0 -0
  510. /package/skills/{implementation-planning → claude/implementation-planning}/SKILL.md +0 -0
  511. /package/skills/{implementation-planning → claude/implementation-planning}/references/plan-document-template.md +0 -0
  512. /package/skills/{implementation-planning → claude/implementation-planning}/references/rationalization-refutation.md +0 -0
  513. /package/skills/{implementation-planning → claude/implementation-planning}/references/spec-tracing-guide.md +0 -0
  514. /package/skills/{implementation-planning → claude/implementation-planning}/references/task-template.md +0 -0
  515. /package/skills/{implementation-planning → claude/implementation-planning}/references/testing-strategy-guide.md +0 -0
  516. /package/skills/{implementation-planning → claude/implementation-planning}/references/worked-example.md +0 -0
  517. /package/skills/{quality-review → claude/quality-review}/references/auto-transition.md +0 -0
  518. /package/skills/{quality-review → claude/quality-review}/references/axiom-integration.md +0 -0
  519. /package/skills/{quality-review → claude/quality-review}/references/code-quality-checklist.md +0 -0
  520. /package/skills/{quality-review → claude/quality-review}/references/convergence-and-verdict.md +0 -0
  521. /package/skills/{quality-review → claude/quality-review}/references/gate-execution.md +0 -0
  522. /package/skills/{quality-review → claude/quality-review}/references/rationalization-refutation.md +0 -0
  523. /package/skills/{quality-review → claude/quality-review}/references/review-report-template.md +0 -0
  524. /package/skills/{quality-review → claude/quality-review}/references/security-checklist.md +0 -0
  525. /package/skills/{quality-review → claude/quality-review}/references/typescript-standards.md +0 -0
  526. /package/skills/{refactor → claude/refactor}/SKILL.md +0 -0
  527. /package/skills/{refactor → claude/refactor}/references/brief-template.md +0 -0
  528. /package/skills/{refactor → claude/refactor}/references/doc-update-checklist.md +0 -0
  529. /package/skills/{refactor → claude/refactor}/references/explore-checklist.md +0 -0
  530. /package/skills/{refactor → claude/refactor}/references/overhaul-track.md +0 -0
  531. /package/skills/{refactor → claude/refactor/references}/phases/auto-chain.md +0 -0
  532. /package/skills/{refactor → claude/refactor/references}/phases/brief.md +0 -0
  533. /package/skills/{refactor → claude/refactor/references}/phases/explore.md +0 -0
  534. /package/skills/{refactor → claude/refactor/references}/phases/overhaul-delegate.md +0 -0
  535. /package/skills/{refactor → claude/refactor/references}/phases/overhaul-plan.md +0 -0
  536. /package/skills/{refactor → claude/refactor/references}/phases/overhaul-review.md +0 -0
  537. /package/skills/{refactor → claude/refactor/references}/phases/polish-implement.md +0 -0
  538. /package/skills/{refactor → claude/refactor/references}/phases/polish-validate.md +0 -0
  539. /package/skills/{refactor → claude/refactor/references}/phases/update-docs.md +0 -0
  540. /package/skills/{refactor → claude/refactor}/references/polish-track.md +0 -0
  541. /package/skills/{shepherd → claude/shepherd}/references/assess-checklist.md +0 -0
  542. /package/skills/{shepherd → claude/shepherd}/references/escalation-criteria.md +0 -0
  543. /package/skills/{shepherd → claude/shepherd}/references/fix-strategies.md +0 -0
  544. /package/skills/{shepherd → claude/shepherd}/references/gate-event-emission.md +0 -0
  545. /package/skills/{shepherd → claude/shepherd}/references/shepherd-event-schemas.md +0 -0
  546. /package/skills/{spec-review → claude/spec-review}/references/rationalization-refutation.md +0 -0
  547. /package/skills/{spec-review → claude/spec-review}/references/review-checklist.md +0 -0
  548. /package/skills/{spec-review → claude/spec-review}/references/worked-example.md +0 -0
  549. /package/skills/{synthesis → claude/synthesis}/references/github-native-stacking.md +0 -0
  550. /package/skills/{synthesis → claude/synthesis}/references/merge-ordering.md +0 -0
  551. /package/skills/{synthesis → claude/synthesis}/references/pr-descriptions.md +0 -0
  552. /package/skills/{synthesis → claude/synthesis}/references/synthesis-steps.md +0 -0
  553. /package/skills/{synthesis → claude/synthesis}/references/troubleshooting.md +0 -0
  554. /package/skills/{workflow-state → claude/workflow-state}/references/mcp-tool-reference.md +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lvlup-sw/exarchos",
3
- "version": "2.5.0",
3
+ "version": "2.6.1",
4
4
  "description": "Structure for agentic development — durable SDLC workflows, convergence gates, agent teams, and audit trails for Claude Code",
5
5
  "type": "module",
6
6
  "bin": {
@@ -25,8 +25,10 @@
25
25
  "!**/trigger-tests"
26
26
  ],
27
27
  "scripts": {
28
- "build": "tsc && bun run build:bundle",
28
+ "build": "tsc && bun run build:bundle && npm run build:skills",
29
29
  "build:bundle": "bun run scripts/build-bundle.ts",
30
+ "build:skills": "node dist/build-skills.js",
31
+ "skills:guard": "node dist/skills-guard.js",
30
32
  "prepare": "tsc",
31
33
  "bench": "cd servers/exarchos-mcp && npx vitest bench",
32
34
  "test": "vitest",
@@ -55,6 +57,7 @@
55
57
  "author": "lvlup-sw",
56
58
  "license": "Apache-2.0",
57
59
  "devDependencies": {
60
+ "@types/js-yaml": "^4.0.9",
58
61
  "@types/node": "^22.0.0",
59
62
  "tsx": "^4.21.0",
60
63
  "typescript": "^5.0.0",
@@ -65,7 +68,8 @@
65
68
  "node": ">=20.0.0"
66
69
  },
67
70
  "dependencies": {
68
- "@inquirer/prompts": "^8.2.1"
71
+ "@inquirer/prompts": "^8.2.1",
72
+ "js-yaml": "^4.1.1"
69
73
  },
70
74
  "workspaces": [
71
75
  "packages/*"
@@ -15,6 +15,12 @@ metadata:
15
15
 
16
16
  Resolve merged workflows to `completed` state in a single operation. Replaces the manual multi-step process of navigating HSM guards after PR stacks merge.
17
17
 
18
+ ## Batch Pruning for Stale Workflows
19
+
20
+ For bulk cleanup of accumulated stale or abandoned workflows (as opposed to resolving a single merged workflow), use `@skills/prune-workflows/SKILL.md`. That skill invokes `exarchos_orchestrate prune_stale_workflows` in dry-run mode, displays candidates, and applies after user confirmation. Safeguards automatically skip workflows with open PRs or recent commits.
21
+
22
+ **Rule of thumb:** cleanup is per-workflow (one merged feature → `completed`); prune is bulk (N inactive workflows → `cancelled`). They are complementary, not alternatives.
23
+
18
24
  ## Triggers
19
25
 
20
26
  Activate this skill when:
@@ -20,6 +20,8 @@ Activate this skill when:
20
20
  - Implementation plan is ready with extractable tasks
21
21
  - User wants to parallelize work across subagents
22
22
 
23
+ **Exception — oneshot workflows skip delegation entirely.** The oneshot playbook runs an in-session TDD loop in the main agent's context, with no subagent dispatch or review phase. If `workflowType === "oneshot"`, do not call this skill — see `@skills/oneshot-workflow/SKILL.md` for the lightweight path.
24
+
23
25
  ## Core Principles
24
26
 
25
27
  ### Fresh Context Per Task (MANDATORY)
@@ -121,33 +123,20 @@ This runbook provides structured criteria for parallel vs sequential dispatch, t
121
123
 
122
124
  ### Parallel Dispatch
123
125
 
124
- Dispatch all independent tasks in a **single message** with multiple `Task` calls.
125
-
126
- **Claude Code Dispatch (native agents):**
126
+ Dispatch all independent tasks using the runtime's native spawn primitive. On runtimes with subagent support, fan out in a **single message** so the dispatches run in parallel. On runtimes without a subagent primitive, execute each task sequentially against its prepared worktree and emit one operator-visible warning per batch so users know they are not getting parallelism.
127
127
 
128
128
  ```typescript
129
129
  Task({
130
130
  subagent_type: "exarchos-implementer",
131
131
  run_in_background: true,
132
132
  description: "Implement task-001: [title]",
133
- prompt: `Task-specific context only: requirements, file paths, acceptance criteria`
133
+ prompt: "Task-specific context: requirements, file paths, acceptance criteria"
134
134
  })
135
- ```
136
-
137
- > **Note:** The agent's system prompt, model, isolation, skills, hooks, and memory are defined by the agent specification in `servers/exarchos-mcp/src/agents/definitions.ts`. The dispatch prompt provides ONLY task-specific context.
138
135
 
139
- **Cross-platform Dispatch (non-Claude-Code clients):**
140
-
141
- ```typescript
142
- Task({
143
- subagent_type: "general-purpose",
144
- model: "opus",
145
- run_in_background: true,
146
- description: "Implement task-001: [title]",
147
- prompt: `[Full implementer prompt — self-contained]`
148
- })
149
136
  ```
150
137
 
138
+ > **Note:** On Claude Code, the `exarchos-implementer` agent definition already contains the system prompt, model, isolation, skills, hooks, and memory — the dispatch prompt should carry ONLY task-specific context. On runtimes without native agent definitions, include the full implementer prompt template from `references/implementer-prompt.md` in the `prompt` field so the spawned agent has a self-contained context.
139
+
151
140
  For parallel grouping strategy and model selection, see `references/parallel-strategy.md`.
152
141
 
153
142
  ### Agent Teams Dispatch
@@ -156,6 +145,22 @@ When using `--mode agent-team`, follow the 6-step saga in `references/agent-team
156
145
 
157
146
  Event emission contract for agent teams: see `references/agent-teams-saga.md` for full payload shapes and compensation protocol.
158
147
 
148
+ ### Event Emission Contract (REQUIRED)
149
+
150
+ The delegate phase requires these events (checked by `check-event-emissions`):
151
+
152
+ | Event | When | Emitted By |
153
+ |-------|------|------------|
154
+ | `team.spawned` | After team creation, before dispatch | Orchestrator |
155
+ | `team.task.planned` | For each task in the plan (use `batch_append`) | Orchestrator |
156
+ | `team.teammate.dispatched` | After each subagent is spawned | Orchestrator |
157
+ | `task.progressed` | After each TDD phase (red/green/refactor) | Subagent |
158
+ | `team.disbanded` | After all subagents complete | Orchestrator |
159
+
160
+ See `references/agent-teams-saga.md` for full event schemas and emission order.
161
+
162
+ > **Note:** `task.progressed` events are emitted by subagents during TDD execution, not by the orchestrator. The orchestrator only emits team lifecycle events.
163
+
159
164
  ---
160
165
 
161
166
  ## Step 3: Monitor and Collect
@@ -233,23 +238,16 @@ For the full recovery flow with a concrete example, see `references/worked-examp
233
238
 
234
239
  ### Fix Failed Tasks
235
240
 
236
- If a task fails and `agentId` is available in workflow state:
241
+ Dispatch a fix agent with the full failure context and the original task description. On runtimes that support session resume (e.g. Claude Code with an `agentId` in workflow state), prefer resuming the original agent so it retains its implementer context; otherwise dispatch a fresh fixer agent using the runtime's native spawn primitive.
237
242
 
238
- **Resume (Claude Code — preserves full implementer context):**
239
243
  ```typescript
240
244
  Task({
241
- resume: "[agentId from workflow state]",
242
- prompt: "Your implementation failed. [failure context from test output]. Apply adversarial verification: do NOT trust your previous self-assessment, re-read actual test output, identify root cause not symptoms."
243
- })
244
- ```
245
-
246
- **Fresh dispatch (cross-platform — when agentId unavailable or platform doesn't support resume):**
247
- ```typescript
248
- Task({
249
- subagent_type: "exarchos-fixer",
245
+ subagent_type: "exarchos-implementer",
250
246
  run_in_background: true,
251
- prompt: "[Full failure context + original task context]"
247
+ description: "Fix failed task-001",
248
+ prompt: "Your implementation failed. [failure context from test output]. Apply adversarial verification: do NOT trust your previous self-assessment, re-read actual test output, identify root cause not symptoms. [Original task context]."
252
249
  })
250
+
253
251
  ```
254
252
 
255
253
  After fix completes, run the `task-fix` runbook gate chain:
@@ -276,6 +274,29 @@ If context compaction occurs during delegation:
276
274
  3. Reconcile: `exarchos_workflow reconcile` replays the event stream and patches stale task state (CAS-protected)
277
275
  4. Do NOT re-create branches or re-dispatch agents until confirmed lost
278
276
 
277
+ ### Worktree State Schema
278
+
279
+ Worktree entries are stored as `worktrees["<wt-id>"]` in workflow state. Each entry requires:
280
+
281
+ | Field | Type | Required | Notes |
282
+ |-------|------|----------|-------|
283
+ | `branch` | string | Yes | Git branch name |
284
+ | `taskId` | string | Conditional | Single task ID (use for 1-task worktrees) |
285
+ | `tasks` | string[] | Conditional | Multiple task IDs (use for multi-task worktrees) |
286
+ | `status` | `"active"` \| `"merged"` \| `"removed"` | Yes | Worktree lifecycle status |
287
+
288
+ Either `taskId` or `tasks` (non-empty array) is required — at least one must be present.
289
+
290
+ **Single-task example:**
291
+ ```json
292
+ { "branch": "feat/task-001", "taskId": "task-001", "status": "active" }
293
+ ```
294
+
295
+ **Multi-task example:**
296
+ ```json
297
+ { "branch": "feat/integration", "tasks": ["task-001", "task-002"], "status": "active" }
298
+ ```
299
+
279
300
  ---
280
301
 
281
302
  ## Phase Transitions and Guards
@@ -60,8 +60,8 @@ If `exarchos_orchestrate` with `action: "task_claim"` returns ALREADY_CLAIMED:
60
60
  ```json
61
61
  {
62
62
  "reviews": {
63
- "spec-compliance": { "status": "pass", "issues": [] },
64
- "code-quality": { "status": "pass", "issues": [] }
63
+ "spec-review": { "status": "pass", "issues": [] },
64
+ "quality-review": { "status": "pass", "issues": [] }
65
65
  }
66
66
  }
67
67
  ```
@@ -0,0 +1,235 @@
1
+ ---
2
+ name: dogfood
3
+ description: "Review failed Exarchos MCP tool calls from the current session, diagnose root causes, and categorize into code bug, documentation issue, or user error. Use when the user says 'dogfood', 'review failures', 'what went wrong', 'triage errors', or runs /dogfood. Scopes exclusively to Exarchos tools (exarchos_workflow, exarchos_event, exarchos_orchestrate, exarchos_view, exarchos_sync). Do NOT use for debugging application code or non-Exarchos tool failures."
4
+ metadata:
5
+ author: exarchos
6
+ version: 2.0.0
7
+ mcp-server: exarchos
8
+ category: utility
9
+ ---
10
+
11
+ # Dogfood Skill
12
+
13
+ ## Overview
14
+
15
+ Retrospective analysis of Exarchos MCP tool usage. Uses the MCP server's own self-service capabilities as the primary diagnostic instrument — describe APIs, views, playbooks, and runbooks turned inward to diagnose failures.
16
+
17
+ Three distinct failure modes require different fixes — code changes, documentation updates, or skill instruction improvements. Mixing them wastes effort.
18
+
19
+ ### Platform-Agnosticity
20
+
21
+ Per `docs/designs/2026-03-09-platform-agnosticity.md`: the MCP server is the self-sufficient, platform-agnostic core. The debug trace relies entirely on MCP tools — not conversation introspection — so it works for any MCP client. Conversation scanning is supplementary.
22
+
23
+ **Diagnostic self-service tools:** `describe(topology)` for HSM verification, `describe(playbook)` for adherence checks, `describe(eventTypes, emissionGuide)` for event schema/catalog comparison, `describe(actions)` for schema/gate metadata, `runbook(phase)` for step conformance, `pipeline`/`convergence`/`telemetry` views for health metrics.
24
+
25
+ ## Triggers
26
+
27
+ Activate this skill when:
28
+ - User runs `/dogfood` or `/exarchos:dogfood`
29
+ - User asks "what went wrong this session" or "review the failures"
30
+ - User wants to triage errors from a workflow run
31
+ - End of a workflow session to capture learnings
32
+
33
+ ## Process
34
+
35
+ ### Step 1: Debug Trace via MCP Self-Service
36
+
37
+ Query the MCP server's own self-service capabilities to build a ground-truth diagnostic picture. This is the primary investigation method — it uses the same tools any MCP client has access to.
38
+
39
+ #### 1a. Identify Active Workflows
40
+
41
+ Use `exarchos_view` with `action: "pipeline"` to get an aggregated view of active workflows with their phases and task counts.
42
+
43
+ If `$ARGUMENTS` specifies a workflow or feature ID, scope to that workflow. Otherwise, inspect all non-terminal workflows.
44
+
45
+ #### 1b. Inspect Workflow State and Topology
46
+
47
+ For each relevant workflow:
48
+
49
+ 1. **Read state** — `exarchos_workflow get` to retrieve current phase, tasks, reviews, gate results.
50
+ 2. **Read topology** — `exarchos_workflow describe(topology: "<workflowType>")` to get the HSM definition. Compare the agent's phase transition attempts against valid transitions. Invalid transition attempts = documentation issue (skill prescribed wrong path) or user error.
51
+ 3. **Check guard prerequisites** — For `workflow.guard-failed` events, look up the guard in the topology to understand unmet preconditions.
52
+
53
+ #### 1c. Playbook Adherence Check
54
+
55
+ Use `exarchos_workflow describe(playbook: "<workflowType>")` to retrieve phase playbooks. For each phase executed, compare playbook's `tools`, `events`, `transitionCriteria`, `guardPrerequisites`, `humanCheckpoint`, and `compactGuidance` against what the agent actually did and what skill docs prescribe.
56
+
57
+ **Playbook violations are diagnostic gold:**
58
+ - Agent deviated and skill docs told it to → **documentation issue** (skill contradicts playbook)
59
+ - Agent deviated and skill docs agree with playbook → **user error**
60
+ - Playbook is wrong (prescribes invalid tools/events) → **code bug**
61
+
62
+ #### 1d. Event Log Analysis
63
+
64
+ Use `exarchos_event query(stream)` on the workflow's event stream. Look for:
65
+
66
+ - **Rejected events** — absent from log despite agent attempts (corroborate with conversation errors)
67
+ - **Missing events** — compare against playbook `events` field and `exarchos_event describe(emissionGuide: true)`. Missing model-emitted events = documentation gap or user error.
68
+ - **Sequence anomalies** — wrong order, duplicates, or timeline gaps
69
+ - **Schema mismatches** — use `describe(eventTypes: [...])` to get authoritative JSON Schema. Compare actual payloads against schema for semantically wrong fields.
70
+
71
+ #### 1e. Orchestrate Action and Gate Analysis
72
+
73
+ 1. **Schema verification** — `exarchos_orchestrate describe(actions: [...])` for authoritative schemas. Compare agent's parameters against schema to detect stale skill docs or improvisation.
74
+ 2. **Gate metadata** — Describe output includes `{ blocking, dimension, autoEmits }`. Check: did the agent treat blocking/non-blocking correctly? Did expected auto-emissions fire?
75
+ 3. **Gate convergence** — `exarchos_view convergence` for per-dimension (D1-D5) pass rates. Low convergence suggests systemic gate issues.
76
+
77
+ #### 1f. Runbook Conformance Check
78
+
79
+ Use `exarchos_orchestrate runbook(phase)` to retrieve relevant runbooks. Check: step ordering, decision branch correctness (steps with `decide` fields), `onFail` directive adherence (`stop`/`continue`/`retry`), and `templateVars` completeness.
80
+
81
+ #### 1g. Telemetry Review
82
+
83
+ Use `exarchos_view telemetry` for per-tool performance. Flag: high error rates (systemic issues), high invocation counts (retry loops), and tools never invoked that the playbook prescribes.
84
+
85
+ ### Step 2: Scan Session for Failed Tool Calls
86
+
87
+ Supplement the debug trace with client-side context — review conversation for failed Exarchos tool calls.
88
+
89
+ **Note:** Platform-dependent step (requires conversation history). Skip on platforms without introspection; the debug trace is self-sufficient.
90
+
91
+ **Target tools:** `exarchos_workflow`, `exarchos_event`, `exarchos_orchestrate`, `exarchos_view`, `exarchos_sync`
92
+
93
+ **Error signals:** `INVALID_INPUT`, `VALIDATION_ERROR`, `BATCH_APPEND_FAILED`, Zod failures (`invalid_type`, `invalid_enum_value`, `unrecognized_keys`), `ENOENT`, `CLAIM_FAILED`, `SEQUENCE_CONFLICT`, CAS exhaustion, retry sequences, successful-after-retry calls.
94
+
95
+ ### Step 3: Diagnose Each Failure
96
+
97
+ Merge debug trace and conversation scan findings. For each failure document:
98
+
99
+ 1. **What was attempted** — action, parameters, intent
100
+ 2. **What went wrong** — error message and validation path
101
+ 3. **Server-side evidence** — event log, state, describe output, views
102
+ 4. **Authoritative reference** — the self-service query providing ground truth (playbook, topology, schema, runbook)
103
+ 5. **Root cause** — per `references/root-cause-patterns.md`
104
+ 6. **Fix category** — code, docs, or user behavior
105
+
106
+ Flag discrepancies only visible via server-side inspection as **trace-only findings**.
107
+
108
+ ### Step 4: Categorize into Buckets
109
+
110
+ Assign each failure to exactly one root cause bucket:
111
+
112
+ #### Bucket 1: Code Bug
113
+ The MCP server, event store, or workflow engine has a defect.
114
+
115
+ **Signals:** Schema rejects valid input (confirmed via `describe`), CAS failures with no concurrent writers, gate over-enforcement, identical-parameter retry succeeds (race condition), state corruption, topology/engine mismatch, auto-emission failure.
116
+
117
+ **Action:** File bug issue with reproduction steps, expected vs actual, and suggested fix.
118
+
119
+ #### Bucket 2: Documentation Issue
120
+ Skill docs are wrong, incomplete, or out of sync with the MCP server's self-service output.
121
+
122
+ **Signals:** Skill payload doesn't match `describe` schema, skill/playbook divergence, skill documents nonexistent topology paths, missing event types (compare emission guide), retry-based field discovery, runbook/skill contradictions, compactGuidance drift.
123
+
124
+ **Action:** File docs issue with file:line, the discrepancy, and correct information from `describe` output.
125
+
126
+ #### Bucket 3: User Error
127
+ The agent misused a tool in a way both docs and `describe` output correctly describe.
128
+
129
+ **Signals:** Format mismatch (confirmed by `describe` + docs agreement), invalid sequence (topology confirms), missing context both skill and playbook prescribe, runbook deviation without justification.
130
+
131
+ **Action:** Note for skill improvement if errors are frequent.
132
+
133
+ ### Step 5: Generate Report
134
+
135
+ Produce the report using the template from `references/report-template.md`. Include:
136
+ - Summary counts per bucket
137
+ - Debug trace summary (workflows inspected, events reviewed, describe queries issued, views consulted)
138
+ - Each failure with full diagnosis (including authoritative self-service references)
139
+ - Trace-only findings section (issues only visible via server-side inspection)
140
+ - Playbook/runbook adherence summary
141
+ - Actionable next steps (draft issue bodies for bugs/docs issues)
142
+
143
+ ### Step 6: Offer to File Issues
144
+
145
+ For findings in the **Code Bug** and **Documentation Issue** buckets, offer to create GitHub issues:
146
+
147
+ ```bash
148
+ gh issue create --title "<type>: <summary>" --body "<issue body>" --label "bug"
149
+ ```
150
+
151
+ Only file issues with user confirmation — present the draft first.
152
+
153
+ ## Required Output Format
154
+
155
+ ```json
156
+ {
157
+ "session_summary": {
158
+ "total_tool_calls": 0,
159
+ "failed_tool_calls": 0,
160
+ "failure_rate": "0%",
161
+ "debug_trace": {
162
+ "workflows_inspected": 0,
163
+ "events_reviewed": 0,
164
+ "describe_queries": 0,
165
+ "views_consulted": [],
166
+ "trace_only_findings": 0
167
+ }
168
+ },
169
+ "playbook_adherence": {
170
+ "phases_checked": 0,
171
+ "violations": [
172
+ {
173
+ "phase": "delegate",
174
+ "field": "events",
175
+ "expected": "team.spawned, team.task.assigned",
176
+ "actual": "none emitted",
177
+ "bucket": "documentation_issue"
178
+ }
179
+ ]
180
+ },
181
+ "runbook_conformance": {
182
+ "runbooks_checked": 0,
183
+ "deviations": []
184
+ },
185
+ "buckets": {
186
+ "code_bug": [],
187
+ "documentation_issue": [],
188
+ "user_error": []
189
+ },
190
+ "findings": [
191
+ {
192
+ "id": 1,
193
+ "bucket": "code_bug | documentation_issue | user_error",
194
+ "tool": "exarchos_workflow",
195
+ "action": "set",
196
+ "error": "INVALID_INPUT: ...",
197
+ "root_cause": "Schema rejects null branch on pending tasks",
198
+ "trace_evidence": "describe(actions: ['set']) shows branch as required string; event log confirms no task.updated event",
199
+ "authoritative_ref": "exarchos_workflow describe(actions: ['set']) → TaskSchema",
200
+ "severity": "HIGH | MEDIUM | LOW",
201
+ "suggested_fix": "Accept nullable branch in TaskSchema",
202
+ "issue_draft": {
203
+ "title": "bug: workflow task schema rejects null branch",
204
+ "labels": ["bug"],
205
+ "body": "..."
206
+ }
207
+ }
208
+ ],
209
+ "trace_only_findings": [
210
+ {
211
+ "id": "T1",
212
+ "description": "State drift: agent assumed phase was 'delegate' but server shows 'plan'",
213
+ "evidence": "exarchos_workflow get shows phase=plan; topology confirms plan→delegate requires planReviewComplete guard",
214
+ "authoritative_ref": "exarchos_workflow describe(topology: 'feature') → guards",
215
+ "bucket": "documentation_issue",
216
+ "suggested_fix": "Skill should instruct agent to verify phase via get before proceeding"
217
+ }
218
+ ]
219
+ }
220
+ ```
221
+
222
+ ## Anti-Patterns
223
+
224
+ | Don't | Do Instead |
225
+ |-------|------------|
226
+ | Skip the debug trace and only scan conversation | Always query MCP self-service tools first — conversation scan is supplementary |
227
+ | Guess what the schema expects | Use `describe` to get authoritative schemas — they are the source of truth |
228
+ | Assess playbook adherence from memory | Query `describe(playbook)` to get the actual prescribed tools, events, and criteria |
229
+ | Assume the topology without checking | Query `describe(topology)` to get valid transitions, guards, and effects |
230
+ | Blame the user when skill docs contradict the playbook | If skill docs diverge from playbook/describe output, it's a documentation issue |
231
+ | File duplicate issues | Check existing open/closed issues before drafting |
232
+ | Categorize retries as separate failures | Group retry sequences as a single finding |
233
+ | Ignore successful-after-retry calls | These reveal friction even though they eventually worked |
234
+ | Include non-Exarchos failures | Scope strictly to the 5 Exarchos tools — other MCP failures are out of scope |
235
+ | Report conversation-only findings without trace corroboration | Cross-reference every finding with server-side state when possible |
@@ -0,0 +1,109 @@
1
+ # Dogfood Report Template
2
+
3
+ ```markdown
4
+ ## Dogfood Report
5
+
6
+ **Session:** [workflow name or description]
7
+ **Date:** [ISO 8601]
8
+ **Workflow type:** [feature | debug | refactor | ad-hoc]
9
+
10
+ ### Summary
11
+
12
+ | Metric | Value |
13
+ |--------|-------|
14
+ | Total Exarchos tool calls | X |
15
+ | Failed tool calls | Y |
16
+ | Failure rate | Z% |
17
+ | Code bugs found | A |
18
+ | Documentation issues found | B |
19
+ | User errors found | C |
20
+
21
+ ### Debug Trace Summary
22
+
23
+ | Metric | Value |
24
+ |--------|-------|
25
+ | Workflows inspected | X |
26
+ | Events reviewed | Y |
27
+ | Describe queries issued | Z |
28
+ | Views consulted | [pipeline, convergence, telemetry, ...] |
29
+ | Trace-only findings | W |
30
+
31
+ ### Playbook Adherence
32
+
33
+ | Phase | Tools | Events | Transition Criteria | Guards | Verdict |
34
+ |-------|-------|--------|-------------------|--------|---------|
35
+ | [phase] | [match/mismatch] | [match/mismatch] | [match/mismatch] | [match/mismatch] | [OK/VIOLATION] |
36
+
37
+ **Violations:**
38
+ - [phase]: [playbook says X, agent did Y — bucket: documentation_issue/user_error]
39
+
40
+ ### Runbook Conformance
41
+
42
+ | Runbook | Steps Executed | Deviations | Verdict |
43
+ |---------|---------------|------------|---------|
44
+ | [id] | X/Y | [list] | [OK/DEVIATED] |
45
+
46
+ ### Code Bugs
47
+
48
+ #### [CB-1] [Title]
49
+ - **Tool:** `exarchos_workflow` action `set`
50
+ - **Error:** `INVALID_INPUT: ...`
51
+ - **Root cause:** [diagnosis]
52
+ - **Trace evidence:** [what describe/view/event query revealed]
53
+ - **Authoritative ref:** [e.g., `describe(actions: ['set']) → TaskSchema`]
54
+ - **Impact:** [blocked workflow / degraded experience / minor friction]
55
+ - **Suggested fix:** [specific code change]
56
+ - **Files:** [file:line references]
57
+
58
+ ### Documentation Issues
59
+
60
+ #### [DOC-1] [Title]
61
+ - **Tool:** `exarchos_event` action `append`
62
+ - **Error:** `VALIDATION_ERROR: invalid_enum_value`
63
+ - **Root cause:** [diagnosis — what the docs say vs what describe output shows]
64
+ - **Trace evidence:** [describe output vs skill doc content]
65
+ - **Authoritative ref:** [e.g., `describe(eventTypes: ['team.spawned']) → JSON Schema`]
66
+ - **Skill/Reference:** [skills/X/SKILL.md:line or references/Y.md:line]
67
+ - **Source of truth:** [describe action + servers/exarchos-mcp/src/file.ts:line]
68
+ - **Suggested fix:** [update docs to match describe output]
69
+
70
+ ### User Errors
71
+
72
+ #### [UE-1] [Title]
73
+ - **Tool:** `exarchos_orchestrate` action `check_tdd_compliance`
74
+ - **Error:** [error message]
75
+ - **What happened:** [agent did X]
76
+ - **What should have happened:** [both docs and describe agree on Y]
77
+ - **Authoritative ref:** [confirm docs match describe/topology/playbook]
78
+ - **Skill improvement:** [if the error is common, suggest making the skill clearer]
79
+
80
+ ### Trace-Only Findings
81
+
82
+ Issues discovered solely through debug trace (not visible in conversation errors):
83
+
84
+ #### [T-1] [Title]
85
+ - **Discovery method:** [describe comparison / event log analysis / view query / playbook check]
86
+ - **Evidence:** [what the trace revealed]
87
+ - **Authoritative ref:** [which self-service query provided the ground truth]
88
+ - **Bucket:** [code_bug / documentation_issue]
89
+ - **Impact:** [silent data loss / state drift / stale guidance / playbook-skill divergence]
90
+ - **Suggested fix:** [specific change]
91
+
92
+ ### Issue Drafts
93
+
94
+ Ready-to-file issue bodies for Code Bugs and Documentation Issues:
95
+
96
+ #### Issue: [CB-1 title]
97
+ ```
98
+ gh issue create --title "bug: [summary]" --label "bug" --body "..."
99
+ ```
100
+
101
+ #### Issue: [DOC-1 title]
102
+ ```
103
+ gh issue create --title "docs: [summary]" --label "bug" --body "..."
104
+ ```
105
+
106
+ ### Patterns & Trends
107
+
108
+ [Observations about recurring failure modes, systemic issues, or improvements to the dogfood process itself]
109
+ ```