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,68 @@
1
+ ---
2
+ name: ew-retrospective
3
+ description: Post-execution retrospective across four independent lenses (technical, process, quality, decision) routing distilled insights
4
+ argument-hint: '[session|range] [--lens technical|process|quality|decision] [--no-route] [--compare <run>] [-y]'
5
+ wiki_categories: [learning, arch]
6
+ search_profile:
7
+ wiki: [constraints, references]
8
+ memory: [correction, decision, work_method]
9
+ session-mode: run
10
+ required_links:
11
+ - references/prepare.md
12
+ - references/workflow.md
13
+ contract:
14
+ consumes:
15
+ - kind: retrospective
16
+ alias: latest-retrospective
17
+ required: false
18
+ schema: retrospective/1.0
19
+ role: primary
20
+ accepts_negative_evidence: true
21
+ - kind: artifact
22
+ alias: current-execution
23
+ required: false
24
+ schema: artifacts/1.0
25
+ role: primary
26
+ accepts_negative_evidence: true
27
+ - kind: verification
28
+ alias: latest-verification
29
+ required: false
30
+ schema: verification/1.0
31
+ role: primary
32
+ accepts_negative_evidence: true
33
+ - kind: review-findings
34
+ alias: latest-review
35
+ required: false
36
+ schema: review-findings/1.0
37
+ role: primary
38
+ accepts_negative_evidence: true
39
+ - kind: priors
40
+ alias: session-priors
41
+ required: false
42
+ schema: priors/1.0
43
+ role: evidence
44
+ produces:
45
+ - path: outputs/retrospective.json
46
+ kind: retrospective
47
+ alias: latest-retrospective
48
+ role: primary
49
+ required: true
50
+ schema: retrospective/1.0
51
+ - path: outputs/retrospective.md
52
+ kind: retrospective-doc
53
+ role: attachment
54
+ required: false
55
+ schema: retrospective-doc/1.0
56
+ gates:
57
+ exit:
58
+ - lenses-complete
59
+ - insights-routed
60
+ contract_version: 2.1
61
+ ---
62
+
63
+ # Retrospective
64
+
65
+ Read [preparation](references/prepare.md), then follow the [retrospective workflow](references/workflow.md).
66
+
67
+ - Runs four independent retrospective lenses (`technical`, `process`, `quality`, `decision`) over sealed execution/verification/review artifacts.
68
+ - Produces `outputs/retrospective.json` and `outputs/retrospective.md` with deterministic `INS-{8hex}` insight IDs, routing project learnings to `ew-knowledge` and Skill defects to `workflow-evolve`.
@@ -0,0 +1,18 @@
1
+ # Pre-flight: ew-retrospective
2
+
3
+ Confirm target Runs, active lenses, read-only source-artifact boundaries, and routing governance before executing [workflow](workflow.md).
4
+
5
+ ## Modes & Flags
6
+
7
+ - **Default / `<session|run>`**: analyze the bound or specified completed execution/verification/review artifacts.
8
+ - **`--lens <technical|process|quality|decision>`**: restrict to selected lens(es); default runs all four in parallel.
9
+ - **`--compare <prior-run>`**: load a prior `retrospective.json` artifact via `evolve run artifact-read` and emit a trend delta section.
10
+ - **`--no-route`**: synthesize `outputs/retrospective.json` and `outputs/retrospective.md` without initiating downstream routing or memory staging.
11
+ - **`-y`**: skip optional interactive confirmation for non-Wiki steps (`memory put`, report formatting); **never** treats `-y` as Wiki publication approval (`ew-knowledge` owns human authorization for `wiki propose` / `apply`).
12
+
13
+ ## Knowledge Gate & Boundaries
14
+
15
+ - Complete the Knowledge Gate (`session-priors` / `wiki_context` / CLI `--reads`) to avoid re-proposing insights already documented in active Wiki entries.
16
+ - **Source artifacts are read-only**: never modify code, `verification.json`, `review.json`, `plan.json`, or completed retrospective artifacts; write only to `{run_dir}/outputs/`.
17
+ - **Never write `wiki/entries/` or `.workflow/specs/` directly**: route project knowledge through `ew-knowledge` (`closeout` / `wiki propose`), and Skill/workflow defects through `workflow-evolve` (`evolve session review` / `skills draft`).
18
+ - **Exit gates**: `lenses-complete` (every requested lens ran independently without cross-suppression) and `insights-routed` (deterministic `INS-{8hex}` IDs + explicit route classification per insight).
@@ -0,0 +1,34 @@
1
+ # Workflow: ew-retrospective
2
+
3
+ Four-lens retrospective: `Load Evidence -> Parallel Lens Analysis -> Synthesize & Compare -> Route Insights -> Seal`.
4
+
5
+ ## Step 1: Load Read-Only Evidence
6
+
7
+ 1. Complete the Knowledge Gate and load bound artifacts (`current-execution`, `latest-verification`, `latest-review`) plus `evolve session status` timeline and any `--compare` prior retrospective.
8
+ 2. Verify source artifacts remain untouched throughout analysis.
9
+
10
+ ## Step 2: Independent Four-Lens Analysis (`lenses-complete` gate)
11
+
12
+ Run one read-only subagent per selected lens in parallel (`invoke_subagent` / host equivalent, **join or cancel all spawned subagents cleanly before synthesis**):
13
+ 1. **`technical`**: architectural trade-offs, coupling surprises, brittle APIs, code patterns worth reusing or avoiding.
14
+ 2. **`process`**: estimation drift, blocked gates, unclear plan boundaries, wasted retries or missing pre-flight context.
15
+ 3. **`quality`**: missed edge cases, test gaps, late regressions caught in review/verify vs earlier steps.
16
+ 4. **`decision`**: assumptions that held vs broke, reversible vs irreversible choices, scope changes.
17
+
18
+ Each lens reports findings independently with exact evidence anchors (`run_id`, `file:line`, exit code); missing a requested lens flags `[LOW CONFIDENCE]`.
19
+
20
+ ## Step 3: Synthesis, Stability & Routing (`insights-routed` gate)
21
+
22
+ 1. Deduplicate cross-lens findings and compute a deterministic `INS-{8hex}` ID per insight (`sha256(scope + normalized_title).slice(0, 8)`) so re-runs do not spawn duplicates.
23
+ 2. Classify each insight's route (unless `--no-route`):
24
+ - `wiki-candidate` -> prepare candidate summary for `ew-knowledge` closeout review (never direct file write).
25
+ - `skill-evolve` -> attribute exact Skill/step + Run receipt for `workflow-evolve` (`evolve session review` / `skills draft`).
26
+ - `issue` -> surface actionable backlog item for user-authorized issue tracking.
27
+ - `none` -> project-specific observation recorded in `retrospective.md` only.
28
+ 3. Collect user confirmation via structured prompt (`ask_question` or host equivalent) before invoking optional external routes (`memory put` / issue tracking); keep Wiki publication explicitly under `ew-knowledge`.
29
+
30
+ ## Step 4: Write Outputs & Seal
31
+
32
+ 1. Write `{run_dir}/outputs/retrospective.json` (`retrospective/1.0`: `lenses_run[]`, `delta` if `--compare`, `insights[]` with `id`, `lens`, `summary`, `evidence[]`, `route`, `status`) and `{run_dir}/outputs/retrospective.md`.
33
+ 2. Write `{run_dir}/report.md` and seal via fenced `evolve run complete <run_id> --session <session> --actor <actor> --expected-orchestration-revision <rev> --expected-run-revision <rev> --gate lenses-complete --gate insights-routed --summary "<summary>" --verdict done|done_with_concerns`.
34
+ 3. At Session completion, hand candidate staging/review cleanly to `ew-knowledge`.
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: ew-review
3
+ description: Review a change or artifact inside the Evolve chain and produce typed findings
4
+ argument-hint: '<target> [--tier quick] [-y]'
5
+ wiki_categories: [review, coding]
6
+ search_profile:
7
+ wiki: [constraints, references]
8
+ memory: [error, correction, verified_fix]
9
+ session-mode: run
10
+ required_links:
11
+ - references/prepare.md
12
+ - references/workflow.md
13
+ contract:
14
+ consumes:
15
+ - kind: artifact
16
+ alias: current-execution
17
+ required: false
18
+ schema: artifacts/1.0
19
+ role: primary
20
+ accepts_negative_evidence: true
21
+ - kind: priors
22
+ alias: session-priors
23
+ required: false
24
+ schema: priors/1.0
25
+ role: evidence
26
+ produces:
27
+ - path: outputs/review.json
28
+ kind: review-findings
29
+ alias: latest-review
30
+ role: primary
31
+ required: true
32
+ schema: review-findings/1.0
33
+ contract_version: 2.1
34
+ ---
35
+
36
+ # Review
37
+
38
+ Review is a quality step inside the Evolve Skill. Use the linked preparation and workflow documents for the full review protocol.
39
+
40
+ - Read [review preparation](references/prepare.md) before defining the audit scope.
41
+ - Read [review workflow](references/workflow.md) for the four dimensions, evidence format and zero-residual gate.
42
+ - Reuse the bound `session-priors` for the same Wiki scope. Search for additional evidence when the scope changes.
43
+ - Write `outputs/review.json` with file and line evidence, severity, remediation and verification status.
44
+
45
+ The review step reports findings and follows the confirmed Session chain. It does not create a separate orchestration entry.
@@ -0,0 +1,17 @@
1
+ # Pre-flight: ew-review
2
+
3
+ Confirm audit target, bound context, and read-only invariants before running [workflow](workflow.md).
4
+
5
+ ## Input & Mode
6
+
7
+ - **Default (`current-execution`)**: read bound `current-execution` (`read_artifact` / `evolve run artifact-read`) and audit its changed files and git diff.
8
+ - **Explicit `<target>`**: file/directory path, `HEAD` / `staged` (`git diff`), or commit/PR range.
9
+ - **`--tier quick`**: focused pass on changed hunks (`correctness` + `security` + regressions).
10
+ - **`-y`**: skip optional confirmation prompts; never suppress findings, missing evidence, or gate checks.
11
+
12
+ ## Boundaries & Invariants
13
+
14
+ - **Read-only audit**: never edit repository source files; write Run outputs only under `{run_dir}/outputs/` and `{run_dir}/report.md`.
15
+ - **Knowledge reuse**: consume `session-priors` for covered `review`/`coding` scope; query `wiki_context` + `wiki_reference` and `memory_search` + `memory_get` (or CLI `--reads` / `--from-search`) whenever the target introduces new paths or categories.
16
+ - **Evidence-first**: audit all 4 dimensions (`correctness`, `security`, `performance`, `architecture`, or `correctness`+`security` in quick tier); every finding requires verified `file:line`, observed evidence, accurate severity (`critical|high|medium|low`), and concrete remediation.
17
+ - **Zero-residual check & routing**: verify claimed fixes and test results against disk state without collapsing distinct root causes. Route actionable multi-tier fixes via `outputs/review.json` + `next` (`ew-plan` / `ew-execute`, or `ew-odyssey-review` for an iterative repair campaign).
@@ -0,0 +1,116 @@
1
+ # Workflow: ew-review
2
+
3
+ Multi-dimensional code and artifact review inside an Evolve Run. Consumes `current-execution` and `session-priors`, verifies implementation quality across four dimensions, runs a zero-residual check, and writes `outputs/review.json` (`review-findings/1.0`) and `report.md`.
4
+
5
+ ## Pipeline
6
+
7
+ 1. **Resolve Target & Load Context**
8
+ 2. **4-Dimension Audit** (standard) or **Focused Diff Audit** (`--tier quick`)
9
+ 3. **Zero-Residual & Evidence Verification**
10
+ 4. **Write `outputs/review.json` and `report.md`**
11
+ 5. **Seal Run & Route Knowledge**
12
+
13
+ ---
14
+
15
+ ## Step 1: Resolve Target & Load Context
16
+
17
+ 1. Read bound inputs via Run MCP (`read_artifact`) or `evolve run artifact-read <run> <alias> --session <session>`:
18
+ - `current-execution`: extract changed files, task results, and self-check evidence.
19
+ - `session-priors`: reuse applicable `review` and `coding` Wiki rules for the matching scope.
20
+ 2. When the target adds paths or categories outside `session-priors`, query `wiki_context` / `memory_search` and open selected entries with `wiki_reference` / `memory_get` (in CLI-only runs, use `evolve context "<query>" --session <session> --include-memory --reads "<run_dir>/knowledge-reads.json"`, then `evolve wiki get <id> --resolved` / `evolve memory get <id>` with `--reads` and `--from-search <search-id>`).
21
+ 3. Resolve the target file set:
22
+ - Explicit file/dir path -> inspect those files.
23
+ - `HEAD` / `staged` -> `git diff HEAD` / `git diff --staged`.
24
+ - Bound `current-execution` -> `change-manifest` / changed files and diff against base commit.
25
+
26
+ ---
27
+
28
+ ## Step 2: 4-Dimension Review Audit
29
+
30
+ Audit every target file across all four dimensions (under `--tier quick`, focus on `correctness` and `security` across the changed hunks):
31
+
32
+ | Dimension | Focus |
33
+ | --- | --- |
34
+ | `correctness` | Logic errors, edge/boundary cases, null/undefined handling, race conditions, type mismatches, missing error propagation, broken invariants |
35
+ | `security` | Injection, XSS/CSRF, auth/permission bypass, secret leakage, path traversal, unsafe deserialization, untrusted input handling |
36
+ | `performance` | Hot-path regressions, N+1 queries, memory/handle leaks, unbounded loops/allocations, blocking I/O |
37
+ | `architecture` | Layer/boundary violations, circular dependencies, contract drift, duplicated logic, abstraction leaks |
38
+
39
+ Parallel execution options:
40
+ - Launch one read-only subagent per dimension (`invoke_subagent` in Antigravity, or `spawn_agent` / `spawn_agents_on_csv` in Codex; join/cancel every spawned subagent before advancing) returning structured findings.
41
+ - For an independent cross-model check, run:
42
+ `evolve delegate "<review prompt with target files and scope>" --to codex --mode analysis --session <session> --run <run>`
43
+ (or `--to agy --mode analysis` without `--session`/`--run` for an unbound second opinion).
44
+
45
+ ---
46
+
47
+ ## Step 3: Zero-Residual & Evidence Verification
48
+
49
+ Cross-check implementation completeness against disk state:
50
+
51
+ 1. Verify every claimed file change and convergence criterion in `current-execution` matches actual repository files.
52
+ 2. Check for residual `TODO`/`FIXME`/debug statements, dead imports, broken relative Markdown links, or skipped/weakened assertions in tests.
53
+ 3. Run the narrowest relevant verification command(s) if not already evidenced in `current-execution` and record the exact exit status and output summary.
54
+ 4. Deduplicate findings by `(file, line, root_cause)` and classify each by severity (`critical`, `high`, `medium`, `low`).
55
+
56
+ ---
57
+
58
+ ## Step 4: Write Outputs & `report.md`
59
+
60
+ Write `{run_dir}/outputs/review.json` matching `review-findings/1.0`:
61
+
62
+ ```json
63
+ {
64
+ "_meta": {
65
+ "kind": "review-findings",
66
+ "schema": "review-findings/1.0",
67
+ "role": "primary"
68
+ },
69
+ "target": "<resolved target>",
70
+ "tier": "standard",
71
+ "dimensions_reviewed": ["correctness", "security", "performance", "architecture"],
72
+ "summary": {
73
+ "critical": 0,
74
+ "high": 0,
75
+ "medium": 0,
76
+ "low": 0,
77
+ "total": 0,
78
+ "remaining_actionable": 0
79
+ },
80
+ "zero_residual_check": {
81
+ "status": "passed",
82
+ "checks": []
83
+ },
84
+ "findings": [
85
+ {
86
+ "id": "REV-001",
87
+ "dimension": "correctness",
88
+ "severity": "high",
89
+ "file": "path/to/file.ts",
90
+ "line": 42,
91
+ "title": "Short title",
92
+ "description": "What is wrong and why",
93
+ "evidence": "Observed code/diff or command output at file:line",
94
+ "suggestion": "Concrete remediation",
95
+ "status": "open"
96
+ }
97
+ ]
98
+ }
99
+ ```
100
+
101
+ Write `{run_dir}/report.md` with frontmatter (`verdict`, `summary`, `constraints`, `decisions`, `concerns`, `next`) and fixed sections (`Summary`, `Conclusion/Verdict`, `Discussion/Retrospective`, `Artifacts`, `Handoff/Next`):
102
+ - Set `verdict: ready` when `critical == 0` and `high == 0` and zero-residual check passes.
103
+ - Set `verdict: ready_with_concerns` when non-blocking findings or unverified limits remain; route `next` to `ew-plan` or `ew-execute` when fixes are needed.
104
+ - Set `verdict: blocked` when `critical > 0` or a hard verification failure prevents acceptance.
105
+
106
+ ---
107
+
108
+ ## Step 5: Seal Run & Knowledge Hooks
109
+
110
+ Seal the Run via:
111
+
112
+ ```text
113
+ evolve run complete <run_id> --session <session_id> --actor <actor_id> --expected-orchestration-revision <orchestration_revision> --expected-run-revision <run_revision> --summary "<observed review summary>" --verdict done|done_with_concerns
114
+ ```
115
+
116
+ Use `--verdict done_with_concerns` when actionable findings remain. Stage any reusable review constraints or defect patterns after sealing through `ew-knowledge` (`evolve workflows show knowledge`).
@@ -0,0 +1,62 @@
1
+ ---
2
+ name: ew-roadmap
3
+ description: Decompose multi-release or broad requirements into a valid Session DAG with scope, success criteria, and dependency edges
4
+ argument-hint: '<requirement> [-y] [-c] [-m progressive|direct|auto] [--from <alias>] [--revise [instructions]] [--review]'
5
+ wiki_categories: [arch]
6
+ search_profile:
7
+ wiki: [constraints, references]
8
+ memory: [decision, correction]
9
+ session-mode: run
10
+ required_links:
11
+ - references/prepare.md
12
+ - references/workflow.md
13
+ contract:
14
+ consumes:
15
+ - kind: roadmap
16
+ alias: current-roadmap
17
+ required: false
18
+ schema: roadmap/1.0
19
+ role: primary
20
+ accepts_negative_evidence: true
21
+ - kind: context-package
22
+ alias: upstream-context
23
+ required: false
24
+ schema: context-package/1.0
25
+ role: attachment
26
+ accepts_negative_evidence: true
27
+ - kind: blueprint
28
+ alias: current-blueprint
29
+ required: false
30
+ schema: blueprint/1.0
31
+ role: primary
32
+ accepts_negative_evidence: true
33
+ - kind: priors
34
+ alias: session-priors
35
+ required: false
36
+ schema: priors/1.0
37
+ role: evidence
38
+ produces:
39
+ - path: outputs/roadmap.json
40
+ kind: roadmap
41
+ alias: current-roadmap
42
+ role: primary
43
+ required: true
44
+ schema: roadmap/1.0
45
+ - path: outputs/roadmap.md
46
+ kind: roadmap-doc
47
+ role: attachment
48
+ required: false
49
+ schema: roadmap-doc/1.0
50
+ gates:
51
+ exit:
52
+ - dag-valid
53
+ - sessions-registered
54
+ contract_version: 2.1
55
+ ---
56
+
57
+ # Roadmap
58
+
59
+ Read [preparation](references/prepare.md), then follow the [roadmap workflow](references/workflow.md).
60
+
61
+ - Decomposes multi-session or cross-release requirements into an acyclic Session DAG (`outputs/roadmap.json`, `outputs/roadmap.md`) inside `{run_dir}/outputs/`.
62
+ - Keeps intra-session task breakdown in `ew-plan` and formal specs in `ew-blueprint`.
@@ -0,0 +1,27 @@
1
+ # Pre-flight: ew-roadmap
2
+
3
+ Confirm mode, Knowledge Gate inputs, and DAG altitude boundaries before running [workflow](workflow.md).
4
+
5
+ ## Input & Mode
6
+
7
+ | Mode | Trigger | Behavior |
8
+ | --- | --- | --- |
9
+ | Create (default) | requirement / `--from` / `current-blueprint` | Build acyclic Session DAG from requirements and upstream context |
10
+ | Revise | `--revise [instructions]` | Update bound `current-roadmap` while preserving all sealed sessions (`E005` if modification collides) |
11
+ | Review | `--review` | Read-only health assessment of DAG acyclicity, coverage, and sizing (`E004` if missing) |
12
+ | Resume | `-c` / `--continue` | Continue from last checkpoint |
13
+
14
+ Missing requirement without `--revise`/`--review` -> error `E001`.
15
+
16
+ ## Knowledge & Context Pre-load
17
+
18
+ 1. Reuse bound `session-priors` for `arch` constraints; otherwise query `wiki_context` + `wiki_reference` (or CLI `evolve context "<requirement keywords>" --task roadmap --session <session> --include-memory --reads "<run_dir>/knowledge-reads.json"` + `--from-search <search-id>`).
19
+ 2. Read active Session registry (`evolve session list`) and codebase boundaries (`evolve code search`) after the Knowledge Gate.
20
+
21
+ ## Decomposition & Output Boundaries
22
+
23
+ - **Run artifacts only**: write `outputs/roadmap.json` and `outputs/roadmap.md` under `{run_dir}/outputs/`; never write legacy `.workflow/roadmap.md` or deprecated `milestones[]` / `current_milestone` / `accumulated_context` fields.
24
+ - **Default to 1 Session**: split into multiple Sessions only when ALL THREE hard-dependency conditions hold: (1) Session B runtime code consumes Session A real output without mocking, (2) interface contracts cannot unblock concurrent work, and (3) every Session A task must complete before Session B starts. Otherwise keep 1 Session and let `ew-plan` model execution waves.
25
+ - **Sizing guard**: aim for `>= 5` substantial tasks per Session; if `> 3` Sessions result, re-audit every split against the 3 hard conditions and merge weak splits.
26
+ - **Altitude guard**: define Session boundaries, success criteria, and `depends_on` edges only — leave task splitting to `ew-plan`.
27
+ - **Exit gates**: `dag-valid` (acyclic, full requirement coverage, valid dependencies) and `sessions-registered` (roadmap metadata recorded cleanly without mutating already-completed Sessions).
@@ -0,0 +1,28 @@
1
+ # Workflow: ew-roadmap
2
+
3
+ Session DAG decomposition: `Parse & Context -> Codebase Mapping -> Decompose / Revise / Review -> Validate DAG -> Wrap-up`.
4
+
5
+ ## Step 1: Load Context & Upstream
6
+
7
+ 1. Complete the Knowledge Gate (`session-priors` / `wiki_context` / CLI `--reads`) and inspect existing `evolve session list` state so already-completed work is excluded.
8
+ 2. Read bound `current-blueprint` / `upstream-context` when provided (`read_artifact` / `evolve run artifact-read`).
9
+ 3. If architectural boundaries are unclear, run a read-only exploration subagent (`invoke_subagent` / host equivalent, joined before Step 2) and optional `search_web` for external API constraints -> save summary to `{run_dir}/evidence/roadmap-context.json`.
10
+
11
+ ## Step 2: Execute Selected Mode
12
+
13
+ - **Create mode**:
14
+ 1. Parse requirement into goals, hard constraints, and acceptance criteria.
15
+ 2. Group requirements into cohesive Sessions using the **default 1-session / 3-hard-condition split rule** (`>= 5` estimated tasks per Session). Map every active requirement to one owning Session and assign `depends_on` edges.
16
+ 3. Confirm scope/mode (`progressive` / `direct` / `auto`) and Session boundaries via structured user prompt (`ask_question` or host equivalent; auto-accept defaults under `-y`).
17
+ 4. Re-audit splits if `> 3` Sessions exist and merge unjustified splits.
18
+ - **Revise mode (`--revise`)**:
19
+ 1. Load `current-roadmap` (`E004` if missing). Check which Sessions are already sealed/completed; refuse (`E005`) or confirm adjustment if a change alters completed scope.
20
+ 2. Update pending Sessions and edges cleanly while preserving sealed entries.
21
+ - **Review mode (`--review`)**:
22
+ 1. Inspect `current-roadmap` read-only for cycles (`E003`), orphaned requirements, undersized Sessions, and blocked dependencies; inside an active Run, copy the read-only roadmap into `{run_dir}/outputs/roadmap.json` with an appended `health_review` summary (and matching `_meta`) so the Run seals cleanly without modifying the original roadmap source.
23
+
24
+ ## Step 3: Write Outputs & Seal (`dag-valid`, `sessions-registered`)
25
+
26
+ 1. Write `{run_dir}/outputs/roadmap.json` (`roadmap/1.0`: `sessions[]` with `id`, `title`, `intent`, `scope`, `requirement_refs[]`, `acceptance_criteria[]`, `depends_on[]`, `status`) and `{run_dir}/outputs/roadmap.md` (including `## Roadmap Decisions` and dependency graph).
27
+ 2. Verify acyclicity (topological sort), zero dangling `depends_on`, and complete requirement mapping.
28
+ 3. Write `{run_dir}/report.md` (`next` proposing `ew-analyze` or `ew-plan` for the first ready Session) and seal via fenced `evolve run complete <run_id> --session <session> --actor <actor> --expected-orchestration-revision <rev> --expected-run-revision <rev> --gate dag-valid --gate sessions-registered --summary "<summary>" --verdict done|done_with_concerns`. Stage reusable architecture learnings through `ew-knowledge`.
@@ -0,0 +1,99 @@
1
+ ---
2
+ name: ew-test
3
+ description: Run conversational UAT, smoke checks, coverage verification, and optional browser acceptance on verified deliverables
4
+ argument-hint: '[scope] [--smoke] [--auto-fix] [--frontend-verify]'
5
+ wiki_categories: [test, review]
6
+ search_profile:
7
+ wiki: [constraints, references]
8
+ memory: [error, verified_fix]
9
+ session-mode: run
10
+ required_links:
11
+ - references/prepare.md
12
+ - references/workflow.md
13
+ contract:
14
+ consumes:
15
+ - kind: verification
16
+ alias: latest-verification
17
+ required: false
18
+ schema: verification/1.0
19
+ role: primary
20
+ accepts_negative_evidence: true
21
+ - kind: plan
22
+ alias: current-plan
23
+ required: false
24
+ schema: plan/1.0
25
+ role: primary
26
+ accepts_negative_evidence: true
27
+ - kind: artifact
28
+ alias: current-execution
29
+ required: false
30
+ schema: artifacts/1.0
31
+ role: primary
32
+ accepts_negative_evidence: true
33
+ - kind: review-findings
34
+ alias: latest-review
35
+ required: false
36
+ schema: review-findings/1.0
37
+ role: primary
38
+ accepts_negative_evidence: true
39
+ - kind: diagnosis
40
+ alias: latest-debug
41
+ required: false
42
+ schema: diagnosis/1.0
43
+ role: primary
44
+ accepts_negative_evidence: true
45
+ - kind: priors
46
+ alias: session-priors
47
+ required: false
48
+ schema: priors/1.0
49
+ role: evidence
50
+ produces:
51
+ - path: outputs/test-results.json
52
+ kind: test-results
53
+ alias: latest-test
54
+ role: primary
55
+ required: true
56
+ schema: test-results/1.0
57
+ - path: outputs/test-plan.json
58
+ kind: test-plan
59
+ role: attachment
60
+ required: false
61
+ schema: test-plan/1.0
62
+ - path: outputs/acceptance.json
63
+ kind: acceptance
64
+ role: evidence
65
+ required: false
66
+ schema: acceptance/1.0
67
+ - path: outputs/coverage.json
68
+ kind: coverage
69
+ role: evidence
70
+ required: false
71
+ schema: coverage/1.0
72
+ - path: outputs/uat.md
73
+ kind: uat-log
74
+ role: attachment
75
+ required: false
76
+ schema: uat-log/1.0
77
+ - path: outputs/issue-candidates.json
78
+ kind: issue-candidates
79
+ role: attachment
80
+ required: false
81
+ schema: issue-candidates/1.0
82
+ - path: outputs/e2e-results.json
83
+ kind: e2e-results
84
+ role: evidence
85
+ required: false
86
+ schema: e2e-results/1.0
87
+ gates:
88
+ exit:
89
+ - coverage-met
90
+ - pass-rate-met
91
+ contract_version: 2.1
92
+ ---
93
+
94
+ # Test
95
+
96
+ Read [preparation](references/prepare.md), then follow the [test workflow](references/workflow.md).
97
+
98
+ - Behavioral UAT, `--smoke` cold-start validation, and `--frontend-verify` live browser acceptance producing `outputs/test-results.json` (`latest-test`) and `outputs/uat.md`.
99
+ - Infers gap severity automatically from observed failures without asking the user to classify severity.
@@ -0,0 +1,23 @@
1
+ # Pre-flight: ew-test
2
+
3
+ Confirm evidence sources, test mode, and UAT/browser acceptance rules before running [workflow](workflow.md).
4
+
5
+ ## Modes & Flags
6
+
7
+ - **Default (Conversational UAT)**: walk deliverable scenarios one by one (`yes`/`y`/`pass` -> pass; `skip`/`n/a` -> skipped; problem description -> failed gap with severity inferred directly from failure impact — never ask "how severe is this?").
8
+ - **`--smoke`**: execute cold-start smoke checks (build, startup, dependencies, core health routes) before behavioral testing.
9
+ - **`--frontend-verify`**: deterministic browser acceptance asserting real UI entry points, network write actions, console/network errors, and DOM state rather than conversational UAT alone (in Antigravity, delegate UI navigation/interaction to a `browser` subagent joined cleanly on completion; otherwise use Playwright / Chrome DevTools).
10
+ - **`--auto-fix`**: record gaps cleanly and emit a `chain-proposal/1.0` (`next`) routing to `ew-debug` / `ew-plan --gaps` -> `ew-execute` rather than silently mutating code mid-UAT.
11
+
12
+ ## Evidence Source Priority
13
+
14
+ 1. `latest-verification` (`full` confidence)
15
+ 2. `current-execution` + `current-plan` (`degraded` confidence)
16
+ 3. `latest-review` (`degraded - lowest`)
17
+ 4. Missing all three without explicit `<scope>` target -> error `E002`.
18
+
19
+ ## Knowledge & Boundaries
20
+
21
+ - Complete the Knowledge Gate (`session-priors` / `wiki_context` / CLI `--reads`) for `test`/`review` conventions before deriving scenarios.
22
+ - Write artifacts strictly under `{run_dir}/outputs/`. Keep `EVIDENCE_SOURCE` and any skipped/unverified scenarios explicit in `outputs/test-results.json` and `outputs/uat.md`.
23
+ - **Exit gates**: `coverage-met` (every planned scenario executed or explicitly skipped with reason) and `pass-rate-met` (observed pass rate + gap list recorded cleanly).
@@ -0,0 +1,23 @@
1
+ # Workflow: ew-test
2
+
3
+ Behavioral testing & UAT: `Resolve Evidence -> Build Test Plan -> Smoke / Browser / UAT Execution -> Diagnose & Package -> Seal`.
4
+
5
+ ## Step 1: Build Test Plan (`outputs/test-plan.json`)
6
+
7
+ 1. Complete the Knowledge Gate and load bound inputs (`latest-verification`, `current-plan`, `current-execution`, `latest-review`, `latest-debug`), recording `evidence_source`.
8
+ 2. Derive observable test scenarios (`T-001`, `T-002`, ...) mapped to requirement/task IDs and write `{run_dir}/outputs/test-plan.json`.
9
+
10
+ ## Step 2: Execute Checks by Mode
11
+
12
+ - **Cold-start smoke (`--smoke`)**: run build/startup/dependency checks first; abort or record blocker immediately on startup failure.
13
+ - **Deterministic browser acceptance (`--frontend-verify`)**: inspect live routes via `browser` subagent (joined cleanly) or headless browser runner, asserting interactive flows, API write persistence, console/network cleanliness, and responsive DOM -> write `{run_dir}/outputs/e2e-results.json`.
14
+ - **Conversational UAT & automated suite**:
15
+ - Execute applicable test commands (`coverage` / unit / integration) -> record exact outputs in `{run_dir}/outputs/coverage.json`.
16
+ - Present interactive scenarios one by one via structured prompt (`ask_question` or concise user check; under `-y` / automated scope, run executable assertions and mark UI-manual scenarios `UNCERTAIN` / `skipped` honestly).
17
+ - Log every scenario outcome into `{run_dir}/outputs/uat.md` and `{run_dir}/outputs/acceptance.json`, inferring severity (`critical|high|medium|low`) from user feedback/error impact.
18
+
19
+ ## Step 3: Results, Gap Candidates & Seal
20
+
21
+ 1. Write `{run_dir}/outputs/test-results.json` (`test-results/1.0`: `evidence_source`, `summary: { total, passed, failed, skipped, pass_rate }`, `gaps[]` mapping `test_id`, `truth`, `reason`, `severity`, `requirement_ref`) and optional `outputs/issue-candidates.json`.
22
+ 2. Write `{run_dir}/report.md` (`verdict: ready|ready_with_concerns|blocked`; if gaps exist, propose `ew-debug --from-test` or `ew-plan --gaps` in `next`).
23
+ 3. Seal via fenced `evolve run complete <run_id> --session <session> --actor <actor> --expected-orchestration-revision <rev> --expected-run-revision <rev> --gate coverage-met --gate pass-rate-met --summary "<summary>" --verdict done|done_with_concerns`. Stage reusable testing patterns afterward via `ew-knowledge`.
@@ -0,0 +1,73 @@
1
+ ---
2
+ name: ew-verify
3
+ description: Independently verify current-execution requirement coverage, behavioral correctness, and anti-pattern risk against current-plan
4
+ argument-hint: '[scope] [--strict] [--skip-tests] [--skip-antipattern]'
5
+ wiki_categories: [review, coding]
6
+ search_profile:
7
+ wiki: [constraints, references]
8
+ memory: [error, correction, verified_fix]
9
+ session-mode: run
10
+ required_links:
11
+ - references/prepare.md
12
+ - references/workflow.md
13
+ contract:
14
+ consumes:
15
+ - kind: plan
16
+ alias: current-plan
17
+ required: true
18
+ schema: plan/1.0
19
+ role: primary
20
+ accepts_negative_evidence: true
21
+ - kind: artifact
22
+ alias: current-execution
23
+ required: true
24
+ schema: artifacts/1.0
25
+ role: primary
26
+ accepts_negative_evidence: true
27
+ - kind: review-findings
28
+ alias: latest-review
29
+ required: false
30
+ schema: review-findings/1.0
31
+ role: primary
32
+ accepts_negative_evidence: true
33
+ - kind: uat-log
34
+ alias: uat-log
35
+ required: false
36
+ schema: uat-log/1.0
37
+ role: attachment
38
+ accepts_negative_evidence: true
39
+ - kind: priors
40
+ alias: session-priors
41
+ required: false
42
+ schema: priors/1.0
43
+ role: evidence
44
+ produces:
45
+ - path: outputs/verification.json
46
+ kind: verification
47
+ alias: latest-verification
48
+ role: primary
49
+ required: true
50
+ schema: verification/1.0
51
+ - path: outputs/requirement-coverage.json
52
+ kind: requirement-coverage
53
+ role: evidence
54
+ required: false
55
+ schema: requirement-coverage/1.0
56
+ - path: outputs/antipattern-report.json
57
+ kind: antipattern-report
58
+ role: evidence
59
+ required: false
60
+ schema: antipattern-report/1.0
61
+ gates:
62
+ exit:
63
+ - goal-backward-verified
64
+ - nyquist-covered
65
+ contract_version: 2.1
66
+ ---
67
+
68
+ # Verify
69
+
70
+ Read [preparation](references/prepare.md), then follow the [verification workflow](references/workflow.md).
71
+
72
+ - Independent iron-gate verification over bound `current-plan` and `current-execution`: goal-backward structural proof + live command coverage + anti-pattern scan.
73
+ - Emits `outputs/verification.json` (`latest-verification`), feeding `ew-test` or `ew-plan --gaps` on failure.