@williambeto/ai-workflow 1.19.1 → 2.2.0

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 (397) hide show
  1. package/CHANGELOG.md +56 -838
  2. package/PUBLISH_MANIFEST.json +34 -0
  3. package/README.md +78 -148
  4. package/{packages/ai-workflow/bin → bin}/ai-workflow.js +0 -0
  5. package/dist-assets/AGENTS.md +27 -0
  6. package/dist-assets/agents/astra.md +63 -0
  7. package/dist-assets/agents/atlas.md +169 -0
  8. package/dist-assets/agents/nexus.md +42 -0
  9. package/dist-assets/agents/orion.md +44 -0
  10. package/dist-assets/agents/phoenix.md +42 -0
  11. package/dist-assets/agents/sage.md +54 -0
  12. package/dist-assets/commands/README.md +14 -0
  13. package/dist-assets/commands/atlas.md +12 -0
  14. package/dist-assets/commands/audit.md +10 -0
  15. package/dist-assets/commands/deploy.md +12 -0
  16. package/dist-assets/commands/discover.md +10 -0
  17. package/dist-assets/commands/implement.md +28 -0
  18. package/dist-assets/commands/optimize-tokens.md +10 -0
  19. package/dist-assets/commands/plan.md +10 -0
  20. package/dist-assets/commands/release.md +12 -0
  21. package/dist-assets/commands/run.md +26 -0
  22. package/dist-assets/commands/spec-create.md +10 -0
  23. package/dist-assets/commands/spec-implement.md +10 -0
  24. package/dist-assets/commands/spec-review.md +10 -0
  25. package/dist-assets/commands/update-memory.md +10 -0
  26. package/dist-assets/commands/validate.md +12 -0
  27. package/dist-assets/docs/INDEX.md +21 -0
  28. package/dist-assets/docs/QUICKSTART.md +23 -0
  29. package/dist-assets/docs/adr/ADR-0000.md +19 -0
  30. package/dist-assets/docs/adr/ADR-0001.md +45 -0
  31. package/dist-assets/docs/adr/ADR-0002.md +62 -0
  32. package/dist-assets/docs/adr/ADR-0003.md +60 -0
  33. package/dist-assets/docs/adr/ADR-0004.md +71 -0
  34. package/dist-assets/docs/adr/ADR-0005.md +22 -0
  35. package/dist-assets/docs/adr/ADR-0006.md +82 -0
  36. package/dist-assets/docs/adr/ADR-0007.md +78 -0
  37. package/dist-assets/docs/api-engine-reference.md +7 -0
  38. package/{docs → dist-assets/docs}/architecture-policy.md +1 -1
  39. package/dist-assets/docs/cli-reference.md +27 -0
  40. package/dist-assets/docs/compatibility/provider-usage.md +38 -0
  41. package/dist-assets/docs/compatibility/runtime-matrix.md +30 -0
  42. package/dist-assets/docs/consumer-onboarding.md +17 -0
  43. package/dist-assets/docs/contributing-guide.md +11 -0
  44. package/{docs → dist-assets/docs}/design-patterns-policy.md +2 -2
  45. package/dist-assets/docs/full-documentation.md +113 -0
  46. package/{docs → dist-assets/docs}/npm-consumer-quickstart.md +18 -46
  47. package/dist-assets/docs/opencode-readme.md +8 -0
  48. package/dist-assets/docs/policies/01-BRANCH_GATE.md +63 -0
  49. package/dist-assets/docs/policies/02-SDD_METHODOLOGY.md +95 -0
  50. package/dist-assets/docs/policies/03-QUALITY_GATE.md +22 -0
  51. package/dist-assets/docs/policies/05-AGENT_CONTRACT.md +7 -0
  52. package/dist-assets/docs/policies/06-FINAL_EVIDENCE_CONTRACT.md +31 -0
  53. package/dist-assets/docs/policies/07-RELEASE_GATE.md +47 -0
  54. package/dist-assets/docs/policies/08-PRODUCT_TRUTHFULNESS_AND_PROJECT_DOCS.md +18 -0
  55. package/dist-assets/docs/policies/09-SPEC_VISIBILITY_AND_PUBLICATION.md +28 -0
  56. package/dist-assets/docs/policies/10-BEHAVIORAL_CONTRACT_HARDENING.md +9 -0
  57. package/dist-assets/docs/policies/11-EXECUTABLE_DELEGATION_AND_TRUTHFULNESS.md +7 -0
  58. package/dist-assets/docs/policies/ORCHESTRATION_PROTOCOL.md +15 -0
  59. package/dist-assets/docs/policies/PROCEDURE_DELIVERY_ARTIFACTS.md +21 -0
  60. package/dist-assets/docs/policies/PROCEDURE_DOCUMENTATION_CHECKLIST.md +24 -0
  61. package/dist-assets/docs/policies/PROCEDURE_UI_CHECKLIST.md +54 -0
  62. package/dist-assets/docs/profiles/README.md +19 -0
  63. package/dist-assets/docs/profiles/backend-api.md +5 -0
  64. package/dist-assets/docs/profiles/documentation.md +3 -0
  65. package/dist-assets/docs/profiles/frontend-product.md +19 -0
  66. package/dist-assets/docs/profiles/frontend-utility.md +19 -0
  67. package/dist-assets/docs/profiles/refactor.md +3 -0
  68. package/dist-assets/docs/profiles/security-review.md +3 -0
  69. package/dist-assets/docs/references/frontend-quality/landing-page-quality-checklist.md +11 -0
  70. package/dist-assets/docs/references/frontend-quality/product-copy-truthfulness.md +7 -0
  71. package/dist-assets/docs/references/frontend-quality/quality-failure-examples.md +20 -0
  72. package/dist-assets/docs/references/frontend-quality/visual-composition-patterns.md +10 -0
  73. package/dist-assets/docs/specs/runtime-operational-contract.md +39 -0
  74. package/dist-assets/docs/troubleshooting-guide.md +21 -0
  75. package/dist-assets/docs/visual-validation-guide.md +76 -0
  76. package/dist-assets/examples/README.md +10 -0
  77. package/dist-assets/examples/autopilot-cycle/00-CONTEXT.md +3 -0
  78. package/dist-assets/examples/autopilot-cycle/01-requirement.md +16 -0
  79. package/dist-assets/examples/autopilot-cycle/02-gate-a-check.md +23 -0
  80. package/dist-assets/examples/autopilot-cycle/03-orion-planning.md +20 -0
  81. package/dist-assets/examples/autopilot-cycle/04-astra-implementation.md +17 -0
  82. package/dist-assets/examples/autopilot-cycle/05-sage-validation.md +15 -0
  83. package/dist-assets/examples/autopilot-cycle/06-phoenix-healing.md +12 -0
  84. package/dist-assets/examples/autopilot-cycle/07-orchestration-report.md +18 -0
  85. package/dist-assets/examples/backend-api/00-CONTEXT.md +12 -0
  86. package/dist-assets/examples/backend-api/01-requirement.md +19 -0
  87. package/dist-assets/examples/backend-api/02-functional-spec.md +20 -0
  88. package/dist-assets/examples/backend-api/03-technical-plan.md +15 -0
  89. package/dist-assets/examples/backend-api/04-pr-breakdown.md +10 -0
  90. package/dist-assets/examples/backend-api/05-execution-handoff.md +13 -0
  91. package/dist-assets/examples/backend-api/06-validation-report.md +11 -0
  92. package/dist-assets/examples/backend-api/07-orchestration-report.md +7 -0
  93. package/dist-assets/examples/blocked-scenarios/00-CONTEXT.md +9 -0
  94. package/dist-assets/examples/blocked-scenarios/01-branch-gate-block.md +12 -0
  95. package/dist-assets/examples/blocked-scenarios/02-quality-gate-block.md +13 -0
  96. package/dist-assets/examples/blocked-scenarios/03-scope-creep-block.md +13 -0
  97. package/dist-assets/examples/blocked-scenarios/04-unblock-resolution.md +9 -0
  98. package/dist-assets/examples/blocked-scenarios/05-orchestration-decision-log.md +11 -0
  99. package/dist-assets/examples/bugfix-critical/00-CONTEXT.md +12 -0
  100. package/dist-assets/examples/bugfix-critical/01-bug-report.md +11 -0
  101. package/dist-assets/examples/bugfix-critical/02-diagnosis-hypothesis.md +11 -0
  102. package/dist-assets/examples/bugfix-critical/03-technical-plan.md +12 -0
  103. package/dist-assets/examples/bugfix-critical/04-implementation-handoff.md +8 -0
  104. package/dist-assets/examples/bugfix-critical/05-validation-report.md +10 -0
  105. package/dist-assets/examples/bugfix-critical/06-orchestration-report.md +7 -0
  106. package/dist-assets/examples/cli-package/00-CONTEXT.md +9 -0
  107. package/dist-assets/examples/cli-package/01-requirement.md +14 -0
  108. package/dist-assets/examples/cli-package/02-technical-spec.md +16 -0
  109. package/dist-assets/examples/cli-package/03-technical-plan.md +12 -0
  110. package/dist-assets/examples/cli-package/04-pr-breakdown.md +9 -0
  111. package/dist-assets/examples/cli-package/05-release-report.md +15 -0
  112. package/dist-assets/examples/docs-only-repo/01-requirement.md +31 -0
  113. package/dist-assets/examples/docs-only-repo/02-functional-spec.md +25 -0
  114. package/dist-assets/examples/docs-only-repo/03-technical-plan.md +21 -0
  115. package/dist-assets/examples/docs-only-repo/04-pr-breakdown.md +13 -0
  116. package/dist-assets/examples/docs-only-repo/05-execution-handoff.md +17 -0
  117. package/dist-assets/examples/docs-only-repo/06-validation-report.md +16 -0
  118. package/dist-assets/examples/docs-only-repo/README.md +26 -0
  119. package/dist-assets/examples/full-stack-checkout/00-CONTEXT.md +9 -0
  120. package/dist-assets/examples/full-stack-checkout/01-requirement.md +12 -0
  121. package/dist-assets/examples/full-stack-checkout/02-functional-spec.md +15 -0
  122. package/dist-assets/examples/full-stack-checkout/03-technical-plan.md +15 -0
  123. package/dist-assets/examples/full-stack-checkout/04-pr-breakdown.md +8 -0
  124. package/dist-assets/examples/full-stack-checkout/05-execution-handoff.md +14 -0
  125. package/dist-assets/examples/full-stack-checkout/06-validation-report.md +12 -0
  126. package/dist-assets/examples/healing-cycle/00-CONTEXT.md +15 -0
  127. package/dist-assets/examples/healing-cycle/01-broken-implementation.md +10 -0
  128. package/dist-assets/examples/healing-cycle/02-sage-fails.md +14 -0
  129. package/dist-assets/examples/healing-cycle/03-phoenix-diagnosis.md +17 -0
  130. package/dist-assets/examples/healing-cycle/04-phoenix-fix.md +18 -0
  131. package/dist-assets/examples/healing-cycle/05-sage-revalidation.md +12 -0
  132. package/dist-assets/examples/healing-cycle/06-orchestration-log.md +14 -0
  133. package/dist-assets/examples/infra-deploy/00-CONTEXT.md +9 -0
  134. package/dist-assets/examples/infra-deploy/01-operational-goal.md +12 -0
  135. package/dist-assets/examples/infra-deploy/02-architecture-specs.md +15 -0
  136. package/dist-assets/examples/infra-deploy/03-implementation-plan.md +14 -0
  137. package/dist-assets/examples/infra-deploy/04-step-breakdown.md +9 -0
  138. package/dist-assets/examples/infra-deploy/05-execution-handoff.md +13 -0
  139. package/dist-assets/examples/infra-deploy/06-operational-report.md +11 -0
  140. package/dist-assets/examples/multi-pr-release/00-CONTEXT.md +9 -0
  141. package/dist-assets/examples/multi-pr-release/01-requirement.md +13 -0
  142. package/dist-assets/examples/multi-pr-release/02-strategic-plan.md +13 -0
  143. package/dist-assets/examples/multi-pr-release/03-pr-breakdown.md +14 -0
  144. package/dist-assets/examples/multi-pr-release/04-release-plan.md +12 -0
  145. package/dist-assets/examples/multi-pr-release/05-orchestration-report.md +7 -0
  146. package/dist-assets/examples/nuxt-dashboard/01-requirement.md +81 -0
  147. package/dist-assets/examples/nuxt-dashboard/02-functional-spec.md +88 -0
  148. package/dist-assets/examples/nuxt-dashboard/03-technical-plan.md +76 -0
  149. package/dist-assets/examples/nuxt-dashboard/04-pr-breakdown.md +219 -0
  150. package/dist-assets/examples/nuxt-dashboard/05-execution-handoff.md +88 -0
  151. package/dist-assets/examples/nuxt-dashboard/06-validation-report.md +56 -0
  152. package/dist-assets/examples/nuxt-dashboard/07-orchestration-report.md +79 -0
  153. package/dist-assets/examples/nuxt-dashboard/README.md +52 -0
  154. package/dist-assets/examples/react-dashboard/01-requirement.md +84 -0
  155. package/dist-assets/examples/react-dashboard/02-functional-spec.md +88 -0
  156. package/dist-assets/examples/react-dashboard/03-technical-plan.md +76 -0
  157. package/dist-assets/examples/react-dashboard/04-pr-breakdown.md +218 -0
  158. package/dist-assets/examples/react-dashboard/05-execution-handoff.md +13 -0
  159. package/dist-assets/examples/react-dashboard/06-validation-report.md +12 -0
  160. package/dist-assets/examples/react-dashboard/07-orchestration-report.md +7 -0
  161. package/dist-assets/examples/react-dashboard/README.md +70 -0
  162. package/dist-assets/examples/refactoring-service/00-CONTEXT.md +9 -0
  163. package/dist-assets/examples/refactoring-service/01-debt-report.md +12 -0
  164. package/dist-assets/examples/refactoring-service/02-behavior-spec.md +11 -0
  165. package/dist-assets/examples/refactoring-service/03-technical-plan.md +13 -0
  166. package/dist-assets/examples/refactoring-service/04-pr-breakdown.md +9 -0
  167. package/dist-assets/examples/refactoring-service/05-execution-handoff.md +14 -0
  168. package/dist-assets/examples/refactoring-service/06-stability-report.md +12 -0
  169. package/dist-assets/examples/sdd-cycle/00-CONTEXT.md +12 -0
  170. package/dist-assets/examples/sdd-cycle/01-raw-request.md +13 -0
  171. package/dist-assets/examples/sdd-cycle/02-spec-creation.md +18 -0
  172. package/dist-assets/examples/sdd-cycle/03-spec-review.md +12 -0
  173. package/dist-assets/examples/sdd-cycle/04-technical-plan.md +16 -0
  174. package/dist-assets/examples/sdd-cycle/05-pr-breakdown.md +9 -0
  175. package/dist-assets/examples/sdd-cycle/06-spec-implement.md +13 -0
  176. package/dist-assets/examples/sdd-cycle/07-validation-against-spec.md +13 -0
  177. package/dist-assets/examples/wordpress-theme/01-requirement.md +29 -0
  178. package/dist-assets/examples/wordpress-theme/02-functional-spec.md +22 -0
  179. package/dist-assets/examples/wordpress-theme/03-technical-plan.md +22 -0
  180. package/dist-assets/examples/wordpress-theme/04-pr-breakdown.md +14 -0
  181. package/dist-assets/examples/wordpress-theme/05-execution-handoff.md +17 -0
  182. package/dist-assets/examples/wordpress-theme/06-validation-report.md +16 -0
  183. package/dist-assets/examples/wordpress-theme/README.md +32 -0
  184. package/{harness → dist-assets/harness}/handoffs/HANDOFF.template.md +2 -2
  185. package/{harness → dist-assets/harness}/workflows/agent-evaluation-checklist.md +5 -5
  186. package/{harness → dist-assets/harness}/workflows/implement-review-validate.md +24 -0
  187. package/{harness → dist-assets/harness}/workflows/multi-agent-handoff.md +4 -4
  188. package/{harness → dist-assets/harness}/workflows/planner-executor-workflow.md +5 -5
  189. package/{harness → dist-assets/harness}/workflows/requirement-to-pr.md +1 -1
  190. package/dist-assets/runbooks/agent-delegation-workflow.md +50 -0
  191. package/dist-assets/runbooks/apply-starter-to-real-project.md +45 -0
  192. package/dist-assets/runbooks/commands-cheatsheet.md +44 -0
  193. package/dist-assets/runbooks/how-to-use-skills.md +44 -0
  194. package/dist-assets/runbooks/private-spec-publication-safety.md +35 -0
  195. package/{runbooks → dist-assets/runbooks}/spec-driven-development.md +3 -6
  196. package/dist-assets/runbooks/tutorial-walkthroughs.md +23 -0
  197. package/dist-assets/runbooks/use-linear-for-operational-planning.md +45 -0
  198. package/dist-assets/runbooks/use-napkin-project-memory.md +33 -0
  199. package/dist-assets/skills/architecture/SKILL.md +166 -0
  200. package/dist-assets/skills/backend-development/SKILL.md +166 -0
  201. package/dist-assets/skills/deployment/SKILL.md +166 -0
  202. package/dist-assets/skills/design-principles/SKILL.md +166 -0
  203. package/dist-assets/skills/documentation/SKILL.md +171 -0
  204. package/dist-assets/skills/frontend-development/SKILL.md +225 -0
  205. package/dist-assets/skills/full-stack-development/SKILL.md +166 -0
  206. package/dist-assets/skills/optimize-tokens/SKILL.md +166 -0
  207. package/dist-assets/skills/pr-workflow/SKILL.md +166 -0
  208. package/dist-assets/skills/product-discovery/SKILL.md +166 -0
  209. package/dist-assets/skills/product-planning/SKILL.md +166 -0
  210. package/dist-assets/skills/project-memory/SKILL.md +166 -0
  211. package/dist-assets/skills/prompt-engineer/SKILL.md +166 -0
  212. package/dist-assets/skills/qa-workflow/SKILL.md +186 -0
  213. package/dist-assets/skills/refactoring/SKILL.md +166 -0
  214. package/dist-assets/skills/release-workflow/SKILL.md +166 -0
  215. package/dist-assets/skills/spec-driven-development/SKILL.md +166 -0
  216. package/dist-assets/skills/technical-leadership/SKILL.md +166 -0
  217. package/dist-assets/skills/ui-ux-design/SKILL.md +202 -0
  218. package/dist-assets/templates/.geminiignore.template +8 -0
  219. package/dist-assets/templates/CLAUDE.md.template +20 -0
  220. package/dist-assets/templates/CODEX.md.template +20 -0
  221. package/dist-assets/templates/GEMINI.md.template +20 -0
  222. package/dist-assets/templates/HANDOFF.template.md +45 -0
  223. package/dist-assets/templates/SPEC.template.md +38 -0
  224. package/dist-assets/templates/change-proposal.template.md +14 -0
  225. package/dist-assets/templates/owner-evidence/astra-implementation.json +10 -0
  226. package/dist-assets/templates/owner-evidence/phoenix-remediation.json +8 -0
  227. package/dist-assets/templates/owner-evidence/sage-revalidation.json +8 -0
  228. package/dist-assets/templates/owner-evidence/sage-validation.json +8 -0
  229. package/dist-assets/templates/specs/deep.md +48 -0
  230. package/dist-assets/templates/specs/standard.md +38 -0
  231. package/dist-assets/templates/specs/tiny.md +19 -0
  232. package/package.json +43 -47
  233. package/src/adapters/index.js +3 -0
  234. package/src/adapters/platforms/claude.js +126 -0
  235. package/src/adapters/platforms/codex.js +100 -0
  236. package/src/adapters/platforms/gemini.js +232 -0
  237. package/src/cli.js +114 -0
  238. package/src/commands/collect-evidence.js +61 -0
  239. package/src/commands/doctor.js +186 -0
  240. package/src/commands/execute.js +172 -0
  241. package/{packages/ai-workflow/src → src}/commands/init.js +119 -20
  242. package/src/commands/run.js +112 -0
  243. package/src/core/completion-contract.js +35 -0
  244. package/src/core/execution-planner.js +59 -0
  245. package/src/core/gates/branch-gate.js +146 -0
  246. package/src/core/handoff/handoff-engine.js +104 -0
  247. package/src/core/healing/cli-remediation-executor.js +151 -0
  248. package/src/core/healing/healer-engine.js +179 -0
  249. package/src/core/identity.js +43 -0
  250. package/{packages/ai-workflow/src → src}/core/install-plan.js +3 -3
  251. package/src/core/opencode-merge.js +149 -0
  252. package/{packages/ai-workflow/src → src}/core/package-assets.js +29 -10
  253. package/src/core/request-classifier.js +58 -0
  254. package/src/core/runtime/opencode-adapter.js +94 -0
  255. package/src/core/sdd/validator.js +67 -0
  256. package/src/core/statuses.js +29 -0
  257. package/src/core/symlink-layout.js +93 -0
  258. package/src/core/templates.js +221 -0
  259. package/src/core/validation/canonical-finalization.js +43 -0
  260. package/src/core/validation/evidence-collector.js +109 -0
  261. package/src/core/validation/quality-guard.js +243 -0
  262. package/src/core/workflow-profiles.js +107 -0
  263. package/src/core/workflow-state-machine.js +46 -0
  264. package/.agents/napkin.md +0 -89
  265. package/.agents/skills/backend-implementer/SKILL.md +0 -490
  266. package/.agents/skills/build-and-validate/SKILL.md +0 -442
  267. package/.agents/skills/deploy-engineer/SKILL.md +0 -541
  268. package/.agents/skills/docs-writer/SKILL.md +0 -430
  269. package/.agents/skills/frontend-implementer/SKILL.md +0 -488
  270. package/.agents/skills/interface-design/SKILL.md +0 -428
  271. package/.agents/skills/interface-design/references/critique.md +0 -67
  272. package/.agents/skills/interface-design/references/example.md +0 -86
  273. package/.agents/skills/interface-design/references/principles.md +0 -235
  274. package/.agents/skills/interface-design/references/validation.md +0 -48
  275. package/.agents/skills/minimal-context/SKILL.md +0 -177
  276. package/.agents/skills/napkin/SKILL.md +0 -84
  277. package/.agents/skills/opencode-agent-design/SKILL.md +0 -77
  278. package/.agents/skills/playwright-cli/SKILL.md +0 -62
  279. package/.agents/skills/pr-orchestrator/SKILL.md +0 -366
  280. package/.agents/skills/product-manager/SKILL.md +0 -519
  281. package/.agents/skills/seo-audit/SKILL.md +0 -176
  282. package/.agents/skills/stack-variant-creator/SKILL.md +0 -265
  283. package/.agents/skills/tech-lead/SKILL.md +0 -453
  284. package/.agents/skills/tester/SKILL.md +0 -399
  285. package/.agents/skills/token-economy/SKILL.md +0 -137
  286. package/.agents/skills/vue-nuxt/SKILL.md +0 -102
  287. package/.agents/skills/wordpress-engineer/SKILL.md +0 -75
  288. package/.codex/prompts/README.md +0 -44
  289. package/.codex/prompts/autopilot.md +0 -50
  290. package/.codex/prompts/deploy.md +0 -33
  291. package/.codex/prompts/execute-selected-pr.md +0 -35
  292. package/.codex/prompts/fix-issue.md +0 -34
  293. package/.codex/prompts/minimal-context-mode.md +0 -55
  294. package/.codex/prompts/orchestrate-next.md +0 -33
  295. package/.codex/prompts/plan-from-requirement.md +0 -37
  296. package/.codex/prompts/review-implementation.md +0 -33
  297. package/.codex/prompts/roadmap-audit.md +0 -22
  298. package/.codex/prompts/specs/create-spec-from-requirement.md +0 -26
  299. package/.codex/prompts/specs/review-spec.md +0 -29
  300. package/.codex/prompts/specs/spec-to-pr-breakdown.md +0 -23
  301. package/.codex/prompts/specs/spec-to-technical-plan.md +0 -28
  302. package/.codex/prompts/start-project.md +0 -29
  303. package/.codex/prompts/token-economy-mode.md +0 -48
  304. package/.codex/prompts/validate-work.md +0 -28
  305. package/checklists/change-spec-readiness-checklist.md +0 -34
  306. package/docs/full-documentation.md +0 -661
  307. package/docs/setup-codex-opencode.md +0 -313
  308. package/harness/README.md +0 -106
  309. package/opencode/README.md +0 -84
  310. package/opencode/agents/README.md +0 -113
  311. package/opencode/agents/atlas.md +0 -127
  312. package/opencode/agents/discovery.md +0 -61
  313. package/opencode/agents/fixer.md +0 -51
  314. package/opencode/agents/implementer.md +0 -61
  315. package/opencode/agents/orchestrator.md +0 -145
  316. package/opencode/agents/planner.md +0 -60
  317. package/opencode/agents/prompt-engineer.md +0 -50
  318. package/opencode/agents/release-manager.md +0 -50
  319. package/opencode/agents/reviewer.md +0 -51
  320. package/opencode/agents/spec-engineer.md +0 -85
  321. package/opencode/agents/validator.md +0 -50
  322. package/opencode/agents/wordpress-engineer.md +0 -49
  323. package/opencode/commands/README.md +0 -48
  324. package/opencode/commands/autopilot.md +0 -50
  325. package/opencode/commands/deploy.md +0 -35
  326. package/opencode/commands/execute.md +0 -47
  327. package/opencode/commands/orchestrate.md +0 -37
  328. package/opencode/commands/plan.md +0 -39
  329. package/opencode/commands/review.md +0 -33
  330. package/opencode/commands/roadmap-audit.md +0 -30
  331. package/opencode/commands/ship.md +0 -48
  332. package/opencode/commands/specs/create-spec-from-request.md +0 -27
  333. package/opencode/commands/specs/create-spec-from-requirement.md +0 -25
  334. package/opencode/commands/specs/review-spec.md +0 -26
  335. package/opencode/commands/specs/spec-to-pr-breakdown.md +0 -19
  336. package/opencode/commands/specs/spec-to-tasks.md +0 -26
  337. package/opencode/commands/specs/spec-to-technical-plan.md +0 -27
  338. package/opencode/commands/start.md +0 -45
  339. package/opencode/commands/token-economy.md +0 -29
  340. package/opencode/commands/validate.md +0 -33
  341. package/opencode.jsonc +0 -235
  342. package/packages/ai-workflow/README.md +0 -82
  343. package/packages/ai-workflow/src/cli.js +0 -70
  344. package/packages/ai-workflow/src/commands/codex.js +0 -37
  345. package/packages/ai-workflow/src/commands/doctor.js +0 -168
  346. package/packages/ai-workflow/src/commands/guide.js +0 -194
  347. package/packages/ai-workflow/src/core/opencode-merge.js +0 -172
  348. package/packages/ai-workflow/src/core/symlink-layout.js +0 -54
  349. package/packages/ai-workflow/src/core/templates.js +0 -276
  350. package/runbooks/agent-delegation-workflow.md +0 -111
  351. package/runbooks/apply-starter-to-real-project.md +0 -445
  352. package/runbooks/commands-cheatsheet.md +0 -71
  353. package/runbooks/how-to-use-skills.md +0 -713
  354. package/runbooks/quick-start-guide.md +0 -213
  355. package/runbooks/tutorial-walkthroughs.md +0 -416
  356. package/runbooks/use-linear-for-operational-planning.md +0 -185
  357. package/runbooks/use-napkin-project-memory.md +0 -77
  358. package/templates/AGENTS.template.md +0 -397
  359. package/templates/DESIGN.template.md +0 -484
  360. package/templates/PR-PLAN.template.md +0 -172
  361. package/templates/README.template.md +0 -293
  362. package/templates/REQUIREMENT.template.md +0 -165
  363. package/templates/SPEC.template.md +0 -397
  364. package/templates/TECH-PLAN.template.md +0 -244
  365. package/templates/change-proposal.template.md +0 -97
  366. /package/{checklists/spec-readiness-checklist.md → dist-assets/docs/policies/SPEC_READINESS.md} +0 -0
  367. /package/{prompts → dist-assets/prompts}/00-bootstrap-project.md +0 -0
  368. /package/{prompts → dist-assets/prompts}/01-create-requirement.md +0 -0
  369. /package/{prompts → dist-assets/prompts}/02-create-spec.md +0 -0
  370. /package/{prompts → dist-assets/prompts}/03-create-tech-plan.md +0 -0
  371. /package/{prompts → dist-assets/prompts}/04-breakdown-prs.md +0 -0
  372. /package/{prompts → dist-assets/prompts}/05-implement-pr.md +0 -0
  373. /package/{prompts → dist-assets/prompts}/06-review-and-fix.md +0 -0
  374. /package/{prompts → dist-assets/prompts}/07-apply-design.md +0 -0
  375. /package/{prompts → dist-assets/prompts}/08-validate.md +0 -0
  376. /package/{prompts → dist-assets/prompts}/09-deploy.md +0 -0
  377. /package/{prompts → dist-assets/prompts}/commands/implement.md +0 -0
  378. /package/{prompts → dist-assets/prompts}/commands/requirement.md +0 -0
  379. /package/{prompts → dist-assets/prompts}/commands/spec.md +0 -0
  380. /package/{prompts → dist-assets/prompts}/commands/tech-plan.md +0 -0
  381. /package/{prompts → dist-assets/prompts}/commands/validate.md +0 -0
  382. /package/{runbooks → dist-assets/runbooks}/branch-cleanup.md +0 -0
  383. /package/{runbooks → dist-assets/runbooks}/deploy-checklist.md +0 -0
  384. /package/{runbooks → dist-assets/runbooks}/publication-readiness-checklist.md +0 -0
  385. /package/{runbooks → dist-assets/runbooks}/publish-package-checklist.md +0 -0
  386. /package/{runbooks → dist-assets/runbooks}/team-governance-pr-readiness.md +0 -0
  387. /package/{runbooks → dist-assets/runbooks}/validate-starter-in-real-project.md +0 -0
  388. /package/{runbooks → dist-assets/runbooks}/validation-checklist.md +0 -0
  389. /package/{schemas → dist-assets/schemas}/README.md +0 -0
  390. /package/{schemas → dist-assets/schemas}/functional-spec.schema.json +0 -0
  391. /package/{schemas → dist-assets/schemas}/handoff.schema.json +0 -0
  392. /package/{schemas → dist-assets/schemas}/pr-breakdown.schema.json +0 -0
  393. /package/{schemas → dist-assets/schemas}/requirement.schema.json +0 -0
  394. /package/{schemas → dist-assets/schemas}/technical-plan.schema.json +0 -0
  395. /package/{schemas → dist-assets/schemas}/validation-report.schema.json +0 -0
  396. /package/{packages/ai-workflow/src → src}/core/backup.js +0 -0
  397. /package/{packages/ai-workflow/src → src}/core/filesystem.js +0 -0
