qfai 1.7.0 → 1.7.2

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`

package/assets/validators/designSlopPatterns.json

@@ -0,0 +1,56 @@
+[
+  {
+    "id": "SLP-01",
+    "category": "generic-shell",
+    "tier": 3,
+    "scopes": ["03_Story-Workshop.md", "05_Examples.md"],
+    "match": "\\b(generic dashboard|placeholder text|lorem ipsum)\\b",
+    "message": "Generic dashboard shell pattern detected",
+    "guidance": "Replace with domain-specific UI structure"
+  },
+  {
+    "id": "SLP-02",
+    "category": "stock-imagery",
+    "tier": 3,
+    "scopes": ["03_Story-Workshop.md", "05_Examples.md"],
+    "match": "\\b(stock photo|unsplash|placeholder image)\\b",
+    "message": "Stock imagery reference detected",
+    "guidance": "Use project-specific imagery or describe actual visual requirements"
+  },
+  {
+    "id": "SLP-03",
+    "category": "dark-pattern",
+    "tier": 3,
+    "scopes": ["03_Story-Workshop.md", "05_Examples.md"],
+    "match": "\\b(hidden fee|forced signup|trick question)\\b",
+    "message": "Potential dark pattern detected",
+    "guidance": "Replace with transparent, user-respecting interaction pattern"
+  },
+  {
+    "id": "SLP-04",
+    "category": "inconsistency",
+    "tier": 3,
+    "scopes": ["03_Story-Workshop.md", "05_Examples.md"],
+    "match": "\\b(inconsistent naming|mixed conventions)\\b",
+    "message": "Design inconsistency pattern detected",
+    "guidance": "Establish and follow consistent naming and convention guidelines"
+  },
+  {
+    "id": "SLP-05",
+    "category": "placeholder-copy",
+    "tier": 3,
+    "scopes": ["03_Story-Workshop.md", "05_Examples.md"],
+    "match": "\\b(Click here|TBD copy|placeholder label)\\b",
+    "message": "Placeholder copy detected in UI definition",
+    "guidance": "Replace with final, user-tested microcopy"
+  },
+  {
+    "id": "SLP-06",
+    "category": "accessibility-theater",
+    "tier": 3,
+    "scopes": ["03_Story-Workshop.md", "05_Examples.md"],
+    "match": "\\b(decorative alt text|aria-hidden on interactive)\\b",
+    "message": "Accessibility theater pattern detected",
+    "guidance": "Implement meaningful accessibility attributes following WCAG guidelines"
+  }
+]