qualia-framework 2.4.4 → 2.4.8

package/README.md

@@ -32,7 +32,7 @@ npx github:Qualiasolutions/qualia-framework verify
 - `~/.claude/hooks/` — 13 hook scripts (pre-commit, deploy gate, etc.)
 - `~/.claude/agents/` — 19 agent definitions
 - `~/.claude/rules/` — Security, frontend, deployment, speed rules
-- `~/.claude/qualia-engine/` — Workflow engine
+- `~/.claude/qualia-framework/` — Workflow engine
 - `~/.claude/knowledge/` — Shared knowledge base
 - `~/.claude/CLAUDE.md` — Personalized to your role
 - `~/.claude/settings.json` — Merged with your existing config

package/bin/cli.js

@@ -458,7 +458,7 @@ async function runUpdate() {
   }
 
   // Clean up removed directories from old versions
-  for (const stale of ['commands', 'config', 'core']) {
+  for (const stale of ['commands', 'config', 'core', 'qualia-engine']) {
     const p = path.join(CLAUDE_DIR, stale);
     if (fs.existsSync(p)) {
       fs.rmSync(p, { recursive: true, force: true });

package/framework/agents/qualia-debugger.md

@@ -983,7 +983,7 @@ mv .planning/debug/{slug}.md .planning/debug/resolved/
 **Check planning config using state load (commit_docs is available from the output):**
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state load)
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state load)
 # commit_docs is in the JSON output
 ```
 

package/framework/agents/qualia-executor.md

@@ -20,7 +20,7 @@ Your job: Execute the plan completely, commit each task, create SUMMARY.md, upda
 Load execution context:
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init execute-phase "${PHASE}")
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init execute-phase "${PHASE}")
 ```
 
 Extract from init JSON: `executor_model`, `commit_docs`, `phase_dir`, `plans`, `incomplete_plans`.
@@ -298,7 +298,7 @@ No user permission needed for Rules 1-3.
 Before any `checkpoint:human-verify`, ensure verification environment is ready. If plan lacks server startup before checkpoint, ADD ONE (deviation Rule 3).
 
 For full automation-first patterns, server lifecycle, CLI handling:
-**See @/home/qualia/.claude/qualia-engine/references/checkpoints.md**
+**See @/home/qualia/.claude/qualia-framework/references/checkpoints.md**
 
 **Quick reference:** Users NEVER run CLI commands. Users ONLY visit URLs, click UI, evaluate visuals, provide secrets. Claude does all automation.
 
@@ -722,7 +722,7 @@ git commit -m "{type}({phase}-{plan}): {concise task description}
 <summary_creation>
 After all tasks complete, create `{phase}-{plan}-SUMMARY.md` at `.planning/phases/XX-name/`.
 
-**Use template:** @/home/qualia/.claude/qualia-engine/templates/summary.md
+**Use template:** @/home/qualia/.claude/qualia-framework/templates/summary.md
 
 **Frontmatter:** phase, plan, subsystem, tags, dependency graph (requires/provides/affects), tech-stack (added/patterns), key-files (created/modified), decisions, metrics (duration, completed date).
 
@@ -844,7 +844,7 @@ Progress: [progress bar]
 
 <final_commit>
 ```bash
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs({phase}-{plan}): complete [plan-name] plan" --files .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .planning/STATE.md
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs({phase}-{plan}): complete [plan-name] plan" --files .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .planning/STATE.md
 ```
 
 Separate from per-task commits — captures execution results only.

package/framework/agents/qualia-plan-checker.md

@@ -396,7 +396,7 @@ issue:
 
 Load phase operation context:
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init phase-op "${PHASE_ARG}")
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "${PHASE_ARG}")
 ```
 
 Extract from init JSON: `phase_dir`, `phase_number`, `has_plans`, `plan_count`.
@@ -405,7 +405,7 @@ Orchestrator provides CONTEXT.md content in the verification prompt. If provided
 
 ```bash
 ls "$phase_dir"/*-PLAN.md 2>/dev/null
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "$phase_number"
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "$phase_number"
 ls "$phase_dir"/*-BRIEF.md 2>/dev/null
 ```
 

package/framework/agents/qualia-roadmapper.md

@@ -287,7 +287,7 @@ After roadmap creation, REQUIREMENTS.md gets updated with phase mappings:
 
 ## ROADMAP.md Structure
 
-Use template from `/home/qualia/.claude/qualia-engine/templates/roadmap.md`.
+Use template from `/home/qualia/.claude/qualia-framework/templates/roadmap.md`.
 
 Key sections:
 - Overview (2-3 sentences)
@@ -296,7 +296,7 @@ Key sections:
 
 ## STATE.md Structure
 
-Use template from `/home/qualia/.claude/qualia-engine/templates/state.md`.
+Use template from `/home/qualia/.claude/qualia-framework/templates/state.md`.
 
 Key sections:
 - Project Reference (core value, current focus)

package/framework/agents/qualia-verifier.md

@@ -55,7 +55,7 @@ Set `is_re_verification = false`, proceed with Step 1.
 ```bash
 ls "$PHASE_DIR"/*-PLAN.md 2>/dev/null
 ls "$PHASE_DIR"/*-SUMMARY.md 2>/dev/null
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "$PHASE_NUM"
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "$PHASE_NUM"
 grep -E "^| $PHASE_NUM" .planning/REQUIREMENTS.md 2>/dev/null
 ```
 

package/framework/hooks/migration-validate.sh

@@ -26,8 +26,11 @@ check_sql_file() {
         q_fail "TRUNCATE in ${file}"
         DESTRUCTIVE=$((DESTRUCTIVE + 1))
     fi
-    if grep -iE '\bDELETE\s+FROM\b' "$file" > /dev/null 2>&1 && ! grep -iE '\bWHERE\b' "$file" > /dev/null 2>&1; then
-        q_fail "DELETE without WHERE in ${file}"
+    # DELETE-without-WHERE: count DELETEs vs WHERE clauses (per-statement approximation)
+    local delete_count=$(grep -ciE '\bDELETE\s+FROM\b' "$file" 2>/dev/null || echo 0)
+    local where_count=$(grep -ciE '\bWHERE\b' "$file" 2>/dev/null || echo 0)
+    if [ "$delete_count" -gt 0 ] && [ "$delete_count" -gt "$where_count" ]; then
+        q_fail "DELETE without WHERE in ${file} (${delete_count} DELETEs, ${where_count} WHEREs)"
         DESTRUCTIVE=$((DESTRUCTIVE + 1))
     fi
     if grep -iE '\bALTER\s+TABLE\b.*\bDROP\s+COLUMN\b' "$file" > /dev/null 2>&1; then
@@ -41,24 +44,24 @@ check_sql_file() {
     fi
 }
 
-TOTAL=0
 TRIGGERED=false
 
 # Mode 1: SQL file written
 if [ -n "$FILE_PATH" ] && [[ "$FILE_PATH" == *.sql ]]; then
     TRIGGERED=true
     check_sql_file "$FILE_PATH"
-    TOTAL=$?
 fi
 
-# Mode 2: supabase db push
+# Mode 2: supabase db push — only scan new/modified migrations (not historical)
 if [ -n "$COMMAND" ] && echo "$COMMAND" | grep -qE 'supabase\s+db\s+push'; then
     TRIGGERED=true
-    for sql_file in supabase/migrations/*.sql; do
-        [ -f "$sql_file" ] || continue
-        check_sql_file "$sql_file"
-        TOTAL=$((TOTAL + $?))
-    done
+    # Scan only uncommitted or recently modified migration files
+    MODIFIED_MIGRATIONS=$(git diff --name-only HEAD -- supabase/migrations/*.sql 2>/dev/null; git diff --cached --name-only -- supabase/migrations/*.sql 2>/dev/null; git ls-files --others -- supabase/migrations/*.sql 2>/dev/null)
+    if [ -n "$MODIFIED_MIGRATIONS" ]; then
+        echo "$MODIFIED_MIGRATIONS" | sort -u | while IFS= read -r sql_file; do
+            [ -f "$sql_file" ] && check_sql_file "$sql_file"
+        done
+    fi
 fi
 
 # Block on destructive ops, warn on missing RLS

package/framework/hooks/pre-deploy-gate.sh

@@ -19,20 +19,27 @@ else
     COMMAND=""
 fi
 
-# Only gate actual production deploy commands (not commit messages containing the word)
+# Skip non-deploy commands first (git, npm, etc. may mention vercel in args/messages)
 case "$COMMAND" in
-    vercel\ *--prod*|npx\ vercel\ *--prod*|bunx\ vercel\ *--prod*) ;;
+    git\ *|npm\ *|node\ *|cat\ *|echo\ *|grep\ *|ls\ *|cd\ *) exit 0 ;;
+esac
+
+# Only gate actual vercel production deploy commands
+case "$COMMAND" in
+    vercel\ *--prod*|npx\ vercel\ *--prod*|bunx\ vercel\ *--prod*|pnpx\ vercel\ *--prod*) ;;
     *) exit 0 ;;
 esac
 
 
-# Skip if gate was passed recently (within 5 minutes)
+# Skip if gate passed recently AND no code changes since
 STAMP="/tmp/.deploy-gate-$(echo "$PWD" | md5sum | cut -c1-8)"
 if [ -f "$STAMP" ]; then
     AGE=$(( $(date +%s) - $(stat -c %Y "$STAMP" 2>/dev/null || echo 0) ))
-    if [ "$AGE" -lt 300 ]; then
+    DIRTY=$(git status --porcelain 2>/dev/null | head -1)
+    if [ "$AGE" -lt 300 ] && [ -z "$DIRTY" ]; then
         exit 0
     fi
+    rm -f "$STAMP"
 fi
 
 q_header "PRE-DEPLOY GATE"
@@ -135,15 +142,10 @@ else
 fi
 
 # ─── Verdict ───
+# Warning only — /ship skill is the real quality gate. Hook is a safety net.
 if [ "$FAILURES" -gt 0 ]; then
-    cat <<EOJSON
-{
-  "continue": false,
-  "stopReason": "◆ Deploy gate: ${FAILURES} check(s) failed",
-  "systemMessage": "◆ DEPLOY BLOCKED: ${FAILURES} check(s) failed. ${FAIL_DETAILS}Fix issues and retry with /ship."
-}
-EOJSON
-    exit 2
+    printf '{"continue":true,"systemMessage":"◆ DEPLOY WARNING: %d check(s) failed. %sThe /ship skill should have caught these — if deploying manually, fix first."}' "$FAILURES" "$FAIL_DETAILS"
+    exit 0
 fi
 
 WARN_MSG=""

package/framework/qualia-framework/VERSION

@@ -1 +1 @@
-2.4.4
+2.4.8

package/framework/qualia-framework/bin/collect-metrics.sh

@@ -49,18 +49,14 @@ fi
 # Lab Notes count
 LAB_NOTES=$(grep -c "^###" .planning/lab-notes.md 2>/dev/null || echo "0")
 
-# Completion rate from ROADMAP.md (actual, not assumed)
-TOTAL_PLANS=$(grep -c "^- \[" .planning/ROADMAP.md 2>/dev/null || echo "0")
-COMPLETED_PLANS=$(grep -c "^- \[x\]" .planning/ROADMAP.md 2>/dev/null || echo "0")
-if [ "$TOTAL_PLANS" -gt 0 ]; then
-  COMPLETION_RATE=$(( COMPLETED_PLANS * 100 / TOTAL_PLANS ))
-else
-  COMPLETION_RATE=100
-fi
-
-# FQS = completion_rate / avg_sessions_to_ship * 100 (per OBJECTIVE.md)
-if [ "$SESSIONS" != "?" ] && [ "$SESSIONS" -gt 0 ]; then
-  FQS=$(( COMPLETION_RATE * 100 / SESSIONS ))
+# Completion rate from ROADMAP.md (case-insensitive, allows indentation)
+TOTAL_PLANS=$(grep -ciE "^\s*- \[" .planning/ROADMAP.md 2>/dev/null || echo "0")
+COMPLETED_PLANS=$(grep -ciE "^\s*- \[x\]" .planning/ROADMAP.md 2>/dev/null || echo "0")
+
+# FQS = (completion_fraction) / sessions * 100 (per OBJECTIVE.md)
+# = COMPLETED_PLANS * 100 / (TOTAL_PLANS * SESSIONS)
+if [ "$TOTAL_PLANS" -gt 0 ] && [ "$SESSIONS" != "?" ] && [ "$SESSIONS" -gt 0 ]; then
+  FQS=$(( COMPLETED_PLANS * 100 / (TOTAL_PLANS * SESSIONS) ))
 else
   FQS="?"
 fi

package/framework/qualia-framework/bin/qualia-tools.js

@@ -1192,7 +1192,7 @@ function cmdStateSnapshot(cwd, raw) {
 
   // Parse "Progress: [...] N%" — extract percentage
   let progressPercent = null;
-  const progressMatch = content.match(/(\d+)%/);
+  const progressMatch = content.match(/^Progress:.*?(\d+)%/m);
   if (progressMatch) progressPercent = parseInt(progressMatch[1], 10);
 
   // Parse "Assigned to: ..."

package/framework/qualia-framework/references/decimal-phase-calculation.md

@@ -6,7 +6,7 @@ Calculate the next decimal phase number for urgent insertions.
 
 ```bash
 # Get next decimal phase after phase 6
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phase next-decimal 6
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phase next-decimal 6
 ```
 
 Output:
@@ -32,14 +32,14 @@ With existing decimals:
 ## Extract Values
 
 ```bash
-DECIMAL_INFO=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phase next-decimal "${AFTER_PHASE}")
+DECIMAL_INFO=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phase next-decimal "${AFTER_PHASE}")
 DECIMAL_PHASE=$(echo "$DECIMAL_INFO" | jq -r '.next')
 BASE_PHASE=$(echo "$DECIMAL_INFO" | jq -r '.base_phase')
 ```
 
 Or with --raw flag:
 ```bash
-DECIMAL_PHASE=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phase next-decimal "${AFTER_PHASE}" --raw)
+DECIMAL_PHASE=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phase next-decimal "${AFTER_PHASE}" --raw)
 # Returns just: 06.1
 ```
 
@@ -57,7 +57,7 @@ DECIMAL_PHASE=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phas
 Decimal phase directories use the full decimal number:
 
 ```bash
-SLUG=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js generate-slug "$DESCRIPTION" --raw)
+SLUG=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js generate-slug "$DESCRIPTION" --raw)
 PHASE_DIR=".planning/phases/${DECIMAL_PHASE}-${SLUG}"
 mkdir -p "$PHASE_DIR"
 ```

package/framework/qualia-framework/references/model-profile-resolution.md

@@ -12,7 +12,7 @@ Default: `balanced` if not set or config missing.
 
 ## Lookup Table
 
-@/home/qualia/.claude/qualia-engine/references/model-profiles.md
+@/home/qualia/.claude/qualia-framework/references/model-profiles.md
 
 Look up the agent in the table for the resolved profile. Pass the model parameter to Task calls:
 

package/framework/qualia-framework/references/phase-argument-parsing.md

@@ -14,7 +14,7 @@ From `$ARGUMENTS`:
 The `find-phase` command handles normalization and validation in one step:
 
 ```bash
-PHASE_INFO=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js find-phase "${PHASE}")
+PHASE_INFO=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js find-phase "${PHASE}")
 ```
 
 Returns JSON with:
@@ -45,7 +45,7 @@ fi
 Use `roadmap get-phase` to validate phase exists:
 
 ```bash
-PHASE_CHECK=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "${PHASE}")
+PHASE_CHECK=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "${PHASE}")
 if [ "$(echo "$PHASE_CHECK" | jq -r '.found')" = "false" ]; then
   echo "ERROR: Phase ${PHASE} not found in roadmap"
   exit 1
@@ -57,5 +57,5 @@ fi
 Use `find-phase` for directory lookup:
 
 ```bash
-PHASE_DIR=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js find-phase "${PHASE}" --raw)
+PHASE_DIR=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js find-phase "${PHASE}" --raw)
 ```

package/framework/qualia-framework/references/planning-config.md

@@ -40,14 +40,14 @@ Configuration options for `.planning/` directory behavior.
 
 ```bash
 # Commit with automatic commit_docs + gitignore checks:
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: update state" --files .planning/STATE.md
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: update state" --files .planning/STATE.md
 
 # Load config via state load (returns JSON):
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state load)
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state load)
 # commit_docs is available in the JSON output
 
 # Or use init commands which include commit_docs:
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init execute-phase "1")
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init execute-phase "1")
 # commit_docs is included in all init command outputs
 ```
 
@@ -143,13 +143,13 @@ To use uncommitted mode:
 
 Use `init execute-phase` which returns all config as JSON:
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init execute-phase "1")
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init execute-phase "1")
 # JSON output includes: branching_strategy, phase_branch_template, milestone_branch_template
 ```
 
 Or use `state load` for the config values:
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state load)
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state load)
 # Parse branching_strategy, phase_branch_template, milestone_branch_template from JSON
 ```
 

package/framework/qualia-framework/references/verification-patterns.md

@@ -600,7 +600,7 @@ Some things can't be verified programmatically. Flag these for human testing:
 
 For automation-first checkpoint patterns, server lifecycle management, CLI installation handling, and error recovery protocols, see:
 
-**@/home/qualia/.claude/qualia-engine/references/checkpoints.md** → `<automation_reference>` section
+**@/home/qualia/.claude/qualia-framework/references/checkpoints.md** → `<automation_reference>` section
 
 Key principles:
 - Claude sets up verification environment BEFORE presenting checkpoints

package/framework/qualia-framework/templates/codebase/structure.md

@@ -123,11 +123,11 @@ Template for `.planning/codebase/STRUCTURE.md` - captures physical file organiza
 ## Directory Layout
 
 ```
-qualia-engine/
+qualia-framework/
 ├── bin/                # Executable entry points
 ├── commands/           # Slash command definitions
 │   └── qualia/           # Qualia-specific commands
-├── qualia-engine/     # Skill resources
+├── qualia-framework/     # Skill resources
 │   ├── references/    # Principle documents
 │   ├── templates/     # File templates
 │   └── workflows/     # Multi-step procedures
@@ -151,19 +151,19 @@ qualia-engine/
 - Key files: new-project.md, plan-phase.md, execute-plan.md
 - Subdirectories: None (flat structure)
 
-**qualia-engine/references/**
+**qualia-framework/references/**
 - Purpose: Core philosophy and guidance documents
 - Contains: principles.md, questioning.md, plan-format.md
 - Key files: principles.md - system philosophy
 - Subdirectories: None
 
-**qualia-engine/templates/**
+**qualia-framework/templates/**
 - Purpose: Document templates for .planning/ files
 - Contains: Template definitions with frontmatter
 - Key files: project.md, roadmap.md, plan.md, summary.md
 - Subdirectories: codebase/ (new - for stack/architecture/structure templates)
 
-**qualia-engine/workflows/**
+**qualia-framework/workflows/**
 - Purpose: Reusable multi-step procedures
 - Contains: Workflow definitions called by commands
 - Key files: execute-plan.md, research-phase.md
@@ -211,15 +211,15 @@ qualia-engine/
 - Documentation: Update `README.md` with new command
 
 **New Template:**
-- Implementation: `qualia-engine/templates/{name}.md`
+- Implementation: `qualia-framework/templates/{name}.md`
 - Documentation: Template is self-documenting (includes guidelines)
 
 **New Workflow:**
-- Implementation: `qualia-engine/workflows/{name}.md`
-- Usage: Reference from command with `@/home/qualia/.claude/qualia-engine/workflows/{name}.md`
+- Implementation: `qualia-framework/workflows/{name}.md`
+- Usage: Reference from command with `@/home/qualia/.claude/qualia-framework/workflows/{name}.md`
 
 **New Reference Document:**
-- Implementation: `qualia-engine/references/{name}.md`
+- Implementation: `qualia-framework/references/{name}.md`
 - Usage: Reference from commands/workflows as needed
 
 **Utilities:**
@@ -228,7 +228,7 @@ qualia-engine/
 
 ## Special Directories
 
-**qualia-engine/**
+**qualia-framework/**
 - Purpose: Resources installed to /home/qualia/.claude/
 - Source: Copied by bin/install.js during installation
 - Committed: Yes (source of truth)

package/framework/qualia-framework/templates/phase-prompt.md

@@ -37,10 +37,10 @@ Output: [What artifacts will be created]
 </objective>
 
 <execution_context>
-@/home/qualia/.claude/qualia-engine/workflows/execute-plan.md
-@/home/qualia/.claude/qualia-engine/templates/summary.md
+@/home/qualia/.claude/qualia-framework/workflows/execute-plan.md
+@/home/qualia/.claude/qualia-framework/templates/summary.md
 [If plan contains checkpoint tasks (type="checkpoint:*"), add:]
-@/home/qualia/.claude/qualia-engine/references/checkpoints.md
+@/home/qualia/.claude/qualia-framework/references/checkpoints.md
 </execution_context>
 
 <context>
@@ -75,7 +75,7 @@ Output: [What artifacts will be created]
   <done>[Acceptance criteria]</done>
 </task>
 
-<!-- For checkpoint task examples and patterns, see @/home/qualia/.claude/qualia-engine/references/checkpoints.md -->
+<!-- For checkpoint task examples and patterns, see @/home/qualia/.claude/qualia-framework/references/checkpoints.md -->
 <!-- Key rule: Claude starts dev server BEFORE human-verify checkpoints. User only visits URLs. -->
 
 <task type="checkpoint:decision" gate="blocking">
@@ -268,7 +268,7 @@ TDD features get dedicated plans with `type: tdd`.
 → Yes: Create a TDD plan
 → No: Standard task in standard plan
 
-See `/home/qualia/.claude/qualia-engine/references/tdd.md` for TDD plan structure.
+See `/home/qualia/.claude/qualia-framework/references/tdd.md` for TDD plan structure.
 
 ---
 
@@ -372,9 +372,9 @@ Output: Working dashboard component.
 </objective>
 
 <execution_context>
-@/home/qualia/.claude/qualia-engine/workflows/execute-plan.md
-@/home/qualia/.claude/qualia-engine/templates/summary.md
-@/home/qualia/.claude/qualia-engine/references/checkpoints.md
+@/home/qualia/.claude/qualia-framework/workflows/execute-plan.md
+@/home/qualia/.claude/qualia-framework/templates/summary.md
+@/home/qualia/.claude/qualia-framework/references/checkpoints.md
 </execution_context>
 
 <context>
@@ -497,7 +497,7 @@ user_setup:
 
 **Result:** Execute-plan generates `{phase}-USER-SETUP.md` with checklist for the user.
 
-See `/home/qualia/.claude/qualia-engine/templates/user-setup.md` for full schema and examples
+See `/home/qualia/.claude/qualia-framework/templates/user-setup.md` for full schema and examples
 
 ---
 
@@ -564,4 +564,4 @@ Task completion ≠ Goal achievement. A task "create chat component" can complet
 5. Gaps found → fix plans created → execute → re-verify
 6. All must_haves pass → phase complete
 
-See `/home/qualia/.claude/qualia-engine/workflows/verify-phase.md` for verification logic.
+See `/home/qualia/.claude/qualia-framework/workflows/verify-phase.md` for verification logic.

package/framework/qualia-framework/workflows/add-phase.md

@@ -29,7 +29,7 @@ Exit.
 Load phase operation context:
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init phase-op "0")
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "0")
 ```
 
 Check `roadmap_exists` from init JSON. If false:
@@ -79,7 +79,7 @@ Convert the phase description to a kebab-case slug.
 
 Use `init phase-op` which provides `phase_slug` computed from phase name, or call:
 ```bash
-slug=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js generate-slug "$description" --raw)
+slug=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js generate-slug "$description" --raw)
 ```
 
 Phase directory name: `{two-digit-phase}-{slug}`

package/framework/qualia-framework/workflows/add-todo.md

@@ -12,7 +12,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 Load todo context:
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init todos)
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init todos)
 ```
 
 Extract from init JSON: `commit_docs`, `date`, `timestamp`, `todo_count`, `todos`, `pending_dir`, `todos_dir_exists`.
@@ -83,7 +83,7 @@ Use values from init context: `timestamp` and `date` are already available.
 
 Generate slug for the title:
 ```bash
-slug=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js generate-slug "$title" --raw)
+slug=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js generate-slug "$title" --raw)
 ```
 
 Write to `.planning/todos/pending/${date}-${slug}.md`:
@@ -118,7 +118,7 @@ If `.planning/STATE.md` exists:
 Commit the todo and any updated state:
 
 ```bash
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: capture todo - [title]" --files .planning/todos/pending/[filename] .planning/STATE.md
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: capture todo - [title]" --files .planning/todos/pending/[filename] .planning/STATE.md
 ```
 
 Tool respects `commit_docs` config and gitignore automatically.

package/framework/qualia-framework/workflows/audit-milestone.md

@@ -11,21 +11,21 @@ Read all files referenced by the invoking prompt's execution_context before star
 ## 0. Initialize Milestone Context
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init milestone-op)
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init milestone-op)
 ```
 
 Extract from init JSON: `milestone_version`, `milestone_name`, `phase_count`, `completed_phases`, `commit_docs`.
 
 Resolve integration checker model:
 ```bash
-CHECKER_MODEL=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js resolve-model qualia-integration-checker --raw)
+CHECKER_MODEL=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js resolve-model qualia-integration-checker --raw)
 ```
 
 ## 1. Determine Milestone Scope
 
 ```bash
 # Get phases in milestone (sorted numerically, handles decimals)
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phases list
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phases list
 ```
 
 - Parse version from arguments or detect current from ROADMAP.md

package/framework/qualia-framework/workflows/check-todos.md

@@ -12,7 +12,7 @@ Read all files referenced by the invoking prompt's execution_context before star
 Load todo context:
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init todos)
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init todos)
 ```
 
 Extract from init JSON: `todo_count`, `todos`, `pending_dir`.
@@ -154,7 +154,7 @@ If todo was moved to done/, commit the change:
 
 ```bash
 git rm --cached .planning/todos/pending/[filename] 2>/dev/null || true
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: start work on todo - [title]" --files .planning/todos/done/[filename] .planning/STATE.md
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: start work on todo - [title]" --files .planning/todos/done/[filename] .planning/STATE.md
 ```
 
 Tool respects `commit_docs` config and gitignore automatically.

package/framework/qualia-framework/workflows/complete-milestone.md

@@ -133,7 +133,7 @@ Extract one-liners from SUMMARY.md files using summary-extract:
 ```bash
 # For each phase in milestone, extract one-liner
 for summary in .planning/phases/*-*/*-SUMMARY.md; do