package/CHANGELOG.md CHANGED
@@ -1,878 +1,96 @@
1
- ## [1.19.1](https://github.com/williambeto/ai-workflow/compare/v1.19.0...v1.19.1) (2026-05-23)
2
-
3
-
4
- ### Bug Fixes
5
-
6
- * **init:** include Atlas agent asset ([#72](https://github.com/williambeto/ai-workflow/issues/72)) ([e12bb26](https://github.com/williambeto/ai-workflow/commit/e12bb26f585b98c58d5d5e5ce68cab0ab4bdff0a))
7
-
8
- ## [1.19.1](https://github.com/williambeto/ai-workflow/compare/v1.19.0...v1.19.1) (2026-05-23)
1
+ ## [2.0.5] - 2026-06-08
9
2
 
10
3
  ### Fixed
11
4
 
12
- - **Atlas consumer initialization**: include `opencode/agents/atlas.md` in generated full-profile assets.
13
- - **OpenCode startup**: prevent startup failure caused by `agent.atlas.prompt` referencing a missing Atlas prompt file after consumer init.
14
-
15
- # [1.19.0](https://github.com/williambeto/ai-workflow/compare/v1.18.18...v1.19.0) (2026-05-23)
16
-
17
-
18
- ### Features
19
-
20
- * add Atlas OpenCode agent ([#70](https://github.com/williambeto/ai-workflow/issues/70)) ([15ae8a2](https://github.com/williambeto/ai-workflow/commit/15ae8a2d0ae0d97cad450280522f5e2849c0149b))
21
-
22
- ## [1.18.18](https://github.com/williambeto/ai-workflow/compare/v1.18.17...v1.18.18) (2026-05-23)
23
-
24
-
25
- ### Bug Fixes
26
-
27
- * **init:** include napkin memory in npm install ([f4f2e31](https://github.com/williambeto/ai-workflow/commit/f4f2e313dfae85daa31c92d60d5402df48c83b62))
28
-
29
- ## [1.18.17](https://github.com/williambeto/ai-workflow/compare/v1.18.16...v1.18.17) (2026-05-23)
30
-
31
-
32
- ### Bug Fixes
33
-
34
- * **init:** ignore generated workflow footprint ([15eba7a](https://github.com/williambeto/ai-workflow/commit/15eba7a2ac3ad81af3f6e6984be900717a6e89ef))
35
- * **init:** use canonical opencode full config ([8b8551d](https://github.com/williambeto/ai-workflow/commit/8b8551d5af00b8924dbc8f2244b159f091fcb810))
36
-
37
- ## [1.18.16](https://github.com/williambeto/ai-workflow/compare/v1.18.15...v1.18.16) (2026-05-22)
38
-
39
-
40
- ### Bug Fixes
41
-
42
- * **audit:** harden artifact safety and align CLI/OpenCode catalog ([047c3bd](https://github.com/williambeto/ai-workflow/commit/047c3bd92d2d7fd3bc7bef2afc5f29a8fba441e9))
43
- * **audit:** harden artifact safety and align CLI/OpenCode catalog ([a13f489](https://github.com/williambeto/ai-workflow/commit/a13f489c1a5cc7a06ba67580b30dd30f670d9b62))
44
-
45
- ## [1.18.15](https://github.com/williambeto/ai-workflow/compare/v1.18.14...v1.18.15) (2026-05-22)
46
-
47
-
48
- ### Bug Fixes
49
-
50
- * **cli-catalog:** sync managed config with current repo skills ([595a4cc](https://github.com/williambeto/ai-workflow/commit/595a4cc71fe89a25664fc2b9c5ae2131b36c92dc))
51
- * **cli-catalog:** sync managed config with current repo skills ([7202320](https://github.com/williambeto/ai-workflow/commit/72023200ccd7d47a5a6e1106b781013fbf27215f))
52
-
53
- ## [1.18.14](https://github.com/williambeto/ai-workflow/compare/v1.18.13...v1.18.14) (2026-05-22)
54
-
55
-
56
- ### Bug Fixes
57
-
58
- * add missing spec-engineer agent to managed OpenCode config ([#58](https://github.com/williambeto/ai-workflow/issues/58)) ([bc0ffc9](https://github.com/williambeto/ai-workflow/commit/bc0ffc963d84956cc2880e6d6903061ea86016cc))
59
-
60
- ## [1.18.13](https://github.com/williambeto/ai-workflow/compare/v1.18.12...v1.18.13) (2026-05-22)
61
-
62
-
63
- ### Bug Fixes
64
-
65
- * remove --provenance flag for private repo publish ([#57](https://github.com/williambeto/ai-workflow/issues/57)) ([557a41e](https://github.com/williambeto/ai-workflow/commit/557a41ed5f56071d932f494ebac0ebd1740d98ec))
66
-
67
- ## [1.18.12](https://github.com/williambeto/ai-workflow/compare/v1.18.11...v1.18.12) (2026-05-22)
68
-
69
-
70
- ### Bug Fixes
71
-
72
- * skip auto-generated CHANGELOG.md from markdownlint and link validation ([#56](https://github.com/williambeto/ai-workflow/issues/56)) ([aefc44d](https://github.com/williambeto/ai-workflow/commit/aefc44d3b137b99e6089763952a8973de74f2ce6))
73
-
74
- ## [1.18.11](https://github.com/williambeto/ai-workflow/compare/v1.18.10...v1.18.11) (2026-05-22)
75
-
76
-
77
- ### Bug Fixes
78
-
79
- * apply readiness audit fixes (security, package, branding, docs) ([9721661](https://github.com/williambeto/ai-workflow/commit/972166100908681f27889e9ddd10de71f20a9627))
80
- * apply readiness audit fixes (security, package, branding, docs) ([ee60c7c](https://github.com/williambeto/ai-workflow/commit/ee60c7cabab77dc45684d8e1b91533566660e794))
81
- * update semantic-release CI to Node.js 22 ([8bbaabb](https://github.com/williambeto/ai-workflow/commit/8bbaabbefa3ffe1a27b19264bc8c98779ba4bddd))
82
- * update semantic-release CI to Node.js 22 ([89a198a](https://github.com/williambeto/ai-workflow/commit/89a198aadd21f10c8b3d65e21a58747e50c23703))
83
-
84
- # Changelog
85
-
86
- All notable changes to AI Workflow Kit (`ai-workflow`) are documented in this file.
87
-
88
- The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
89
- and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
90
-
91
- ## [1.18.9] - 2026-05-21
92
-
93
- ### Removed
94
-
95
- - **Consumer `workflow:validate` and `workflow:doctor` scripts**: removed thin wrapper aliases from consumer `package.json`. These provided marginal value over direct commands (`npm run validate`, `npx ai-workflow doctor`). Removed `merge-package-json.js`, updated `init.js`, `doctor.js`, `templates.js`, and all documentation references.
96
-
97
- ## [1.18.8] - 2026-05-20
98
-
99
- ### Added
100
-
101
- - **Discovery gate enforcement**: `opencode/agents/discovery.md` now explicitly blocks execution/delegation requests and routes them to `orchestrator`.
102
- - **Discovery routing guard docs**: added explicit guard behavior to `opencode/agents/README.md` and `runbooks/agent-delegation-workflow.md` to keep gate behavior consistent across agent docs and runbooks.
103
- - **Roadmap simplification phases**: added Phase 17/18/19 plan in `ROADMAP.md` for OpenCode-first focus, artifact surface reduction, and consumer-validation/Napkin hardening.
104
-
105
- ### Changed
106
-
107
- - **Roadmap priority update**: `ROADMAP.md` next sprint, next step, and next recommended PR now point to Phase 17 platform focus as immediate priority.
5
+ - Locked standard/full Atlas completion behind current-task Sage, Evidence Collector, and QualityGuard execution.
6
+ - Rejected direct Atlas `PASS`, user-deferred `/validate`, self-validation, and missing executable finalizer paths.
7
+ - Added canonical cross-field validation for branch evidence, owners, artifacts, truthfulness, collector/final status, and Phoenix/Sage consistency.
8
+ - Strengthened fictitious-product claim detection for unsupported market superlatives, pricing, SLA/support, API, batch, and export capabilities.
9
+ - Added regression tests for runtime completion lock and internally inconsistent canonical results.
108
10
 
109
- ## [1.18.6] - 2026-05-20
11
+ ## [2.0.3] - 2026-06-08
110
12
 
111
13
  ### Added
112
14
 
113
- - **Publish hardening via `.npmignore`**: added a defense-in-depth ignore file to prevent accidental inclusion of non-essential repository assets during publish operations.
114
-
115
- ## [1.18.5] - 2026-05-20
116
-
117
- ### Added
118
-
119
- - **Symlink layout manager**: added `packages/ai-workflow/src/core/symlink-layout.js` to define and validate managed root/file links from project root to `.ai-workflow/`.
15
+ - Lightweight workflow profiles separating execution mode from domain quality guidance.
16
+ - Deterministic profile routing for frontend product, frontend utility, backend API, refactor, documentation, and security review work.
17
+ - Objective owner-completion contract with one bounded resume before `BLOCKED`.
18
+ - Consumer workflow profile documentation.
120
19
 
121
20
  ### Changed
122
21
 
123
- - **Standalone install target**: `init` now installs workflow assets under `.ai-workflow/` as the source of truth, while exposing root-level links for Codex/OpenCode compatibility.
124
- - **Init flow and config contract**: `init` now records `managedLinks` in `.ai-workflow.json` and reports link creation in install summary.
125
- - **Doctor coverage**: `doctor` now validates `.ai-workflow/` presence and managed link health in standalone mode.
126
- - **Documentation and discoverability**: updated quickstart/setup/command indexes to reflect `.ai-workflow/` + symlink default model.
127
-
128
- ### Removed
22
+ - Visual validation now uses objective rendered checks instead of subjective labels or benchmark comparison.
23
+ - Frontend product and utility profiles load both frontend and UI/UX skills without imposing a fixed SaaS page template.
24
+ - Product Truthfulness accepts clear page-level conceptual labels for non-authoritative commercial concepts while keeping official/live/security/SLA claims strict.
25
+ - Atlas handoff guidance is shorter and outcome-first.
129
26
 
130
- - **Legacy submodule sync flow**: removed `update-submodule` prompt/command/runbook flow and `scripts/validate-submodule.mjs` validation path.
27
+ # Changelog
131
28
 
132
- ## [1.18.4] - 2026-05-20
29
+ ## [2.0.4] - 2026-06-08
133
30
 
134
31
  ### Fixed
135
32
 
136
- - **CLI init process not exiting**: fixed `guide` command readline lifecycle so importing CLI commands no longer keeps stdin open after `init` execution in consumer projects.
137
-
138
- ### Changed
139
-
140
- - **Release continuity**: package version bumped to `1.18.4`.
141
-
142
- ## [1.18.3] - 2026-05-20
143
-
144
- ### Changed
145
-
146
- - **Publish retry with unique version**: bumped package version to `1.18.3` after `1.18.2` was already published.
147
-
148
- ## [1.18.2] - 2026-05-20
149
-
150
- ### Added
151
-
152
- - **Spec-Driven Development workflow assets**:
153
- - `checklists/spec-readiness-checklist.md`
154
- - `.codex/prompts/specs/` (create/review/spec-to-plan/spec-to-pr)
155
- - `opencode/commands/specs/` (create/review/spec-to-plan/spec-to-pr)
156
- - `runbooks/spec-driven-development.md`
157
-
158
- ### Changed
159
-
160
- - **Spec template expanded for planning/validation evidence**: `templates/SPEC.template.md` now includes explicit sections for objective/context/problem, functional and non-functional requirements, technical constraints, implementation plan, PR breakdown, validation plan, and expected evidence.
161
- - **Workflow discovery docs updated**: `README.md`, `docs/full-documentation.md`, `.codex/prompts/README.md`, `opencode/commands/README.md`, `runbooks/commands-cheatsheet.md`, `prompts/02-create-spec.md`, `ROADMAP.md`.
162
- - **Release continuity**: package version bumped to `1.18.2`.
163
-
164
- ## [1.18.1] - 2026-05-20
165
-
166
- ### Added
167
-
168
- - **Public-readiness evaluation report**: added `docs/reports/project-evaluation.md` with evidence-backed verdict, adoption blockers, and minimal PR roadmap.
169
- - **Public-readiness improvement backlog**: added `docs/reports/public-readiness-backlog.md` with prioritized incremental execution plan.
170
-
171
- ### Changed
172
-
173
- - **Validation E2E refs assertions**: updated `tests/validate-e2e.mjs` to align with current `validate-refs` output markers.
174
- - **Version alignment**: local package version aligned and bumped to `1.18.1` for publish/release continuity.
175
-
176
- ## [1.15.0] - 2026-05-20
177
-
178
- ### Added
179
-
180
- - **npm consumer quickstart guide**: created `docs/npm-consumer-quickstart.md` with install, inspect, init, Codex quickstart, OpenCode quickstart, validation checklist, troubleshooting, and next steps.
181
- - **README Quickstart npm entry point**: the Quickstart section now opens with the `npm install` path and links to the detailed guide.
182
-
183
- ### Changed
184
-
185
- - **ROADMAP.md**: status line updated, delivered entry recorded, public-readiness audit item about npm install path marked fixed.
186
- - **Dependencies**: `@semantic-release/github` 10.3.5→12.0.8, `@semantic-release/npm` 12.0.2→13.1.5, `semantic-release` 24.2.9→25.0.3.
33
+ - Removed circular finalization evidence by deriving canonical results from executed policy checks and persisting them in `EVIDENCE.json`.
34
+ - Enforced all canonical standard/full final response fields from one machine-readable contract.
35
+ - Persisted and rendered delegation owners, loaded skills, delivery artifacts, Sage revalidation, Evidence Collector, QualityGuard, Product Truthfulness, finalizer, and terminal status.
36
+ - Required structured TypeScript waivers with an explicit source and concrete constraint.
37
+ - Added regression coverage for omitted fields, direct finalizer bypass, remediation without Sage revalidation, and canonical status spelling.
187
38
 
188
- ## [1.14.0] - 2026-05-20
189
-
190
- ### Added
191
-
192
- - **`init` copies real skill/agent/workflow assets**: `init --profile=full` no longer generates 3-line stub files for each skill. Instead, it reads the actual content from the installed package (62–528 lines per skill) plus subdirectories like `interface-design/references/*.md`. Also copies OpenCode agent prompts, command files, additional Codex prompts, harness workflow contracts, policy docs (`docs/architecture-policy.md`, `docs/design-patterns-policy.md`), project templates, and JSON schemas. Total files created: 86 (up from ~35).
193
- - **Dependabot automation**: added `.github/dependabot.yml` for weekly npm dependency update PRs.
194
- - **Semantic-release automation**: added `.github/workflows/semantic-release.yml` and `.releaserc.json` for automated versioning/release flow on `main`.
195
- - **Local developer bootstrap**: added `npm run setup:dev` powered by `scripts/setup-dev.mjs` (`npm ci` + validation + CLI smoke checks).
196
- - **Feedback metrics**: added `npm run metrics:feedback` and `scripts/collect-feedback-metrics.mjs` with output to `evidence/feedback-metrics.json`.
197
- - **Feedback intake template**: added `.github/ISSUE_TEMPLATE/feedback.yml`.
198
-
199
- ### Changed
200
39
 
201
- - **`templates.js`**: `buildFullFiles()` now reads real files from disk via the new `package-assets.js` utility instead of generating inline stubs for skills, agents, and commands.
202
- - **`package-assets.js`**: Added utility to resolve the installed package root and recursively discover files from `.agents/skills/`, `opencode/agents/`, `opencode/commands/`, `.codex/prompts/`, `harness/`, `docs/`, `templates/`, and `schemas/`.
203
- - **npm publish workflow**: fixed `.github/workflows/publish-npm.yml` to publish from repository root package (removed incorrect `working-directory: packages/ai-workflow`).
204
- - **Agent routing registry**: added `seo-audit` as subagent in `opencode.jsonc` to align with available skills and routing matrix.
40
+ ## 2.0.2
205
41
 
206
42
  ### Fixed
207
43
 
208
- - **Placeholder stub skills on `init`**: All 20 skills were previously generated as 3-line stubs, making them non-functional as subagent prompts. Now each skill file contains the real content (frontmatter, sections, validation rules, constraints).
209
- - **Missing reference files**: `interface-design/references/*.md` (4 files) were not included in the generated project.
210
- - **Missing harness workflows**: `harness/workflows/*.md` and `harness/handoffs/HANDOFF.template.md` (referenced by orchestrator agent) were not copied.
211
- - **Missing policy docs**: `docs/architecture-policy.md` and `docs/design-patterns-policy.md` were not included.
212
- - **Missing `.codex/prompts/` extra files**: 7 additional prompt files (autopilot, deploy, fix-issue, roadmap-audit, etc.) were missing.
44
+ - Enforced mode-specific final delivery artifacts so `standard` cannot pass with `delivery-summary.md`.
45
+ - Added mandatory finalization evidence for collector, QualityGuard, Product Truthfulness, delegation, and finalizer identity.
46
+ - Prevented `PASS` when canonical finalization fields are missing or inconsistent.
47
+ - Added direct tests for standard artifact mismatch and finalization evidence.
48
+ - Kept bounded remediation responsible for correcting final-gate failures before promotion.
213
49
 
214
- ## [1.12.6] - 2026-05-19
50
+ ## 2.0.1
215
51
 
216
52
  ### Fixed
217
53
 
218
- - **CLI executable resolution**: `npx @williambeto/ai-workflow init` now works. Root `package.json` was missing `bin/ai-workflow` entry pointing to `packages/ai-workflow/bin/ai-workflow.js`.
219
- - **npm publish over 1.12.5**: bumped to `1.12.6` to republish with correct package structure.
220
-
221
- ### Added
222
-
223
- - **CLI bin entry**: root `package.json` now registers `"bin": { "ai-workflow": "packages/ai-workflow/bin/ai-workflow.js" }` so npm can resolve the executable on install.
224
-
225
- ## [1.12.5] - 2026-05-19
226
-
227
- ### Added
228
-
229
- - **Codex compatibility audit**: full audit report in `evidence/codex-compatibility-audit-2026-05-19.md` covering 20 skills, 10 OpenCode agents, 13 Codex prompts, 5 workflows.
230
- - **Phase 15 documentation**: added to ROADMAP.md with 3 incremental fixes applied.
231
-
232
- ### Changed
233
-
234
- - **Dedup orchestrator routing matrix**: `opencode/agents/orchestrator.md` no longer duplicates the delegation table from `AGENTS.md`; references `AGENTS.md` §453 instead.
235
- - **Delegation matrix completeness**: `AGENTS.md` §464 now includes `Bug fixing / diagnostics | fixer` with Codex path `.codex/prompts/fix-issue.md`, closing the documented gap.
236
- - **Codex/OpenCode comparison table**: `docs/setup-codex-opencode.md` now explicitly states OpenCode agent files are not Codex subagents.
237
-
238
- ## [1.12.4] - 2026-05-16
239
-
240
- ### Added
241
-
242
- - **Guarded npm publish workflow**: added `.github/workflows/publish-npm.yml` with manual trigger, dry-run default, required validation, and token-gated real publish.
243
- - **Publish runbook**: added `runbooks/publish-package-checklist.md` with pre-publish gates, evidence requirements, and rollback/deprecate guidance.
244
- - **Publish rehearsal evidence**: added `evidence/publish-dry-run-2026-05-15.md` documenting the successful dry-run workflow run.
245
-
246
- ### Changed
247
-
248
- - **Validation default flow**: `npm run validate` now includes external link validation.
249
- - **Autopilot/ship context discipline**: Codex/OpenCode entrypoints now use minimum-first context loading to reduce token-heavy scans.
250
- - **Documentation consistency**: examples maturity rows and quickstart validation counts aligned with current repository checks.
251
- - **GitHub Actions runtime compatibility**: workflows now force JavaScript actions to Node 24 runtime to preempt Node 20 runner deprecation.
252
-
253
- ## [1.12.1] - 2026-05-14
254
-
255
- ### Added
256
-
257
- - **Implementation output effort line**: added `Effort: AI elapsed ~Xm | Senior dev estimate ~Ym` to implementation-oriented output templates across Codex prompts, OpenCode commands/agents, and implementation skills.
258
-
259
- ### Changed
260
-
261
- - **README.md**: repositioned as AI Workflow Kit landing page with compact structure and OpenCode/Codex setup guidance links.
262
- - **docs/full-documentation.md**: added detailed workflow reference document.
263
- - **docs/setup-codex-opencode.md**: added dedicated setup and usage guide for OpenCode and Codex.
264
- - **Roadmap**: marked Phase 13 (AI Workflow Kit documentation repositioning) complete and advanced next recommended PR to Phase 14 guarded publish workflow.
265
-
266
- ## [1.11.0] - 2026-05-13
267
-
268
- ### Changed
269
-
270
- - **AGENTS.md**: Synced with opencode.jsonc. Phase 7 complete.
271
-
272
- ## [1.10.5] - 2026-05-13
273
-
274
- ### Added
275
-
276
- - **Delegation matrix**: Add interface-design, playwright-cli, stack-variant-creator. Phase 7 PR 7.
277
-
278
- ## [1.10.4] - 2026-05-13
279
-
280
- ### Removed
281
-
282
- - **skill-creator subagent**: Scope absorbed by prompt-engineer. Phase 7 PR 6.
283
-
284
- ## [1.10.3] - 2026-05-13
285
-
286
- ### Removed
287
-
288
- - **estimator agent**: Never routed, no command, no documented use. Phase 7 PR 5.
289
- - **frontend-architect agent**: Scope covered by frontend-implementer + tech-lead. Phase 7 PR 5.
54
+ - Added bounded, progress-aware remediation for recoverable quality and delegation gates.
55
+ - Prevented unresolved gate failures from being downgraded to `PASS_WITH_NOTES`.
56
+ - Added hard remediation limits by execution mode and blocking on repeated/no-progress findings.
57
+ - Synchronized the root evidence contract with the canonical distributed contract.
58
+ - Added direct coverage for implementation documentation and remediation lifecycle behavior.
290
59
 
291
- ## [1.10.2] - 2026-05-13
292
-
293
- ### Removed
294
-
295
- - **codex-token-economy skill**: Merged into token-economy. Phase 7 PR 4.
296
-
297
- ## [1.10.1] - 2026-05-13
298
-
299
- ### Removed
300
-
301
- - **git-pr-release-flow subagent**: Deleted; scope covered by release-manager. Phase 7 PR 3.
302
-
303
- ## [1.10.0] - 2026-05-13
304
-
305
- ### Removed
306
-
307
- - **autopilot agent**: Merged into orchestrator. `/start` and `/ship` now route to orchestrator. Phase 7 PR 2.
308
-
309
- ## [1.9.10] - 2026-05-13
310
-
311
- ### Removed
312
-
313
- - **Codex subagents/**: Deleted 5 files. Project is primary OpenCode; AGENTS.md covers Codex routing. Phase 7 PR 1.
314
-
315
- ## [1.9.9] - 2026-05-13
316
-
317
- ### Changed
318
-
319
- - **ROADMAP.md**: Add Phase 7 agent & skill simplification plan with 8-PR reduction from audit findings
320
-
321
- ## [1.9.8] - 2026-05-13
60
+ ## 2.0.0
322
61
 
323
62
  ### Added
324
63
 
325
- - **Token economy coverage**: Add `token-economy` + `minimal-context` directive to all 22 skills and 3 primary agents (discovery, wordpress-engineer, prompt-engineer)
326
-
327
- ## [1.9.7] - 2026-05-13
328
-
329
- ### Fixed
330
-
331
- - **ROADMAP.md**: Update skill count (19→22), runbook count (6→13), example count (3→4) with react-dashboard
332
- - **README.md**: Add missing skills (`minimal-context`, `stack-variant-creator`, `token-economy`) to specialist skills table
333
- - **package.json**: Replace stale `your-org` placeholder URLs with actual owner
334
-
335
- ## [1.8.2] - 2026-05-13
64
+ - OpenCode-first workflow with six primary ownership roles.
65
+ - Proportional `quick`, `standard`, and `full` delivery modes.
66
+ - Persisted delivery artifacts and executable evidence collection.
67
+ - Branch recovery, quality gates, delegation statuses, Product Truthfulness, and safe packaging.
68
+ - TypeScript default for new frontend applications unless explicitly waived.
69
+ - Consumer quickstart, runtime compatibility guidance, and v2 upgrade documentation.
70
+ - Optional Codex, Claude Code, and Gemini adapter assets.
336
71
 
337
72
  ### Changed
338
73
 
339
- - **init.mjs**: Simplify to only merge opencode.jsonc no file copying, assets stay in submodule
340
- - **runbooks/sync-workflow-from-submodule.md**: Updated install/uninstall steps
74
+ - Public version identity is now aligned with the npm upgrade path from `1.x` to `2.0.0`.
75
+ - Active documentation describes only the current 2.0 product and supported migration path.
76
+ - Repository-maintenance paths are separated from consumer-facing paths.
77
+ - The initial `2.0.0` rollout uses the npm `next` dist-tag without moving `latest`.
341
78
 
342
79
  ### Removed
343
80
 
344
- - **sync.mjs**: No longer needed
345
- - **uninstall-workflow.mjs**: Manual cleanup sufficient
346
- - **submodule-sync-allowlist.json**: No longer needed
347
-
348
- ## [1.7.5] - 2026-05-13
349
-
350
- ### Changed
351
-
352
- - **init.mjs** (renamed from bootstrap-parent-workflow.mjs): bootstrap workflow assets, merge opencode.jsonc into parent root
353
- - **sync.mjs** (renamed from refresh-submodule.mjs): sync workflow subtree, merge opencode.jsonc (backups existing)
354
-
355
- ### Added
356
-
357
- - **opencode.jsonc merge**: init.mjs and sync.mjs now merge opencode.jsonc from `.workflow/` into parent root with backup of existing config
358
-
359
- ### Fixed
360
-
361
- - **validate-refs.mjs**: exclude example paths from validation (`prompts/codex/`, `prompts/codex-repo-starter/`, `.workflow-sync-backups/<timestamp>/`)
362
-
363
- ## [1.7.4] - 2026-05-13
364
-
365
- ### Added
366
-
367
- - **Token-economy auto-load in all agents**: 8 agents (planner, implementer, validator, reviewer, orchestrator, release-manager, fixer, autopilot) now have token-economy + minimal-context in `Required context` — caveman mode persists across delegation chains.
368
- - **Napkin entry**: Token economy does not auto-pass to subagents — delegation packets must explicitly request compact output.
369
- - **Minimal-context troubleshooting**: Added section explaining session history as primary input token driver, with quick diagnostic and solutions (start new session, explicit handoff, compact output).
370
-
371
- ## [1.7.2] - 2026-05-13
372
-
373
- ### Added
374
-
375
- - **`.workflow/` as source of truth for submodule installs**: `runbooks/sync-workflow-from-submodule.md` — install, sync, rollback for projects using codex-repo-starter as git submodule into `.workflow/`.
376
- - **Migration script**: `scripts/migrate-to-workflow.mjs` — migrate legacy `.codex/` + `.agents/` paths to `.workflow/` pointing in `opencode.json`. Supports `--dry-run` and `--force`. Backs up to `.workflow-migration-backups/`.
377
-
378
- ### Changed
379
-
380
- - **update-submodule command** updated: references `.workflow/` path and `runbooks/sync-workflow-from-submodule.md`.
381
- - **bootstrap-parent-workflow.mjs** already supports `.workflow/` as target (detected by script).
382
-
383
- ## [1.7.1] - 2026-05-13
384
-
385
- ### Added
386
-
387
- - **Minimal Context Mode skill**: `.agents/skills/minimal-context/SKILL.md` — input discipline rules (3–7 files per read, grep before read, no broad scans unless audit).
388
- - **Minimal Context Codex prompt**: `.codex/prompts/minimal-context-mode.md` — reusable prompt with input budget rules.
389
- - **Handoff validation script**: `scripts/validate-handoffs.mjs` — structural skill-to-skill handoff readiness validation.
390
- - **Skill auto-load baseline** in `AGENTS.md` — agent-to-skill mapping (planner, implementer, reviewer, validator, release-manager) discoverable from central rules.
391
-
392
- ### Changed
393
-
394
- - **Token economy skill** updated: added input vs output distinction (`minimal-context` reduces input, `token-economy` reduces output).
395
- - **implementer** and **planner** agents updated: added input discipline sections.
396
- - **execute** command updated: references minimal-context skill.
397
- - **README.md** updated: input vs output token distinction, minimal-context usage.
398
-
399
- ### Fixed
400
-
401
- - **ROADMAP.md**: all planned PRs marked complete; Phase 4B, 4A, and 6 PRs added to completed table.
402
-
403
- ## [1.7.0] - 2026-05-13
404
-
405
- ### Added
406
-
407
- - **Token economy mode**: project-native compact output skill (`.agents/skills/token-economy/SKILL.md`) with modes `compact`, `terse`, `audit`, `handoff` and output contracts for implementation, audit, bugfix, handoff.
408
- - **Token economy Codex prompt**: `.codex/prompts/token-economy-mode.md`.
409
- - **Token economy OpenCode command**: `opencode/commands/token-economy.md`.
410
- - **Token economy mode documentation** in `README.md` (compact output usage, modes, notes on verbosity reduction, optional external caveman tooling).
411
-
412
- ### Changed
413
-
414
- - **Next recommended PR** in `ROADMAP.md` advanced to Phase 4B (agent routing refinement) after Phase 4A command work completed via PR #57.
415
- - **PR queue** reprioritized: routing drift → handoff validation → Phase 6 docs.
416
-
417
- ### Validation
418
-
419
- - `npm run validate` — all 9 checks passed, 0 skill warnings.
420
-
421
- ## [1.6.9] - 2026-05-13
422
-
423
- ### Changed
81
+ - Obsolete pre-2.0 runtime guidance, taxonomies, aliases, package paths, and intermediate release-candidate documentation.
424
82
 
425
- - **Phase 5 (stack variants)**: marked as Complete in AGENTS.md and ROADMAP.md.
426
- - **ROADMAP.md**: Phase 5 status updated to Complete, exit criteria all checked, completed items listed for all 5 variants, PR queue updated with remaining Phase 4A/4B/6 items, next recommended PR set to Phase 4A command refinement.
427
- - **AGENTS.md**: maturity table updated — stack variants now "Complete (5 variants: nuxt, wordpress, docs-only, nodejs-api, python-api)".
83
+ ## Previous public releases
428
84
 
429
- ### Validation
430
-
431
- - `npm run validate` — all 9 checks passed.
432
-
433
- ## [1.6.8] - 2026-05-13
434
-
435
- ### Added
436
-
437
- - **Skill section consistency**: added missing `## Stop conditions` to 16 skills, `## Core responsibilities` + `## Constraints` + `## Expected output` to 7 skills, and `## Expected output` + `## Stop conditions` to tech-lead.
438
-
439
- ### Changed
440
-
441
- - **interface-design skill**: improved description to avoid weak phrase; removed literal "placeholder" text.
442
- - **wordpress-engineer skill**: changed H1 heading to "WordPress Engineer" to match skill name.
443
-
444
- ### Validation
445
-
446
- - `npm run validate` — all 9 checks passed, 0 skill warnings (was 42).
447
-
448
- ## [1.6.7] - 2026-05-12
449
-
450
- ### Added
85
+ The previous npm line ends at `1.19.1`. Detailed historical changes remain available in Git history and GitHub Releases.
451
86
 
452
- - **Commands cheat sheet**: added `runbooks/commands-cheatsheet.md` as a quick reference for Codex (`.codex/prompts/`) and OpenCode (`opencode/commands/`) commands, with usage examples and safety rules.
87
+ ## 2.1.0
453
88
 
454
89
  ### Changed
455
90
 
456
- - **AGENTS.md file tree**: synced to reflect current repository structure (skill-creator, stack-variant-creator, new scripts, variants, tests).
457
- - **README.md runbooks table**: added `commands-cheatsheet.md` entry.
458
- - **Repository maturity**: marked stack-specific variants as "In progress".
459
-
460
- ### Validation
461
-
462
- - Ran `npm run validate` — all 9 checks passed.
463
-
464
- ## [1.6.6] - 2026-05-11
465
-
466
- ### Added
467
-
468
- - **Submodule update commands**: added `.codex/prompts/update-submodule.md` and `opencode/commands/update-submodule.md` to safely update `codex-repo-starter` when installed as a submodule in another repository.
469
-
470
- ### Changed
471
-
472
- - **OpenCode command registry**: registered `update-submodule` in `opencode.jsonc` using `release-manager` as the command owner.
473
- - **Discoverability and structure checks**: updated command READMEs and `scripts/validate-structure.mjs` to require and document the new submodule-update command files.
474
-
475
- ### Validation
476
-
477
- - Ran `npm run validate`
478
-
479
- ## [1.6.5] - 2026-05-11
480
-
481
- ### Added
482
-
483
- - **Delegation workflow runbook**: added `runbooks/agent-delegation-workflow.md` to document orchestration rules, delegation matrix, escalation paths, and anti-overdelegation behavior.
484
- - **Delegation validation script**: added `scripts/validate-delegation.mjs` and `npm run validate:delegation` to enforce orchestrator presence, command-to-agent mapping integrity, and Codex/OpenCode routing guidance checks.
485
-
486
- ### Changed
487
-
488
- - **Governance and routing contracts**: updated `AGENTS.md`, `opencode/agents/orchestrator.md`, and OpenCode/Codex command prompts to make delegation contracts explicit (task type classification, handoff fields, specialist output expectations).
489
- - **Validation suite**: wired delegation checks into `scripts/validate-all.mjs` so `npm run validate` continuously verifies delegation integrity.
490
-
491
- ### Validation
492
-
493
- - Ran `npm run validate:delegation`
494
- - Ran `npm run validate`
495
-
496
- ## [1.6.4] - 2026-05-11
497
-
498
- ### Added
499
-
500
- - **Napkin project memory**: added `.agents/napkin.md` and `runbooks/use-napkin-project-memory.md` to provide durable, repository-specific memory with progressive disclosure guidance.
501
-
502
- ### Changed
503
-
504
- - **Agent guidance**: updated `AGENTS.md`, `opencode/README.md`, `opencode/agents/README.md`, and `opencode/commands/README.md` to require contextual Napkin checks at task start without force-loading full memory.
505
- - **Structure validation hardening**: `scripts/validate-structure.mjs` now fails when `.agents/napkin.md` or `.agents/skills/napkin/SKILL.md` is missing and dynamically requires `SKILL.md` in every `.agents/skills/*` directory.
506
-
507
- ### Validation
508
-
509
- - Ran `npm run validate`
510
-
511
- ## [1.6.3] - 2026-05-09
512
-
513
- ### Changed
514
-
515
- - **Interface-design skill sync**: replaced `.agents/skills/interface-design/SKILL.md` with the upstream content from `Dammyjay93/interface-design` while preserving local validator compatibility sections.
516
- - **Reference materials added**: added `.agents/skills/interface-design/references/{principles,critique,example,validation}.md` to provide deeper craft guidance and post-build critique workflows.
517
-
518
- ### Validation
519
-
520
- - Ran `npm run validate:md`
521
- - Ran `npm run validate:skills`
522
- - Ran `npm run validate`
523
-
524
- ## [1.6.2] - 2026-05-09
525
-
526
- ### Changed
527
-
528
- - **English-only root documentation**: translated remaining Portuguese sections in `README.md`, `runbooks/quick-start-guide.md`, and submodule install prompts to keep the repository default language consistent.
529
- - **Skill example language consistency**: translated the example snippet in `.agents/skills/stack-variant-creator/SKILL.md` to English.
530
-
531
- ## [1.6.1] - 2026-05-09
532
-
533
- ### Added
534
-
535
- - **Quick-start guide**: `runbooks/quick-start-guide.md` with zero-to-first-PR in 10 minutes.
536
-
537
- ## [1.6.0] - 2026-05-09
538
-
539
- ### Added
540
-
541
- - **Cross-reference depth validation**: `scripts/validate-refs.mjs` enhanced with reference graph builder, circular reference detection (self-references filtered), depth computation, configurable depth limits (max 5 levels), and deep directory nesting checks (>6 levels).
542
- - **Automated release workflow**: `.github/workflows/release.yml` creates a GitHub Release with notes from CHANGELOG.md when a `v*` tag is pushed, after running the full validation suite. Uses `body_path` for safe multiline release notes.
543
- - **End-to-end validation tests**: `tests/validate-e2e.mjs` runs 14 tests covering all 8 validation scripts plus markdown lint, depth validation, placeholder exclusions, anchor validation, and release workflow structure. Added `npm run test:e2e` script.
544
- - **Structure validation**: `tests/` registered as an optional directory in `scripts/validate-structure.mjs`.
545
- - **Tutorial walkthroughs**: `runbooks/tutorial-walkthroughs.md` with 10 structured modules covering the full workflow from zero to first PR through deployment and stack customization, usable as self-guided tutorials or video scripts.
546
-
547
- ## [1.5.0] - 2026-05-09
548
-
549
- ### Added
550
-
551
- - **Python API variant**: New variant (`variants/python-api/`) for FastAPI/Flask/Django backend projects with layered architecture, Pydantic validation, type hints, security, and framework-specific rules
552
-
553
- ### Fixed
554
-
555
- - `validate-refs.mjs`: Added `tests/` to placeholder path prefixes to fix false positive for test directory references
556
-
557
- ## [1.3.0] - 2026-05-09
558
-
559
- ### Added
560
-
561
- - **Public readiness**:
562
- - `CONTRIBUTING.md` — New contribution guidelines, PR process, validation instructions
563
- - License badge and npm version badge added to README
564
- - Copyright year updated to 2026 in LICENSE
565
-
566
- ### Changed
567
-
568
- - **Phase 2, 3, 3A, 5, 6 completion**: All major phases marked as Complete in ROADMAP.md
569
-
570
- ## [1.2.9] - 2026-05-09
571
-
572
- ### Added
573
-
574
- - **Phase 6 - Advanced agent workflows**:
575
- - `harness/workflows/planner-executor-workflow.md` — Planner/executor role separation, gate model, failure modes, workflow sequence, integration with OpenCode agents
576
- - `harness/workflows/agent-evaluation-checklist.md` — Criteria for evaluating agent outputs: Useful, Safe, Scoped, Validated; severity model; final recommendations
577
- - **Phase 2 - Consistency checks completed**:
578
- - Verified no conflicting duplicate rules across 341+ "Do not" rules
579
- - Standardized recommendation labels (Approved/Approved with notes/Changes requested/Blocked) across 30+ files
580
- - Standardized severity language (High/Medium/Low) across 51+ files
581
- - Standardized evidence rules wording across 11+ files
582
- - Decision: No central `PROJECT_RULES.md` needed; AGENTS.md serves as central rules file
583
-
584
- ### Changed
585
-
586
- - **ROADMAP.md**: Marked Phases 2, 3, 3A, 5, and 6 as Complete; added delivered items documentation
587
-
588
- ## [1.2.8] - 2026-05-09
589
-
590
- ### Added
591
-
592
- - **Internal anchor validation**: `scripts/validate-refs.mjs` now validates anchor references (e.g. `#section` and `file.md#section` patterns) against parsed ATX and setext headings using GitHub-style ID generation. Detects broken anchors alongside existing file-path validation.
593
-
594
- ### Changed
595
-
596
- - **validate-refs.mjs heading detection**: Added `headingToId()`, `extractHeadings()`, `resolveAnchorTargetFile()` functions; builds a heading index from all `.md` files before cross-reference checking.
597
-
598
- ## [1.2.7] - 2026-05-09
599
-
600
- ### Added
601
-
602
- - **Offline-safe link validation**: Network errors (DNS, timeout, unreachable) in `scripts/validate-links.mjs` now print warnings and exit 0; only HTTP error responses (400+) cause failures. `npm run validate:links` is now usable offline.
603
- - **Optional evidence directory**: `scripts/validate-structure.mjs` now accepts `evidence/` as an optional directory — warns if absent, does not fail — enabling future pilots to produce evidence organically.
604
-
605
- ### Changed
606
-
607
- - **Workflow-state filename alignment**: `.workflow-state.json` phase filenames and `scripts/validate-workflow.mjs` `VALID_PHASES` map corrected to match actual prompt file names (e.g., `00-bootstrap.md` → `00-bootstrap-project.md`).
608
- - **Skill table sync**: Both `README.md` and `AGENTS.md` specialist skill listings expanded to 19 entries, matching all actual skill directories in `.agents/skills/`.
609
- - **markdownlint-cli 0.44 → 0.48**: Updated dependency; disabled MD060 rule (GFM-style tables do not require pipe alignment).
610
-
611
- ## [1.2.6] - 2026-05-09
612
-
613
- ### Added
614
-
615
- - **Full skill-directory validation**: Added `scripts/validate-skills.mjs` wired into `npm run validate` to ensure every `.agents/skills/*/SKILL.md` passes structural checks.
616
- - **Missing skill file**: Added `.agents/skills/playwright-cli/SKILL.md` to satisfy per-skill validation contract.
617
-
618
- ### Changed
619
-
620
- - **Deterministic default validation**: Made default `npm run validate` deterministic and offline-safe by keeping external HTTP link checks explicit in `npm run validate:links` only.
621
- - **OpenCode implementation naming**: Normalized naming around `implementer`, documenting `subagents/executor.md` as a lightweight local equivalent.
622
-
623
- ### Removed
624
-
625
- - **Fragile consistency checks**: Removed count-coupled checks in docs-consistency validation that drifted as the repository grew.
626
-
627
- ## [1.2.5] - 2026-05-08
628
-
629
- ### Added
630
-
631
- - **Handoff instance schema validation**: Added validation path for handoff instance files against the handoff schema in CI.
632
-
633
- ### Fixed
634
-
635
- - **WordPress skill naming alignment**: Aligned WordPress skill naming convention with agent routing across all references.
636
-
637
- ### Changed
638
-
639
- - **Adoption runbook Quick Start**: Added Quick Start section to `runbooks/apply-starter-to-real-project.md` for faster onboarding.
640
-
641
- ## [1.2.4] - 2026-05-08
642
-
643
- ### Added
644
-
645
- - **One-command parent bootstrap**: Added `submodule:bootstrap` in `package.json` to prepare parent repositories after installing this starter as `.workflow`.
646
- - **Bootstrap automation script**: Added `scripts/bootstrap-parent-workflow.mjs` to run full workflow sync, align parent `opencode.json` from `.workflow/opencode.jsonc`, and enforce backup ignore defaults.
647
-
648
- ### Changed
649
-
650
- - **Adoption runbook guidance**: Updated `runbooks/apply-starter-to-real-project.md` with fast bootstrap instructions for submodule mode.
651
- - **Submodule installation prompts**: Updated `prompts/commands/install-codex-repo-starter-submodule.md` and `.short.md` to include optional full bootstrap execution.
652
- - **README adoption quickstart**: Documented bootstrap usage in `README.md` for faster first-run setup in target projects.
653
-
654
- ## [1.2.3] - 2026-05-08
655
-
656
- ### Added
657
-
658
- - **Submodule refresh automation command**: Added `submodule:refresh`, `submodule:refresh:minimal`, and `submodule:refresh:full` scripts in `package.json` to support parent-repo update workflows when this starter is installed as `.workflow`.
659
- - **Allowlist profiles for parent sync**: Added `scripts/submodule-sync-allowlist.json` with `minimal` and `full` sync profiles to control which workflow assets can be propagated outside `.workflow`.
660
- - **Safe refresh script with backups**: Added `scripts/refresh-submodule.mjs` to run submodule sync/update/tag refresh and copy allowlisted files to the parent repository with timestamped backups.
661
-
662
- ### Changed
663
-
664
- - **OpenCode command routing coverage**: Registered the `deploy` command in `opencode.jsonc` and aligned readiness routing with existing deploy command assets.
665
- - **Readiness documentation cohesion**: Updated `README.md` inventory/tree markers and standardized submodule path guidance in `runbooks/validate-starter-in-real-project.md`.
666
- - **Docs consistency guardrails**: Extended `scripts/validate-doc-consistency.mjs` to detect missing README structure markers and runbook-count drift.
667
-
668
- ## [1.2.1] - 2026-05-08
669
-
670
- ### Fixed
671
-
672
- - **Submodule version-validation guidance**: Updated `prompts/commands/install-codex-repo-starter-submodule.md` and `.short.md` to reduce false version confusion when `git submodule status` shows stale tag metadata.
673
- - **Tag refresh step in submodule flow**: Added `git -C .workflow fetch --tags --force` to ensure local submodule tag metadata is current before validating with `describe`.
674
- - **Stronger validation evidence**: Added explicit checks with `git -C .workflow rev-parse HEAD` and `git -C .workflow describe --tags --always` in the submodule setup prompts.
675
-
676
- ## [1.2.0] - 2026-05-08
677
-
678
- ### Added
679
-
680
- - **Team governance runbook**: Added `runbooks/team-governance-pr-readiness.md` with Definition of Ready/Definition of Done, reviewer ownership, escalation policy, and optional CODEOWNERS guidance.
681
- - **Readiness hardening**: Synced top-level documentation (`README.md`, `AGENTS.md`) with current repository assets and roadmap improvements.
682
- - **Structure validation hardening**: Extended `scripts/validate-structure.mjs` to require orchestration-related OpenCode agent/command files (`autopilot`, `orchestrator`, `start`, `ship`, `orchestrate`, `deploy`).
683
- - **Startup routing alignment**: Aligned Codex and OpenCode startup defaults to `autopilot` with explicit fallbacks (`planner`, `discovery`, `prompt-engineer`).
684
- - **OpenCode first-run smoke test**: Added verification checklist to `opencode/README.md` and `runbooks/apply-starter-to-real-project.md` to reduce manual interpretation during adoption.
685
-
686
- ### Changed
687
-
688
- - **ROADMAP.md**: Marked team governance runbook as delivered and refined next-sprint action plan.
689
- - **Documentation consistency**: Updated structure trees in `README.md` and `AGENTS.md` to reflect current harness workflows, example counts, and OpenCode assets.
690
-
691
- ## [1.1.9] - 2026-05-08
692
-
693
- ### Added
694
-
695
- - **Deploy command entrypoint**: Added `opencode/commands/deploy.md` and documented it in `opencode/commands/README.md` for deployment readiness, rollout, and rollback planning.
696
- - **Persistent operational memory**: Added `.codex/napkin.md` as curated runbook memory for recurring execution guardrails and token-efficiency directives.
697
-
698
- ### Changed
699
-
700
- - **Branch safety enforcement**: Expanded branch-gate requirements to implementation workflows, OpenCode execute command, and implementer/subagent contracts to block implementation on `main`.
701
- - **PR approval policy for private repositories**: Added two-account approval flow with squash-default merge guidance in adoption runbooks.
702
- - **Validation pipeline coverage**: Added external HTTP link validation (`scripts/validate-links.mjs`) and integrated it into the unified `npm run validate` flow.
703
- - **Agent/skill routing clarity**: Added official agent-to-skill auto-load baseline and next-sprint action plan updates in runbooks and roadmap documentation.
704
-
705
- ## [1.1.8] - 2026-05-08
706
-
707
- ### Added
708
-
709
- - **Startup routing entrypoints**: Added `opencode/commands/start.md` and `.codex/prompts/start-project.md` to enforce planner-first startup routing with safe fallbacks to discovery and prompt-engineer.
710
-
711
- ### Changed
712
-
713
- - **OpenCode config routing**: Registered `start` command in `opencode.jsonc` pointing to planner with startup routing template.
714
- - **Prompt docs discoverability**: Updated `.codex/prompts/README.md` and `opencode/README.md` to document the new startup routing entrypoints.
715
-
716
- ## [1.1.7] - 2026-05-08
717
-
718
- ### Added
719
-
720
- - **Submodule setup prompts**: Added `prompts/commands/install-codex-repo-starter-submodule.md` and `.short.md` for installing `codex-repo-starter` as a `.workflow` submodule with safe backup/removal flow and GH CLI SSH URL resolution.
721
- - **New reusable skills**: Added `.agents/skills/skill-creator/SKILL.md`, `.agents/skills/interface-design/SKILL.md`, and `.agents/skills/napkin/SKILL.md` adapted to this repository workflow.
722
-
723
- ### Changed
724
-
725
- - **Skill routing documentation**: Updated `AGENTS.md` to include `skill-creator` in specialist skills, usage guide, and routing quick map.
726
-
727
- ## [1.1.6] - 2026-05-08
728
-
729
- ### Changed
730
-
731
- - **README inventory accuracy**: Updated validation script count from 3 to 7 to reflect the current validation toolchain.
732
- - **ROADMAP clarity**: Renamed a stale subsection label from "Planned items" to "Planned and completed updates" where checklist items are mixed by design.
733
-
734
- ## [1.1.5] - 2026-05-08
735
-
736
- ### Added
737
-
738
- - **Workflow-state schema contract**: Added `.workflow-state.schema.json` and included it in repository structure validation.
739
-
740
- ### Changed
741
-
742
- - **Schema validation coverage**: Updated `scripts/validate-schemas.mjs` to compile-check `.workflow-state.schema.json` in addition to existing workflow schemas.
743
- - **CI validation flow**: Simplified `.github/workflows/validate.yml` to run a single canonical `npm run validate` step.
744
-
745
- ### Fixed
746
-
747
- - **AGENTS maturity table duplication**: Removed duplicated status rows in `AGENTS.md`.
748
- - **ROADMAP status drift**: Reconciled example and changelog completion markers in `ROADMAP.md` to reflect current repository state.
749
-
750
- ## [1.1.4] - 2026-05-08
751
-
752
- ### Added
753
-
754
- - **Subagent routing guide**: Added `subagents/README.md` with ownership boundaries, best-use routing, optimization rules, and a recommended handoff chain (`planner -> executor -> reviewer -> validator`).
755
-
756
- ### Changed
757
-
758
- - **OpenCode agent documentation**: Updated `opencode/agents/README.md` with a “Fast path with local subagents” section to improve routing between repository subagents and broader OpenCode agent roles.
759
- - **Top-level discoverability**: Updated `README.md` `subagents/` section to link to `subagents/README.md` for quick routing and handoff guidance.
760
-
761
- ## [1.1.3] - 2026-05-08
762
-
763
- ### Added
764
-
765
- - **Real-project validation runbook**: Added `runbooks/validate-starter-in-real-project.md` with adoption criteria, workflow proof steps, and common pitfalls.
766
- - **Quickstart (10 minutes)**: Added a fast-path onboarding section to `README.md` for first-value execution.
767
- - **Documentation consistency validation**: Added `scripts/validate-doc-consistency.mjs` and integrated it into `validate-all.mjs` as a new validation tier.
768
- - **Completed examples**: Finished full 6-file workflow artifacts for `examples/docs-only-repo/` and `examples/wordpress-theme/`.
769
-
770
- ### Changed
771
-
772
- - **Project positioning text**: Updated key documents to present the repository as a **Workflow starter kit** while preserving `codex-repo-starter` technical identifier.
773
- - **Maturity status tables**: Updated examples status to `Complete (nuxt-dashboard, docs-only-repo, wordpress-theme)` in `README.md` and `AGENTS.md`.
774
-
775
- ### Fixed
776
-
777
- - **Skill routing clarity**: Added quick routing maps and practical selection heuristics to reduce ambiguity when choosing primary vs supporting skills.
778
-
779
- ## [1.1.2] - 2026-05-08
780
-
781
- ### Fixed
782
-
783
- - **opencode.jsonc**: Replaced invalid top-level keys (`version`, `name`, `description`, `agents`, `commands`, `workflow`) with OpenCode schema keys (`agent`, `command`, `skills.paths`).
784
- - **OpenCode docs**: Updated README references to describe the validated OpenCode project config structure.
785
-
786
- ## [1.1.1] - 2026-05-08
787
-
788
- ### Added
789
-
790
- - **Cross-reference validation**: `scripts/validate-refs.mjs` extracts file paths from Markdown code fences, backticks, and links. Verifies each path resolves to an existing file or directory. Handles placeholder exclusions for examples/ and template files.
791
- - **Workflow state tracker**: `.workflow-state.json` + `scripts/validate-workflow.mjs` track 5 workflow phases (bootstrap, requirement, specification, technicalPlan, prBreakdown) with status, completion date, active PR, and completed PRs. Validates phase ordering.
792
- - **Schema validation**: `scripts/validate-schemas.mjs` uses `ajv` to validate all 6 JSON schemas. Verifies valid JSON, no circular refs, and all internal `$ref` resolution.
793
- - **harness/README.md**: Added Workflow State Tracker section documenting phase order, rules, and usage.
794
- - **opencode/README.md**: Added Configuration section documenting `opencode.jsonc` experimental status and verification requirements.
795
-
796
- ### Fixed
797
-
798
- - **AGENTS.md maturity table**: Fixed "Automated Markdown validation" from "Not started" to "Complete"; added 5 missing rows (opencode.jsonc, CI workflow, package.json/version, CHANGELOG, LICENSE).
799
- - **README.md known gaps**: Removed stale "changelog" and "license decision" references; updated "executable validation" to reflect new cross-reference and workflow state checks.
800
- - **README.md next improvements**: Replaced outdated PR recommendations with schema validation and OpenCode config verification as top priorities.
801
- - **AGENTS.md next improvements**: Replaced completed items with genuine future work (schema validation, cross-reference checks, harness expansion, link validation, stack variants).
802
- - **opencode.jsonc**: Added informational comment noting that `$schema` reference is unverified and the configuration structure is experimental.
803
- - **All 6 schemas**: Removed `https://json-schema.org/draft/2020-12/schema` reference from `schemas/*.schema.json` — schemas are self-contained with `$id` only.
804
-
805
- ### Changed
806
-
807
- - **validate-all.mjs**: Expanded from 3 to 6 validation tiers (Markdown, JSON, cross-refs, workflow state, schemas, structure).
808
- - **package.json**: Added `validate:refs`, `validate:workflow`, `validate:schemas` scripts; added `ajv` and `ajv-formats` dev dependencies.
809
- - **validate-structure.mjs**: Added `.workflow-state.json` to required paths (55 paths total).
810
-
811
- ## [1.1.0] - 2024-05-07
812
-
813
- ### Added
814
-
815
- - **License**: Added MIT LICENSE file for legal clarity
816
- - **OpenCode config**: Added `opencode.jsonc` with agent, command, and skill mappings
817
- - **CI workflow**: Added `.github/workflows/validate.yml` for automatic validation
818
- - **Compact commands**: Added 5 token-efficient command prompts in `prompts/commands/`:
819
- - `requirement.md` (~47 lines) - Create requirement
820
- - `spec.md` (~41 lines) - Create specification
821
- - `tech-plan.md` (~41 lines) - Create technical plan
822
- - `implement.md` (~42 lines) - Implement PR
823
- - `validate.md` (~42 lines) - Validate PR
824
-
825
- ### Changed
826
-
827
- - Updated `opencode.jsonc` to include `compact_commands` references
828
- - Reduced token usage by 87-92% for common workflow commands
829
-
830
- ## [1.0.0] - 2024-05-05
831
-
832
- ### Added
833
-
834
- - **Core structure**: Initial repository foundation
835
- - **Skills**: 15 specialist skills in `.agents/skills/`
836
- - **Prompts**: 10 ordered prompts in `prompts/00-09/`
837
- - **Codex entrypoints**: 4 compact prompts in `.codex/prompts/`
838
- - **OpenCode commands**: 5 commands in `opencode/commands/`
839
- - **OpenCode agents**: 11 agents in `opencode/agents/`
840
- - **Templates**: 7 reusable templates in `templates/`
841
- - **Runbooks**: 5 operational runbooks in `runbooks/`
842
- - **Schemas**: 6 JSON schemas in `schemas/`
843
- - **Example**: Nuxt dashboard workflow in `examples/`
844
- - **Validation**: Markdown, JSON, and structure validation scripts
845
- - **Documentation**: README.md, AGENTS.md, ROADMAP.md
846
-
847
- ---
848
-
849
- ## Versioning strategy
850
-
851
- - **Major**: Breaking changes to workflow structure or skill contracts
852
- - **Minor**: New features (commands, skills, examples)
853
- - **Patch**: Documentation fixes, validation improvements
854
-
855
- ## How to add changes
856
-
857
- When contributing changes:
858
-
859
- 1. Add entry under `[Unreleased]` with date
860
- 2. Categorize as `Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, `Security`
861
- 3. Be specific about what changed and where
862
- 4. Update version in header when releasing
863
-
864
- ## Migration notes
865
-
866
- ### 1.1.0 → 1.1.1
867
-
868
- - Run `npm install` to install `ajv` and `ajv-formats` dev dependencies
869
- - Validation now has 6 tiers — `npm run validate` runs cross-reference, workflow state, and schema checks in addition to previous checks
870
- - `.workflow-state.json` is optional — the repository validates without it
871
- - `opencode.jsonc` is marked experimental — verify configuration against a known OpenCode installation before production use
872
-
873
- ### 1.0.0 → 1.1.0
874
-
875
- - New `opencode.jsonc` enables direct OpenCode integration
876
- - Use `prompts/commands/` for token-efficient workflow
877
- - CI now validates automatically on push/PR
878
- - All changes backwards compatible
91
+ - Recovered the original product direction: proportionate workflows, useful software, and concise evidence.
92
+ - Kept protected-branch enforcement, required validation execution, bounded remediation, and false-success prevention as non-negotiable guardrails.
93
+ - Removed mandatory canonical response fields, owner JSON, fixed delivery filenames, and persisted evidence from quick/standard work.
94
+ - Simplified Atlas to route and coordinate without forcing multi-agent ceremony.
95
+ - Simplified QualityGuard to objective branch, validation, documentation, UI-evidence, and full-mode persistence checks.
96
+ - Replaced keyword-driven Product Truthfulness enforcement with semantic guidance.