qfai 1.8.8 → 1.8.10

package/README.md

@@ -18,11 +18,19 @@ The agent reads the repository, produces the required artifacts, and iterates un
 ## Release status
 
 - Release posture: runtime truthfulness is enforced.
-- Prototyping is UI-only and runs a single-thread evolution loop driven by
-  `qfai prototyping iterate --cycle <n>`, with deterministic stop conditions
-  (exit codes 0 continue / 64 convergence / 65 max-iterations / 2 input error).
+- Prototyping is UI-only and runs a multi-spec evolution loop driven by
+  `qfai prototyping iterate --cycle <n>`. The skill resolves every
+  UI-bearing spec in one invocation, freezes that set at cycle 0, and
+  iterates `cycle 0..9` (max 10 cycles) with deterministic stop conditions
+  (exit codes 0 continue / 64 convergence / 65 max-iterations /
+  66 license-verify failure / 2 input or lock drift).
 - Runtime observation is observed-only (no synthetic 200 / API / DB prototyping coverage).
-- Per-iter evidence is `screenshot.png` + `index.html` per declared screen plus a single `review.json` (4-axis ordinal, prose critique, anti-slop detection, pivot directive).
+- Per-iter evidence is a single `<screen>.review.json` per declared spec ×
+  screen pair (4-axis ordinal verdicts, 6 `*Feel` short-prose impressions
+  bounded to 200 words each, `layoutAntiPatternsDetected[]`,
+  `designMdViolations[]`, and `pivotDirective`). Reviewer-emitted
+  `<screen>.review.json` is the only per-cycle artifact — no `screenshot.png`,
+  `index.html`, or `interaction.json`.
 - Calibration SSOT is the calibration pack referenced by `calibrationRef.packPath`.
 
 ## Quick start
@@ -66,8 +74,8 @@ npx qfai report
     Use `npx qfai prototyping preflight --target-url <url>` for a focused
     prototyping preflight before the skill starts; it surfaces blocking
     `QFAI-DCON-*` design-contract issues alongside runtime assumptions and resolves a runnable Playwright CLI launcher.
-    Use `npx qfai prototyping iterate --cycle <n> --target-url <url>` to drive each cycle of the single-thread
-    evolution loop. Exit codes: 0 (continue), 64 (convergence), 65 (max-iterations), 2 (input error).
+    Use `npx qfai prototyping iterate --cycle <n> --target-url <url>` to drive each cycle of the multi-spec
+    evolution loop. Exit codes: 0 (continue), 64 (convergence), 65 (max-iterations), 66 (license-verify failure), 2 (input or lock drift).
     Traceability refs inside prototyping evidence must use repo-root-relative concrete artifact refs
     (for example `.qfai/specs/spec-0001/01_Spec.md#L3` or `.qfai/evidence/prototyping/iter-03/home.png`).
     Absolute paths are invalid. The same strict ref grammar is enforced for top-level and leaf evidence-bearing fields, including
