qfai 1.8.3 → 1.8.4

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

@@ -30,8 +30,8 @@ Do not rely on a CLI entrypoint or package runtime loop.
 ## CRITICAL CONSTRAINTS (Read First)
 
 - Scope is all specs from `.qfai/specs/spec-*`.
-- The AI evaluator sub-agent performs visual evaluation. QFAI does not score visual quality. (spec-0012)
-- Playwright CLI (`playwright-cli`) is the sole standard browser tool. Playwright MCP, Node Playwright direct invocation, and screenshot-capture shell scripts are not used. (spec-0012)
+- The AI evaluator sub-agent performs visual evaluation. QFAI does not score visual quality. (per the resolved primary prototyping spec — see `qfai prototyping show-spec`)
+- Playwright CLI (`playwright-cli`) is the sole standard browser tool. Playwright MCP, Node Playwright direct invocation, and screenshot-capture shell scripts are not used. (per the resolved primary prototyping spec)
 - QFAI pre-assigns evidence paths. The evaluator MUST use the paths in the command plan (`review-bundle.json` → `command-plans.json`); it MUST NOT invent paths.
 - For every declared screen and every active candidate in every round, 4 evidence artifacts are mandatory:
   - screenshot: `.qfai/evidence/prototyping/rounds/<round>/candidates/<candidate-id>/<screen-id>.png`
@@ -42,7 +42,7 @@ Do not rely on a CLI entrypoint or package runtime loop.
 - Canonical latest HTML path: `.qfai/evidence/prototyping/html/<screen-id>.html`
 - Canonical latest paths MUST mirror the latest accepted winner/polish artifacts.
 - If any of the 4 artifacts is missing for a declared screen, the round is incomplete; rerun is mandatory, not waiver.
-- Mode differences are limited to `maxCycles` only (low-cost=1, standard=3, full-harness=20). Every other gate, obligation, reviewer severity, and completion criterion is identical across modes. (spec-0012)
+- Mode differences are limited to `maxCycles` only (low-cost=1, standard=3, full-harness=20). Every other gate, obligation, reviewer severity, and completion criterion is identical across modes. (per the resolved primary prototyping spec)
 - DONE is forbidden until `qfai validate --profile prototyping --fail-on error` passes and `/qfai-verify` can approve the run.
 - Supported UI prototyping surfaces are `web`, `mobile`, `desktop`, and `mixed`.
 - `cli`, API-only, backend-only, and `ui_bearing: false` classifications are not prototyping execution targets.
@@ -60,7 +60,7 @@ Generate multiple design directions, converge on a winner, extract the selected
 ## Surface / Mode
 
 - surface / mode routing uses `standard` as the default execution path.
-- **Mode Invariant (spec-0012)**: modes differ only by `maxCycles`. Review gate, evidence requirements, reviewer severity, best-of-history, breakthrough detection, and completion criteria are identical across modes.
+- **Mode Invariant**: modes differ only by `maxCycles`. Review gate, evidence requirements, reviewer severity, best-of-history, breakthrough detection, and completion criteria are identical across modes.
   - `low-cost`: `maxCycles = 1`
   - `standard`: `maxCycles = 3` (default)
   - `full-harness`: `maxCycles = 20`
@@ -70,7 +70,12 @@ Generate multiple design directions, converge on a winner, extract the selected
 
 Read and follow these references before execution:
 
-- `.qfai/specs/spec-0012/01_Spec.md` — primary SSOT for the prototyping harness
+- **Primary SSOT for the prototyping harness**: resolve at runtime by running
+  `qfai prototyping show-spec` from the repo root. The output gives you the
+  resolved spec ID and `01_Spec.md` path (configured via
+  `qfai.config.yaml: prototyping.primarySpecId`, or auto-detected via the
+  `surface_type: ui-bearing` marker in `01_Spec.md`). Do not assume any
+  particular spec ID exists — read whatever `show-spec` returns.
 - `.qfai/assistant/skills/qfai-prototyping/references/evidence-requirements.md`
 - `.qfai/assistant/skills/qfai-prototyping/references/iteration-cycle.md`
 - `.qfai/assistant/skills/qfai-prototyping/references/l1-review-guide.md`
@@ -161,7 +166,7 @@ Before launching the evaluator, prepare the round-scoped artifacts via QFAI (not
 - QFAI produces:
   - `.qfai/evidence/prototyping/rounds/<rN>/command-plans.json` — the candidate-aware Playwright CLI command plans
   - `.qfai/evidence/prototyping/rounds/<rN>/review-bundle.json` — the evaluator input bundle (candidates, axisDefs, designSystemChecklist, commandPlanRef)
-- Do not invent evidence paths. Paths are fixed by QFAI per spec-0012.
+- Do not invent evidence paths. Paths are fixed by QFAI per the resolved primary prototyping spec.
 
 ### Step 5 — AI Evaluator Executes the Command Plans and Captures Evidence
 
@@ -220,7 +225,7 @@ At least one full post-selection polish loop is mandatory. Each polish loop must
 
 ## Cycle Gate
 
-- Completion requires at least one `polish` cycle after winner selection (spec-0012). This applies to all modes.
+- Completion requires at least one `polish` cycle after winner selection (per the resolved primary prototyping spec). This applies to all modes.
 - The same gate applies in every mode; modes differ only in `maxCycles` (low-cost=1, standard=3, full-harness=20).
 - If the polish-cycle budget is exhausted before the gate is satisfied, the run does NOT complete. The evaluator returns `REVISE` and the developer may re-run at a higher mode.
 - Any phase transition to completion must pass through the cycle gate and the reviewer gate.

package/assets/init/.qfai/assistant/skills/qfai-prototyping/references/evidence-requirements.md

@@ -47,7 +47,7 @@ Optional evidence is not allowed.
 
 ## Mode invariant
 
-Evidence requirements are identical for all modes (low-cost / standard / full-harness) per spec-0012. Modes differ only by `maxCycles` (1 / 3 / 20). Choosing a lower mode does NOT reduce evidence obligations.
+Evidence requirements are identical for all modes (low-cost / standard / full-harness) per the resolved primary prototyping spec (run `qfai prototyping show-spec` to see which one applies). Modes differ only by `maxCycles` (1 / 3 / 20). Choosing a lower mode does NOT reduce evidence obligations.
 
 ## Validate gate expectations
 

package/assets/init/.qfai/assistant/skills/qfai-prototyping/references/reviewer-gate.md

@@ -1,6 +1,6 @@
 # Reviewer Gate
 
-The reviewer is an independent gate, not the implementation author. The reviewer gate applies identically to all modes (spec-0012); modes differ only in `maxCycles`.
+The reviewer is an independent gate, not the implementation author. The reviewer gate applies identically to all modes (per the resolved primary prototyping spec); modes differ only in `maxCycles`.
 
 ## Reviewer must verify
 

package/assets/init/.qfai/assistant/skills/qfai-sdd/templates/contracts/evaluation-rubric.sample.yaml

@@ -22,6 +22,8 @@ hard_floors:
     min_score: 80
   - id: conceptFit
     min_score: 85
+  - id: originality
+    min_score: 80
 absorbable_categories:
   - layout
   - interaction

package/assets/init/.qfai/contracts/ui/README.md

@@ -125,9 +125,7 @@ screens:
 
 ## Example
 
-- Copy-ready repository sample:
-  `docs/examples/ui-contract.good.yaml`
-- Also available from prototyping skill template:
+- Copy-ready sample bundled with this package:
   `../../assistant/skills/qfai-prototyping/templates/contracts/ui-0001-order-mockable.yaml`
 
 ## FAQ (Typical failures)