qualia-framework 5.5.0 → 5.9.0

package/skills/qualia-road/SKILL.md

@@ -45,23 +45,22 @@ Every road agent loads `PRODUCT.md + DESIGN.md + design-laws.md` substrate. Buil
 /qualia-polish --quick                       ~1m  gates only
 ```
 
-## /qualia-polish-loop -- autonomous visual QA (v5.1+, hardened in v5.2)
+## /qualia-polish --loop -- autonomous visual QA (v5.1+, consolidated into /qualia-polish in v5.8)
 ```
-/qualia-polish-loop http://localhost:3000                screenshot + eval + fix loop
-/qualia-polish-loop {url} --max 4                       cap iterations
-/qualia-polish-loop {url} --ref design.png              anchor to reference image
-/qualia-polish-loop {url} --reduced-motion              force prefers-reduced-motion (v5.2+)
-/qualia-polish-loop --routes /a,/b,/c                   multi-route sweep (v5.2+)
+/qualia-polish --loop http://localhost:3000               screenshot + eval + fix loop
+/qualia-polish --loop {url} --max 4                       cap iterations
+/qualia-polish --loop {url} --ref design.png              anchor to reference image
+/qualia-polish --loop {url} --reduced-motion              force prefers-reduced-motion
+/qualia-polish --loop --routes /a,/b,/c                   multi-route sweep
 ```
 Screenshots at 3 viewports (375/768/1440), scores 8 design dimensions using vision, fixes issues, re-screenshots, loops until all dims >= 3 or kill-switch triggers. Per-iteration git commits for clean revert.
 
-## v5.3+ skills (Matt Pocock gaps closed)
+## v5.3+ skills
 ```
-/qualia-prd            synthesize current conversation → .planning/PRD-{slug}.md (durable feature spec)
 /qualia-hook-gen       convert a CLAUDE.md/rules instruction into a deterministic pre-tool-use hook
-/qualia-optimize --deepen   now spawns 3 parallel interface-design variants per candidate (Step 5b)
+/qualia-optimize --deepen   spawns 3 parallel interface-design variants per candidate (Step 5b)
 ```
-`/qualia-prd` pairs with `/qualia-issues` to form the PRD → vertical-slice → execute loop. `/qualia-hook-gen` reduces lifetime token cost (each migrated rule frees ~50-200 tokens per request). `/qualia-optimize --deepen` produces dramatically better refactor RFCs because 3 radically-different interfaces are surfaced and the human picks/hybridizes.
+`/qualia-hook-gen` reduces lifetime token cost (each migrated rule frees ~50-200 tokens per request). `/qualia-optimize --deepen` produces dramatically better refactor RFCs because 3 radically-different interfaces are surfaced and the human picks/hybridizes.
 
 ## Alignment substrate (v5.0+)
 Before high-stakes phases, run alignment skills against `.planning/CONTEXT.md` (domain glossary) and `.planning/decisions/` (ADRs):
@@ -80,7 +79,7 @@ Before high-stakes phases, run alignment skills against `.planning/CONTEXT.md` (
 ```
 Lost?        → /qualia        (state router — tells you the next command)
 Stuck/weird? → /qualia-idk    (diagnostic — spawns plan-view + code-view agents in parallel)
-Quick fix?   → /qualia-quick  (skip planning for small tasks)
+Single feature? → /qualia-feature (auto-scoped: inline for trivia, fresh spawn for 1-5 files)
 Paused?      → /qualia-resume (restore from .continue-here.md or STATE.md)
 End of day?  → /qualia-report (mandatory before clock-out; writes ERP payload)
 Debug bug?   → /qualia-debug  (feedback-loop-first investigation)

package/skills/qualia-verify/SKILL.md

@@ -104,6 +104,22 @@ Append '## Adversarial Findings' to verification file. Empty section fine if not
 
 Findings merge into main report. Union PASS/FAIL: either pass found CRITICAL/HIGH → phase FAIL.
 
