self-evolving-workflow 0.0.0-stage → 0.1.4

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 (375) hide show
  1. package/LICENSE +27 -0
  2. package/README.md +195 -2
  3. package/dist/agent-memory-prompts.d.ts +13 -0
  4. package/dist/agent-memory-prompts.js +55 -0
  5. package/dist/cli.d.ts +2 -0
  6. package/dist/cli.js +6 -0
  7. package/dist/closeout.d.ts +105 -0
  8. package/dist/closeout.js +473 -0
  9. package/dist/code.d.ts +39 -0
  10. package/dist/code.js +124 -0
  11. package/dist/codex-memory.d.ts +24 -0
  12. package/dist/codex-memory.js +217 -0
  13. package/dist/common.d.ts +16 -0
  14. package/dist/common.js +52 -0
  15. package/dist/context-envelope.d.ts +59 -0
  16. package/dist/context-envelope.js +23 -0
  17. package/dist/host-adapters.d.ts +34 -0
  18. package/dist/host-adapters.js +151 -0
  19. package/dist/http.d.ts +3 -0
  20. package/dist/http.js +90 -0
  21. package/dist/index.d.ts +16 -0
  22. package/dist/index.js +13 -0
  23. package/dist/knowledge-cli.d.ts +198 -0
  24. package/dist/knowledge-cli.js +761 -0
  25. package/dist/knowledge-reads.d.ts +72 -0
  26. package/dist/knowledge-reads.js +201 -0
  27. package/dist/memory-config.d.ts +44 -0
  28. package/dist/memory-config.js +204 -0
  29. package/dist/memory-evidence.d.ts +13 -0
  30. package/dist/memory-evidence.js +40 -0
  31. package/dist/memory-history.d.ts +46 -0
  32. package/dist/memory-history.js +432 -0
  33. package/dist/memory.d.ts +96 -0
  34. package/dist/memory.js +362 -0
  35. package/dist/retrospective.d.ts +57 -0
  36. package/dist/retrospective.js +240 -0
  37. package/dist/search.d.ts +36 -0
  38. package/dist/search.js +112 -0
  39. package/dist/skill-addition.d.ts +25 -0
  40. package/dist/skill-addition.js +89 -0
  41. package/dist/skill-design.d.ts +96 -0
  42. package/dist/skill-design.js +226 -0
  43. package/dist/skill-replay.d.ts +55 -0
  44. package/dist/skill-replay.js +448 -0
  45. package/dist/skill-route.d.ts +30 -0
  46. package/dist/skill-route.js +75 -0
  47. package/dist/transcript-evidence.d.ts +3 -0
  48. package/dist/transcript-evidence.js +58 -0
  49. package/dist/upstream/chunker.d.ts +24 -0
  50. package/dist/upstream/chunker.js +96 -0
  51. package/dist/upstream/file-protocol.d.ts +45 -0
  52. package/dist/upstream/file-protocol.js +117 -0
  53. package/dist/upstream/frontmatter.d.ts +47 -0
  54. package/dist/upstream/frontmatter.js +86 -0
  55. package/dist/upstream/graph-search.d.ts +33 -0
  56. package/dist/upstream/graph-search.js +67 -0
  57. package/dist/upstream/l1-extraction.d.ts +26 -0
  58. package/dist/upstream/l1-extraction.js +405 -0
  59. package/dist/upstream/llm.d.ts +8 -0
  60. package/dist/upstream/llm.js +1 -0
  61. package/dist/upstream/merge.d.ts +50 -0
  62. package/dist/upstream/merge.js +153 -0
  63. package/dist/upstream/prompts.d.ts +53 -0
  64. package/dist/upstream/prompts.js +181 -0
  65. package/dist/upstream/search-utils.d.ts +34 -0
  66. package/dist/upstream/search-utils.js +55 -0
  67. package/dist/upstream/slug.d.ts +26 -0
  68. package/dist/upstream/slug.js +103 -0
  69. package/dist/upstream/template.d.ts +29 -0
  70. package/dist/upstream/template.js +80 -0
  71. package/dist/upstream/tokenize.d.ts +4 -0
  72. package/dist/upstream/tokenize.js +29 -0
  73. package/dist/wiki-change.d.ts +76 -0
  74. package/dist/wiki-change.js +299 -0
  75. package/dist/wiki-entry.d.ts +26 -0
  76. package/dist/wiki-entry.js +93 -0
  77. package/dist/wiki-ingest.d.ts +12 -0
  78. package/dist/wiki-ingest.js +126 -0
  79. package/dist/wiki-migration.d.ts +16 -0
  80. package/dist/wiki-migration.js +268 -0
  81. package/dist/wiki-tokens.d.ts +1 -0
  82. package/dist/wiki-tokens.js +46 -0
  83. package/dist/wiki.d.ts +103 -0
  84. package/dist/wiki.js +330 -0
  85. package/dist/workflow-cli.d.ts +2 -0
  86. package/dist/workflow-cli.js +319 -0
  87. package/dist/workflow-install.d.ts +37 -0
  88. package/dist/workflow-install.js +148 -0
  89. package/dist/workflow-knowledge.d.ts +18 -0
  90. package/dist/workflow-knowledge.js +32 -0
  91. package/dist/workflow-mcp.d.ts +2 -0
  92. package/dist/workflow-mcp.js +137 -0
  93. package/dist/workflow-names.d.ts +4 -0
  94. package/dist/workflow-names.js +31 -0
  95. package/dist/workflow-runtime.d.ts +735 -0
  96. package/dist/workflow-runtime.js +747 -0
  97. package/dist/workflow-skills.d.ts +48 -0
  98. package/dist/workflow-skills.js +141 -0
  99. package/docs/images/impeccable-skill.png +0 -0
  100. package/docs/images/workflow-overview.png +0 -0
  101. package/docs/images/workflow-skills.png +0 -0
  102. package/package.json +77 -4
  103. package/skills/ew-impeccable/LICENSE +191 -0
  104. package/skills/ew-impeccable/NOTICE.md +19 -0
  105. package/skills/ew-impeccable/SKILL.md +91 -0
  106. package/skills/ew-impeccable/UPSTREAM.md +23 -0
  107. package/skills/ew-impeccable/reference/adapt.md +314 -0
  108. package/skills/ew-impeccable/reference/adapt.native.md +60 -0
  109. package/skills/ew-impeccable/reference/android.md +46 -0
  110. package/skills/ew-impeccable/reference/animate.md +91 -0
  111. package/skills/ew-impeccable/reference/audit.md +138 -0
  112. package/skills/ew-impeccable/reference/audit.native.md +141 -0
  113. package/skills/ew-impeccable/reference/bolder.md +35 -0
  114. package/skills/ew-impeccable/reference/clarify.md +96 -0
  115. package/skills/ew-impeccable/reference/colorize.md +88 -0
  116. package/skills/ew-impeccable/reference/craft-floor.md +44 -0
  117. package/skills/ew-impeccable/reference/craft.md +5 -0
  118. package/skills/ew-impeccable/reference/critique.md +808 -0
  119. package/skills/ew-impeccable/reference/degraded/asset-producer.md +36 -0
  120. package/skills/ew-impeccable/reference/degraded/documenter.md +23 -0
  121. package/skills/ew-impeccable/reference/degraded/finish-reviewer.md +72 -0
  122. package/skills/ew-impeccable/reference/degraded/manual-edit-applier.md +91 -0
  123. package/skills/ew-impeccable/reference/delight.md +72 -0
  124. package/skills/ew-impeccable/reference/distill.md +113 -0
  125. package/skills/ew-impeccable/reference/doctor.md +56 -0
  126. package/skills/ew-impeccable/reference/document.md +418 -0
  127. package/skills/ew-impeccable/reference/extract.md +68 -0
  128. package/skills/ew-impeccable/reference/harden.md +338 -0
  129. package/skills/ew-impeccable/reference/hooks.md +113 -0
  130. package/skills/ew-impeccable/reference/init.md +133 -0
  131. package/skills/ew-impeccable/reference/ios.md +51 -0
  132. package/skills/ew-impeccable/reference/layout.md +86 -0
  133. package/skills/ew-impeccable/reference/live-setup.md +102 -0
  134. package/skills/ew-impeccable/reference/live.md +326 -0
  135. package/skills/ew-impeccable/reference/new-work.md +209 -0
  136. package/skills/ew-impeccable/reference/onboard.md +236 -0
  137. package/skills/ew-impeccable/reference/operate.md +61 -0
  138. package/skills/ew-impeccable/reference/optimize.md +260 -0
  139. package/skills/ew-impeccable/reference/overdrive.md +127 -0
  140. package/skills/ew-impeccable/reference/polish.md +105 -0
  141. package/skills/ew-impeccable/reference/quieter.md +101 -0
  142. package/skills/ew-impeccable/reference/routing.md +20 -0
  143. package/skills/ew-impeccable/reference/shape.md +59 -0
  144. package/skills/ew-impeccable/reference/typeset.md +82 -0
  145. package/skills/ew-impeccable/reference/visualize.md +46 -0
  146. package/skills/ew-impeccable/scripts/build-phase.mjs +1022 -0
  147. package/skills/ew-impeccable/scripts/command-metadata.json +94 -0
  148. package/skills/ew-impeccable/scripts/comp-diff.mjs +391 -0
  149. package/skills/ew-impeccable/scripts/comp-spec.mjs +513 -0
  150. package/skills/ew-impeccable/scripts/concept-seed.mjs +814 -0
  151. package/skills/ew-impeccable/scripts/context-signals.mjs +325 -0
  152. package/skills/ew-impeccable/scripts/context.mjs +1521 -0
  153. package/skills/ew-impeccable/scripts/critique-storage.mjs +473 -0
  154. package/skills/ew-impeccable/scripts/data/font-index-failures.json +121 -0
  155. package/skills/ew-impeccable/scripts/data/font-index.json +1 -0
  156. package/skills/ew-impeccable/scripts/detect-csp.mjs +246 -0
  157. package/skills/ew-impeccable/scripts/detect.mjs +30 -0
  158. package/skills/ew-impeccable/scripts/detector/browser/injected/index.mjs +2580 -0
  159. package/skills/ew-impeccable/scripts/detector/cli/main.mjs +498 -0
  160. package/skills/ew-impeccable/scripts/detector/design-system.mjs +1311 -0
  161. package/skills/ew-impeccable/scripts/detector/detect-antipatterns-browser.js +9486 -0
  162. package/skills/ew-impeccable/scripts/detector/detect-antipatterns.mjs +51 -0
  163. package/skills/ew-impeccable/scripts/detector/engines/browser/detect-url.mjs +434 -0
  164. package/skills/ew-impeccable/scripts/detector/engines/regex/detect-text.mjs +1439 -0
  165. package/skills/ew-impeccable/scripts/detector/engines/static-html/css-cascade.mjs +1242 -0
  166. package/skills/ew-impeccable/scripts/detector/engines/static-html/detect-html.mjs +263 -0
  167. package/skills/ew-impeccable/scripts/detector/engines/visual/screenshot-contrast.mjs +189 -0
  168. package/skills/ew-impeccable/scripts/detector/findings.mjs +23 -0
  169. package/skills/ew-impeccable/scripts/detector/node/file-system.mjs +225 -0
  170. package/skills/ew-impeccable/scripts/detector/profile/profiler.mjs +166 -0
  171. package/skills/ew-impeccable/scripts/detector/registry/antipatterns.mjs +636 -0
  172. package/skills/ew-impeccable/scripts/detector/rules/checks.mjs +5750 -0
  173. package/skills/ew-impeccable/scripts/detector/shared/color.mjs +596 -0
  174. package/skills/ew-impeccable/scripts/detector/shared/constants.mjs +127 -0
  175. package/skills/ew-impeccable/scripts/detector/shared/fonts.mjs +30 -0
  176. package/skills/ew-impeccable/scripts/detector/shared/inline-ignores.mjs +148 -0
  177. package/skills/ew-impeccable/scripts/detector/shared/page.mjs +7 -0
  178. package/skills/ew-impeccable/scripts/detector/vendor/MDN-DATA-LICENSE +116 -0
  179. package/skills/ew-impeccable/scripts/detector/vendor/THIRD_PARTY_LICENSES.md +227 -0
  180. package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.build-entry.txt +11 -0
  181. package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.bundle.mjs +9121 -0
  182. package/skills/ew-impeccable/scripts/doctor.mjs +330 -0
  183. package/skills/ew-impeccable/scripts/embed-prompt.mjs +166 -0
  184. package/skills/ew-impeccable/scripts/font-match.mjs +457 -0
  185. package/skills/ew-impeccable/scripts/generate-image.mjs +447 -0
  186. package/skills/ew-impeccable/scripts/hook-admin.mjs +829 -0
  187. package/skills/ew-impeccable/scripts/hook-before-edit.mjs +538 -0
  188. package/skills/ew-impeccable/scripts/hook-lib.mjs +2493 -0
  189. package/skills/ew-impeccable/scripts/hook.mjs +79 -0
  190. package/skills/ew-impeccable/scripts/lib/artifact-schema.mjs +93 -0
  191. package/skills/ew-impeccable/scripts/lib/composition-catalog.mjs +200 -0
  192. package/skills/ew-impeccable/scripts/lib/concept-catalog.mjs +395 -0
  193. package/skills/ew-impeccable/scripts/lib/design-parser.mjs +880 -0
  194. package/skills/ew-impeccable/scripts/lib/font-fingerprint.mjs +564 -0
  195. package/skills/ew-impeccable/scripts/lib/font-index.mjs +130 -0
  196. package/skills/ew-impeccable/scripts/lib/hero-checks.mjs +246 -0
  197. package/skills/ew-impeccable/scripts/lib/image-metrics.mjs +306 -0
  198. package/skills/ew-impeccable/scripts/lib/impeccable-config.mjs +640 -0
  199. package/skills/ew-impeccable/scripts/lib/impeccable-paths.mjs +137 -0
  200. package/skills/ew-impeccable/scripts/lib/is-generated.mjs +72 -0
  201. package/skills/ew-impeccable/scripts/lib/live-path-globs.mjs +37 -0
  202. package/skills/ew-impeccable/scripts/lib/open-system-browser.mjs +26 -0
  203. package/skills/ew-impeccable/scripts/lib/png.mjs +281 -0
  204. package/skills/ew-impeccable/scripts/lib/provider.mjs +5 -0
  205. package/skills/ew-impeccable/scripts/lib/raster.mjs +194 -0
  206. package/skills/ew-impeccable/scripts/lib/roll-selection.mjs +369 -0
  207. package/skills/ew-impeccable/scripts/lib/staleness-deep.mjs +491 -0
  208. package/skills/ew-impeccable/scripts/lib/staleness-notice.mjs +169 -0
  209. package/skills/ew-impeccable/scripts/lib/staleness.mjs +532 -0
  210. package/skills/ew-impeccable/scripts/lib/surface-briefs.mjs +149 -0
  211. package/skills/ew-impeccable/scripts/lib/target-args.mjs +42 -0
  212. package/skills/ew-impeccable/scripts/lib/target-slug.mjs +33 -0
  213. package/skills/ew-impeccable/scripts/lib/template-extensions.mjs +146 -0
  214. package/skills/ew-impeccable/scripts/live/accept-css.mjs +617 -0
  215. package/skills/ew-impeccable/scripts/live/accept-verify.mjs +60 -0
  216. package/skills/ew-impeccable/scripts/live/browser-script-parts.mjs +84 -0
  217. package/skills/ew-impeccable/scripts/live/completion.mjs +28 -0
  218. package/skills/ew-impeccable/scripts/live/event-validation.mjs +199 -0
  219. package/skills/ew-impeccable/scripts/live/frameworks/astro.mjs +47 -0
  220. package/skills/ew-impeccable/scripts/live/frameworks/detect-utils.mjs +73 -0
  221. package/skills/ew-impeccable/scripts/live/frameworks/index.mjs +143 -0
  222. package/skills/ew-impeccable/scripts/live/frameworks/journal.mjs +197 -0
  223. package/skills/ew-impeccable/scripts/live/frameworks/nextjs.mjs +49 -0
  224. package/skills/ew-impeccable/scripts/live/frameworks/nuxt.mjs +161 -0
  225. package/skills/ew-impeccable/scripts/live/frameworks/script-src.mjs +17 -0
  226. package/skills/ew-impeccable/scripts/live/frameworks/static-html.mjs +26 -0
  227. package/skills/ew-impeccable/scripts/live/frameworks/sveltekit.mjs +71 -0
  228. package/skills/ew-impeccable/scripts/live/frameworks/tag-strategy.mjs +247 -0
  229. package/skills/ew-impeccable/scripts/live/frameworks/tanstack-start.mjs +70 -0
  230. package/skills/ew-impeccable/scripts/live/frameworks/vite-generic.mjs +42 -0
  231. package/skills/ew-impeccable/scripts/live/generation-preflight.mjs +149 -0
  232. package/skills/ew-impeccable/scripts/live/insert-ui.mjs +458 -0
  233. package/skills/ew-impeccable/scripts/live/instructions.mjs +142 -0
  234. package/skills/ew-impeccable/scripts/live/manual-apply.mjs +939 -0
  235. package/skills/ew-impeccable/scripts/live/manual-edit-routes.mjs +357 -0
  236. package/skills/ew-impeccable/scripts/live/manual-edits-buffer.mjs +152 -0
  237. package/skills/ew-impeccable/scripts/live/poll-lanes.mjs +14 -0
  238. package/skills/ew-impeccable/scripts/live/project-ignores.mjs +139 -0
  239. package/skills/ew-impeccable/scripts/live/roots.mjs +508 -0
  240. package/skills/ew-impeccable/scripts/live/session-store.mjs +563 -0
  241. package/skills/ew-impeccable/scripts/live/source-lock.mjs +105 -0
  242. package/skills/ew-impeccable/scripts/live/source-search.mjs +105 -0
  243. package/skills/ew-impeccable/scripts/live/svelte-ast.mjs +969 -0
  244. package/skills/ew-impeccable/scripts/live/svelte-component.mjs +1366 -0
  245. package/skills/ew-impeccable/scripts/live/sveltekit-adapter.mjs +304 -0
  246. package/skills/ew-impeccable/scripts/live/tanstack-adapter.mjs +259 -0
  247. package/skills/ew-impeccable/scripts/live/ui-surfaces.mjs +75 -0
  248. package/skills/ew-impeccable/scripts/live/vocabulary.mjs +171 -0
  249. package/skills/ew-impeccable/scripts/live-accept.mjs +938 -0
  250. package/skills/ew-impeccable/scripts/live-browser-dom.js +167 -0
  251. package/skills/ew-impeccable/scripts/live-browser-ignores.js +242 -0
  252. package/skills/ew-impeccable/scripts/live-browser-session.js +144 -0
  253. package/skills/ew-impeccable/scripts/live-browser.js +12851 -0
  254. package/skills/ew-impeccable/scripts/live-commit-manual-edits.mjs +1200 -0
  255. package/skills/ew-impeccable/scripts/live-complete.mjs +107 -0
  256. package/skills/ew-impeccable/scripts/live-copy-edit-agent.mjs +800 -0
  257. package/skills/ew-impeccable/scripts/live-discard-manual-edits.mjs +51 -0
  258. package/skills/ew-impeccable/scripts/live-inject.mjs +463 -0
  259. package/skills/ew-impeccable/scripts/live-insert.mjs +292 -0
  260. package/skills/ew-impeccable/scripts/live-manual-edit-evidence.mjs +368 -0
  261. package/skills/ew-impeccable/scripts/live-poll.mjs +430 -0
  262. package/skills/ew-impeccable/scripts/live-resume.mjs +123 -0
  263. package/skills/ew-impeccable/scripts/live-server.mjs +1698 -0
  264. package/skills/ew-impeccable/scripts/live-status.mjs +71 -0
  265. package/skills/ew-impeccable/scripts/live-target.mjs +30 -0
  266. package/skills/ew-impeccable/scripts/live-wrap.mjs +927 -0
  267. package/skills/ew-impeccable/scripts/live.mjs +334 -0
  268. package/skills/ew-impeccable/scripts/modern-screenshot.umd.js +14 -0
  269. package/skills/ew-impeccable/scripts/palette.mjs +628 -0
  270. package/skills/ew-impeccable/scripts/pin.mjs +352 -0
  271. package/skills/ew-impeccable/scripts/serve-question.mjs +1783 -0
  272. package/skills/ew-impeccable/scripts/surface-brief.mjs +74 -0
  273. package/skills/ew-knowledge/SKILL.md +35 -0
  274. package/skills/ew-knowledge/references/closeout-protocol.md +68 -0
  275. package/skills/ew-knowledge/references/knowledge-route.md +73 -0
  276. package/skills/ew-knowledge/references/wiki-maintenance.md +27 -0
  277. package/skills/ew-odyssey/SKILL.md +106 -0
  278. package/skills/ew-odyssey/references/audit-artifacts.md +7 -0
  279. package/skills/ew-odyssey/references/odyssey-base.md +104 -0
  280. package/skills/ew-odyssey/references/odyssey-debug.md +264 -0
  281. package/skills/ew-odyssey/references/odyssey-defensive.md +351 -0
  282. package/skills/ew-odyssey/references/odyssey-improve.md +230 -0
  283. package/skills/ew-odyssey/references/odyssey-planex.md +294 -0
  284. package/skills/ew-odyssey/references/odyssey-review.md +233 -0
  285. package/skills/ew-odyssey/references/odyssey-security.md +231 -0
  286. package/skills/ew-odyssey/references/odyssey-ui.md +232 -0
  287. package/skills/ew-odyssey/references/prepare/odyssey-debug.md +102 -0
  288. package/skills/ew-odyssey/references/prepare/odyssey-defensive.md +117 -0
  289. package/skills/ew-odyssey/references/prepare/odyssey-improve.md +95 -0
  290. package/skills/ew-odyssey/references/prepare/odyssey-planex.md +105 -0
  291. package/skills/ew-odyssey/references/prepare/odyssey-review.md +105 -0
  292. package/skills/ew-odyssey/references/prepare/odyssey-security.md +91 -0
  293. package/skills/ew-odyssey/references/prepare/odyssey-ui.md +88 -0
  294. package/skills/ew-odyssey/references/runtime-adapters.md +31 -0
  295. package/skills/ew-orchestrate/SKILL.md +89 -0
  296. package/skills/ew-orchestrate/references/auto-policy.md +66 -0
  297. package/skills/ew-orchestrate/references/boundary-grill.md +51 -0
  298. package/skills/ew-orchestrate/references/companion-route.md +40 -0
  299. package/skills/ew-orchestrate/references/ew-orchestrate.md +44 -0
  300. package/skills/ew-orchestrate/references/goal.md +51 -0
  301. package/skills/ew-orchestrate/references/orchestrator-run-loop.md +33 -0
  302. package/skills/ew-orchestrate/references/planning.md +54 -0
  303. package/skills/ew-orchestrate/steps/ew-analyze/SKILL.md +70 -0
  304. package/skills/ew-orchestrate/steps/ew-analyze/references/issue-gaps-analyze.md +24 -0
  305. package/skills/ew-orchestrate/steps/ew-analyze/references/prepare.md +8 -0
  306. package/skills/ew-orchestrate/steps/ew-analyze/references/workflow.md +138 -0
  307. package/skills/ew-orchestrate/steps/ew-auto-test/SKILL.md +80 -0
  308. package/skills/ew-orchestrate/steps/ew-auto-test/references/prepare.md +23 -0
  309. package/skills/ew-orchestrate/steps/ew-auto-test/references/workflow.md +31 -0
  310. package/skills/ew-orchestrate/steps/ew-blueprint/SKILL.md +122 -0
  311. package/skills/ew-orchestrate/steps/ew-blueprint/references/prepare.md +21 -0
  312. package/skills/ew-orchestrate/steps/ew-blueprint/references/workflow.md +28 -0
  313. package/skills/ew-orchestrate/steps/ew-brainstorm/SKILL.md +49 -0
  314. package/skills/ew-orchestrate/steps/ew-companion/SKILL.md +50 -0
  315. package/skills/ew-orchestrate/steps/ew-debug/SKILL.md +85 -0
  316. package/skills/ew-orchestrate/steps/ew-debug/references/prepare.md +27 -0
  317. package/skills/ew-orchestrate/steps/ew-debug/references/workflow.md +31 -0
  318. package/skills/ew-orchestrate/steps/ew-execute/SKILL.md +74 -0
  319. package/skills/ew-orchestrate/steps/ew-execute/references/prepare.md +27 -0
  320. package/skills/ew-orchestrate/steps/ew-execute/references/workflow.md +87 -0
  321. package/skills/ew-orchestrate/steps/ew-grill/SKILL.md +62 -0
  322. package/skills/ew-orchestrate/steps/ew-grill/references/prepare.md +26 -0
  323. package/skills/ew-orchestrate/steps/ew-grill/references/workflow.md +31 -0
  324. package/skills/ew-orchestrate/steps/ew-init/SKILL.md +56 -0
  325. package/skills/ew-orchestrate/steps/ew-init/references/prepare.md +25 -0
  326. package/skills/ew-orchestrate/steps/ew-init/references/workflow.md +28 -0
  327. package/skills/ew-orchestrate/steps/ew-plan/SKILL.md +131 -0
  328. package/skills/ew-orchestrate/steps/ew-plan/references/prepare.md +8 -0
  329. package/skills/ew-orchestrate/steps/ew-plan/references/tdd.md +53 -0
  330. package/skills/ew-orchestrate/steps/ew-plan/references/workflow.md +100 -0
  331. package/skills/ew-orchestrate/steps/ew-retrospective/SKILL.md +68 -0
  332. package/skills/ew-orchestrate/steps/ew-retrospective/references/prepare.md +18 -0
  333. package/skills/ew-orchestrate/steps/ew-retrospective/references/workflow.md +34 -0
  334. package/skills/ew-orchestrate/steps/ew-review/SKILL.md +45 -0
  335. package/skills/ew-orchestrate/steps/ew-review/references/prepare.md +17 -0
  336. package/skills/ew-orchestrate/steps/ew-review/references/workflow.md +116 -0
  337. package/skills/ew-orchestrate/steps/ew-roadmap/SKILL.md +62 -0
  338. package/skills/ew-orchestrate/steps/ew-roadmap/references/prepare.md +27 -0
  339. package/skills/ew-orchestrate/steps/ew-roadmap/references/workflow.md +28 -0
  340. package/skills/ew-orchestrate/steps/ew-test/SKILL.md +99 -0
  341. package/skills/ew-orchestrate/steps/ew-test/references/prepare.md +23 -0
  342. package/skills/ew-orchestrate/steps/ew-test/references/workflow.md +23 -0
  343. package/skills/ew-orchestrate/steps/ew-verify/SKILL.md +73 -0
  344. package/skills/ew-orchestrate/steps/ew-verify/references/prepare.md +21 -0
  345. package/skills/ew-orchestrate/steps/ew-verify/references/workflow.md +29 -0
  346. package/skills/ew-skill-design/SKILL.md +30 -0
  347. package/skills/ew-skill-design/references/package-contract.md +40 -0
  348. package/skills/ew-skill-design/references/validation.md +21 -0
  349. package/skills/team-swarm/SKILL.md +68 -0
  350. package/skills/team-swarm/references/mcp-coordination.md +14 -0
  351. package/skills/team-swarm/roles/analyst/role.md +181 -0
  352. package/skills/team-swarm/roles/ant/role.md +149 -0
  353. package/skills/team-swarm/roles/coordinator/commands/converge.md +112 -0
  354. package/skills/team-swarm/roles/coordinator/commands/init-swarm.md +136 -0
  355. package/skills/team-swarm/roles/coordinator/commands/iterate.md +171 -0
  356. package/skills/team-swarm/roles/coordinator/role.md +170 -0
  357. package/skills/team-swarm/roles/scorer/role.md +150 -0
  358. package/skills/team-swarm/scripts/aco.py +646 -0
  359. package/skills/team-swarm/scripts/pheromone.py +144 -0
  360. package/skills/team-swarm/scripts/scoring.py +111 -0
  361. package/skills/team-swarm/scripts/test_aco.py +606 -0
  362. package/skills/team-swarm/specs/ant-output-schema.md +127 -0
  363. package/skills/team-swarm/specs/convergence-criteria.md +108 -0
  364. package/skills/team-swarm/specs/pheromone-schema.md +125 -0
  365. package/skills/team-swarm/specs/swarm-config-template.json +71 -0
  366. package/skills/team-swarm/specs/swarm-protocol.md +119 -0
  367. package/skills/workflow-evolve/SKILL.md +64 -0
  368. package/skills/workflow-evolve/references/agy-gate.md +27 -0
  369. package/skills/workflow-evolve/references/auto-loop.md +23 -0
  370. package/skills/workflow-evolve/references/history-review.md +15 -0
  371. package/skills/workflow-evolve/scripts/codex-memory-replay.mjs +86 -0
  372. package/skills/workflow-evolve/scripts/codex-replay.mjs +1 -0
  373. package/skills/workflow-evolve/scripts/evolve-loop.mjs +260 -0
  374. package/skills/workflow-evolve/scripts/memory-codex-mcp.mjs +124 -0
  375. package/workflows/index.json +33 -0