@@ -132,10 +140,19 @@ QFAI includes a small set of custom skills (stored under `.qfai/assistant/skills
   in `.qfai/specs/_policies/03_Capabilities.md` before the row is accepted
   (`QFAI-TRIAGE-006`). Every `01_Spec.md` declares a lifecycle
   `Status: active | superseded | deprecated | removed` (`QFAI-STATUS-001..006`).
-- **qfai-prototyping**: Single-thread design evolution loop. One prototype iterated through up to
-  15 cycles of generate -> capture -> review with a 4-axis ordinal rubric, anti-slop detection,
-  prose critique, and explicit pivot permission. Stops deterministically when all four axes hit
-  `exceptional` (exit 64) or the iteration budget is exhausted (exit 65).
+- **qfai-prototyping**: Multi-spec parallel design evolution loop. Resolves
+  every UI-bearing spec in one invocation, freezes that set at cycle 0,
+  and iterates each `spec × screen` pair through up to 10 cycles
+  (`cycle 0..9`) of generate → capture → review with a 4-axis ordinal
+  rubric, 6 `*Feel` short-prose impressions (200-word bounded), explicit
+  layout anti-pattern detection (`lap-001..lap-008`), DESIGN.md token
+  violation detection, and explicit pivot permission. Stops
+  deterministically when every `spec × screen` pair satisfies the AND
+  convergence condition (all four ordinal axes `exceptional` AND
+  `layoutAntiPatternsDetected` empty AND `designMdViolations` empty)
+  (exit 64), when the 10-cycle budget is exhausted (exit 65), or when a
+  stock-photo source violates the cycle-0 frozen license catalog
+  (exit 66). Lock drift / input errors exit 2.
 - **qfai-atdd**: Implement acceptance tests driven by specs/scenarios.
 - **qfai-implement**: Unified TDD micro-cycle (Red/Green/Refactor) one test at a time using `test-list.md` as the execution ledger, including ledger status updates and exception closure.
 - **qfai-verify**: Run full-scan local quality gates (`validate --fail-on error`, `report`, repo gates) and produce reviewer-approved evidence under `.qfai/evidence/`.

package/assets/init/.qfai/assistant/agents/product-experience-architect.md

@@ -28,8 +28,9 @@ tools: [Read, Write, Edit, Glob, Grep, Bash]
 - .qfai/specs/spec-\*/09_delta.md
 - .qfai/specs/spec-\*/01_Spec.md
 - .github/instructions/principles.instructions.md
-- Exploration brief, reference pool, evaluation rubric, evaluator calibration, selected direction, finalized design system,
-  screen contracts, optional tokens, optional fallback HTML/CSS mock, and Mermaid flows
+- Root `DESIGN.md` (brand SSOT: front-matter tokens plus `# Brand Philosophy` body)
+- Reference pool framed as deviate-from inputs, screen contracts (`uiux/40_screen_contracts.md`), optional tokens, optional fallback HTML/CSS mock, and Mermaid flows
+- Evaluator axes are fixed in `core/prototyping/evaluatorReview.ts#ORDINAL_AXES` (information architecture / navigation flow / usability / functionality) and no longer authored as sidecar files
 - Runtime screenshots or rendered evidence when available
 
 ## Deliverables

package/assets/init/.qfai/assistant/skills/qfai-discussion/SKILL.md

@@ -32,47 +32,41 @@ Produce a unified 15-file discussion pack plus exploration-first UI sidecars so
 ## CRITICAL CONSTRAINTS (Read First)
 
 - Output path is fixed: `.qfai/discussion/discussion-YYYYMMDDhhmmssSSS/`.
-- Required fixed files (all 15 are mandatory) remain unchanged.
+- All 15 mandatory fixed files remain unchanged.
 - UI-bearing discussion packs may include `prototyping.yaml` as an optional recommendation artifact; non-ui discussion packs typically omit it.
-- Discussion completion requires `Disposition: open` count to be zero in `11_OQ-Register.md`.
+- Completion requires `Disposition: open` count to be zero in `11_OQ-Register.md`.
 - If UI requirements exist, behavior obligations are primary and HTML+CSS mock is optional fallback only.
 - Discussion is planner-first: do not select a single visual winner and do not finalize the design system here.
 - Use artifact files, not conversational summaries, as the downstream handoff.
 
 ## UI-bearing Canonical Sidecar Family
 
-UI-bearing packs must produce the following sidecars as primary truth:
+UI-bearing packs must produce, as primary truth: `uiux/40_screen_contracts.md`, `uiux/50_review_input_bundle.md`. They MUST also emit a draft brand SSOT at the **consuming-project root**:
 
-- `uiux/30_exploration_brief.md`
-- `uiux/31_reference_pool.md`
-- `uiux/32_design_anti_goals.md`
-- `uiux/40_screen_contracts.md`
-- `uiux/50_review_input_bundle.md`
+- `<consuming-project-root>/DESIGN.md` — brand SSOT consumed by `/qfai-sdd` (freezes its sha256 in `.qfai/contracts/design/DESIGN.md.lock.yaml`) and by `/qfai-prototyping` (iterates against locked tokens). Brand intent (product intent, brand signals, anti-goals, reference pool framed as deviate-from inputs) lives in front-matter + `# Brand Philosophy` body — no separate per-aspect sidecar.
 
 ## Required Process
 
 1. Run the core interview for concept, scope, stakeholders, and constraints.
 2. Run Inception Deck and include at least one Mermaid diagram.
-3. Run Story Workshop, capture user stories and user flows, and keep HTML+CSS mock as optional fallback only.
+3. Run Story Workshop, capture user stories and user flows; HTML+CSS mock is optional fallback only.
 4. Register source traceability and reference research in `04_Sources.md`.
 5. Capture scope, REQ, NFR, glossary, constraints, and policies.
 6. Run Example Mapping and capture `Example Seeds`.
 7. Update `11_OQ-Register.md`, resolve OQs until open count is zero, and move deferred items to `13_Deferred.md`.
 8. Generate the exploration-first sidecar family for UI-bearing targets.
-9. Generate `prototyping.yaml` only when the latest discussion pack is UI-bearing and an explicit prototyping recommendation is useful.
-10. Request review and record the Reviewer result.
+9. **Emit root `DESIGN.md` draft** for UI-bearing targets per `references/design-dna-intake.md`. Required when UI-bearing; skip otherwise.
+10. Generate `prototyping.yaml` only when the latest discussion pack is UI-bearing and an explicit prototyping recommendation is useful.
+11. Request review and record the Reviewer result.
 
 For UI-bearing targets, follow `references/design-dna-intake.md` while authoring the UI/UX sidecars. Keep this `SKILL.md` compact; put detailed interview prompts and examples in the reference file.
 
 ## UI-bearing Authoring Requirements
 
-- `30_exploration_brief.md` must define product intent, brand signals, and differentiation targets.
-- `31_reference_pool.md` must define exploration references with adopted points, rejected points, and copy risk — framed as **deviate-from** inputs (not imitate-this) for downstream `/qfai-prototyping` reviewer.
-- `32_design_anti_goals.md` must contain explicit anti-goals; this also feeds the global anti-slop pattern list consulted by the prototyping reviewer.
-- `50_review_input_bundle.md` must document review inputs for downstream skills.
-
-Evaluation axes are global constants (4-step ordinal: weak / acceptable /
-strong / exceptional) and are not authored as discussion sidecars.
+- Root `DESIGN.md` front-matter must define `brand` (name, archetype, voice), `audience` (emotion, do_not_look_like), and the full `visual.*` token tree (colors, typography, spacing, radius, shadow).
+- `# Brand Philosophy` body documents do/don't, brand signals, and exploration references framed as **deviate-from** inputs (not imitate-this) for the downstream `/qfai-prototyping` reviewer.
+- `40_screen_contracts.md` defines each screen contract per the template schema; `50_review_input_bundle.md` documents review inputs for downstream skills.
+- Evaluation axes are global constants (4-step ordinal: weak / acceptable / strong / exceptional) and are not authored as discussion sidecars.
 
 ## Completion Contract (Shared)
 
@@ -84,7 +78,7 @@ Before declaring completion, you MUST:
 - ensure `Disposition: open` count is zero in `11_OQ-Register.md`;
 - ensure every deferred item has full metadata in `13_Deferred.md`;
 - ensure `02_Inception-Deck.md` and `03_Story-Workshop.md` include Mermaid diagrams;
-- ensure the UI-bearing sidecar family is complete;
+- ensure the UI-bearing sidecar family is complete and the root `DESIGN.md` draft exists at the consuming-project root and parses as valid front-matter;
 - run `qfai validate --profile discussion --fail-on error` and fix discussion-owned findings;
 - avoid selecting a single visual winner in discussion artifacts.
 
@@ -92,15 +86,12 @@ Before declaring completion, you MUST:
 
 Reviewer checks must confirm:
 
-- the 15-file discussion pack is complete
-- `Disposition: open` count is zero in `11_OQ-Register.md`
-- the UI-bearing sidecar family is complete when the pack is UI-bearing
-- discussion stayed planner-first and did not choose a single visual winner
-- Drift Protocol is enforced
-- review policy is checked against `.qfai/assistant/steering/test-layers.md`
-- planning and coverage heuristics are signals, not gates
-- review findings end with `Status (PASS/REVISE)`
-- Reviewer result is explicit as `PASS` or `REVISE`
+- the 15-file discussion pack is complete; `Disposition: open` count is zero in `11_OQ-Register.md`;
+- the UI-bearing sidecar family is complete when the pack is UI-bearing;
+- discussion stayed planner-first and did not choose a single visual winner;
+- Drift Protocol is enforced; review policy is checked against `.qfai/assistant/steering/test-layers.md`;
+- planning and coverage heuristics are signals, not gates;
+- review findings end with `Status (PASS/REVISE)` and Reviewer result is explicit as `PASS` or `REVISE`.
 
 ## Sub-agent Delegation (MANDATORY)
 
@@ -108,9 +99,7 @@ Follow `.qfai/assistant/instructions/shared-skill-delegation-baseline.md`.
 
 ### Orchestrator Protocol (MUST)
 
-- do not self-approve
-- use artifact files as the handoff surface
-- integrate delegated outputs only after checking pack completeness
+- do not self-approve; use artifact files as the handoff surface; integrate delegated outputs only after checking pack completeness.
 
 ### Capability Probe (MUST)
 

package/assets/init/.qfai/assistant/skills/qfai-discussion/references/design-dna-intake.md

@@ -6,24 +6,54 @@ Use this reference only for UI-bearing discussion packs.
 
 - Brand personality: list 3-5 traits the product should express.
 - Audience emotion: define what users should feel after the primary task.
-- Category conventions: name the expected layout and interaction patterns for this market.
-- Differentiation targets: state what must feel unlike generic SaaS, generic shadcn, or direct competitors.
-- Anti-template constraints: name default visual patterns that must not survive into prototyping.
-- Reference strategy: collect competitor, adjacent, aspirational, template-seed, and anti-pattern references.
+- Category conventions: name the expected layout and interaction
+  patterns for this market.
+- Differentiation targets: state what must feel unlike generic SaaS or
+  direct competitors.
+- Anti-template constraints: name default visual patterns that must
+  not survive into prototyping.
+- Reference strategy: collect competitor, adjacent, aspirational,
+  template-seed, and anti-pattern references.
 
 ## Reference Rules
 
 - Treat templates as seeds, not winners.
 - Capture both adopted and rejected points for every reference.
-- Translate references into local product rules instead of copying visual surfaces.
+- Translate references into local product rules instead of copying
+  visual surfaces.
 - Record copy risk as `low`, `medium`, or `high`.
-- Record template usage policy as `none`, `reference-only`, or `implementation-seed`.
-
-## Output Mapping
-
-- Put product intent and brand signals in `30_exploration_brief.md`.
-- Put all reference decisions in `31_reference_pool.md` (deviate-from input, not imitate).
-- Put prohibited visual directions in `32_design_anti_goals.md` (also feeds reviewer anti-slop).
-
-Evaluation axes are global constants (4-step ordinal: weak / acceptable /
-strong / exceptional) and are not authored as discussion sidecars.
+- Record template usage policy as `none`, `reference-only`, or
+  `implementation-seed`.
+
+## Output Mapping (new SSOT path)
+
+The interview produces **one root `DESIGN.md`** at
+`<consuming-project-root>/DESIGN.md`. This file is the brand SSOT
+consumed by `/qfai-sdd` (which freezes its sha256) and by
+`/qfai-prototyping` (which iterates under its tokens).
+
+Map the interview answers into `DESIGN.md` as follows:
+
+- Brand personality → `brand.voice` (1..N short trait words) and the
+  `# Brand Philosophy` body.
+- Brand archetype → `brand.archetype`. Allowed values are the
+  8-archetype catalog in `design-md-brand-catalog.md`
+  (`minimal | bold | corporate | playful | organic | tech | elegant |
+casual`). Use `aesthetic_properties` from the catalog as defaults.
+- Audience emotion → `audience.emotion`.
+- Anti-template constraints + rejected references →
+  `audience.do_not_look_like` and the **Don't** subsection of the
+  `# Brand Philosophy` body.
+- Visual decisions (color, typography, radius, shadow) → the
+  `visual.*` token tree. Schema and validation rules live in
+  `.qfai/assistant/skills/qfai-prototyping/references/design-md-spec.md`.
+- Adopted reference points → the **Do** subsection of
+  `# Brand Philosophy`.
+
+For the schema (12 colors, 3 fonts, 4 radii, 3 shadows, 8 archetypes),
+read `qfai-prototyping/references/design-md-spec.md` and use the
+sample at `qfai-prototyping/templates/DESIGN.md.sample` as a starting
+shape.
+
+Evaluation axes are global constants (4-step ordinal: weak / acceptable
+/ strong / exceptional) and are not authored as discussion sidecars.

package/assets/init/.qfai/assistant/skills/qfai-discussion/references/discussion-artifact-rules.md

@@ -41,12 +41,10 @@ UI-bearing discussion packs may include `prototyping.yaml` as an optional recomm
 For UI-bearing packs, use:
 
 - `04_Sources.md` for trend translation and competitive reference registry
-- `uiux/30_exploration_brief.md`
-- `uiux/31_reference_pool.md`
-- `uiux/32_design_anti_goals.md`
+- `DESIGN.md` (root) — brand SSOT draft (front-matter + `# Brand Philosophy` body); `/qfai-sdd` Phase 0 freezes it into `.qfai/contracts/design/DESIGN.md.lock.yaml`
 - `uiux/40_screen_contracts.md`
 
-Discussion is exploration-first and must not choose a single visual winner or final design system. Those are downstream prototyping outputs.
+Discussion is exploration-first and must not choose a single visual winner or final design system. The brand decision is captured once in root `DESIGN.md`; downstream prototyping consumes the frozen tokens.
 
 ## `prototyping.yaml`
 

package/assets/init/.qfai/assistant/skills/qfai-discussion/references/ui-bearing-playbook.md

@@ -26,17 +26,12 @@ Use this file when `/qfai-discussion` needs the full UI-bearing decision logic.
 
 ## Sidecar Family SSOT
 
+For UI-bearing packs the brand SSOT is root `DESIGN.md` (drafted by
+`/qfai-discussion` and frozen by `/qfai-sdd` Phase 0 into
+`.qfai/contracts/design/DESIGN.md.lock.yaml`). The remaining sidecars are
+the screen-level UX inputs:
+
 - `uiux/00_index.md`
-- `uiux/10_implementation_strategy.md`
-- `uiux/11_design_taste_interview.md`
-- `uiux/12_design_system.md`
-- `uiux/20_design_eval_invariant.md`
-- `uiux/21_design_eval_trend_derived.md`
-- `uiux/22_design_eval_product_specific.md`
-- `uiux/23_design_eval_aggregate.md`
-- `uiux/24_design_eval_dynamic_overrides.md`
-- `uiux/30_option_comparison.md`
-- `uiux/31_selected_anchor_screen.md`
 - `uiux/40_screen_contracts.md`
 - `uiux/50_review_input_bundle.md`
 

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/14_Review-Request.md

@@ -35,10 +35,10 @@
   - Acceptance criteria are consistent with flows/state transitions
   - Security/operations risks are reflected in diagrams where relevant
 - Mermaid diagrams use ` ```mermaid ` fences only
-- Exploration brief completeness and differentiation clarity (when UI-bearing)
-- Reference pool freshness and translation quality (when UI-bearing)
-- Exploration rubric quality and evaluation traceability (when UI-bearing)
-- Evaluator calibration skepticism and blandness rejection quality (when UI-bearing)
+- Root `DESIGN.md` completeness and differentiation clarity (when UI-bearing)
+- Reference pool freshness and translation quality into `DESIGN.md` (when UI-bearing)
+- Evaluator scoring covers all four canonical UX axes — information architecture / navigation flow / usability / functionality, fixed in `core/prototyping/evaluatorReview.ts#ORDINAL_AXES` (when UI-bearing)
+- Evaluator critique skepticism and blandness rejection quality applied against the four axes (when UI-bearing)
 - Best-of-history handling and winner selection consistency (when UI-bearing)
 - Screen contract sufficiency and strong schema completeness (when UI-bearing)
 - Generic fallback risk — ensure no unreviewed generic/placeholder UI remains (when UI-bearing)
@@ -47,21 +47,17 @@
 
 ## Exploration Direction Consistency
 
-<!-- Required for UI-bearing packs. Verifies sidecar-family alignment. -->
+<!-- Required for UI-bearing packs. Verifies brand SSOT and sidecar alignment. -->
 
-- Exploration brief: verify `uiux/30_exploration_brief.md` defines product intent, must-preserve interactions, brand signals, and differentiation targets
-- Evaluation alignment: verify `uiux/33_exploration_rubric.md` and `uiux/34_evaluator_calibration.md` support skeptical evaluation and originality pressure
+- Brand SSOT: verify root `DESIGN.md` defines `brand`, `audience`, and `visual.*` tokens, and that `# Brand Philosophy` body documents product intent, must-preserve interactions, brand signals, and differentiation targets
+- Evaluator axes: confirm reviewers will score against the four canonical UX axes (information architecture / navigation flow / usability / functionality) — these are fixed in `core/prototyping/evaluatorReview.ts#ORDINAL_AXES` and no longer authored as sidecar files
 - History handling: verify `uiux/50_review_input_bundle.md` documents best-of-history comparison instead of latest-only preference
 
 ## Sidecar Artifact Review Scope
 
-<!-- Required for UI-bearing packs. Reviews uiux/ sidecar artifacts. -->
+<!-- Required for UI-bearing packs. Reviews root DESIGN.md + uiux/ sidecar artifacts. -->
 
-- Verify exploration sidecars are present and complete (`30` to `34`, `40`, `50`)
-- Verify `uiux/30_exploration_brief.md` is specific enough to support divergent exploration
-- Verify `uiux/31_reference_pool.md` documents adopted, rejected, and locally translated references
-- Verify `uiux/33_exploration_rubric.md` weights design quality and originality explicitly
-- Verify `uiux/34_evaluator_calibration.md` contains good-critique / too-lenient / blandness-fail / originality-fail examples
+- Verify root `DESIGN.md` is specific enough to support divergent exploration (front-matter populated, `# Brand Philosophy` body written, do/don't and reference notes framed as deviate-from inputs)
 - Verify `uiux/50_review_input_bundle.md` preserves best-of-history handling
 - Verify screen contracts use nested strong schema with all 4 required states (default/loading/empty/error) and treat `uiux/40_screen_contracts.md` as the state SSOT
 

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/00_index.md

@@ -6,27 +6,30 @@ Manifest of all UI/UX sidecar artifacts produced during a UI-bearing discussion.
 
 ## File Inventory
 
-| File                        | Purpose                                      | Required |
-| --------------------------- | -------------------------------------------- | -------- |
-| 00_index.md                 | This manifest                                | Yes      |
-| 30_exploration_brief.md     | Exploration brief and design intent          | Yes      |
-| 31_reference_pool.md        | Exploration references and local translation | Yes      |
-| 32_design_anti_goals.md     | Anti-goals and recurrence prevention         | Yes      |
-| 33_exploration_rubric.md    | Evaluator rubric                             | Yes      |
-| 34_evaluator_calibration.md | Evaluator calibration examples               | Yes      |
-| 40_screen_contracts.md      | Screen interaction contracts (11 fields)     | Yes      |
-| 50_review_input_bundle.md   | Review input bundle                          | Yes      |
+Brand-level intent (product intent, brand signals, anti-goals,
+reference pool framed as deviate-from inputs) lives in root
+`DESIGN.md` (front-matter + `# Brand Philosophy` body), not in this
+sidecar family.
+
+| File                      | Purpose                                  | Required |
+| ------------------------- | ---------------------------------------- | -------- |
+| 00_index.md               | This manifest                            | Yes      |
+| 40_screen_contracts.md    | Screen interaction contracts (11 fields) | Yes      |
+| 50_review_input_bundle.md | Review input bundle                      | Yes      |
 
 ## Completeness Rule
 
-All required files (8 files) MUST be present for a UI-bearing pack. Partial generation is not permitted (BR-0026-0002).
+All required files MUST be present for a UI-bearing pack alongside root
+`DESIGN.md`. Partial generation is not permitted.
 
 ## Forbidden Legacy Files
 
 The following files are NOT part of the canonical family and must NOT be created in new packs:
 
-- `30_option_comparison.md` — replaced by `30_exploration_brief.md`
-- `31_selected_anchor_screen.md` — replaced by `31_reference_pool.md` + `selected-direction.yaml`
+- `30_option_comparison.md` — replaced by root `DESIGN.md`
+- `31_selected_anchor_screen.md` — replaced by root `DESIGN.md`
+- `33_exploration_rubric.md` — replaced by `core/prototyping/evaluatorReview.ts#ORDINAL_AXES`
+- `34_evaluator_calibration.md` — replaced by `core/prototyping/evaluatorReview.ts#ORDINAL_AXES`
 - `40_contracts.md` — replaced by `40_screen_contracts.md`
 - `50_review_bundle.md` — replaced by `50_review_input_bundle.md`
 - `60_critique_loop.md` — removed (critique integrated into review bundle)

package/assets/init/.qfai/assistant/skills/qfai-discussion/templates/uiux/50_review_input_bundle.md

@@ -6,27 +6,23 @@ Consolidate all sidecar artifacts into a review-ready bundle for design reviewer
 
 ## Bundle Contents
 
-| Artifact                   | Path                               | Status                    |
-| -------------------------- | ---------------------------------- | ------------------------- |
-| Exploration brief          | `uiux/30_exploration_brief.md`     | [draft/reviewed/approved] |
-| Reference pool             | `uiux/31_reference_pool.md`        | [draft/reviewed/approved] |
-| Design anti-goals          | `uiux/32_design_anti_goals.md`     | [draft/reviewed/approved] |
-| Exploration rubric         | `uiux/33_exploration_rubric.md`    | [draft/reviewed/approved] |
-| Evaluator calibration      | `uiux/34_evaluator_calibration.md` | [draft/reviewed/approved] |
-| Screen contracts           | `uiux/40_screen_contracts.md`      | [draft/reviewed/approved] |
-| Prototyping recommendation | `../prototyping.yaml`              | [draft/reviewed/approved] |
+| Artifact                   | Path                          | Status                    |
+| -------------------------- | ----------------------------- | ------------------------- |
+| Brand SSOT (root)          | `DESIGN.md`                   | [draft/reviewed/approved] |
+| Screen contracts           | `uiux/40_screen_contracts.md` | [draft/reviewed/approved] |
+| Prototyping recommendation | `../prototyping.yaml`         | [draft/reviewed/approved] |
 
 ## Trend-derived review focus
 
 - Required references are all present and complete.
 - Stale / overused AI slop patterns are explicitly avoided.
-- Reference research is translated into exploration and evaluator calibration inputs.
+- Reference research is translated into local design decisions on root `DESIGN.md` and screen contracts.
 - Later iterations are not automatically preferred over stronger middle iterations.
 
 ## Review Checklist
 
-- [ ] Exploration brief aligns with surface type and project constraints
+- [ ] Root `DESIGN.md` aligns with surface type and project constraints
 - [ ] Reference pool is complete and translated into local design decisions
-- [ ] Evaluator calibration includes skeptical critique examples
+- [ ] Evaluator scoring covers all four canonical UX axes (information architecture / navigation flow / usability / functionality) — fixed in `core/prototyping/evaluatorReview.ts#ORDINAL_AXES`
 - [ ] Best-of-history handling is explicit
 - [ ] Screen contracts cover all required states

package/assets/init/.qfai/assistant/skills/qfai-implement/SKILL.md

@@ -33,19 +33,13 @@ QFAI Skill Body (SSOT)
 
 ## Spec Auto-Discovery Protocol
 
-When no explicit argument is given, detect the candidate spec and constrain execution to one spec only.
-
-### One-Spec-at-a-Time Guarantee
-
-- Auto-discovery selects at most one spec for this run.
-- This protocol does NOT enable multi-spec parallel execution.
-- If multiple candidate specs are detected, do not start implementation until the user selects exactly one spec.
+When no explicit argument is given, detect the candidate spec and constrain execution to one spec only. Auto-discovery selects at most one spec; this protocol does NOT enable multi-spec parallel execution.
 
 ### User Selection Flow
 
-- Single spec detected: announce the detected spec and ask for confirmation when scope is ambiguous.
-- Multiple specs detected: display the candidates and require the user to choose one spec.
-- Zero specs detected: stop and ask the user to provide the target spec explicitly.
+- Single spec: announce the detected spec; ask for confirmation when scope is ambiguous.
+- Multiple specs: display the candidates and require the user to choose one spec.
+- Zero specs: stop and ask the user to provide the target spec explicitly.
 
 ## User Questions (AskUserQuestion Protocol)
 
@@ -75,20 +69,10 @@ Execute the TDD micro-cycle for each pending item in `test-list.md`, transitioni
 ## Visual Review Guard
 
 - Review rendered output, screenshot evidence, or HTML output before closing any UI-affecting item.
-- Read spec + contract inputs first whenever implementation touches UI or critique-driven behavior.
-- Read order: `01_Spec.md` → `03_Acceptance-Criteria.md` → `05_Examples.md` →
-  `.qfai/contracts/design/exploration-brief.yaml` →
-  `.qfai/contracts/design/reference-pool.yaml` → `.qfai/contracts/design/brand-design.yaml` →
-  `.qfai/contracts/design/design-system.yaml` (extracted from final iter) →
-  `.qfai/contracts/design/prototype-handoff.yaml` → `.qfai/contracts/ui/*.yaml` →
-  canonical prototype evidence under `.qfai/evidence/prototyping/iter-NN/<screen>.{png,html}` →
-  `.qfai/prototypes/final/index.html`.
+- Read spec + contract inputs first whenever implementation touches UI or critique-driven behavior. Read order: `01_Spec.md` → `03_Acceptance-Criteria.md` → `05_Examples.md` → root `DESIGN.md` → `.qfai/contracts/design/DESIGN.md.lock.yaml` → `.qfai/contracts/design/design-system.yaml` (post-loop token mirror) → `.qfai/contracts/design/prototype-handoff.yaml` → `.qfai/contracts/ui/*.yaml` → `.qfai/evidence/prototyping/iter-NN/<screen>.{png,html}` → `.qfai/prototypes/final/index.html`.
 - Do not read discussion-pack UI/UX sidecars or fallback mocks.
-- Prototype HTML is analysis input, not production source. Reimplement with project-native
-  patterns while preserving the visual identity captured in `prototype-handoff.yaml`
-  `implementationNotes` (free-form prose).
-- UI-affecting items require product-surface-reviewer prototype parity review before `done`.
-- If code intent and rendered output diverge, treat the rendered/HTML result as the blocking review input and reconcile before DONE.
+- Prototype HTML is analysis input, not production source. Reimplement with project-native patterns while preserving the visual identity captured in `prototype-handoff.yaml` `implementationNotes` (free-form prose).
+- UI-affecting items require product-surface-reviewer prototype parity review before `done`. If code intent and rendered output diverge, treat the rendered/HTML result as the blocking review input and reconcile before DONE.
 
 ## Non-goals