+### 2d. INSUFFICIENT EVIDENCE downgrade (mandatory)
+
+The verifier marks criteria it could not check (budget exhaustion, missing context) as `INSUFFICIENT EVIDENCE`. The orchestrator treats those as silent PASS unless explicitly downgraded — that's the #1 false-pass vector. Grep the verification file before declaring PASS:
+
+```bash
+IE_COUNT=$(grep -c "INSUFFICIENT EVIDENCE" .planning/phase-{N}-verification.md 2>/dev/null || echo 0)
+if [ "$IE_COUNT" -gt 0 ]; then
+  node ~/.claude/bin/qualia-ui.js warn "${IE_COUNT} criteria marked INSUFFICIENT EVIDENCE — downgrading verdict to FAIL"
+  # Rewrite the verdict line in-place
+  sed -i 's/^result: PASS$/result: FAIL/' .planning/phase-{N}-verification.md
+  sed -i 's/^## Verdict$/## Verdict\n\n**Downgraded to FAIL:** '"${IE_COUNT}"' criteria left unchecked. Re-run with larger budget (`max(25, tasks*5)` already applied) or simplify the phase plan./' .planning/phase-{N}-verification.md
+fi
+```
+
+The same check runs after the adversarial pass if it executed.
+
 ### 3. Present Results
 
 Read verification report. Present:

package/templates/help.html

@@ -374,9 +374,8 @@
       <h3>Quick Paths</h3>
       <p class="cmd-group-note">Lightweight alternatives when the full road is overkill.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-quick</span><span class="cmd-desc">Fast path for small tasks &mdash; bug fixes, tweaks, hot fixes. Skips full phase planning.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-task</span><span class="cmd-desc">Build a single task &mdash; more structured than /qualia-quick, lighter than /qualia-build. Spawns a fresh builder agent for one focused task.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-design</span><span class="cmd-desc">One-shot design transformation &mdash; critiques, fixes, polishes, hardens, makes responsive. No reports, no choices, just makes it professional.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-feature</span><span class="cmd-desc">Auto-scoped single-feature build. Inline for trivia (typo, config), fresh builder spawn for 1-5 file features. Refuses and routes to /qualia-plan for phase-sized work. Flags: --force-spawn, --force-inline.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Design pass, scope-adaptive &mdash; component, route, full app, redesign, critique, quick. Add --loop for the autonomous screenshot &rarr; score &rarr; fix loop.</span></div>
       </div>
     </div>
 

package/templates/project-discovery.md

