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.
- package/LICENSE +27 -0
- package/README.md +195 -2
- package/dist/agent-memory-prompts.d.ts +13 -0
- package/dist/agent-memory-prompts.js +55 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +6 -0
- package/dist/closeout.d.ts +105 -0
- package/dist/closeout.js +473 -0
- package/dist/code.d.ts +39 -0
- package/dist/code.js +124 -0
- package/dist/codex-memory.d.ts +24 -0
- package/dist/codex-memory.js +217 -0
- package/dist/common.d.ts +16 -0
- package/dist/common.js +52 -0
- package/dist/context-envelope.d.ts +59 -0
- package/dist/context-envelope.js +23 -0
- package/dist/host-adapters.d.ts +34 -0
- package/dist/host-adapters.js +151 -0
- package/dist/http.d.ts +3 -0
- package/dist/http.js +90 -0
- package/dist/index.d.ts +16 -0
- package/dist/index.js +13 -0
- package/dist/knowledge-cli.d.ts +198 -0
- package/dist/knowledge-cli.js +761 -0
- package/dist/knowledge-reads.d.ts +72 -0
- package/dist/knowledge-reads.js +201 -0
- package/dist/memory-config.d.ts +44 -0
- package/dist/memory-config.js +204 -0
- package/dist/memory-evidence.d.ts +13 -0
- package/dist/memory-evidence.js +40 -0
- package/dist/memory-history.d.ts +46 -0
- package/dist/memory-history.js +432 -0
- package/dist/memory.d.ts +96 -0
- package/dist/memory.js +362 -0
- package/dist/retrospective.d.ts +57 -0
- package/dist/retrospective.js +240 -0
- package/dist/search.d.ts +36 -0
- package/dist/search.js +112 -0
- package/dist/skill-addition.d.ts +25 -0
- package/dist/skill-addition.js +89 -0
- package/dist/skill-design.d.ts +96 -0
- package/dist/skill-design.js +226 -0
- package/dist/skill-replay.d.ts +55 -0
- package/dist/skill-replay.js +448 -0
- package/dist/skill-route.d.ts +30 -0
- package/dist/skill-route.js +75 -0
- package/dist/transcript-evidence.d.ts +3 -0
- package/dist/transcript-evidence.js +58 -0
- package/dist/upstream/chunker.d.ts +24 -0
- package/dist/upstream/chunker.js +96 -0
- package/dist/upstream/file-protocol.d.ts +45 -0
- package/dist/upstream/file-protocol.js +117 -0
- package/dist/upstream/frontmatter.d.ts +47 -0
- package/dist/upstream/frontmatter.js +86 -0
- package/dist/upstream/graph-search.d.ts +33 -0
- package/dist/upstream/graph-search.js +67 -0
- package/dist/upstream/l1-extraction.d.ts +26 -0
- package/dist/upstream/l1-extraction.js +405 -0
- package/dist/upstream/llm.d.ts +8 -0
- package/dist/upstream/llm.js +1 -0
- package/dist/upstream/merge.d.ts +50 -0
- package/dist/upstream/merge.js +153 -0
- package/dist/upstream/prompts.d.ts +53 -0
- package/dist/upstream/prompts.js +181 -0
- package/dist/upstream/search-utils.d.ts +34 -0
- package/dist/upstream/search-utils.js +55 -0
- package/dist/upstream/slug.d.ts +26 -0
- package/dist/upstream/slug.js +103 -0
- package/dist/upstream/template.d.ts +29 -0
- package/dist/upstream/template.js +80 -0
- package/dist/upstream/tokenize.d.ts +4 -0
- package/dist/upstream/tokenize.js +29 -0
- package/dist/wiki-change.d.ts +76 -0
- package/dist/wiki-change.js +299 -0
- package/dist/wiki-entry.d.ts +26 -0
- package/dist/wiki-entry.js +93 -0
- package/dist/wiki-ingest.d.ts +12 -0
- package/dist/wiki-ingest.js +126 -0
- package/dist/wiki-migration.d.ts +16 -0
- package/dist/wiki-migration.js +268 -0
- package/dist/wiki-tokens.d.ts +1 -0
- package/dist/wiki-tokens.js +46 -0
- package/dist/wiki.d.ts +103 -0
- package/dist/wiki.js +330 -0
- package/dist/workflow-cli.d.ts +2 -0
- package/dist/workflow-cli.js +319 -0
- package/dist/workflow-install.d.ts +37 -0
- package/dist/workflow-install.js +148 -0
- package/dist/workflow-knowledge.d.ts +18 -0
- package/dist/workflow-knowledge.js +32 -0
- package/dist/workflow-mcp.d.ts +2 -0
- package/dist/workflow-mcp.js +137 -0
- package/dist/workflow-names.d.ts +4 -0
- package/dist/workflow-names.js +31 -0
- package/dist/workflow-runtime.d.ts +735 -0
- package/dist/workflow-runtime.js +747 -0
- package/dist/workflow-skills.d.ts +48 -0
- package/dist/workflow-skills.js +141 -0
- package/docs/images/impeccable-skill.png +0 -0
- package/docs/images/workflow-overview.png +0 -0
- package/docs/images/workflow-skills.png +0 -0
- package/package.json +77 -4
- package/skills/ew-impeccable/LICENSE +191 -0
- package/skills/ew-impeccable/NOTICE.md +19 -0
- package/skills/ew-impeccable/SKILL.md +91 -0
- package/skills/ew-impeccable/UPSTREAM.md +23 -0
- package/skills/ew-impeccable/reference/adapt.md +314 -0
- package/skills/ew-impeccable/reference/adapt.native.md +60 -0
- package/skills/ew-impeccable/reference/android.md +46 -0
- package/skills/ew-impeccable/reference/animate.md +91 -0
- package/skills/ew-impeccable/reference/audit.md +138 -0
- package/skills/ew-impeccable/reference/audit.native.md +141 -0
- package/skills/ew-impeccable/reference/bolder.md +35 -0
- package/skills/ew-impeccable/reference/clarify.md +96 -0
- package/skills/ew-impeccable/reference/colorize.md +88 -0
- package/skills/ew-impeccable/reference/craft-floor.md +44 -0
- package/skills/ew-impeccable/reference/craft.md +5 -0
- package/skills/ew-impeccable/reference/critique.md +808 -0
- package/skills/ew-impeccable/reference/degraded/asset-producer.md +36 -0
- package/skills/ew-impeccable/reference/degraded/documenter.md +23 -0
- package/skills/ew-impeccable/reference/degraded/finish-reviewer.md +72 -0
- package/skills/ew-impeccable/reference/degraded/manual-edit-applier.md +91 -0
- package/skills/ew-impeccable/reference/delight.md +72 -0
- package/skills/ew-impeccable/reference/distill.md +113 -0
- package/skills/ew-impeccable/reference/doctor.md +56 -0
- package/skills/ew-impeccable/reference/document.md +418 -0
- package/skills/ew-impeccable/reference/extract.md +68 -0
- package/skills/ew-impeccable/reference/harden.md +338 -0
- package/skills/ew-impeccable/reference/hooks.md +113 -0
- package/skills/ew-impeccable/reference/init.md +133 -0
- package/skills/ew-impeccable/reference/ios.md +51 -0
- package/skills/ew-impeccable/reference/layout.md +86 -0
- package/skills/ew-impeccable/reference/live-setup.md +102 -0
- package/skills/ew-impeccable/reference/live.md +326 -0
- package/skills/ew-impeccable/reference/new-work.md +209 -0
- package/skills/ew-impeccable/reference/onboard.md +236 -0
- package/skills/ew-impeccable/reference/operate.md +61 -0
- package/skills/ew-impeccable/reference/optimize.md +260 -0
- package/skills/ew-impeccable/reference/overdrive.md +127 -0
- package/skills/ew-impeccable/reference/polish.md +105 -0
- package/skills/ew-impeccable/reference/quieter.md +101 -0
- package/skills/ew-impeccable/reference/routing.md +20 -0
- package/skills/ew-impeccable/reference/shape.md +59 -0
- package/skills/ew-impeccable/reference/typeset.md +82 -0
- package/skills/ew-impeccable/reference/visualize.md +46 -0
- package/skills/ew-impeccable/scripts/build-phase.mjs +1022 -0
- package/skills/ew-impeccable/scripts/command-metadata.json +94 -0
- package/skills/ew-impeccable/scripts/comp-diff.mjs +391 -0
- package/skills/ew-impeccable/scripts/comp-spec.mjs +513 -0
- package/skills/ew-impeccable/scripts/concept-seed.mjs +814 -0
- package/skills/ew-impeccable/scripts/context-signals.mjs +325 -0
- package/skills/ew-impeccable/scripts/context.mjs +1521 -0
- package/skills/ew-impeccable/scripts/critique-storage.mjs +473 -0
- package/skills/ew-impeccable/scripts/data/font-index-failures.json +121 -0
- package/skills/ew-impeccable/scripts/data/font-index.json +1 -0
- package/skills/ew-impeccable/scripts/detect-csp.mjs +246 -0
- package/skills/ew-impeccable/scripts/detect.mjs +30 -0
- package/skills/ew-impeccable/scripts/detector/browser/injected/index.mjs +2580 -0
- package/skills/ew-impeccable/scripts/detector/cli/main.mjs +498 -0
- package/skills/ew-impeccable/scripts/detector/design-system.mjs +1311 -0
- package/skills/ew-impeccable/scripts/detector/detect-antipatterns-browser.js +9486 -0
- package/skills/ew-impeccable/scripts/detector/detect-antipatterns.mjs +51 -0
- package/skills/ew-impeccable/scripts/detector/engines/browser/detect-url.mjs +434 -0
- package/skills/ew-impeccable/scripts/detector/engines/regex/detect-text.mjs +1439 -0
- package/skills/ew-impeccable/scripts/detector/engines/static-html/css-cascade.mjs +1242 -0
- package/skills/ew-impeccable/scripts/detector/engines/static-html/detect-html.mjs +263 -0
- package/skills/ew-impeccable/scripts/detector/engines/visual/screenshot-contrast.mjs +189 -0
- package/skills/ew-impeccable/scripts/detector/findings.mjs +23 -0
- package/skills/ew-impeccable/scripts/detector/node/file-system.mjs +225 -0
- package/skills/ew-impeccable/scripts/detector/profile/profiler.mjs +166 -0
- package/skills/ew-impeccable/scripts/detector/registry/antipatterns.mjs +636 -0
- package/skills/ew-impeccable/scripts/detector/rules/checks.mjs +5750 -0
- package/skills/ew-impeccable/scripts/detector/shared/color.mjs +596 -0
- package/skills/ew-impeccable/scripts/detector/shared/constants.mjs +127 -0
- package/skills/ew-impeccable/scripts/detector/shared/fonts.mjs +30 -0
- package/skills/ew-impeccable/scripts/detector/shared/inline-ignores.mjs +148 -0
- package/skills/ew-impeccable/scripts/detector/shared/page.mjs +7 -0
- package/skills/ew-impeccable/scripts/detector/vendor/MDN-DATA-LICENSE +116 -0
- package/skills/ew-impeccable/scripts/detector/vendor/THIRD_PARTY_LICENSES.md +227 -0
- package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.build-entry.txt +11 -0
- package/skills/ew-impeccable/scripts/detector/vendor/static-html-parser.bundle.mjs +9121 -0
- package/skills/ew-impeccable/scripts/doctor.mjs +330 -0
- package/skills/ew-impeccable/scripts/embed-prompt.mjs +166 -0
- package/skills/ew-impeccable/scripts/font-match.mjs +457 -0
- package/skills/ew-impeccable/scripts/generate-image.mjs +447 -0
- package/skills/ew-impeccable/scripts/hook-admin.mjs +829 -0
- package/skills/ew-impeccable/scripts/hook-before-edit.mjs +538 -0
- package/skills/ew-impeccable/scripts/hook-lib.mjs +2493 -0
- package/skills/ew-impeccable/scripts/hook.mjs +79 -0
- package/skills/ew-impeccable/scripts/lib/artifact-schema.mjs +93 -0
- package/skills/ew-impeccable/scripts/lib/composition-catalog.mjs +200 -0
- package/skills/ew-impeccable/scripts/lib/concept-catalog.mjs +395 -0
- package/skills/ew-impeccable/scripts/lib/design-parser.mjs +880 -0
- package/skills/ew-impeccable/scripts/lib/font-fingerprint.mjs +564 -0
- package/skills/ew-impeccable/scripts/lib/font-index.mjs +130 -0
- package/skills/ew-impeccable/scripts/lib/hero-checks.mjs +246 -0
- package/skills/ew-impeccable/scripts/lib/image-metrics.mjs +306 -0
- package/skills/ew-impeccable/scripts/lib/impeccable-config.mjs +640 -0
- package/skills/ew-impeccable/scripts/lib/impeccable-paths.mjs +137 -0
- package/skills/ew-impeccable/scripts/lib/is-generated.mjs +72 -0
- package/skills/ew-impeccable/scripts/lib/live-path-globs.mjs +37 -0
- package/skills/ew-impeccable/scripts/lib/open-system-browser.mjs +26 -0
- package/skills/ew-impeccable/scripts/lib/png.mjs +281 -0
- package/skills/ew-impeccable/scripts/lib/provider.mjs +5 -0
- package/skills/ew-impeccable/scripts/lib/raster.mjs +194 -0
- package/skills/ew-impeccable/scripts/lib/roll-selection.mjs +369 -0
- package/skills/ew-impeccable/scripts/lib/staleness-deep.mjs +491 -0
- package/skills/ew-impeccable/scripts/lib/staleness-notice.mjs +169 -0
- package/skills/ew-impeccable/scripts/lib/staleness.mjs +532 -0
- package/skills/ew-impeccable/scripts/lib/surface-briefs.mjs +149 -0
- package/skills/ew-impeccable/scripts/lib/target-args.mjs +42 -0
- package/skills/ew-impeccable/scripts/lib/target-slug.mjs +33 -0
- package/skills/ew-impeccable/scripts/lib/template-extensions.mjs +146 -0
- package/skills/ew-impeccable/scripts/live/accept-css.mjs +617 -0
- package/skills/ew-impeccable/scripts/live/accept-verify.mjs +60 -0
- package/skills/ew-impeccable/scripts/live/browser-script-parts.mjs +84 -0
- package/skills/ew-impeccable/scripts/live/completion.mjs +28 -0
- package/skills/ew-impeccable/scripts/live/event-validation.mjs +199 -0
- package/skills/ew-impeccable/scripts/live/frameworks/astro.mjs +47 -0
- package/skills/ew-impeccable/scripts/live/frameworks/detect-utils.mjs +73 -0
- package/skills/ew-impeccable/scripts/live/frameworks/index.mjs +143 -0
- package/skills/ew-impeccable/scripts/live/frameworks/journal.mjs +197 -0
- package/skills/ew-impeccable/scripts/live/frameworks/nextjs.mjs +49 -0
- package/skills/ew-impeccable/scripts/live/frameworks/nuxt.mjs +161 -0
- package/skills/ew-impeccable/scripts/live/frameworks/script-src.mjs +17 -0
- package/skills/ew-impeccable/scripts/live/frameworks/static-html.mjs +26 -0
- package/skills/ew-impeccable/scripts/live/frameworks/sveltekit.mjs +71 -0
- package/skills/ew-impeccable/scripts/live/frameworks/tag-strategy.mjs +247 -0
- package/skills/ew-impeccable/scripts/live/frameworks/tanstack-start.mjs +70 -0
- package/skills/ew-impeccable/scripts/live/frameworks/vite-generic.mjs +42 -0
- package/skills/ew-impeccable/scripts/live/generation-preflight.mjs +149 -0
- package/skills/ew-impeccable/scripts/live/insert-ui.mjs +458 -0
- package/skills/ew-impeccable/scripts/live/instructions.mjs +142 -0
- package/skills/ew-impeccable/scripts/live/manual-apply.mjs +939 -0
- package/skills/ew-impeccable/scripts/live/manual-edit-routes.mjs +357 -0
- package/skills/ew-impeccable/scripts/live/manual-edits-buffer.mjs +152 -0
- package/skills/ew-impeccable/scripts/live/poll-lanes.mjs +14 -0
- package/skills/ew-impeccable/scripts/live/project-ignores.mjs +139 -0
- package/skills/ew-impeccable/scripts/live/roots.mjs +508 -0
- package/skills/ew-impeccable/scripts/live/session-store.mjs +563 -0
- package/skills/ew-impeccable/scripts/live/source-lock.mjs +105 -0
- package/skills/ew-impeccable/scripts/live/source-search.mjs +105 -0
- package/skills/ew-impeccable/scripts/live/svelte-ast.mjs +969 -0
- package/skills/ew-impeccable/scripts/live/svelte-component.mjs +1366 -0
- package/skills/ew-impeccable/scripts/live/sveltekit-adapter.mjs +304 -0
- package/skills/ew-impeccable/scripts/live/tanstack-adapter.mjs +259 -0
- package/skills/ew-impeccable/scripts/live/ui-surfaces.mjs +75 -0
- package/skills/ew-impeccable/scripts/live/vocabulary.mjs +171 -0
- package/skills/ew-impeccable/scripts/live-accept.mjs +938 -0
- package/skills/ew-impeccable/scripts/live-browser-dom.js +167 -0
- package/skills/ew-impeccable/scripts/live-browser-ignores.js +242 -0
- package/skills/ew-impeccable/scripts/live-browser-session.js +144 -0
- package/skills/ew-impeccable/scripts/live-browser.js +12851 -0
- package/skills/ew-impeccable/scripts/live-commit-manual-edits.mjs +1200 -0
- package/skills/ew-impeccable/scripts/live-complete.mjs +107 -0
- package/skills/ew-impeccable/scripts/live-copy-edit-agent.mjs +800 -0
- package/skills/ew-impeccable/scripts/live-discard-manual-edits.mjs +51 -0
- package/skills/ew-impeccable/scripts/live-inject.mjs +463 -0
- package/skills/ew-impeccable/scripts/live-insert.mjs +292 -0
- package/skills/ew-impeccable/scripts/live-manual-edit-evidence.mjs +368 -0
- package/skills/ew-impeccable/scripts/live-poll.mjs +430 -0
- package/skills/ew-impeccable/scripts/live-resume.mjs +123 -0
- package/skills/ew-impeccable/scripts/live-server.mjs +1698 -0
- package/skills/ew-impeccable/scripts/live-status.mjs +71 -0
- package/skills/ew-impeccable/scripts/live-target.mjs +30 -0
- package/skills/ew-impeccable/scripts/live-wrap.mjs +927 -0
- package/skills/ew-impeccable/scripts/live.mjs +334 -0
- package/skills/ew-impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/skills/ew-impeccable/scripts/palette.mjs +628 -0
- package/skills/ew-impeccable/scripts/pin.mjs +352 -0
- package/skills/ew-impeccable/scripts/serve-question.mjs +1783 -0
- package/skills/ew-impeccable/scripts/surface-brief.mjs +74 -0
- package/skills/ew-knowledge/SKILL.md +35 -0
- package/skills/ew-knowledge/references/closeout-protocol.md +68 -0
- package/skills/ew-knowledge/references/knowledge-route.md +73 -0
- package/skills/ew-knowledge/references/wiki-maintenance.md +27 -0
- package/skills/ew-odyssey/SKILL.md +106 -0
- package/skills/ew-odyssey/references/audit-artifacts.md +7 -0
- package/skills/ew-odyssey/references/odyssey-base.md +104 -0
- package/skills/ew-odyssey/references/odyssey-debug.md +264 -0
- package/skills/ew-odyssey/references/odyssey-defensive.md +351 -0
- package/skills/ew-odyssey/references/odyssey-improve.md +230 -0
- package/skills/ew-odyssey/references/odyssey-planex.md +294 -0
- package/skills/ew-odyssey/references/odyssey-review.md +233 -0
- package/skills/ew-odyssey/references/odyssey-security.md +231 -0
- package/skills/ew-odyssey/references/odyssey-ui.md +232 -0
- package/skills/ew-odyssey/references/prepare/odyssey-debug.md +102 -0
- package/skills/ew-odyssey/references/prepare/odyssey-defensive.md +117 -0
- package/skills/ew-odyssey/references/prepare/odyssey-improve.md +95 -0
- package/skills/ew-odyssey/references/prepare/odyssey-planex.md +105 -0
- package/skills/ew-odyssey/references/prepare/odyssey-review.md +105 -0
- package/skills/ew-odyssey/references/prepare/odyssey-security.md +91 -0
- package/skills/ew-odyssey/references/prepare/odyssey-ui.md +88 -0
- package/skills/ew-odyssey/references/runtime-adapters.md +31 -0
- package/skills/ew-orchestrate/SKILL.md +89 -0
- package/skills/ew-orchestrate/references/auto-policy.md +66 -0
- package/skills/ew-orchestrate/references/boundary-grill.md +51 -0
- package/skills/ew-orchestrate/references/companion-route.md +40 -0
- package/skills/ew-orchestrate/references/ew-orchestrate.md +44 -0
- package/skills/ew-orchestrate/references/goal.md +51 -0
- package/skills/ew-orchestrate/references/orchestrator-run-loop.md +33 -0
- package/skills/ew-orchestrate/references/planning.md +54 -0
- package/skills/ew-orchestrate/steps/ew-analyze/SKILL.md +70 -0
- package/skills/ew-orchestrate/steps/ew-analyze/references/issue-gaps-analyze.md +24 -0
- package/skills/ew-orchestrate/steps/ew-analyze/references/prepare.md +8 -0
- package/skills/ew-orchestrate/steps/ew-analyze/references/workflow.md +138 -0
- package/skills/ew-orchestrate/steps/ew-auto-test/SKILL.md +80 -0
- package/skills/ew-orchestrate/steps/ew-auto-test/references/prepare.md +23 -0
- package/skills/ew-orchestrate/steps/ew-auto-test/references/workflow.md +31 -0
- package/skills/ew-orchestrate/steps/ew-blueprint/SKILL.md +122 -0
- package/skills/ew-orchestrate/steps/ew-blueprint/references/prepare.md +21 -0
- package/skills/ew-orchestrate/steps/ew-blueprint/references/workflow.md +28 -0
- package/skills/ew-orchestrate/steps/ew-brainstorm/SKILL.md +49 -0
- package/skills/ew-orchestrate/steps/ew-companion/SKILL.md +50 -0
- package/skills/ew-orchestrate/steps/ew-debug/SKILL.md +85 -0
- package/skills/ew-orchestrate/steps/ew-debug/references/prepare.md +27 -0
- package/skills/ew-orchestrate/steps/ew-debug/references/workflow.md +31 -0
- package/skills/ew-orchestrate/steps/ew-execute/SKILL.md +74 -0
- package/skills/ew-orchestrate/steps/ew-execute/references/prepare.md +27 -0
- package/skills/ew-orchestrate/steps/ew-execute/references/workflow.md +87 -0
- package/skills/ew-orchestrate/steps/ew-grill/SKILL.md +62 -0
- package/skills/ew-orchestrate/steps/ew-grill/references/prepare.md +26 -0
- package/skills/ew-orchestrate/steps/ew-grill/references/workflow.md +31 -0
- package/skills/ew-orchestrate/steps/ew-init/SKILL.md +56 -0
- package/skills/ew-orchestrate/steps/ew-init/references/prepare.md +25 -0
- package/skills/ew-orchestrate/steps/ew-init/references/workflow.md +28 -0
- package/skills/ew-orchestrate/steps/ew-plan/SKILL.md +131 -0
- package/skills/ew-orchestrate/steps/ew-plan/references/prepare.md +8 -0
- package/skills/ew-orchestrate/steps/ew-plan/references/tdd.md +53 -0
- package/skills/ew-orchestrate/steps/ew-plan/references/workflow.md +100 -0
- package/skills/ew-orchestrate/steps/ew-retrospective/SKILL.md +68 -0
- package/skills/ew-orchestrate/steps/ew-retrospective/references/prepare.md +18 -0
- package/skills/ew-orchestrate/steps/ew-retrospective/references/workflow.md +34 -0
- package/skills/ew-orchestrate/steps/ew-review/SKILL.md +45 -0
- package/skills/ew-orchestrate/steps/ew-review/references/prepare.md +17 -0
- package/skills/ew-orchestrate/steps/ew-review/references/workflow.md +116 -0
- package/skills/ew-orchestrate/steps/ew-roadmap/SKILL.md +62 -0
- package/skills/ew-orchestrate/steps/ew-roadmap/references/prepare.md +27 -0
- package/skills/ew-orchestrate/steps/ew-roadmap/references/workflow.md +28 -0
- package/skills/ew-orchestrate/steps/ew-test/SKILL.md +99 -0
- package/skills/ew-orchestrate/steps/ew-test/references/prepare.md +23 -0
- package/skills/ew-orchestrate/steps/ew-test/references/workflow.md +23 -0
- package/skills/ew-orchestrate/steps/ew-verify/SKILL.md +73 -0
- package/skills/ew-orchestrate/steps/ew-verify/references/prepare.md +21 -0
- package/skills/ew-orchestrate/steps/ew-verify/references/workflow.md +29 -0
- package/skills/ew-skill-design/SKILL.md +30 -0
- package/skills/ew-skill-design/references/package-contract.md +40 -0
- package/skills/ew-skill-design/references/validation.md +21 -0
- package/skills/team-swarm/SKILL.md +68 -0
- package/skills/team-swarm/references/mcp-coordination.md +14 -0
- package/skills/team-swarm/roles/analyst/role.md +181 -0
- package/skills/team-swarm/roles/ant/role.md +149 -0
- package/skills/team-swarm/roles/coordinator/commands/converge.md +112 -0
- package/skills/team-swarm/roles/coordinator/commands/init-swarm.md +136 -0
- package/skills/team-swarm/roles/coordinator/commands/iterate.md +171 -0
- package/skills/team-swarm/roles/coordinator/role.md +170 -0
- package/skills/team-swarm/roles/scorer/role.md +150 -0
- package/skills/team-swarm/scripts/aco.py +646 -0
- package/skills/team-swarm/scripts/pheromone.py +144 -0
- package/skills/team-swarm/scripts/scoring.py +111 -0
- package/skills/team-swarm/scripts/test_aco.py +606 -0
- package/skills/team-swarm/specs/ant-output-schema.md +127 -0
- package/skills/team-swarm/specs/convergence-criteria.md +108 -0
- package/skills/team-swarm/specs/pheromone-schema.md +125 -0
- package/skills/team-swarm/specs/swarm-config-template.json +71 -0
- package/skills/team-swarm/specs/swarm-protocol.md +119 -0
- package/skills/workflow-evolve/SKILL.md +64 -0
- package/skills/workflow-evolve/references/agy-gate.md +27 -0
- package/skills/workflow-evolve/references/auto-loop.md +23 -0
- package/skills/workflow-evolve/references/history-review.md +15 -0
- package/skills/workflow-evolve/scripts/codex-memory-replay.mjs +86 -0
- package/skills/workflow-evolve/scripts/codex-replay.mjs +1 -0
- package/skills/workflow-evolve/scripts/evolve-loop.mjs +260 -0
- package/skills/workflow-evolve/scripts/memory-codex-mcp.mjs +124 -0
- 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).
|