qfai 1.7.0 → 1.7.1

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

@@ -45,6 +45,13 @@ QFAI Skill Body (SSOT)
 
 Execute the TDD micro-cycle for each pending item in `test-list.md`, transitioning each through Red -> Green -> Refactor -> Done, producing tested production code aligned with the spec.
 
+## Visual Review Guard
+
+- Review rendered output, screenshot evidence, or HTML output before closing any UI-affecting item.
+- Read the DDP (Design Direction Pack) first whenever implementation touches UI or critique-driven behavior.
+- Read order: DDP -> Design Token -> UI Contract -> HTML Mock -> Flow.
+- If code intent and rendered output diverge, treat the rendered/HTML result as the blocking review input and reconcile before DONE.
+
 ## Non-goals
 
 - Writing spec artifacts (use `/qfai-sdd`).

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

@@ -49,6 +49,13 @@ This stage is complete only when all specs pass the minimum runtime contract:
 - DB objects needed for runtime are present (real DB or documented in-memory substitute).
 - Evidence is captured and validate can enforce it.
 
+## Visual Review Guard
+
+- Review rendered output, screenshot captures, or generated HTML for every UI-affecting slice; code-only inspection is insufficient.
+- Read the DDP (Design Direction Pack) first before comparing visuals or wiring critique outcomes into implementation.
+- Read order: DDP -> Design Token -> UI Contract -> HTML Mock -> Flow.
+- If rendered/HTML evidence disagrees with code intent, fix the rendered result before declaring completion.
+
 ## Definition of Done by fidelity level (Mandatory)
 
 - L1 (`skeleton`):

package/assets/init/.qfai/evidence/README.md

@@ -49,6 +49,36 @@ Recommended approach:
 
 When `uiFidelity` is present, keep all minimum fields above.
 
+### Render evidence bundle conventions
+
+When render capture is enabled, keep render metadata path-only and store artifacts on disk:
+
+- default bundle path: `.qfai/evidence/render.json`
+- default viewports: `desktop`, `mobile`
+- `uiFidelity.screens[].renders[]` is the normalized in-band source for validator/report use
+- captured entries require `imagePath` and `htmlPath`
+- skipped entries require `skippedReason`
+- failed entries require `error`
+
+Degraded mode is allowed:
+
+- if renderer setup is unavailable, record `status: "skipped"` with a concrete reason
+- do not inline screenshot bytes or HTML bodies into JSON
+- keep `prototyping.json` and `render.json` aligned by file path only
+
+```json
+{
+  "renderEvidence": {
+    "status": "skipped",
+    "requested": true,
+    "autogenEnabled": false,
+    "viewports": ["desktop", "mobile"],
+    "outputPath": ".qfai/evidence/render.json",
+    "reason": "render requested without autogen-ui-fidelity"
+  }
+}
+```
+
 Good example references:
 
 - Repository docs sample: `docs/examples/prototyping-ui-fidelity.good.json`