-  node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js summary-extract "$summary" --fields one_liner | jq -r '.one_liner'
+  node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js summary-extract "$summary" --fields one_liner | jq -r '.one_liner'
 done
 ```
 
@@ -373,7 +373,7 @@ Update `.planning/ROADMAP.md` — group completed milestone phases:
 Extract completed milestone details to archive.
 
 1. Create `.planning/milestones/v[X.Y]-ROADMAP.md`
-2. Read `/home/qualia/.claude/qualia-engine/templates/milestone-archive.md` template
+2. Read `/home/qualia/.claude/qualia-framework/templates/milestone-archive.md` template
 3. Extract from ROADMAP.md: all phases in milestone (by number range), full phase details, plan lists with checkmarks
 4. Extract from PROJECT.md: key decisions, validated requirements
 5. Fill template placeholders: {{VERSION}}, {{MILESTONE_NAME}}, {{DATE}}, {{PHASE_START}}, {{PHASE_END}}, {{TOTAL_PLANS}}, {{MILESTONE_DESCRIPTION}}, {{PHASES_SECTION}}, {{DECISIONS_FROM_PROJECT}}, {{ISSUES_RESOLVED_DURING_MILESTONE}}
@@ -599,7 +599,7 @@ Check branching strategy and offer merge options.
 Use `init milestone-op` for context, or load config directly:
 
 ```bash
-INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init execute-phase "1")
+INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init execute-phase "1")
 ```
 
 Extract `branching_strategy`, `phase_branch_template`, `milestone_branch_template` from init JSON.
@@ -777,7 +777,7 @@ git push origin v[X.Y]
 Commit milestone completion.
 
 ```bash
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "chore: complete v[X.Y] milestone" --files .planning/milestones/v[X.Y]-ROADMAP.md .planning/milestones/v[X.Y]-REQUIREMENTS.md .planning/milestones/v[X.Y]-MILESTONE-AUDIT.md .planning/MILESTONES.md .planning/PROJECT.md .planning/STATE.md
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "chore: complete v[X.Y] milestone" --files .planning/milestones/v[X.Y]-ROADMAP.md .planning/milestones/v[X.Y]-REQUIREMENTS.md .planning/milestones/v[X.Y]-MILESTONE-AUDIT.md .planning/MILESTONES.md .planning/PROJECT.md .planning/STATE.md
 ```
 ```
 

package/framework/qualia-framework/workflows/diagnose-issues.md

@@ -158,7 +158,7 @@ Update status in frontmatter to "diagnosed".
 
 Commit the updated UAT.md:
 ```bash
-node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs({phase}): add root causes from diagnosis" --files ".planning/phases/XX-name/{phase}-UAT.md"
+node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs({phase}): add root causes from diagnosis" --files ".planning/phases/XX-name/{phase}-UAT.md"
 ```
 </step>