@@ -0,0 +1,230 @@
1
+ # Workflow: Odyssey Improve
2
+
3
+ 6-dimension runtime quality improvement — performance/security/architecture/reliability/observability/maintainability audit → diagnose → fix → generalize. Follow [shared phases](odyssey-base.md) and [runtime adapters](runtime-adapters.md).
4
+
5
+ ---
6
+
7
+ ## State Chain
8
+
9
+ ```
10
+ S_INTAKE → S_SURVEY → S_AUDIT → S_DIAGNOSE → S_FIX → S_VERIFY → [back-half]
11
+ ```
12
+
13
+ Back-half: `S_GENERALIZE → S_DISCOVER → S_RECORD → END` (see [shared phases](odyssey-base.md) §Shared Back-Half).
14
+
15
+ ---
16
+
17
+ ## Boundary
18
+
19
+ **In scope:** Runtime quality improvement — performance/security/architecture/reliability/observability/maintainability audit → diagnose → fix → generalize. **Out of scope:** UI visual → `--mode ui` | New features → `--mode planex` | Single bug → `--mode debug` | Style review → `--mode review`. Zero-residual applies.
20
+
21
+ ---
22
+
23
+ ## Context
24
+
25
+ ### Target Resolution
26
+
27
+ | Input | Resolution |
28
+ |-------|-----------|
29
+ | Module/dir path | Audit that module |
30
+ | `HEAD` / `staged` | Review changes in diff |
31
+ | Feature area keyword | Resolve to related files |
32
+ | `--all` | Full project scan (use with caution) |
33
+
34
+ ### Dimensions (6)
35
+
36
+ 1. **performance** — hot paths, N+1, memory allocation, cache efficiency, bundle size, lazy loading
37
+ 2. **security** — OWASP Top 10, injection, auth bypass, data exposure, dependency vulns, secrets
38
+ 3. **architecture** — layer violations, circular deps, coupling, interface contracts, SRP
39
+ 4. **reliability** — error handling gaps, retry, timeout, graceful degradation, resource cleanup
40
+ 5. **observability** — logging coverage, metric gaps, trace propagation, error reporting, health checks
41
+ 6. **maintainability** — cyclomatic complexity, dead code, test coverage gaps, doc debt
42
+
43
+ ### Session Fields
44
+
45
+ ```json
46
+ { "target": "", "dimensions": [], "baseline_metrics": {},
47
+ "audit_result": {}, "diagnoses": [], "confirmation": null,
48
+ "generalization_stats": null }
49
+ ```
50
+
51
+ ### evidence.ndjson Phases
52
+
53
+ `survey|audit|diagnosis|fix|discovery|decision|self-iteration`
54
+
55
+ - `survey`: `category` (dependency|complexity|coverage|error_pattern), `detail`
56
+ - `audit`: `dimension`, `severity`, `measurement`
57
+ - `diagnosis`: `finding_ref`, `hypothesis`, `result`, `root_cause`
58
+ - `fix`: `finding_ref`, `change_summary`, `risk`
59
+
60
+ ### phase_goals[]
61
+
62
+ | ID | Goal | Phase | skip_when |
63
+ |----|------|-------|-----------|
64
+ | G1 | Survey completed | S_SURVEY | — |
65
+ | G2 | Audit completed | S_AUDIT | — |
66
+ | G3 | Diagnosis completed | S_DIAGNOSE | — |
67
+ | G4 | Zero remaining: all findings fixed and verified | S_VERIFY | skip_fix |
68
+ | G5 | Pattern generalized | S_GENERALIZE | skip_generalize |
69
+ | G6 | Discoveries triaged | S_DISCOVER | skip_generalize |
70
+ | G7 | Learnings persisted | S_RECORD | — |
71
+
72
+ ### understanding.md — 9 Sections
73
+
74
+ 1. Target & Baseline
75
+ 2. Current State Survey
76
+ 3. Audit Findings
77
+ 4. Root Cause Diagnosis
78
+ 5. Fix & Verification
79
+ 6. Generalization
80
+ 7. Discoveries
81
+ 8. Improvement Metrics (before/after)
82
+ 9. Engineering Learnings
83
+
84
+ ---
85
+
86
+ ## State Machine
87
+
88
+ ### Transitions
89
+
90
+ ```
91
+ S_SURVEY → S_AUDIT : complete
92
+ S_AUDIT → S_DIAGNOSE : critical/high findings exist
93
+ S_AUDIT → S_GENERALIZE : no critical/high, !skip_generalize
94
+ S_AUDIT → S_RECORD : no findings OR skip_generalize
95
+ S_DIAGNOSE → S_FIX : root causes identified, !skip_fix
96
+ S_DIAGNOSE → S_GENERALIZE : root causes identified, skip_fix, !skip_generalize
97
+ S_DIAGNOSE → S_RECORD : root causes identified, skip_fix, skip_generalize
98
+ S_DIAGNOSE → S_DIAGNOSE : hypotheses failed, retries < 3 → A_ESCALATE_DIAGNOSIS
99
+ S_DIAGNOSE → S_RECORD : retries >= 3 → INCONCLUSIVE
100
+ S_FIX → S_VERIFY : fix implemented
101
+ S_VERIFY → S_GENERALIZE : verified, !skip_generalize
102
+ S_VERIFY → S_RECORD : verified, skip_generalize
103
+ S_VERIFY → S_FIX : needs_rework
104
+ ```
105
+
106
+ ### Actions
107
+
108
+ **A_INTAKE extra** — Baseline capture: record current metrics (test pass rate, bundle size, dependency count, complexity hotspots) to `session.json.baseline_metrics`.
109
+
110
+ **A_SURVEY** — (1) Dependency audit (package.json/lock), complexity scan (size/nesting), test coverage map, error handling scan (empty catch, unhandled promise). (2) CLI-assisted (optional): `evolve delegate "Survey dependency health, complexity hotspots, coverage gaps, and error patterns for {target}" --to codex --mode analysis`. (3) Evidence phase=survey. Update §2. Mark G1.
111
+
112
+ Commit: `"odyssey-improve({slug}): SURVEY — current state survey complete"`
113
+
114
+ **A_AUDIT** — Run 6 parallel subagents (one per dimension, or `--dimensions` subset; join all before advancing — see [runtime adapters](runtime-adapters.md)). Each returns `[{title, severity, dimension, file, line, description, suggestion, measurement}]`. Merge → evidence phase=audit. Write `session.json.audit_result`. Update §3 (findings by dimension + severity matrix). Mark G2.
115
+
116
+ **GATE: all-dimensions-audited** — all 6 dimensions (or `--dimensions` subset) completed with structured findings, merged into severity matrix, evidence phase=audit logged per dimension. Zero dimensions reviewed is BLOCKED (W002 partial from agent failure is a warning).
117
+
118
+ Commit: `"odyssey-improve({slug}): AUDIT — dimension audit complete"`
119
+
120
+ **A_DIAGNOSE** — Root cause analysis for critical/high findings — don't fix symptoms. (1) Group by dimension, prioritize by severity; for each: hypothesis → trace code path + git history → evidence phase=diagnosis. (2) Ambiguity → evidence phase=decision; Normal: structured prompt | `-y`: defer. (3) CLI-assisted for complex findings via `evolve delegate "<prompt>" --to codex --mode analysis`. (4) Write `session.json.diagnoses[]`. Update §4. Mark G3.
121
+
122
+ Commit: `"odyssey-improve({slug}): DIAGNOSE — root cause analysis complete"`
123
+
124
+ **A_ESCALATE_DIAGNOSIS** — `retries++`. < 3: `evolve delegate "Analyze failed hypotheses for {finding} and propose new root-cause hypotheses with file:line evidence" --to codex --mode analysis`, new hypotheses, → S_DIAGNOSE. >= 3: Normal → structured prompt | `-y` → INCONCLUSIVE → S_RECORD.
125
+
126
+ **A_FIX** — (1) Exhaustive fix: ALL diagnosed issues by severity tier (critical → high → medium → low within fix_threshold), one dimension at a time. After each tier, re-verify **current tier's dimension only** (not all dimensions); new findings at same or higher severity append to current tier. Cross-dimension regression checks run once at S_VERIFY after all tiers. **No partial-tier advancement** — each tier fully addressed (fixed or individually classified) before advancing; blanket "pre-existing" skip forbidden. (2) For each fix: implement → **run tests covering the modified area immediately** → evidence phase=fix. **Incremental verification** — each discrete fix step verified before proceeding; NEVER batch unrelated changes. **Rollback safety** — if tests fail after a fix step, revert that specific change (`git checkout -- {file}`) before attempting alternatives; NEVER proceed with failing tests. **Behavioral equivalence** — fixes MUST preserve existing behavior; no API changes, no new functionality. Beneficial changes discovered during fixing → evidence phase=decision as recommendations, NOT applied. **Scope lock** — once tier plan confirmed, no scope expansion without re-confirmation. (3) Normal: structured prompt per-fix | `-y`: auto-proceed, record `deferred`.
127
+
128
+ Commit: `"odyssey-improve({slug}): FIX — {dimension} {tier} tier addressed"`
129
+
130
+ **A_VERIFY** — (1) Run tests covering modified areas. (2) Re-capture metrics, compare with `baseline_metrics`. (3) CLI-assisted: `evolve delegate "Review fixes for {target} against quality dimensions and regressions" --to codex --mode analysis`. (4) `needs_rework` → S_FIX; `verified` → mark G4. (5) Write `confirmation`. Update §5 (before/after metrics table).
131
+
132
+ **GATE: zero-remaining-verified** — every diagnosed finding is fixed and verified, individually classified (issue / decision), or skipped via `--skip-fix`; tests pass over modified areas; metrics re-captured and compared against `baseline_metrics`; no unaddressed actionable findings; before/after table written to understanding.md §8.
133
+
134
+ Commit: `"odyssey-improve({slug}): VERIFY — fix verification complete"`
135
+
136
+ ---
137
+
138
+ ## Generalize Source
139
+
140
+ Diagnosed root causes + applied fixes across all dimensions. **Discover routing:** `bug` → S_FIX; new critical → S_DIAGNOSE.
141
+
142
+ ---
143
+
144
+ ## Knowledge Persistence (§9)
145
+
146
+ Include verified reusable findings in the Run summary and harvest the completed Session through `evolve workflows show knowledge` (`evolve closeout session` → `evolve wiki propose`).
147
+
148
+ A_RECORD extra: §8 improvement metrics — re-capture and build before/after comparison table from `baseline_metrics` vs current.
149
+
150
+ | Category | Content | Follow-up |
151
+ |----------|---------|-----------|
152
+ | Performance pattern | Bottleneck type + fix approach + measurement | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
153
+ | Security rule | Vulnerability class + fix + prevention | `evolve closeout session` → `evolve wiki propose` (`category: debug`) |
154
+ | Architecture constraint | Violation + correct boundary + check | `evolve closeout session` → `evolve wiki propose` (`category: arch`) |
155
+ | Reliability pattern | Failure mode + handling strategy + verification | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
156
+
157
+ ---
158
+
159
+ ## Completion Summary
160
+
161
+ ```
162
+ --- IMPROVE ODYSSEY COMPLETE ---
163
+ Target: {target}
164
+ Dimensions: {dimensions}
165
+ Findings: {critical}C / {high}H / {medium}M / {low}L
166
+ Diagnosed: {count}
167
+ Fixed: {count} ({verified} verified)
168
+ Metrics: {improved} improved / {regressed} regressed
169
+ Patterns: {count} ({by_layer})
170
+ Scan hits: {total} ({cross_layer_confirmed} confirmed)
171
+ Issues: {N} created
172
+ Decisions: {N} resolved, {M} pending, {K} deferred
173
+ Learnings: {N} persisted
174
+ Self-iter: {N} rounds across {M} stages
175
+ Cross-loops: {N}
176
+ Goals: {done}/{total} ({skipped} skipped)
177
+ ---
178
+ ```
179
+
180
+ ---
181
+
182
+ ## Mode `-y` Points
183
+
184
+ | Decision Point | Normal | `-y` |
185
+ |---------------|--------|------|
186
+ | A_FIX confirmation | structured prompt | auto-proceed `deferred` |
187
+ | A_DIAGNOSE ambiguity | structured prompt | auto-proceed with default, record `deferred` |
188
+ | A_ESCALATE 3-strike | structured prompt | auto INCONCLUSIVE |
189
+ | A_DISCOVER routing | structured prompt | auto create issue |
190
+ | Ambiguous items | structured prompt | all `deferred` |
191
+
192
+ ---
193
+
194
+ ## Phase Gates
195
+
196
+ - **Discovery gate** (SURVEY): evidence for the phase logged, understanding.md updated. Survey requires all scan types attempted.
197
+ - **Audit gate** (DIAGNOSE): all dimension agents completed, findings merged with severity classification. Zero dimensions reviewed is BLOCKED (W002 partial allowed).
198
+ - **FIX gate:** current severity tier fully addressed. Per-fix evidence phase=fix logged. **Per-change test verification** — each fix step runs tests before proceeding. **Rollback on failure** — failed fix reverted immediately. **Behavioral equivalence** — no API/behavior changes; beneficial changes logged as recommendations only. Auto-commit per tier. No partial-tier advancement.
199
+ - **VERIFY gate:** tests pass; metrics re-captured; confirmation written, understanding.md updated, verify goal marked. needs_rework → route back to FIX.
200
+
201
+ ---
202
+
203
+ ## Error Codes
204
+
205
+ | Code | Severity | Condition | Recovery |
206
+ |------|----------|-----------|----------|
207
+ | E001 | error | No target provided | Provide target or -c |
208
+ | E002 | error | Target path not found | Check path |
209
+ | W001 | warning | No dependency manifest / no test coverage tool | Proceed with defaults |
210
+ | W002 | warning | Some dimension agents failed | Partial coverage accepted |
211
+ | W004 | warning | Generalization 0 hits after full 3-layer scan | Advance to S_RECORD |
212
+ | W005 | warning | Pending decisions | Filter evidence phase=decision |
213
+
214
+ ---
215
+
216
+ ## Success Criteria
217
+
218
+ - [ ] Target resolved; session + output files created; baseline metrics captured
219
+ - [ ] Survey completed with all scan types attempted (dependency, complexity, coverage, error handling)
220
+ - [ ] 6-dimension audit completed with structured findings + severity matrix
221
+ - [ ] understanding.md sections written progressively (§1–§9)
222
+ - [ ] Fix + verify (unless --skip-fix); zero-residual — every finding has concrete action
223
+ - [ ] Multi-layer generalization + discovery triage (unless --skip-generalize)
224
+ - [ ] phase_goals derived, tracked, and hardened-audited; goal_mode injected via prepare goal:true
225
+ - [ ] §8 improvement metrics: before/after comparison table from baseline_metrics
226
+ - [ ] Session resumable via -c; completion summary emitted
227
+
228
+ ---
229
+
230
+ See [shared base](odyssey-base.md) for generic follow-up routing (`Next Step Routing`). Related transitions: `/ew-odyssey <finding> --mode debug` (root cause), `/ew-odyssey <changed-files> --mode review` (formal review), `/ew-odyssey <component> --mode ui` (UI fixes).
@@ -0,0 +1,294 @@
1
+ # Workflow: Odyssey Planex
2
+
3
+ Single requirement delivery loop — requirement parsing → acceptance criteria → plan → execute → verify → generalize. Follow [shared phases](odyssey-base.md) and [runtime adapters](runtime-adapters.md).
4
+
5
+ ---
6
+
7
+ ## State Chain
8
+
9
+ ```
10
+ S_INTAKE → S_PLAN → S_EXECUTE → S_VERIFY → S_FIX → [back-half]
11
+ ```
12
+
13
+ FIX↔VERIFY loop until all criteria pass. Back-half: `S_GENERALIZE → S_DISCOVER → S_RECORD → END` (see [shared phases](odyssey-base.md) §Shared Back-Half).
14
+
15
+ ---
16
+
17
+ ## Boundary
18
+
19
+ **In scope:** Single requirement delivery loop — requirement parsing → all acceptance criteria passing + generalization.
20
+ **Out of scope:** Multi-requirement orchestration → `/ew-orchestrate --goal roadmap` | Deep debugging → `--mode debug` | Code review → `--mode review` | UI optimization → `--mode ui`
21
+
22
+ ---
23
+
24
+ ## Context
25
+
26
+ ### `--template <name>`
27
+
28
+ | Template | Criteria pattern | Use case |
29
+ |----------|-----------------|----------|
30
+ | `feature` | User story acceptance + boundary tests + UI verification | New feature |
31
+ | `bugfix` | Regression tests + root cause confirmation + boundary coverage | Bug fix |
32
+ | `refactor` | Behavior preservation + performance baseline + API compatibility | Refactoring |
33
+ | `migration` | Data consistency + rollback verification + performance comparison | Data/API migration |
34
+ | `api-endpoint` | Request/response contract + error handling + permission checks | API development |
35
+
36
+ ### Target Resolution
37
+
38
+ Requirement parsed from `<intent>`.
39
+
40
+ ### Session Fields
41
+
42
+ ```json
43
+ { "requirement": "",
44
+ "acceptance_criteria": [{"id":"AC1","criterion":"","verify_method":"test|grep|cli-review|manual","status":"pending","evidence":"","passed_at":null}],
45
+ "plan": {"tasks":[{"id":"T1","title":"","description":"","criteria_refs":["AC1"],"status":"pending","files_modified":[],"domain":"general","executor":"agent"}],"created_at":""},
46
+ "execution_config": {"method":"auto","default_executor":"","domain_routing":{"frontend":"","backend":"","default":"agent"},"code_review_tool":"Skip","verification_tool":"Auto","confirmed":false},
47
+ "iterations": [{"iteration":1,"started_at":"","completed_at":"","criteria_before":{"passed":0,"total":0},"criteria_after":{"passed":0,"total":0},"gaps_fixed":[],"files_modified":[]}],
48
+ "current_iteration": 0,
49
+ "patterns": [], "generalization_stats": null }
50
+ ```
51
+
52
+ ### evidence.ndjson Phases
53
+
54
+ `planning|execution|verification|fix|decision|generalization|discovery|self-iteration`
55
+
56
+ ### phase_goals[]
57
+
58
+ | ID | Goal | done_when | phase | skip_when |
59
+ |----|------|-----------|-------|-----------|
60
+ | G1 | Acceptance criteria defined | ≥1 criterion in acceptance_criteria[] | S_INTAKE | — |
61
+ | G2 | Plan created | session.json.plan populated | S_PLAN | — |
62
+ | G3 | Implementation complete | all plan tasks executed | S_EXECUTE | — |
63
+ | G4 | All criteria pass | all acceptance_criteria[].status == passed | S_VERIFY | — |
64
+ | G5 | Pattern generalized | patterns[] ≥1 entry | S_GENERALIZE | skip_generalize |
65
+ | G6 | Discoveries triaged | all scan hits classified | S_DISCOVER | skip_generalize |
66
+ | G7 | Learnings persisted | spec entries created OR no actionable | S_RECORD | — |
67
+
68
+ ### understanding.md — 8 Sections
69
+
70
+ 1. Requirement & Criteria
71
+ 2. Plan
72
+ 3. Execution
73
+ 4. Verification
74
+ 5. Fix Log
75
+ 6. Generalization
76
+ 7. Discoveries
77
+ 8. Learnings
78
+
79
+ ---
80
+
81
+ ## State Machine
82
+
83
+ ### Transitions
84
+
85
+ ```
86
+ S_PLAN → S_EXECUTE
87
+ S_EXECUTE → S_VERIFY
88
+ S_VERIFY → S_GENERALIZE : all passed AND !skip_generalize
89
+ S_VERIFY → S_RECORD : all passed AND skip_generalize
90
+ S_VERIFY → S_FIX : some failed AND iteration < max
91
+ S_VERIFY → S_PLAN : fundamental plan flaw → cross_phase_loops++ (replan). Criteria preservation: acceptance_criteria[] statuses preserved; only plan.tasks[] regenerated. Passed criteria retain `passed`; failed criteria reset to `pending` for re-verification.
92
+ S_VERIFY → S_RECORD : some failed AND iteration >= max (escalate)
93
+ S_FIX → S_VERIFY (loop)
94
+ ```
95
+
96
+ Discover routes to S_EXECUTE (not FIX): area needing same implementation → new task, `cross_phase_loops++`.
97
+
98
+ ### Actions
99
+
100
+ **A_INTAKE extra** — Define acceptance criteria: analyze requirement → derive testable criteria, each with `verify_method` (test|grep|cli-review|manual). Normal: structured prompt to confirm/edit | `-y`: auto-derive, record `{"phase":"decision","type":"criteria-confirmation","status":"deferred"}`. Mark G1.
101
+
102
+ **GATE: criteria-defined** — ≥1 criterion in `acceptance_criteria[]`, each with a testable `criterion` and assigned `verify_method` (test|grep|cli-review|manual); confirmed by user or auto-derived with deferred confirmation under `-y`; G1 marked.
103
+
104
+ **A_PLAN** — (1) Decompose requirement into ordered tasks mapped to acceptance criteria. (2) CLI-assisted planning (optional):
105
+ ```bash
106
+ evolve delegate "PURPOSE: Create implementation plan for: {requirement}
107
+ TASK: Decompose into subtasks | Map to acceptance criteria | Identify dependencies
108
+ MODE: analysis
109
+ CONTEXT: @**/* | Criteria: {criteria_summary}
110
+ EXPECTED: JSON [{task_id, title, description, criteria_refs, deps}]
111
+ " --to codex --mode analysis
112
+ ```
113
+ (3) Write `session.json.plan`, append evidence (planning), update §2. Mark G2.
114
+
115
+ Commit: `"odyssey-planex({slug}): PLAN — requirement decomposed into tasks"`
116
+
117
+ **A_EXECUTE** —
118
+
119
+ - **Step 1 — Execution Options Confirmation.** Skip if `-y` OR `--method` explicitly set OR `execution_config.confirmed == true` (resume). Load tools: `the Codex or Agy executables available to the host`. Prompt via structured prompt (3 questions): Executor (Auto domain routing | Agent all | specific CLI | custom) / Review (Skip | {tool}) / Verify (Auto | specific tool | Skip). Parse → write `execution_config`, set `confirmed: true`. `--skip-verify` overrides verification to `"Skip"`.
120
+
121
+ - **Step 2 — Executor Resolution** (method == "auto"): domain routing — frontend (UI/component/page/style, .tsx/.jsx/.vue/.css/.html/.svelte) | backend (API/server/db/service, .go/.rs/.java/.py/.sql/.proto) | general (mixed/config/tests, .ts/.js/other). Resolution: `execution_config.domain_routing[domain]` or default `"agent"`.
122
+
123
+ - **Step 3 — Task Execution** per plan order (independent tasks may parallelize cleanly via joined subagents — see [runtime adapters](runtime-adapters.md)). **Agent path:** launch subagent with task definition + criteria refs + prior task summaries + specs_content → implement → verify convergence → auto-fix (max 3) → return. **CLI path:**
124
+ ```bash
125
+ evolve delegate "PURPOSE: Implement task ${task_id}: ${title}; success = criteria ${criteria_refs} satisfied
126
+ TASK: ${description} | Read existing code first | Verify convergence criteria after changes
127
+ MODE: write
128
+ CONTEXT: @${scope}/**/* | Criteria: ${criteria_summary}
129
+ EXPECTED: Working code changes, convergence evidence, summary of what was done
130
+ CONSTRAINTS: Scope limited to task files | Follow project specs
131
+
132
+ ## Acceptance Criteria (must satisfy)
133
+ ${criteria_refs.map(ref => criteria[ref].criterion).join('\n')}
134
+
135
+ ## Implementation Steps
136
+ ${task.description}
137
+
138
+ ## Project Specs
139
+ ${specs_content}
140
+
141
+ ## Prior Task Summaries
142
+ ${prior_summaries}
143
+ " --to ${resolved_executor} --mode write
144
+ ```
145
+ **Deviation Rule (MANDATORY hard limit — max 3 retries per task):** first attempt normal dispatch → retry with simplified self-contained prompt via `evolve delegate "<simplified prompt>" --to ${resolved_executor} --mode write` → switch to Agent path → all 3 fail → mark task `blocked`, checkpoint, continue remaining. NEVER exceed 3 attempts on a single task.
146
+
147
+ - **Step 4 — Per-Task Evidence:** `{"phase":"execution","type":"task-completed","task_id":"T1","executor":"...","files_modified":[],"summary":"","attempt":1}`; update task status.
148
+
149
+ - **Step 5 — Post-Execution Validation.** Skip if `verification_tool == "Skip"` OR `--skip-verify` OR no completed tasks. **Check 1** Summary Consistency (task status vs git diff). **Check 2** CLI Verification Gate:
150
+ ```bash
151
+ evolve delegate "PURPOSE: Verify execution output meets acceptance criteria; success = all criteria verified with file:line evidence
152
+ TASK:
153
+ 1. CONVERGENCE: For each criterion, read actual code, verify behavior exists, report status with evidence
154
+ 2. EXISTENCE: Verify all expected files exist on disk
155
+ 3. SUBSTANCE: Verify real implementation — flag stubs, placeholders, TODO-only
156
+ 4. ANTI-PATTERNS: Scan for TODO/FIXME/HACK, console.log debug, disabled tests
157
+ MODE: analysis
158
+ CONTEXT: @${modified_files}
159
+ EXPECTED: JSON { convergence: [{criterion, status, evidence}], issues: [{type, file, line, severity}], overall: passed|gaps_found }
160
+ CONSTRAINTS: Read-only | Check ALL criteria exhaustively | Evidence must be file:line
161
+
162
+ ## Acceptance Criteria (verify each)
163
+ ${acceptance_criteria.map(c => c.criterion).join('\n')}
164
+
165
+ ## Modified Files
166
+ ${modified_files.join('\n')}
167
+ " --to ${execution_config.verification_tool} --mode analysis
168
+ ```
169
+ `overall == "passed"` → proceed to S_VERIFY with boosted confidence; `gaps_found` → log findings, proceed. **Check 3** Code Review (if `code_review_tool != "Skip"`): `evolve delegate "Review git diff for correctness, style, bugs, and code quality" --to ${code_review_tool} --mode analysis`.
170
+
171
+ - **Step 6 — Completion:** update §3. Mark G3.
172
+
173
+ **GATE: plan-executed** — all plan tasks executed (`completed`) or explicitly `blocked` after 3 retries with logged evidence; per-task execution evidence recorded; post-execution validation (convergence, existence, substance, anti-patterns) completed unless `--skip-verify`; G3 marked.
174
+
175
+ Commit: `"odyssey-planex({slug}): EXECUTE — task implementation complete"`
176
+
177
+ **A_VERIFY** — Iron gate; verify each criterion by method:
178
+
179
+ | Method | Action |
180
+ |--------|--------|
181
+ | `test` | Run relevant tests, check pass/fail |
182
+ | `grep` | Grep for expected pattern |
183
+ | `cli-review` | `evolve delegate "PURPOSE: Verify criterion {id}: {criterion}\nTASK: Read implementation \| Check behavior \| Report pass/fail with file:line\nMODE: analysis\nCONTEXT: @{relevant_files}\nEXPECTED: JSON {criterion_id, status, evidence}" --to codex --mode analysis` |
184
+ | `manual` | Normal: structured prompt / `-y`: record `deferred` |
185
+
186
+ Record per criterion: `{"phase":"verification","type":"criterion-check","criterion_id":"AC1","method":"","result":"passed|failed","evidence":"","iteration":N}`. Update `acceptance_criteria[].status`. Append to `iterations[]`. Update §4 pass/fail table. **Route:** all passed → mark G4 → next. Some failed + iteration < max → S_FIX. Some failed + iteration >= max → Normal: structured prompt (continue/lower bar/accept) / `-y`: `deferred`, proceed S_RECORD.
187
+
188
+ **GATE: all-criteria-passed** — every `acceptance_criteria[].status == passed` with recorded evidence and `passed_at`, verified by the declared `verify_method`; iterations logged in `iterations[]`; if max iterations exceeded, criteria may be `deferred` only with explicit user consent (or `-y` auto-accept); G4 marked.
189
+
190
+ Commit: `"odyssey-planex({slug}): VERIFY — criteria verification iteration {N}"`
191
+
192
+ **A_FIX** — (1) Increment `current_iteration`. (2) For each failed criterion: diagnose gap → targeted code fix (not re-implementation). (3) CLI fix review (optional): `evolve delegate "Review fixes in git diff for regressions and return JSON {verdict, regression_risk, concerns}" --to codex --mode analysis`. (4) Append evidence (fix), update §5 → S_VERIFY.
193
+
194
+ Commit: `"odyssey-planex({slug}): FIX — iteration {N} gap fixes"`
195
+
196
+ ---
197
+
198
+ ## Generalize Source
199
+
200
+ Implementation patterns from executed tasks (API contract shapes, validation shapes, error response format, config structure).
201
+
202
+ ---
203
+
204
+ ## Iteration Model
205
+
206
+ ```
207
+ S_EXECUTE → S_VERIFY ──all pass──→ S_GENERALIZE → S_DISCOVER → S_RECORD
208
+ │ │
209
+ some fail + iter < max 3-layer scan, 0 hits ─→ S_RECORD
210
+ ▼
211
+ S_FIX ──→ S_VERIFY (loop)
212
+ ```
213
+
214
+ Max iterations (default 3) prevents infinite loops.
215
+
216
+ ---
217
+
218
+ ## Knowledge Persistence (§8)
219
+
220
+ Include verified reusable findings in the Run summary and harvest the completed Session through `evolve workflows show knowledge` (`evolve closeout session` → `evolve wiki propose`).
221
+
222
+ | Category | Content | Follow-up |
223
+ |----------|---------|-----------|
224
+ | Multi-round fix cycle pattern | Problem scenario + fix iteration + final approach | `evolve closeout session` → `evolve wiki propose` (`category: debug`) |
225
+ | Reusable implementation pattern | Pattern + applicable scope + code template | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
226
+ | Acceptance criteria template | Standard template + verify_method suggestion | `evolve closeout session` → `evolve wiki propose` (`category: review`) |
227
+ | Generalization pattern | Signature + risk + fix template | `evolve closeout session` → `evolve wiki propose` (`category: coding`) |
228
+
229
+ ---
230
+
231
+ ## Completion Summary
232
+
233
+ ```
234
+ --- PLANEX ODYSSEY COMPLETE ---
235
+ Requirement: {requirement}
236
+ Criteria: {passed}/{total} passed
237
+ Iterations: {N} cycles
238
+ Patterns: {patterns_extracted} ({by_layer} distribution)
239
+ Scan hits: {total_hits} ({cross_layer_confirmed} cross-layer confirmed)
240
+ Issues: {N} created | Decisions: {N} resolved, {M} pending, {K} deferred
241
+ Learnings: {N} spec entries
242
+ Self-iter: {N} rounds across {M} stages
243
+ Goals: {done}/{total} confirmed ({skipped} skipped)
244
+ Status: {ALL_PASSED|PARTIAL|ESCALATED}
245
+ ---
246
+ ```
247
+
248
+ ---
249
+
250
+ ## Mode `-y` Points
251
+
252
+ | Decision Point | Normal | `-y` |
253
+ |---------------|--------|------|
254
+ | S_INTAKE criteria | structured prompt | auto-derive `deferred` |
255
+ | S_EXECUTE options | structured prompt | defaults (auto/Skip/Auto) `confirmed:true` |
256
+ | S_EXECUTE task blocked | structured prompt | auto continue, log blocked |
257
+ | S_VERIFY manual criterion | structured prompt | `deferred` |
258
+ | S_VERIFY max iteration | structured prompt | auto accept `deferred` |
259
+ | A_DISCOVER routing | structured prompt | auto-route to execute, issue for rest |
260
+
261
+ ---
262
+
263
+ ## Phase Gates
264
+
265
+ - **Audit gate** (PLAN+EXECUTE): plan tasks mapped to criteria; all tasks executed or blocked after 3 retries (`plan-executed`).
266
+ - **FIX gate:** every failing acceptance criterion receives a targeted fix scoped to the diagnosed failure without dropping/weakening criteria (`evidence phase=fix`), bounded by `--max-iterations`.
267
+ - **VERIFY gate:** every criterion verified by its declared `verify_method`; `all-criteria-passed` confirmed or max-iteration escalation consented (`needs_rework` routes back to FIX).
268
+
269
+ ---
270
+
271
+ ## Error Codes
272
+
273
+ | Code | Severity | Condition | Recovery |
274
+ |------|----------|-----------|----------|
275
+ | E001 | error | No requirement | Provide requirement or -c |
276
+ | W007 | warning | CLI review regression concern | Review before next iteration |
277
+
278
+ ---
279
+
280
+ ## Success Criteria
281
+
282
+ - [ ] Requirement parsed; session + output files created; acceptance criteria defined
283
+ - [ ] Plan decomposed into tasks mapped to acceptance criteria
284
+ - [ ] All tasks executed (or blocked after 3 retries); execution evidence logged
285
+ - [ ] understanding.md sections written progressively (§1–§8)
286
+ - [ ] Criteria verified by method (test/grep/cli-review/manual); fix loop if needed
287
+ - [ ] Multi-layer generalization + discovery triage (unless --skip-generalize)
288
+ - [ ] phase_goals derived, tracked, and hardened-audited; goal_mode injected via prepare goal:true
289
+ - [ ] Session resumable via -c; completion summary emitted
290
+ - [ ] Status: ALL_PASSED / PARTIAL / ESCALATED
291
+
292
+ ---
293
+
294
+ See [shared base](odyssey-base.md) for generic follow-up routing (`Next Step Routing`). Related transitions: `/ew-odyssey <finding> --mode debug` (root cause), `/ew-odyssey <changed-files> --mode review` (formal review), `/ew-odyssey <component> --mode ui` (UI fixes).