@@ -0,0 +1,83 @@
+---
+project_type: {demo or full}
+discovered_at: {YYYY-MM-DD}
+discovery_mode: project
+---
+
+# Project Discovery, {Project Name}
+
+The non-technical kickoff interview output. `/qualia-discuss` writes this in PROJECT MODE before `/qualia-new` generates JOURNEY.md. Captures intent, audience, brand, and constraints in the user's own words.
+
+Demo path: 8 questions. Full-project path: 14 questions.
+
+## 1. The one-line pitch
+
+> {What is this thing, in one sentence a stranger would understand?}
+
+## 2. Who is it for
+
+> {Name three real humans who will use this. Not personas, real names plus their scenario.}
+
+## 3. The "remember 24 hours later" sentence
+
+> {What does someone remember 24 hours after first using this?}
+
+## 4. Three anti-references
+
+> {Three sites or apps this should NOT look like, with one-line reasons each.}
+
+## 5. Brand voice
+
+> {Three adjectives, then one paragraph of voice in motion — an error message, a confirmation, an empty state.}
+
+## 6. Success criterion
+
+> {How does the client know this worked? One observable outcome.}
+
+## 7. Hard constraints
+
+> {Anything that is non-negotiable: stack, deadline, compliance, integrations, budget.}
+
+## 8. Out of scope
+
+> {What is intentionally NOT in this project, even if it would be obvious to add.}
+
+---
+
+The remaining six questions only run for `project_type: full`. Demo mode stops here.
+
+## 9. Milestone arc, in the client's words
+
+> {After the demo, what's the next chapter? After that, what's the chapter after? Stop at three to five chapters total. The last chapter is always Handoff.}
+
+## 10. Compliance and legal
+
+> {Anything regulated: payments, medical, legal, finance, accessibility commitments, data residency.}
+
+## 11. Integrations
+
+> {Third-party systems this must talk to, in priority order.}
+
+## 12. Content and copy
+
+> {Who writes the copy and where does it live, today and after handoff?}
+
+## 13. Team and roles after handoff
+
+> {Who maintains this after we ship? What can they do, what can't they do?}
+
+## 14. Budget and timeline shape
+
+> {Fixed deadline, fixed scope, or fixed budget? Pick one — the other two flex.}
+
+---
+
+## How this feeds `/qualia-new`
+
+- §1-§5 seed PROJECT.md (one-line pitch, what we're building) and PRODUCT.md (users, register, voice, anti-references).
+- §6 becomes the first row of the success-criteria table in ROADMAP.md.
+- §7-§8 populate PROJECT.md's "Out of Scope" and the constraints section.
+- §9 (full only) seeds JOURNEY.md milestone names + "why now" lines.
+- §10-§14 (full only) feed research scoping and the Handoff milestone checklist.
+
+Demo projects skip §9-§14 because they ARE one milestone — the journey is just that milestone plus an implicit "client signs, we extend" branch handled by `/qualia-milestone`.

package/templates/project.md

@@ -1,8 +1,15 @@
+---
+project_type: full
+---
+
 # {Project Name}
 
 ## Client
 {client name}
 
+## Project Type
+{demo or full — demo is a single shippable milestone for a sales conversation; full is the multi-milestone arc to Handoff}
+
 ## What We're Building
 {description}
 

package/tests/bin.test.sh

@@ -719,18 +719,36 @@ else
   fail_case "research-synthesizer missing model frontmatter"
 fi
 
-# 64. Other agents do NOT have model frontmatter (conservative matrix)
-SAFE_AGENTS=("planner.md" "builder.md" "verifier.md" "plan-checker.md")
+# 64. v5.9 model tiering: structured agents (verifier, plan-checker, roadmapper,
+# qa-browser) use Sonnet. Real-reasoning agents (planner, builder, researcher,
+# visual-evaluator) keep inherited Opus.
+SONNET_AGENTS=("verifier.md" "plan-checker.md" "roadmapper.md" "qa-browser.md")
+OPUS_AGENTS=("planner.md" "builder.md" "researcher.md" "visual-evaluator.md")
+
 ALL_OK=1
-for a in "${SAFE_AGENTS[@]}"; do
+for a in "${SONNET_AGENTS[@]}"; do
+  if ! grep -q '^model: sonnet$' "$TMP/.claude/agents/$a" 2>/dev/null; then
+    ALL_OK=0
+    echo "    missing 'model: sonnet' in $a"
+  fi
+done
+if [ "$ALL_OK" = "1" ]; then
+  pass "structured agents (verifier/plan-checker/roadmapper/qa-browser) use sonnet (v5.9 tiering)"
+else
+  fail_case "v5.9 sonnet-tier agent has wrong model frontmatter"
+fi
+
+ALL_OK=1
+for a in "${OPUS_AGENTS[@]}"; do
   if grep -q '^model: ' "$TMP/.claude/agents/$a" 2>/dev/null; then
     ALL_OK=0
+    echo "    unexpected 'model:' in $a (should inherit Opus)"
   fi
 done
 if [ "$ALL_OK" = "1" ]; then
-  pass "high-stakes agents (planner/builder/verifier/plan-checker) keep default model"
+  pass "reasoning agents (planner/builder/researcher/visual-evaluator) inherit Opus"
 else
-  fail_case "high-stakes agent has unexpected model frontmatter"
+  fail_case "Opus-tier agent has unexpected model frontmatter"
 fi
 
 echo ""
@@ -1131,52 +1149,59 @@ fi
 echo ""
 echo "--- v5.0.0 (visual-polish loop addendum) ---"
 
-# 99. qualia-polish-loop SKILL.md installs
+# 99. qualia-polish SKILL.md installs (v5.8: polish-loop consolidated into --loop flag)
 TMP=$(mktmp)
 echo "QS-FAWZI-01" | HOME="$TMP" $NODE "$INSTALL_JS" >/dev/null 2>&1
-if [ -f "$TMP/.claude/skills/qualia-polish-loop/SKILL.md" ]; then
-  pass "qualia-polish-loop SKILL.md installs"
+if [ -f "$TMP/.claude/skills/qualia-polish/SKILL.md" ]; then
+  pass "qualia-polish SKILL.md installs"
+else
+  fail_case "qualia-polish SKILL.md missing after install"
+fi
+
+# 100. qualia-polish REFERENCE.md installs (carries the loop spec)
+if [ -f "$TMP/.claude/skills/qualia-polish/REFERENCE.md" ]; then
+  pass "qualia-polish REFERENCE.md installs"
 else
-  fail_case "qualia-polish-loop SKILL.md missing after install"
+  fail_case "qualia-polish REFERENCE.md missing after install"
 fi
 
-# 100. qualia-polish-loop REFERENCE.md installs
-if [ -f "$TMP/.claude/skills/qualia-polish-loop/REFERENCE.md" ]; then
-  pass "qualia-polish-loop REFERENCE.md installs"
+# 101. qualia-polish SKILL.md references the design rubric
+if grep -q "design-rubric.md" "$TMP/.claude/skills/qualia-polish/SKILL.md"; then
+  pass "qualia-polish references design-rubric.md"
 else
-  fail_case "qualia-polish-loop REFERENCE.md missing after install"
+  fail_case "qualia-polish missing rubric reference"
 fi
 
-# 101. qualia-polish-loop SKILL.md references the design rubric
-if grep -q "design-rubric.md" "$TMP/.claude/skills/qualia-polish-loop/SKILL.md"; then
-  pass "qualia-polish-loop references design-rubric.md"
+# 102. qualia-polish REFERENCE.md has the anchored vision eval prompt
+if grep -q "DEFAULT TO 3" "$TMP/.claude/skills/qualia-polish/REFERENCE.md"; then
+  pass "qualia-polish REFERENCE.md has anchored rubric prompt"
 else
-  fail_case "qualia-polish-loop missing rubric reference"
+  fail_case "qualia-polish REFERENCE.md missing anchored rubric"
 fi
 
-# 102. qualia-polish-loop REFERENCE.md has the anchored vision eval prompt
-if grep -q "DEFAULT TO 3" "$TMP/.claude/skills/qualia-polish-loop/REFERENCE.md"; then
-  pass "qualia-polish-loop REFERENCE.md has anchored rubric prompt"
+# 103. qualia-polish REFERENCE.md has regression detection (LOOP_REGRESSION_DETECTED)
+if grep -q "LOOP_REGRESSION_DETECTED" "$TMP/.claude/skills/qualia-polish/REFERENCE.md"; then
+  pass "qualia-polish has regression kill-switch"
 else
-  fail_case "qualia-polish-loop REFERENCE.md missing anchored rubric"
+  fail_case "qualia-polish missing regression kill-switch"
 fi
 
-# 103. qualia-polish-loop SKILL.md has regression detection (LOOP_REGRESSION_DETECTED)
-if grep -q "LOOP_REGRESSION_DETECTED" "$TMP/.claude/skills/qualia-polish-loop/SKILL.md"; then
-  pass "qualia-polish-loop has regression kill-switch"
+# 103b. qualia-polish SKILL.md documents the --loop flag
+if grep -q -- "--loop" "$TMP/.claude/skills/qualia-polish/SKILL.md"; then
+  pass "qualia-polish SKILL.md documents --loop flag"
 else
-  fail_case "qualia-polish-loop missing regression kill-switch"
+  fail_case "qualia-polish SKILL.md missing --loop documentation"
 fi
 
 # 104. score.mjs exists in the framework skill scripts
-if [ -f "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/score.mjs" ]; then
+if [ -f "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" ]; then
   pass "score.mjs exists in skill scripts"
 else
   fail_case "score.mjs missing from skill scripts"
 fi
 
 # 105. score.mjs computes pass correctly (all dims >= 3)
-SCORE_OUT=$(echo '{"typography":3,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/score.mjs" 2>&1)
+SCORE_OUT=$(echo '{"typography":3,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" 2>&1)
 EXIT=$?
 if [ "$EXIT" -eq 0 ] && echo "$SCORE_OUT" | grep -q '"pass": true'; then
   pass "score.mjs pass on all-3 scores"
@@ -1185,7 +1210,7 @@ else
 fi
 
 # 106. score.mjs computes fail correctly (one dim < 3)
-SCORE_OUT=$(echo '{"typography":2,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/score.mjs" 2>&1)
+SCORE_OUT=$(echo '{"typography":2,"color":3,"spatial":3,"layout":3,"shadow":3,"motion":3,"microcopy":3,"container":3}' | $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/score.mjs" 2>&1)
 EXIT=$?
 if [ "$EXIT" -eq 1 ] && echo "$SCORE_OUT" | grep -q '"pass": false'; then
   pass "score.mjs fail on dim < 3"
@@ -1193,38 +1218,38 @@ else
   fail_case "score.mjs fail computation" "exit=$EXIT"
 fi
 
-# 107. qualia-road references qualia-polish-loop
-if grep -q "qualia-polish-loop" "$TMP/.claude/skills/qualia-road/SKILL.md"; then
-  pass "qualia-road references qualia-polish-loop"
+# 107. qualia-road references the polish loop (now via --loop flag)
+if grep -qE "qualia-polish --loop|/qualia-polish --loop" "$TMP/.claude/skills/qualia-road/SKILL.md"; then
+  pass "qualia-road references /qualia-polish --loop"
 else
-  fail_case "qualia-road missing qualia-polish-loop reference"
+  fail_case "qualia-road missing /qualia-polish --loop reference"
 fi
 
 # 108. package.json version is 5.x (5.1+ accepted; v5.1 / v5.2 share the v5 line)
-if grep -qE '"5\.[1234]\.' "$FRAMEWORK_DIR/package.json"; then
+if grep -qE '"5\.([1-9]|[1-9][0-9])\.' "$FRAMEWORK_DIR/package.json"; then
   pass "package.json version is 5.x"
 else
   fail_case "package.json version not 5.x"
 fi
 
 # 109. loop.mjs installs (orchestrator)
-if [ -f "$TMP/.claude/skills/qualia-polish-loop/scripts/loop.mjs" ]; then
-  pass "qualia-polish-loop scripts/loop.mjs installs"
+if [ -f "$TMP/.claude/skills/qualia-polish/scripts/loop.mjs" ]; then
+  pass "qualia-polish scripts/loop.mjs installs"
 else
   fail_case "scripts/loop.mjs missing — install.js scripts/ subfolder copy broken"
 fi
 
 # 110. playwright-capture.mjs installs (capture helper)
-if [ -f "$TMP/.claude/skills/qualia-polish-loop/scripts/playwright-capture.mjs" ]; then
-  pass "qualia-polish-loop scripts/playwright-capture.mjs installs"
+if [ -f "$TMP/.claude/skills/qualia-polish/scripts/playwright-capture.mjs" ]; then
+  pass "qualia-polish scripts/playwright-capture.mjs installs"
 else
   fail_case "scripts/playwright-capture.mjs missing"
 fi
 
 # 111. fixtures/ subfolder installs (self-test pages)
-if [ -f "$TMP/.claude/skills/qualia-polish-loop/fixtures/clean.html" ] && \
-   [ -f "$TMP/.claude/skills/qualia-polish-loop/fixtures/broken.html" ]; then
-  pass "qualia-polish-loop fixtures/ installs (clean.html + broken.html)"
+if [ -f "$TMP/.claude/skills/qualia-polish/fixtures/clean.html" ] && \
+   [ -f "$TMP/.claude/skills/qualia-polish/fixtures/broken.html" ]; then
+  pass "qualia-polish fixtures/ installs (clean.html + broken.html)"
 else
   fail_case "fixtures/ subfolder not copied by install.js"
 fi
@@ -1237,7 +1262,7 @@ else
 fi
 
 # 113. loop.mjs parses as valid Node ESM
-EXIT=0; $NODE --check "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" 2>/dev/null || EXIT=$?
+EXIT=0; $NODE --check "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" 2>/dev/null || EXIT=$?
 if [ "$EXIT" -eq 0 ]; then
   pass "loop.mjs parses as valid Node ESM"
 else
@@ -1245,7 +1270,7 @@ else
 fi
 
 # 114. playwright-capture.mjs parses as valid Node ESM
-EXIT=0; $NODE --check "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/playwright-capture.mjs" 2>/dev/null || EXIT=$?
+EXIT=0; $NODE --check "$FRAMEWORK_DIR/skills/qualia-polish/scripts/playwright-capture.mjs" 2>/dev/null || EXIT=$?
 if [ "$EXIT" -eq 0 ]; then
   pass "playwright-capture.mjs parses as valid Node ESM"
 else
@@ -1255,7 +1280,7 @@ fi
 # 115. loop.mjs init creates a valid state file
 TMP_STATE=$(mktmp)/qpl-state.json
 mkdir -p "$(dirname "$TMP_STATE")"
-EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" init \
+EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" init \
   --state "$TMP_STATE" --url "http://localhost:3000" --max 4 --budget 50000 >/dev/null 2>&1 || EXIT=$?
 if [ "$EXIT" -eq 0 ] && [ -f "$TMP_STATE" ] && grep -q '"verdict": "pending"' "$TMP_STATE"; then
   pass "loop.mjs init creates valid state.json"
@@ -1267,7 +1292,7 @@ fi
 TMP_STATE2=$(mktmp)/qpl-kill.json
 TMP_EVAL=$(mktmp)/qpl-eval.json
 mkdir -p "$(dirname "$TMP_STATE2")" "$(dirname "$TMP_EVAL")"
-$NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" init \
+$NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" init \
   --state "$TMP_STATE2" --url "http://localhost:3000" --max 8 >/dev/null 2>&1
 # write 3 identical evals
 KILL_OK=true
@@ -1282,7 +1307,7 @@ for ITER in 1 2 3; do
   "pass": false
 }
 EOF
-  EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" record \
+  EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" record \
     --state "$TMP_STATE2" --eval "$TMP_EVAL" >/dev/null 2>&1 || EXIT=$?
   if [ "$ITER" -lt 3 ] && [ "$EXIT" -ne 1 ]; then KILL_OK=false; fi
   if [ "$ITER" -eq 3 ] && [ "$EXIT" -ne 3 ]; then KILL_OK=false; fi
@@ -1430,7 +1455,7 @@ fi
 
 # 128. package.json bumped to 5.x (5.1+ accepted; 5.2 is the v5.2 release)
 PKG_V=$($NODE -e 'console.log(require("'"$FRAMEWORK_DIR"'/package.json").version)')
-if echo "$PKG_V" | grep -qE "^5\.[1234]\."; then
+if echo "$PKG_V" | grep -qE "^5\.([1-9]|[1-9][0-9])\."; then
   pass "package.json version bumped to 5.x ($PKG_V)"
 else
   fail_case "package.json version not 5.x" "got=$PKG_V"
@@ -1442,7 +1467,7 @@ echo "--- v5.2.0 (polish-loop reliability) ---"
 # 129. loop.mjs init accepts --routes and stores the URL list
 TMP_S=$(mktmp)/qpl-routes.json
 mkdir -p "$(dirname "$TMP_S")"
-EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" init \
+EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" init \
   --state "$TMP_S" \
   --routes "http://x.test/a,http://x.test/b,http://x.test/c" \
   --max 4 >/dev/null 2>&1 || EXIT=$?
@@ -1466,7 +1491,7 @@ fi
 # 131. loop.mjs init accepts --reduced-motion and records it in state
 TMP_S2=$(mktmp)/qpl-rm.json
 mkdir -p "$(dirname "$TMP_S2")"
-EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" init \
+EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" init \
   --state "$TMP_S2" --url "http://x.test/" --reduced-motion >/dev/null 2>&1 || EXIT=$?
 if [ "$EXIT" -eq 0 ] && grep -q '"reduced_motion": true' "$TMP_S2"; then
   pass "loop.mjs init --reduced-motion records state.reduced_motion=true"
@@ -1475,7 +1500,7 @@ else
 fi
 
 # 132. playwright-capture.mjs accepts --reduced-motion (parses without error)
-EXIT=0; OUT=$($NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/playwright-capture.mjs" --help 2>&1) || EXIT=$?
+EXIT=0; OUT=$($NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/playwright-capture.mjs" --help 2>&1) || EXIT=$?
 if [ "$EXIT" -eq 0 ] && echo "$OUT" | grep -q -- "--reduced-motion"; then
   pass "playwright-capture.mjs --help documents --reduced-motion"
 else
@@ -1485,7 +1510,7 @@ fi
 # 133. loop.mjs init rejects when neither --url nor --routes given
 TMP_S3=$(mktmp)/qpl-nourl.json
 mkdir -p "$(dirname "$TMP_S3")"
-EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" init \
+EXIT=0; $NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" init \
   --state "$TMP_S3" --max 4 >/dev/null 2>&1 || EXIT=$?
 if [ "$EXIT" -eq 2 ]; then
   pass "loop.mjs init rejects missing --url/--routes (exit 2)"
@@ -1496,9 +1521,9 @@ fi
 # 134. loop.mjs report mentions multi-route when state.urls > 1
 TMP_S4=$(mktmp)/qpl-rep.json
 mkdir -p "$(dirname "$TMP_S4")"
-$NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" init \
+$NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" init \
   --state "$TMP_S4" --routes "http://a/,http://b/" >/dev/null 2>&1
-REP=$($NODE "$FRAMEWORK_DIR/skills/qualia-polish-loop/scripts/loop.mjs" report --state "$TMP_S4" 2>&1)
+REP=$($NODE "$FRAMEWORK_DIR/skills/qualia-polish/scripts/loop.mjs" report --state "$TMP_S4" 2>&1)
 if echo "$REP" | grep -q "URLs (2)"; then
   pass "loop.mjs report renders multi-route header"
 else
@@ -1512,27 +1537,32 @@ echo "--- v5.3.0 (Matt Pocock gaps: prd, hook-gen, parallel-interface) ---"
 TMP=$(mktmp)
 echo "QS-FAWZI-01" | HOME="$TMP" $NODE "$INSTALL_JS" >/dev/null 2>&1
 
-# 135. qualia-prd skill installs
-if [ -f "$TMP/.claude/skills/qualia-prd/SKILL.md" ]; then
-  pass "qualia-prd skill installs"
+# 135-137. /qualia-prd removed in v5.8.0 (was deprecated, overlapped /qualia-discuss).
+# Assert non-existence so the framework cannot accidentally re-ship it.
+if [ ! -f "$TMP/.claude/skills/qualia-prd/SKILL.md" ]; then
+  pass "qualia-prd removed (v5.8.0 cleanup)"
+else
+  fail_case "qualia-prd unexpectedly present after v5.8.0 removal"
+fi
+
+# v5.8.0: assert /qualia-quick + /qualia-task also removed (were deprecated in v5.7).
+if [ ! -f "$TMP/.claude/skills/qualia-quick/SKILL.md" ]; then
+  pass "qualia-quick removed (v5.8.0 cleanup)"
 else
-  fail_case "qualia-prd SKILL.md missing after install"
+  fail_case "qualia-quick unexpectedly present after v5.8.0 removal"
 fi
 
-# 136. qualia-prd description mentions PRD synthesis from conversation
-if grep -q "synthesize\|Synthesize" "$TMP/.claude/skills/qualia-prd/SKILL.md" \
-   && grep -q "/qualia-issues" "$TMP/.claude/skills/qualia-prd/SKILL.md"; then
-  pass "qualia-prd describes synthesis flow + pairs with /qualia-issues"
+if [ ! -f "$TMP/.claude/skills/qualia-task/SKILL.md" ]; then
+  pass "qualia-task removed (v5.8.0 cleanup)"
 else
-  fail_case "qualia-prd missing synthesis or /qualia-issues link"
+  fail_case "qualia-task unexpectedly present after v5.8.0 removal"
 fi
 
-# 137. qualia-prd documents fork-based token discipline
-if grep -qE "[Ff]orked subagent|fork.*subagent" "$TMP/.claude/skills/qualia-prd/SKILL.md" \
-   && grep -q "Token discipline" "$TMP/.claude/skills/qualia-prd/SKILL.md"; then
-  pass "qualia-prd documents fork-based synthesis (token discipline)"
+# v5.8.0: assert /qualia-feature is the canonical single-feature surface.
+if [ -f "$TMP/.claude/skills/qualia-feature/SKILL.md" ]; then
+  pass "qualia-feature installed (canonical single-feature surface)"
 else
-  fail_case "qualia-prd missing fork/token-discipline section"
+  fail_case "qualia-feature missing after install"
 fi
 
 # 138. qualia-hook-gen skill installs
@@ -1577,7 +1607,7 @@ fi
 
 # 143. package.json version is 5.x (5.1+ accepted; v5.3 is the v5.3 release)
 PKG_V=$($NODE -e 'console.log(require("'"$FRAMEWORK_DIR"'/package.json").version)')
-if echo "$PKG_V" | grep -qE "^5\.[1234]\."; then
+if echo "$PKG_V" | grep -qE "^5\.([1-9]|[1-9][0-9])\."; then
   pass "package.json version is 5.x ($PKG_V) — v5.3 accepted"
 else
   fail_case "package.json version not 5.x" "got=$PKG_V"