qualia-framework 5.5.0 → 5.8.0

package/skills/qualia-polish/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qualia-polish
-description: "Scope-adaptive design pass — works on a single component, a route, the whole app, or a ground-up redesign. Trigger on 'polish', 'design pass', 'fix the design', 'redesign', 'critique', 'audit design', 'looks ugly', 'make it look better'. Replaces both /qualia-polish and /qualia-design from earlier versions."
+description: "Scope-adaptive design pass. Works on a single component, a route, the whole app, a ground-up redesign, or an autonomous visual loop. Trigger on 'polish', 'design pass', 'fix the design', 'redesign', 'critique', 'audit design', 'looks ugly', 'make it look better', 'polish loop', 'visual loop', 'fix what I see', 'iterate on the design until it's correct'. Replaces /qualia-polish-loop (now /qualia-polish --loop) and /qualia-design from earlier versions."
 allowed-tools:
   - Bash
   - Read
@@ -9,12 +9,12 @@ allowed-tools:
   - Grep
   - Glob
   - Agent
-argument-hint: "[file|route|--redesign|--critique|--quick] [--register=brand|product]"
+argument-hint: "[file|route|--redesign|--critique|--quick|--loop] [--register=brand|product] [--brief PATH] [--max 8] [--viewports 375,768,1440]"
 ---
 
 # /qualia-polish — Scope-Adaptive Design Pass
 
-One command. Six scopes. Use it whenever you need design work — from a 30-second component touch-up to a 30-minute ground-up redesign.
+One command. Seven scopes. Use it whenever you need design work, from a 30-second component touch-up to a 30-minute ground-up redesign to a fully autonomous see-fix-verify loop.
 
 ## Scopes
 
@@ -28,8 +28,17 @@ The first argument selects the scope. Stage selection follows from scope.
 | `/qualia-polish --redesign` | **Redesign** | ~30m | all + Stage 1 mandatory + 2 vision iterations |
 | `/qualia-polish --critique` | **Critique** | read-only | 0, 4, 5 (no edits) |
 | `/qualia-polish --quick` | **Quick** | ~1m | 0, 2, 7 (gates only, no vision loop) |
+| `/qualia-polish --loop {url}` | **Loop** | ~5-15m | autonomous see/fix/verify, max 8 iterations |
 
-Other flags: `--register=brand|product` to override register inference.
+Other flags: `--register=brand|product` overrides register inference. Loop-specific flags: `--brief PATH`, `--max N`, `--viewports 375,768,1440`, `--ref PATH`, `--budget 100000`.
+
+## --loop mode (autonomous visual loop)
+
+When `--loop` is the first flag, the polish run is fully autonomous: screenshot a live URL at three viewports, score 8 design dimensions of `qualia-design/design-rubric.md` against the brief using vision, fix top issues in the codebase, re-screenshot, repeat until every dimension scores ≥ 3 or the kill-switch fires (regression, budget cap, max iterations).
+
+This is the surface formerly known as `/qualia-polish-loop` (consolidated into a flag in v5.8.0). The scripts ship at `skills/qualia-polish/scripts/{loop,playwright-capture,score}.mjs`; vision evaluator is `agents/visual-evaluator.md`; full loop spec lives in this skill's `REFERENCE.md`.
+
+When `--loop` is detected on entry, route to the loop process documented in `REFERENCE.md` and stop executing the standard stages below. The two paths share Stage 0 substrate gates and the rubric, but diverge from Stage 1 onward.
 
 ## Setup gates (non-optional, every scope)
 

package/skills/{qualia-polish-loop → qualia-polish}/scripts/loop.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * loop.mjs — orchestrator state-machine for /qualia-polish-loop.
+ * loop.mjs — orchestrator state-machine for /qualia-polish --loop.
  *
  * Claude (the parent session) drives the loop by issuing CLI commands. This
  * script keeps the deterministic state — iteration counter, regression
@@ -294,7 +294,7 @@ switch (cmd) {
   case "--help":
   case "-h":
   case undefined:
-    console.log(`loop.mjs — orchestrator for /qualia-polish-loop
+    console.log(`loop.mjs — orchestrator for /qualia-polish --loop
 
 Commands:
   init       --state PATH (--url URL | --routes URL1,URL2,...) [--brief PATH] [--ref PATH] [--max 8] [--budget 100000] [--reduced-motion]

package/skills/{qualia-polish-loop → qualia-polish}/scripts/playwright-capture.mjs

@@ -36,7 +36,7 @@ function parseArgs() {
     } else if (a === "--wait" && argv[i + 1]) args.wait = parseInt(argv[++i], 10);
     else if (a === "--reduced-motion") args.reducedMotion = true;
     else if (a === "--help" || a === "-h") {
-      console.log(`playwright-capture.mjs — Screenshot capture for /qualia-polish-loop
+      console.log(`playwright-capture.mjs — Screenshot capture for /qualia-polish --loop
 
 Usage:
   node playwright-capture.mjs --url <url> --out <dir> [--viewports 375,768,1440] [--wait 1500] [--reduced-motion]

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/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

@@ -1131,52 +1131,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-loop SKILL.md missing after install"
+  fail_case "qualia-polish SKILL.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"
+# 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 REFERENCE.md missing after install"
+  fail_case "qualia-polish REFERENCE.md missing after install"
 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"
+# 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 missing rubric reference"
+  fail_case "qualia-polish missing rubric reference"
 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"
+# 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 REFERENCE.md missing anchored rubric"
+  fail_case "qualia-polish REFERENCE.md missing anchored rubric"
 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"
+# 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 missing regression kill-switch"
+  fail_case "qualia-polish missing regression kill-switch"
+fi
+
+# 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 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 +1192,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 +1200,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 +1244,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 +1252,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 +1262,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 +1274,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 +1289,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 +1437,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 +1449,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 +1473,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 +1482,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 +1492,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 +1503,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 +1519,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 +1589,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"

package/tests/slop-detect.test.sh

@@ -121,8 +121,8 @@ else
   fail_case "gradient detection" "expected exit 1, got $EXIT_CODE"
 fi
 
-# ── Existing fixture: skills/qualia-polish-loop/fixtures/broken.html ──
-FIXTURE="$(cd "$(dirname "$0")/.." && pwd)/skills/qualia-polish-loop/fixtures/broken.html"
+# ── Existing fixture: skills/qualia-polish/fixtures/broken.html ──
+FIXTURE="$(cd "$(dirname "$0")/.." && pwd)/skills/qualia-polish/fixtures/broken.html"
 if [ -f "$FIXTURE" ]; then
   EXIT_CODE=0
   $NODE "$SLOP_DETECT" "$FIXTURE" >/dev/null 2>&1 || EXIT_CODE=$?