@williambeto/ai-workflow 1.19.0 → 2.1.0

package/CHANGELOG.md

@@ -1,877 +1,96 @@
-# [1.19.0](https://github.com/williambeto/ai-workflow/compare/v1.18.18...v1.19.0) (2026-05-23)
-
-
-### Features
-
-* add Atlas OpenCode agent ([#70](https://github.com/williambeto/ai-workflow/issues/70)) ([15ae8a2](https://github.com/williambeto/ai-workflow/commit/15ae8a2d0ae0d97cad450280522f5e2849c0149b))
-
-## [1.19.0](https://github.com/williambeto/ai-workflow/compare/v1.18.18...v1.19.0) (2026-05-23)
-
-### Added
-
-- **Atlas OpenCode agent**: added Atlas as a primary OpenCode agent and default senior engineering partner for project workflows.
-- **Atlas prompt file**: added `opencode/agents/atlas.md` with workflow orchestration, implementation quality, no-regression, validation evidence, and critical review guidance.
-- **OpenCode configuration**: registered Atlas in `opencode.jsonc` and set `default_agent` to `atlas` while preserving existing agents, commands, permissions, and workflows.
-- **OpenCode documentation**: documented Atlas in OpenCode agent documentation and package-facing documentation.
-
-### Validation
-
-- Validated JSON, delegation contracts, full repository validation, diff checks, and npm package dry-run for the Atlas release.
-
-## [1.18.18](https://github.com/williambeto/ai-workflow/compare/v1.18.17...v1.18.18) (2026-05-23)
-
-
-### Bug Fixes
-
-* **init:** include napkin memory in npm install ([f4f2e31](https://github.com/williambeto/ai-workflow/commit/f4f2e313dfae85daa31c92d60d5402df48c83b62))
-
-## [1.18.17](https://github.com/williambeto/ai-workflow/compare/v1.18.16...v1.18.17) (2026-05-23)
-
-
-### Bug Fixes
-
-* **init:** ignore generated workflow footprint ([15eba7a](https://github.com/williambeto/ai-workflow/commit/15eba7a2ac3ad81af3f6e6984be900717a6e89ef))
-* **init:** use canonical opencode full config ([8b8551d](https://github.com/williambeto/ai-workflow/commit/8b8551d5af00b8924dbc8f2244b159f091fcb810))
-
-## [1.18.16](https://github.com/williambeto/ai-workflow/compare/v1.18.15...v1.18.16) (2026-05-22)
-
-
-### Bug Fixes
-
-* **audit:** harden artifact safety and align CLI/OpenCode catalog ([047c3bd](https://github.com/williambeto/ai-workflow/commit/047c3bd92d2d7fd3bc7bef2afc5f29a8fba441e9))
-* **audit:** harden artifact safety and align CLI/OpenCode catalog ([a13f489](https://github.com/williambeto/ai-workflow/commit/a13f489c1a5cc7a06ba67580b30dd30f670d9b62))
-
-## [1.18.15](https://github.com/williambeto/ai-workflow/compare/v1.18.14...v1.18.15) (2026-05-22)
-
-
-### Bug Fixes
-
-* **cli-catalog:** sync managed config with current repo skills ([595a4cc](https://github.com/williambeto/ai-workflow/commit/595a4cc71fe89a25664fc2b9c5ae2131b36c92dc))
-* **cli-catalog:** sync managed config with current repo skills ([7202320](https://github.com/williambeto/ai-workflow/commit/72023200ccd7d47a5a6e1106b781013fbf27215f))
-
-## [1.18.14](https://github.com/williambeto/ai-workflow/compare/v1.18.13...v1.18.14) (2026-05-22)
-
-
-### Bug Fixes
-
-* 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))
-
-## [1.18.13](https://github.com/williambeto/ai-workflow/compare/v1.18.12...v1.18.13) (2026-05-22)
-
-
-### Bug Fixes
-
-* 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))
-
-## [1.18.12](https://github.com/williambeto/ai-workflow/compare/v1.18.11...v1.18.12) (2026-05-22)
-
-
-### Bug Fixes
-
-* 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))
-
-## [1.18.11](https://github.com/williambeto/ai-workflow/compare/v1.18.10...v1.18.11) (2026-05-22)
-
-
-### Bug Fixes
-
-* apply readiness audit fixes (security, package, branding, docs) ([9721661](https://github.com/williambeto/ai-workflow/commit/972166100908681f27889e9ddd10de71f20a9627))
-* apply readiness audit fixes (security, package, branding, docs) ([ee60c7c](https://github.com/williambeto/ai-workflow/commit/ee60c7cabab77dc45684d8e1b91533566660e794))
-* update semantic-release CI to Node.js 22 ([8bbaabb](https://github.com/williambeto/ai-workflow/commit/8bbaabbefa3ffe1a27b19264bc8c98779ba4bddd))
-* update semantic-release CI to Node.js 22 ([89a198a](https://github.com/williambeto/ai-workflow/commit/89a198aadd21f10c8b3d65e21a58747e50c23703))
-
-# Changelog
-
-All notable changes to AI Workflow Kit (`ai-workflow`) are documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.18.9] - 2026-05-21
-
-### Removed
-
-- **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.
-
-## [1.18.8] - 2026-05-20
-
-### Added
-
-- **Discovery gate enforcement**: `opencode/agents/discovery.md` now explicitly blocks execution/delegation requests and routes them to `orchestrator`.
-- **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.
-- **Roadmap simplification phases**: added Phase 17/18/19 plan in `ROADMAP.md` for OpenCode-first focus, artifact surface reduction, and consumer-validation/Napkin hardening.
-
-### Changed
-
-- **Roadmap priority update**: `ROADMAP.md` next sprint, next step, and next recommended PR now point to Phase 17 platform focus as immediate priority.
-
-## [1.18.6] - 2026-05-20
-
-### Added
-
-- **Publish hardening via `.npmignore`**: added a defense-in-depth ignore file to prevent accidental inclusion of non-essential repository assets during publish operations.
-
-## [1.18.5] - 2026-05-20
-
-### Added
-
-- **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/`.
-
-### Changed
-
-- **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.
-- **Init flow and config contract**: `init` now records `managedLinks` in `.ai-workflow.json` and reports link creation in install summary.
-- **Doctor coverage**: `doctor` now validates `.ai-workflow/` presence and managed link health in standalone mode.
-- **Documentation and discoverability**: updated quickstart/setup/command indexes to reflect `.ai-workflow/` + symlink default model.
-
-### Removed
-
-- **Legacy submodule sync flow**: removed `update-submodule` prompt/command/runbook flow and `scripts/validate-submodule.mjs` validation path.
-
-## [1.18.4] - 2026-05-20
+## [2.0.5] - 2026-06-08
 
 ### Fixed
 
-- **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.
-
-### Changed
-
-- **Release continuity**: package version bumped to `1.18.4`.
-
-## [1.18.3] - 2026-05-20
-
-### Changed
-
-- **Publish retry with unique version**: bumped package version to `1.18.3` after `1.18.2` was already published.
-
-## [1.18.2] - 2026-05-20
-
-### Added
-
-- **Spec-Driven Development workflow assets**:
-  - `checklists/spec-readiness-checklist.md`
-  - `.codex/prompts/specs/` (create/review/spec-to-plan/spec-to-pr)
-  - `opencode/commands/specs/` (create/review/spec-to-plan/spec-to-pr)
-  - `runbooks/spec-driven-development.md`
-
-### Changed
-
-- **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.
-- **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`.
-- **Release continuity**: package version bumped to `1.18.2`.
-
-## [1.18.1] - 2026-05-20
-
-### Added
-
-- **Public-readiness evaluation report**: added `docs/reports/project-evaluation.md` with evidence-backed verdict, adoption blockers, and minimal PR roadmap.
-- **Public-readiness improvement backlog**: added `docs/reports/public-readiness-backlog.md` with prioritized incremental execution plan.
-
-### Changed
-
-- **Validation E2E refs assertions**: updated `tests/validate-e2e.mjs` to align with current `validate-refs` output markers.
-- **Version alignment**: local package version aligned and bumped to `1.18.1` for publish/release continuity.
+- Locked standard/full Atlas completion behind current-task Sage, Evidence Collector, and QualityGuard execution.
+- Rejected direct Atlas `PASS`, user-deferred `/validate`, self-validation, and missing executable finalizer paths.
+- Added canonical cross-field validation for branch evidence, owners, artifacts, truthfulness, collector/final status, and Phoenix/Sage consistency.
+- Strengthened fictitious-product claim detection for unsupported market superlatives, pricing, SLA/support, API, batch, and export capabilities.
+- Added regression tests for runtime completion lock and internally inconsistent canonical results.
 
-## [1.15.0] - 2026-05-20
+## [2.0.3] - 2026-06-08
 
 ### Added
 
-- **npm consumer quickstart guide**: created `docs/npm-consumer-quickstart.md` with install, inspect, init, Codex quickstart, OpenCode quickstart, validation checklist, troubleshooting, and next steps.
-- **README Quickstart npm entry point**: the Quickstart section now opens with the `npm install` path and links to the detailed guide.
+- Lightweight workflow profiles separating execution mode from domain quality guidance.
+- Deterministic profile routing for frontend product, frontend utility, backend API, refactor, documentation, and security review work.
+- Objective owner-completion contract with one bounded resume before `BLOCKED`.
+- Consumer workflow profile documentation.
 
 ### Changed
 
-- **ROADMAP.md**: status line updated, delivered entry recorded, public-readiness audit item about npm install path marked fixed.
-- **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.
-
-## [1.14.0] - 2026-05-20
-
-### Added
-
-- **`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).
-- **Dependabot automation**: added `.github/dependabot.yml` for weekly npm dependency update PRs.
-- **Semantic-release automation**: added `.github/workflows/semantic-release.yml` and `.releaserc.json` for automated versioning/release flow on `main`.
-- **Local developer bootstrap**: added `npm run setup:dev` powered by `scripts/setup-dev.mjs` (`npm ci` + validation + CLI smoke checks).
-- **Feedback metrics**: added `npm run metrics:feedback` and `scripts/collect-feedback-metrics.mjs` with output to `evidence/feedback-metrics.json`.
-- **Feedback intake template**: added `.github/ISSUE_TEMPLATE/feedback.yml`.
-
-### Changed
-
-- **`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.
-- **`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/`.
-- **npm publish workflow**: fixed `.github/workflows/publish-npm.yml` to publish from repository root package (removed incorrect `working-directory: packages/ai-workflow`).
-- **Agent routing registry**: added `seo-audit` as subagent in `opencode.jsonc` to align with available skills and routing matrix.
-
-### Fixed
-
-- **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).
-- **Missing reference files**: `interface-design/references/*.md` (4 files) were not included in the generated project.
-- **Missing harness workflows**: `harness/workflows/*.md` and `harness/handoffs/HANDOFF.template.md` (referenced by orchestrator agent) were not copied.
-- **Missing policy docs**: `docs/architecture-policy.md` and `docs/design-patterns-policy.md` were not included.
-- **Missing `.codex/prompts/` extra files**: 7 additional prompt files (autopilot, deploy, fix-issue, roadmap-audit, etc.) were missing.
-
-## [1.12.6] - 2026-05-19
-
-### Fixed
-
-- **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`.
-- **npm publish over 1.12.5**: bumped to `1.12.6` to republish with correct package structure.
-
-### Added
+- Visual validation now uses objective rendered checks instead of subjective labels or benchmark comparison.
+- Frontend product and utility profiles load both frontend and UI/UX skills without imposing a fixed SaaS page template.
+- Product Truthfulness accepts clear page-level conceptual labels for non-authoritative commercial concepts while keeping official/live/security/SLA claims strict.
+- Atlas handoff guidance is shorter and outcome-first.
 
-- **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.
-
-## [1.12.5] - 2026-05-19
-
-### Added
-
-- **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.
-- **Phase 15 documentation**: added to ROADMAP.md with 3 incremental fixes applied.
-
-### Changed
-
-- **Dedup orchestrator routing matrix**: `opencode/agents/orchestrator.md` no longer duplicates the delegation table from `AGENTS.md`; references `AGENTS.md` §453 instead.
-- **Delegation matrix completeness**: `AGENTS.md` §464 now includes `Bug fixing / diagnostics | fixer` with Codex path `.codex/prompts/fix-issue.md`, closing the documented gap.
-- **Codex/OpenCode comparison table**: `docs/setup-codex-opencode.md` now explicitly states OpenCode agent files are not Codex subagents.
-
-## [1.12.4] - 2026-05-16
-
-### Added
-
-- **Guarded npm publish workflow**: added `.github/workflows/publish-npm.yml` with manual trigger, dry-run default, required validation, and token-gated real publish.
-- **Publish runbook**: added `runbooks/publish-package-checklist.md` with pre-publish gates, evidence requirements, and rollback/deprecate guidance.
-- **Publish rehearsal evidence**: added `evidence/publish-dry-run-2026-05-15.md` documenting the successful dry-run workflow run.
-
-### Changed
-
-- **Validation default flow**: `npm run validate` now includes external link validation.
-- **Autopilot/ship context discipline**: Codex/OpenCode entrypoints now use minimum-first context loading to reduce token-heavy scans.
-- **Documentation consistency**: examples maturity rows and quickstart validation counts aligned with current repository checks.
-- **GitHub Actions runtime compatibility**: workflows now force JavaScript actions to Node 24 runtime to preempt Node 20 runner deprecation.
-
-## [1.12.1] - 2026-05-14
-
-### Added
-
-- **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.
-
-### Changed
-
-- **README.md**: repositioned as AI Workflow Kit landing page with compact structure and OpenCode/Codex setup guidance links.
-- **docs/full-documentation.md**: added detailed workflow reference document.
-- **docs/setup-codex-opencode.md**: added dedicated setup and usage guide for OpenCode and Codex.
-- **Roadmap**: marked Phase 13 (AI Workflow Kit documentation repositioning) complete and advanced next recommended PR to Phase 14 guarded publish workflow.
-
-## [1.11.0] - 2026-05-13
-
-### Changed
-
-- **AGENTS.md**: Synced with opencode.jsonc. Phase 7 complete.
-
-## [1.10.5] - 2026-05-13
-
-### Added
-
-- **Delegation matrix**: Add interface-design, playwright-cli, stack-variant-creator. Phase 7 PR 7.
-
-## [1.10.4] - 2026-05-13
-
-### Removed
-
-- **skill-creator subagent**: Scope absorbed by prompt-engineer. Phase 7 PR 6.
-
-## [1.10.3] - 2026-05-13
-
-### Removed
-
-- **estimator agent**: Never routed, no command, no documented use. Phase 7 PR 5.
-- **frontend-architect agent**: Scope covered by frontend-implementer + tech-lead. Phase 7 PR 5.
-
-## [1.10.2] - 2026-05-13
-
-### Removed
-
-- **codex-token-economy skill**: Merged into token-economy. Phase 7 PR 4.
-
-## [1.10.1] - 2026-05-13
-
-### Removed
-
-- **git-pr-release-flow subagent**: Deleted; scope covered by release-manager. Phase 7 PR 3.
-
-## [1.10.0] - 2026-05-13
-
-### Removed
-
-- **autopilot agent**: Merged into orchestrator. `/start` and `/ship` now route to orchestrator. Phase 7 PR 2.
-
-## [1.9.10] - 2026-05-13
-
-### Removed
-
-- **Codex subagents/**: Deleted 5 files. Project is primary OpenCode; AGENTS.md covers Codex routing. Phase 7 PR 1.
-
-## [1.9.9] - 2026-05-13
-
-### Changed
-
-- **ROADMAP.md**: Add Phase 7 agent & skill simplification plan with 8-PR reduction from audit findings
-
-## [1.9.8] - 2026-05-13
-
-### Added
-
-- **Token economy coverage**: Add `token-economy` + `minimal-context` directive to all 22 skills and 3 primary agents (discovery, wordpress-engineer, prompt-engineer)
+# Changelog
 
-## [1.9.7] - 2026-05-13
+## [2.0.4] - 2026-06-08
 
 ### Fixed
 
-- **ROADMAP.md**: Update skill count (19→22), runbook count (6→13), example count (3→4) with react-dashboard
-- **README.md**: Add missing skills (`minimal-context`, `stack-variant-creator`, `token-economy`) to specialist skills table
-- **package.json**: Replace stale `your-org` placeholder URLs with actual owner
-
-## [1.8.2] - 2026-05-13
-
-### Changed
-
-- **init.mjs**: Simplify to only merge opencode.jsonc — no file copying, assets stay in submodule
-- **runbooks/sync-workflow-from-submodule.md**: Updated install/uninstall steps
-
-### Removed
+- Removed circular finalization evidence by deriving canonical results from executed policy checks and persisting them in `EVIDENCE.json`.
+- Enforced all canonical standard/full final response fields from one machine-readable contract.
+- Persisted and rendered delegation owners, loaded skills, delivery artifacts, Sage revalidation, Evidence Collector, QualityGuard, Product Truthfulness, finalizer, and terminal status.
+- Required structured TypeScript waivers with an explicit source and concrete constraint.
+- Added regression coverage for omitted fields, direct finalizer bypass, remediation without Sage revalidation, and canonical status spelling.
 
-- **sync.mjs**: No longer needed
-- **uninstall-workflow.mjs**: Manual cleanup sufficient
-- **submodule-sync-allowlist.json**: No longer needed
 
-## [1.7.5] - 2026-05-13
-
-### Changed
-
-- **init.mjs** (renamed from bootstrap-parent-workflow.mjs): bootstrap workflow assets, merge opencode.jsonc into parent root
-- **sync.mjs** (renamed from refresh-submodule.mjs): sync workflow subtree, merge opencode.jsonc (backups existing)
-
-### Added
-
-- **opencode.jsonc merge**: init.mjs and sync.mjs now merge opencode.jsonc from `.workflow/` into parent root with backup of existing config
+## 2.0.2
 
 ### Fixed
 
-- **validate-refs.mjs**: exclude example paths from validation (`prompts/codex/`, `prompts/codex-repo-starter/`, `.workflow-sync-backups/<timestamp>/`)
-
-## [1.7.4] - 2026-05-13
-
-### Added
-
-- **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.
-- **Napkin entry**: Token economy does not auto-pass to subagents — delegation packets must explicitly request compact output.
-- **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).
-
-## [1.7.2] - 2026-05-13
-
-### Added
+- Enforced mode-specific final delivery artifacts so `standard` cannot pass with `delivery-summary.md`.
+- Added mandatory finalization evidence for collector, QualityGuard, Product Truthfulness, delegation, and finalizer identity.
+- Prevented `PASS` when canonical finalization fields are missing or inconsistent.
+- Added direct tests for standard artifact mismatch and finalization evidence.
+- Kept bounded remediation responsible for correcting final-gate failures before promotion.
 
-- **`.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/`.
-- **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/`.
-
-### Changed
-
-- **update-submodule command** updated: references `.workflow/` path and `runbooks/sync-workflow-from-submodule.md`.
-- **bootstrap-parent-workflow.mjs** already supports `.workflow/` as target (detected by script).
-
-## [1.7.1] - 2026-05-13
-
-### Added
-
-- **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).
-- **Minimal Context Codex prompt**: `.codex/prompts/minimal-context-mode.md` — reusable prompt with input budget rules.
-- **Handoff validation script**: `scripts/validate-handoffs.mjs` — structural skill-to-skill handoff readiness validation.
-- **Skill auto-load baseline** in `AGENTS.md` — agent-to-skill mapping (planner, implementer, reviewer, validator, release-manager) discoverable from central rules.
-
-### Changed
-
-- **Token economy skill** updated: added input vs output distinction (`minimal-context` reduces input, `token-economy` reduces output).
-- **implementer** and **planner** agents updated: added input discipline sections.
-- **execute** command updated: references minimal-context skill.
-- **README.md** updated: input vs output token distinction, minimal-context usage.
+## 2.0.1
 
 ### Fixed
 
-- **ROADMAP.md**: all planned PRs marked complete; Phase 4B, 4A, and 6 PRs added to completed table.
-
-## [1.7.0] - 2026-05-13
-
-### Added
-
-- **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.
-- **Token economy Codex prompt**: `.codex/prompts/token-economy-mode.md`.
-- **Token economy OpenCode command**: `opencode/commands/token-economy.md`.
-- **Token economy mode documentation** in `README.md` (compact output usage, modes, notes on verbosity reduction, optional external caveman tooling).
-
-### Changed
-
-- **Next recommended PR** in `ROADMAP.md` advanced to Phase 4B (agent routing refinement) after Phase 4A command work completed via PR #57.
-- **PR queue** reprioritized: routing drift → handoff validation → Phase 6 docs.
+- Added bounded, progress-aware remediation for recoverable quality and delegation gates.
+- Prevented unresolved gate failures from being downgraded to `PASS_WITH_NOTES`.
+- Added hard remediation limits by execution mode and blocking on repeated/no-progress findings.
+- Synchronized the root evidence contract with the canonical distributed contract.
+- Added direct coverage for implementation documentation and remediation lifecycle behavior.
 
-### Validation
-
-- `npm run validate` — all 9 checks passed, 0 skill warnings.
-
-## [1.6.9] - 2026-05-13
-
-### Changed
-
-- **Phase 5 (stack variants)**: marked as Complete in AGENTS.md and ROADMAP.md.
-- **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.
-- **AGENTS.md**: maturity table updated — stack variants now "Complete (5 variants: nuxt, wordpress, docs-only, nodejs-api, python-api)".
-
-### Validation
-
-- `npm run validate` — all 9 checks passed.
-
-## [1.6.8] - 2026-05-13
+## 2.0.0
 
 ### Added
 
-- **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.
+- OpenCode-first workflow with six primary ownership roles.
+- Proportional `quick`, `standard`, and `full` delivery modes.
+- Persisted delivery artifacts and executable evidence collection.
+- Branch recovery, quality gates, delegation statuses, Product Truthfulness, and safe packaging.
+- TypeScript default for new frontend applications unless explicitly waived.
+- Consumer quickstart, runtime compatibility guidance, and v2 upgrade documentation.
+- Optional Codex, Claude Code, and Gemini adapter assets.
 
 ### Changed
 
-- **interface-design skill**: improved description to avoid weak phrase; removed literal "placeholder" text.
-- **wordpress-engineer skill**: changed H1 heading to "WordPress Engineer" to match skill name.
-
-### Validation
-
-- `npm run validate` — all 9 checks passed, 0 skill warnings (was 42).
-
-## [1.6.7] - 2026-05-12
-
-### Added
-
-- **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.
-
-### Changed
-
-- **AGENTS.md file tree**: synced to reflect current repository structure (skill-creator, stack-variant-creator, new scripts, variants, tests).
-- **README.md runbooks table**: added `commands-cheatsheet.md` entry.
-- **Repository maturity**: marked stack-specific variants as "In progress".
-
-### Validation
-
-- Ran `npm run validate` — all 9 checks passed.
-
-## [1.6.6] - 2026-05-11
-
-### Added
-
-- **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.
-
-### Changed
-
-- **OpenCode command registry**: registered `update-submodule` in `opencode.jsonc` using `release-manager` as the command owner.
-- **Discoverability and structure checks**: updated command READMEs and `scripts/validate-structure.mjs` to require and document the new submodule-update command files.
-
-### Validation
-
-- Ran `npm run validate`
-
-## [1.6.5] - 2026-05-11
-
-### Added
-
-- **Delegation workflow runbook**: added `runbooks/agent-delegation-workflow.md` to document orchestration rules, delegation matrix, escalation paths, and anti-overdelegation behavior.
-- **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.
-
-### Changed
-
-- **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).
-- **Validation suite**: wired delegation checks into `scripts/validate-all.mjs` so `npm run validate` continuously verifies delegation integrity.
-
-### Validation
-
-- Ran `npm run validate:delegation`
-- Ran `npm run validate`
-
-## [1.6.4] - 2026-05-11
-
-### Added
-
-- **Napkin project memory**: added `.agents/napkin.md` and `runbooks/use-napkin-project-memory.md` to provide durable, repository-specific memory with progressive disclosure guidance.
-
-### Changed
-
-- **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.
-- **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.
-
-### Validation
-
-- Ran `npm run validate`
-
-## [1.6.3] - 2026-05-09
-
-### Changed
-
-- **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.
-- **Reference materials added**: added `.agents/skills/interface-design/references/{principles,critique,example,validation}.md` to provide deeper craft guidance and post-build critique workflows.
-
-### Validation
-
-- Ran `npm run validate:md`
-- Ran `npm run validate:skills`
-- Ran `npm run validate`
-
-## [1.6.2] - 2026-05-09
-
-### Changed
-
-- **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.
-- **Skill example language consistency**: translated the example snippet in `.agents/skills/stack-variant-creator/SKILL.md` to English.
-
-## [1.6.1] - 2026-05-09
-
-### Added
-
-- **Quick-start guide**: `runbooks/quick-start-guide.md` with zero-to-first-PR in 10 minutes.
-
-## [1.6.0] - 2026-05-09
-
-### Added
-
-- **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).
-- **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.
-- **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.
-- **Structure validation**: `tests/` registered as an optional directory in `scripts/validate-structure.mjs`.
-- **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.
-
-## [1.5.0] - 2026-05-09
-
-### Added
-
-- **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
-
-### Fixed
-
-- `validate-refs.mjs`: Added `tests/` to placeholder path prefixes to fix false positive for test directory references
-
-## [1.3.0] - 2026-05-09
-
-### Added
-
-- **Public readiness**:
-  - `CONTRIBUTING.md` — New contribution guidelines, PR process, validation instructions
-  - License badge and npm version badge added to README
-  - Copyright year updated to 2026 in LICENSE
-
-### Changed
-
-- **Phase 2, 3, 3A, 5, 6 completion**: All major phases marked as Complete in ROADMAP.md
-
-## [1.2.9] - 2026-05-09
-
-### Added
-
-- **Phase 6 - Advanced agent workflows**:
-  - `harness/workflows/planner-executor-workflow.md` — Planner/executor role separation, gate model, failure modes, workflow sequence, integration with OpenCode agents
-  - `harness/workflows/agent-evaluation-checklist.md` — Criteria for evaluating agent outputs: Useful, Safe, Scoped, Validated; severity model; final recommendations
-- **Phase 2 - Consistency checks completed**:
-  - Verified no conflicting duplicate rules across 341+ "Do not" rules
-  - Standardized recommendation labels (Approved/Approved with notes/Changes requested/Blocked) across 30+ files
-  - Standardized severity language (High/Medium/Low) across 51+ files
-  - Standardized evidence rules wording across 11+ files
-  - Decision: No central `PROJECT_RULES.md` needed; AGENTS.md serves as central rules file
-
-### Changed
-
-- **ROADMAP.md**: Marked Phases 2, 3, 3A, 5, and 6 as Complete; added delivered items documentation
-
-## [1.2.8] - 2026-05-09
-
-### Added
-
-- **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.
-
-### Changed
-
-- **validate-refs.mjs heading detection**: Added `headingToId()`, `extractHeadings()`, `resolveAnchorTargetFile()` functions; builds a heading index from all `.md` files before cross-reference checking.
-
-## [1.2.7] - 2026-05-09
-
-### Added
-
-- **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.
-- **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.
-
-### Changed
-
-- **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`).
-- **Skill table sync**: Both `README.md` and `AGENTS.md` specialist skill listings expanded to 19 entries, matching all actual skill directories in `.agents/skills/`.
-- **markdownlint-cli 0.44 → 0.48**: Updated dependency; disabled MD060 rule (GFM-style tables do not require pipe alignment).
-
-## [1.2.6] - 2026-05-09
-
-### Added
-
-- **Full skill-directory validation**: Added `scripts/validate-skills.mjs` wired into `npm run validate` to ensure every `.agents/skills/*/SKILL.md` passes structural checks.
-- **Missing skill file**: Added `.agents/skills/playwright-cli/SKILL.md` to satisfy per-skill validation contract.
-
-### Changed
-
-- **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.
-- **OpenCode implementation naming**: Normalized naming around `implementer`, documenting `subagents/executor.md` as a lightweight local equivalent.
+- Public version identity is now aligned with the npm upgrade path from `1.x` to `2.0.0`.
+- Active documentation describes only the current 2.0 product and supported migration path.
+- Repository-maintenance paths are separated from consumer-facing paths.
+- The initial `2.0.0` rollout uses the npm `next` dist-tag without moving `latest`.
 
 ### Removed
 
-- **Fragile consistency checks**: Removed count-coupled checks in docs-consistency validation that drifted as the repository grew.
-
-## [1.2.5] - 2026-05-08
-
-### Added
-
-- **Handoff instance schema validation**: Added validation path for handoff instance files against the handoff schema in CI.
-
-### Fixed
-
-- **WordPress skill naming alignment**: Aligned WordPress skill naming convention with agent routing across all references.
-
-### Changed
-
-- **Adoption runbook Quick Start**: Added Quick Start section to `runbooks/apply-starter-to-real-project.md` for faster onboarding.
+- Obsolete pre-2.0 runtime guidance, taxonomies, aliases, package paths, and intermediate release-candidate documentation.
 
-## [1.2.4] - 2026-05-08
+## Previous public releases
 
-### Added
-
-- **One-command parent bootstrap**: Added `submodule:bootstrap` in `package.json` to prepare parent repositories after installing this starter as `.workflow`.
-- **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.
-
-### Changed
-
-- **Adoption runbook guidance**: Updated `runbooks/apply-starter-to-real-project.md` with fast bootstrap instructions for submodule mode.
-- **Submodule installation prompts**: Updated `prompts/commands/install-codex-repo-starter-submodule.md` and `.short.md` to include optional full bootstrap execution.
-- **README adoption quickstart**: Documented bootstrap usage in `README.md` for faster first-run setup in target projects.
-
-## [1.2.3] - 2026-05-08
-
-### Added
-
-- **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`.
-- **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`.
-- **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.
-
-### Changed
-
-- **OpenCode command routing coverage**: Registered the `deploy` command in `opencode.jsonc` and aligned readiness routing with existing deploy command assets.
-- **Readiness documentation cohesion**: Updated `README.md` inventory/tree markers and standardized submodule path guidance in `runbooks/validate-starter-in-real-project.md`.
-- **Docs consistency guardrails**: Extended `scripts/validate-doc-consistency.mjs` to detect missing README structure markers and runbook-count drift.
-
-## [1.2.1] - 2026-05-08
-
-### Fixed
-
-- **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.
-- **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`.
-- **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.
-
-## [1.2.0] - 2026-05-08
-
-### Added
-
-- **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.
-- **Readiness hardening**: Synced top-level documentation (`README.md`, `AGENTS.md`) with current repository assets and roadmap improvements.
-- **Structure validation hardening**: Extended `scripts/validate-structure.mjs` to require orchestration-related OpenCode agent/command files (`autopilot`, `orchestrator`, `start`, `ship`, `orchestrate`, `deploy`).
-- **Startup routing alignment**: Aligned Codex and OpenCode startup defaults to `autopilot` with explicit fallbacks (`planner`, `discovery`, `prompt-engineer`).
-- **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.
-
-### Changed
-
-- **ROADMAP.md**: Marked team governance runbook as delivered and refined next-sprint action plan.
-- **Documentation consistency**: Updated structure trees in `README.md` and `AGENTS.md` to reflect current harness workflows, example counts, and OpenCode assets.
-
-## [1.1.9] - 2026-05-08
-
-### Added
-
-- **Deploy command entrypoint**: Added `opencode/commands/deploy.md` and documented it in `opencode/commands/README.md` for deployment readiness, rollout, and rollback planning.
-- **Persistent operational memory**: Added `.codex/napkin.md` as curated runbook memory for recurring execution guardrails and token-efficiency directives.
+The previous npm line ends at `1.19.1`. Detailed historical changes remain available in Git history and GitHub Releases.
 
-### Changed
-
-- **Branch safety enforcement**: Expanded branch-gate requirements to implementation workflows, OpenCode execute command, and implementer/subagent contracts to block implementation on `main`.
-- **PR approval policy for private repositories**: Added two-account approval flow with squash-default merge guidance in adoption runbooks.
-- **Validation pipeline coverage**: Added external HTTP link validation (`scripts/validate-links.mjs`) and integrated it into the unified `npm run validate` flow.
-- **Agent/skill routing clarity**: Added official agent-to-skill auto-load baseline and next-sprint action plan updates in runbooks and roadmap documentation.
-
-## [1.1.8] - 2026-05-08
-
-### Added
-
-- **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.
-
-### Changed
-
-- **OpenCode config routing**: Registered `start` command in `opencode.jsonc` pointing to planner with startup routing template.
-- **Prompt docs discoverability**: Updated `.codex/prompts/README.md` and `opencode/README.md` to document the new startup routing entrypoints.
-
-## [1.1.7] - 2026-05-08
-
-### Added
-
-- **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.
-- **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.
+## 2.1.0
 
 ### Changed
 
-- **Skill routing documentation**: Updated `AGENTS.md` to include `skill-creator` in specialist skills, usage guide, and routing quick map.
-
-## [1.1.6] - 2026-05-08
-
-### Changed
-
-- **README inventory accuracy**: Updated validation script count from 3 to 7 to reflect the current validation toolchain.
-- **ROADMAP clarity**: Renamed a stale subsection label from "Planned items" to "Planned and completed updates" where checklist items are mixed by design.
-
-## [1.1.5] - 2026-05-08
-
-### Added
-
-- **Workflow-state schema contract**: Added `.workflow-state.schema.json` and included it in repository structure validation.
-
-### Changed
-
-- **Schema validation coverage**: Updated `scripts/validate-schemas.mjs` to compile-check `.workflow-state.schema.json` in addition to existing workflow schemas.
-- **CI validation flow**: Simplified `.github/workflows/validate.yml` to run a single canonical `npm run validate` step.
-
-### Fixed
-
-- **AGENTS maturity table duplication**: Removed duplicated status rows in `AGENTS.md`.
-- **ROADMAP status drift**: Reconciled example and changelog completion markers in `ROADMAP.md` to reflect current repository state.
-
-## [1.1.4] - 2026-05-08
-
-### Added
-
-- **Subagent routing guide**: Added `subagents/README.md` with ownership boundaries, best-use routing, optimization rules, and a recommended handoff chain (`planner -> executor -> reviewer -> validator`).
-
-### Changed
-
-- **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.
-- **Top-level discoverability**: Updated `README.md` `subagents/` section to link to `subagents/README.md` for quick routing and handoff guidance.
-
-## [1.1.3] - 2026-05-08
-
-### Added
-
-- **Real-project validation runbook**: Added `runbooks/validate-starter-in-real-project.md` with adoption criteria, workflow proof steps, and common pitfalls.
-- **Quickstart (10 minutes)**: Added a fast-path onboarding section to `README.md` for first-value execution.
-- **Documentation consistency validation**: Added `scripts/validate-doc-consistency.mjs` and integrated it into `validate-all.mjs` as a new validation tier.
-- **Completed examples**: Finished full 6-file workflow artifacts for `examples/docs-only-repo/` and `examples/wordpress-theme/`.
-
-### Changed
-
-- **Project positioning text**: Updated key documents to present the repository as a **Workflow starter kit** while preserving `codex-repo-starter` technical identifier.
-- **Maturity status tables**: Updated examples status to `Complete (nuxt-dashboard, docs-only-repo, wordpress-theme)` in `README.md` and `AGENTS.md`.
-
-### Fixed
-
-- **Skill routing clarity**: Added quick routing maps and practical selection heuristics to reduce ambiguity when choosing primary vs supporting skills.
-
-## [1.1.2] - 2026-05-08
-
-### Fixed
-
-- **opencode.jsonc**: Replaced invalid top-level keys (`version`, `name`, `description`, `agents`, `commands`, `workflow`) with OpenCode schema keys (`agent`, `command`, `skills.paths`).
-- **OpenCode docs**: Updated README references to describe the validated OpenCode project config structure.
-
-## [1.1.1] - 2026-05-08
-
-### Added
-
-- **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.
-- **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.
-- **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.
-- **harness/README.md**: Added Workflow State Tracker section documenting phase order, rules, and usage.
-- **opencode/README.md**: Added Configuration section documenting `opencode.jsonc` experimental status and verification requirements.
-
-### Fixed
-
-- **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).
-- **README.md known gaps**: Removed stale "changelog" and "license decision" references; updated "executable validation" to reflect new cross-reference and workflow state checks.
-- **README.md next improvements**: Replaced outdated PR recommendations with schema validation and OpenCode config verification as top priorities.
-- **AGENTS.md next improvements**: Replaced completed items with genuine future work (schema validation, cross-reference checks, harness expansion, link validation, stack variants).
-- **opencode.jsonc**: Added informational comment noting that `$schema` reference is unverified and the configuration structure is experimental.
-- **All 6 schemas**: Removed `https://json-schema.org/draft/2020-12/schema` reference from `schemas/*.schema.json` — schemas are self-contained with `$id` only.
-
-### Changed
-
-- **validate-all.mjs**: Expanded from 3 to 6 validation tiers (Markdown, JSON, cross-refs, workflow state, schemas, structure).
-- **package.json**: Added `validate:refs`, `validate:workflow`, `validate:schemas` scripts; added `ajv` and `ajv-formats` dev dependencies.
-- **validate-structure.mjs**: Added `.workflow-state.json` to required paths (55 paths total).
-
-## [1.1.0] - 2024-05-07
-
-### Added
-
-- **License**: Added MIT LICENSE file for legal clarity
-- **OpenCode config**: Added `opencode.jsonc` with agent, command, and skill mappings
-- **CI workflow**: Added `.github/workflows/validate.yml` for automatic validation
-- **Compact commands**: Added 5 token-efficient command prompts in `prompts/commands/`:
-  - `requirement.md` (~47 lines) - Create requirement
-  - `spec.md` (~41 lines) - Create specification
-  - `tech-plan.md` (~41 lines) - Create technical plan
-  - `implement.md` (~42 lines) - Implement PR
-  - `validate.md` (~42 lines) - Validate PR
-
-### Changed
-
-- Updated `opencode.jsonc` to include `compact_commands` references
-- Reduced token usage by 87-92% for common workflow commands
-
-## [1.0.0] - 2024-05-05
-
-### Added
-
-- **Core structure**: Initial repository foundation
-- **Skills**: 15 specialist skills in `.agents/skills/`
-- **Prompts**: 10 ordered prompts in `prompts/00-09/`
-- **Codex entrypoints**: 4 compact prompts in `.codex/prompts/`
-- **OpenCode commands**: 5 commands in `opencode/commands/`
-- **OpenCode agents**: 11 agents in `opencode/agents/`
-- **Templates**: 7 reusable templates in `templates/`
-- **Runbooks**: 5 operational runbooks in `runbooks/`
-- **Schemas**: 6 JSON schemas in `schemas/`
-- **Example**: Nuxt dashboard workflow in `examples/`
-- **Validation**: Markdown, JSON, and structure validation scripts
-- **Documentation**: README.md, AGENTS.md, ROADMAP.md
-
----
-
-## Versioning strategy
-
-- **Major**: Breaking changes to workflow structure or skill contracts
-- **Minor**: New features (commands, skills, examples)
-- **Patch**: Documentation fixes, validation improvements
-
-## How to add changes
-
-When contributing changes:
-
-1. Add entry under `[Unreleased]` with date
-2. Categorize as `Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, `Security`
-3. Be specific about what changed and where
-4. Update version in header when releasing
-
-## Migration notes
-
-### 1.1.0 → 1.1.1
-
-- Run `npm install` to install `ajv` and `ajv-formats` dev dependencies
-- Validation now has 6 tiers — `npm run validate` runs cross-reference, workflow state, and schema checks in addition to previous checks
-- `.workflow-state.json` is optional — the repository validates without it
-- `opencode.jsonc` is marked experimental — verify configuration against a known OpenCode installation before production use
-
-### 1.0.0 → 1.1.0
-
-- New `opencode.jsonc` enables direct OpenCode integration
-- Use `prompts/commands/` for token-efficient workflow
-- CI now validates automatically on push/PR
-- All changes backwards compatible
+- Recovered the original product direction: proportionate workflows, useful software, and concise evidence.
+- Kept protected-branch enforcement, required validation execution, bounded remediation, and false-success prevention as non-negotiable guardrails.
+- Removed mandatory canonical response fields, owner JSON, fixed delivery filenames, and persisted evidence from quick/standard work.
+- Simplified Atlas to route and coordinate without forcing multi-agent ceremony.
+- Simplified QualityGuard to objective branch, validation, documentation, UI-evidence, and full-mode persistence checks.
+- Replaced keyword-driven Product Truthfulness enforcement with semantic guidance.