# Changelog

## v0.16 - 2026-06-14

- Cited `docs/prototype-session-loop-convention.md` as the prototype-phase contract.
- Clarified that prototype build status is stored in the build-plan ledger and flow-tree manifest, not `tasks/todo.md`.

## v0.15 - 2026-06-13

- Added `design/prototype-build-plan-[topic].md` as the required prototype todo ledger produced by `$user-flow-map --prototype-build-plan`.
- Updated prototype build behavior to build only pending/needs-revision items, skip deferred/dropped items, and update build-plan plus flow-tree status after each build.

## v0.14 - 2026-06-13

- Moved prototype gates and source reads from pre-prototype `specs/` files to `design/` flow maps, UX variation plans, UI branch packets, and flow-tree manifests.
- Clarified that prototype output remains under `prototypes/` and consumes design-phase branch approval state before post-prototype specification work.

## v0.13 - 2026-06-12

- Standardized active pack and skill install guidance on `npx skillpacks install <pack-or-skill>` instead of agent-native `/pack install` or `$pack install` recommendations.

## v0.12 - 2026-06-11

- Added npm-aware install-route wording for product-testing recommendations while preserving Codex `$pack install ...` routes.

## v0.11 - 2026-06-10

- Converted the hand-authored alignment-page section to the generator-owned stub plus a bundled `ALIGNMENT-PAGE.md`; the page contract now follows the full shared convention (lifecycle states, central alignment index, section feedback, gate/feedback YAML, TTS, browser open) with the prototype-specific gates from the generator gate map.
- Kept the prototype-first timing rule (prototype files may be created before the alignment page; the page is required before downstream routing, UAT handoff, consolidation, spec updates, research updates, or task/roadmap changes) as bespoke prose beside the stub.

## v0.10 - 2026-06-06

- Added `specs/user-flow-*.md` as a preferred prototype input for screen ordering, route inventory, branches, states, failure/recovery paths, handoffs, and low-fidelity wireframe structure while preserving the existing UX/UI hard gate.

## v0.9 - 2026-06-05

- Changed alignment-page section feedback so the positive option is `emphasize` with `feedback: emphasize` and `requested_agent_action: add-weight-to-section`, making it a revision/weighting request instead of approval as-is.


## v0.8 - 2026-05-31

- Required alignment pages to use a top in-flow Table of Contents instead of sidebar navigation, and to avoid sticky/fixed bottom compile banners.
- Restored bottom `Compile Feedback YAML` aggregation while keeping local section feedback YAML controls under selected section feedback textareas.

## v0.7 - 2026-05-31

- Kept final `Compile Answers` at the bottom while moving feedback-only YAML display/copy controls under each selected section feedback textarea.
- Clarified that section thumbs up/down/clarify selections always reveal their own multiline feedback textarea even when the section also has gate-question inputs.

## v0.6 - 2026-05-31

- Added top-level `alignment_page` to feedback-only and final compiled YAML so agents can reopen the exact HTML review page.

## v0.5 - 2026-05-30

- Added feedback-only YAML alignment-page handling so section concerns and clarification requests can be sent before final gate answers.

## v0.4 - 2026-05-30

- Added product-path scope resolution that prefers non-archived `research/{slug}/` paths and active manifest paths before code or monorepo hints.
- Excluded `research/_archive/`, legacy `abandoned`, `archived`, `deferred`, `revisit_candidate`, and `promoted` paths from active target selection while preserving flat `research/*.md` compatibility.


## v0.0

- Archived previous skill contract.

## v0.3 - 2026-05-27

- Added a prototype-specific alignment gate after runnable artifacts are created and before UAT, consolidation, spec, research, or task routing.

## v0.2 - 2026-05-26

- Gate cross-pack routing recommendations on pack availability — recommend `$pack install <pack>` when the target pack is not enabled

## v0.1 - 2026-05-25

- Added research-quality alignment requirements covering claim/evidence/inference separation, no-context-loss HTML translation, evidence matrices, confidence/assumption registers, source coverage, and research completeness gates.
