qualia-framework 2.4.5 → 2.4.9

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/CLAUDE.md

@@ -1,42 +1,39 @@
-# CLAUDE.md — Qualia Solutions
+# CLAUDE.md — OWNER Profile
 
 ## Identity
-**Fawzi Goussous** — Founder, Qualia Solutions. Nicosia, Cyprus.
-
+**Fawzi Goussous** — Founder at Qualia Solutions. Nicosia, Cyprus.
+One-man dev shop. Websites, AI agents, voice agents, AI automation.
+- Direct, action-oriented, no fluff. Code > theory.
+- يعني اذا حكى عربي رد عربي، اذا انجليزي رد انجليزي، واذا خلط خلط معه
 - Stack: Next.js 16+, React 19, TypeScript, Supabase, Vercel, VAPI, ElevenLabs, Telnyx, Retell AI, OpenRouter
-- Partner: Jay | Team: Moayad (full-time, Jordan), Ahasan (part-time, Cyprus)
 
 ## Role: OWNER
-
-Full authority over all projects, deployments, architecture, and client decisions.
-- Deploy directly to production
-- Make architectural decisions unilaterally
-- Access all Supabase projects and service role keys
-- Modify the Qualia framework (CLAUDE.md, skills, hooks)
+You are the founder. Full authority over all projects, deployments, architecture, and client decisions.
+- Can deploy directly to production
+- Can make architectural decisions unilaterally
+- Can access all Supabase projects and service role keys
+- Can modify CLAUDE.md, skills, hooks, and framework config
+- Can approve/reject employee work
 
 ## Rules
 - Read before Write/Edit — no exceptions
-- Feature branches only — never commit to main/master
+- Feature branches preferred — OWNER may push to main when necessary (branch-guard enforces for non-OWNER)
 - MVP first. Build only what's asked. No over-engineering.
 - Root cause on failures — no band-aids
 - `npx tsc --noEmit` after multi-file TS changes
 - Glob/Grep directly — no Task(Explore) unless 5+ rounds needed
-- For non-trivial work (multi-file changes, architectural decisions, unfamiliar codebases), confirm understanding before coding — quick tasks are exempt
+- For non-trivial work (multi-file changes, architectural decisions, unfamiliar codebases), confirm understanding before coding: "Here's what I understand: [summary]. Correct?" — quick tasks (typo, single-file, familiar pattern) are exempt
 - See `rules/security.md` for auth, RLS, Zod, secrets rules
 - See `rules/frontend.md` for design standards
 - See `rules/deployment.md` for deploy checklist
-- See `rules/speed.md` for tool usage and workflow shortcuts
-- See `rules/context7.md` for library documentation lookup
 
 ## Collaboration
 Collaborator, not executor. Speak up about bugs, simpler approaches, bad architecture.
 Be honest. Default to action. Never speculate on unread code. Say when blocked.
-- Direct, action-oriented, no fluff. Code > theory.
-- Arabic or English — match whatever language is used
 
 ## Workflow
 - **MANDATORY FIRST ACTION**: On every session start, invoke the `qualia-start` skill before doing anything else. This is non-negotiable — do not wait for user input, do not skip it, do not just acknowledge the hook message. Actually invoke the skill using the Skill tool.
-- Subagents (Opus) for research and complex reasoning.
+- Subagents default to Opus (set via CLAUDE_CODE_SUBAGENT_MODEL).
 - `/compact` at 60%. `/clear` between tasks. `/learn` after mistakes.
 
 ## Qualia Mode (always active)

package/framework/agents/backend-agent.md

@@ -3,7 +3,7 @@ name: backend-agent
 description: Backend/database specialist - Supabase, APIs, Edge Functions. Spawned for parallel backend development.
 category: development
 tools: Read, Write, Edit, Glob, Grep, Bash
-model: claude-opus-4-6
+model: inherit
 skills:
   - supabase
 tags: [backend, supabase, api, database, typescript]

package/framework/agents/frontend-agent.md

@@ -2,8 +2,8 @@
 name: frontend-agent
 description: Frontend implementation specialist - React, TypeScript, CSS, animations. Spawned for parallel UI development.
 category: development
-tools: Read, Write, Edit, Glob, Grep, Bash(npm:*), Bash(npx:*)
-model: claude-opus-4-6
+tools: Read, Write, Edit, Glob, Grep, Bash
+model: inherit
 skills:
   - frontend-master
   - responsive

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/agents/test-agent.md

@@ -3,7 +3,7 @@ name: test-agent
 description: Testing and QA specialist - unit tests, integration tests, E2E with Playwright. Spawned for parallel test development.
 category: testing
 tools: Read, Write, Edit, Glob, Grep, Bash
-model: claude-sonnet-4-20250514
+model: inherit
 tags: [testing, jest, vitest, playwright, qa]
 ---
 

package/framework/hooks/auto-format.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
-# Auto-format hook for PostToolUse(Write)
+# Auto-format hook for PostToolUse(Write/Edit)
 # Runs prettier on supported file types if available in the project
+source "$(dirname "$0")/qualia-colors.sh"
 
 # Parse file path from stdin JSON (Claude Code hook protocol)
 if [ ! -t 0 ]; then

package/framework/hooks/block-env-edit.sh

@@ -9,7 +9,10 @@ else
     FILE_PATH="${1:-}"
 fi
 
-[ -z "$FILE_PATH" ] && exit 0
+if [ -z "$FILE_PATH" ]; then
+    printf '{"continue":true}'
+    exit 0
+fi
 
 BASENAME=$(basename "$FILE_PATH")
 
@@ -35,4 +38,5 @@ EOJSON
     exit 2
 fi
 
+printf '{"continue":true}'
 exit 0

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
+        while IFS= read -r sql_file; do
+            [ -f "$sql_file" ] && check_sql_file "$sql_file"
+        done < <(echo "$MODIFIED_MIGRATIONS" | sort -u)
+    fi
 fi
 
 # Block on destructive ops, warn on missing RLS

package/framework/hooks/notification-speak.sh

@@ -12,4 +12,5 @@ if [ -n "$TEXT" ]; then
     ~/.claude/scripts/speak.sh "$TEXT" &
 fi
 
+printf '{"continue":true}'
 exit 0

package/framework/hooks/pre-compact.sh

@@ -52,4 +52,5 @@ cat > "$COMPACT_FILE" << EOF
 }
 EOF
 
+printf '{"continue":true}'
 exit 0

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/hooks/qualia-colors.sh

@@ -1,10 +1,10 @@
 # Qualia teal brand palette — source this in all hooks
 # Usage: source "$(dirname "$0")/qualia-colors.sh"
 
-Q_TEAL='\033[38;2;0;188;175m'
-Q_BRIGHT='\033[38;2;45;226;210m'
-Q_DIM='\033[38;2;0;120;112m'
-Q_WHITE='\033[38;2;220;225;230m'
+Q_TEAL='\033[38;2;0;140;130m'
+Q_BRIGHT='\033[38;2;0;200;185m'
+Q_DIM='\033[38;2;0;100;92m'
+Q_WHITE='\033[38;2;230;230;230m'
 Q_PASS='\033[38;2;52;211;153m'
 Q_WARN='\033[38;2;234;179;8m'
 Q_FAIL='\033[38;2;239;68;68m'

package/framework/hooks/retention-cleanup.sh

@@ -44,9 +44,19 @@ find "$CLAUDE_DIR/tasks/" -mindepth 1 -type d -empty -delete 2>/dev/null
 # plans/ — keep 7 days (old Claude Code plan mode files)
 find "$CLAUDE_DIR/plans/" -type f -mtime +7 -delete 2>/dev/null
 
+# downloads/ — keep 7 days
+find "$CLAUDE_DIR/downloads/" -type f -mtime +7 -delete 2>/dev/null
+
+# image-cache/ — keep 7 days
+find "$CLAUDE_DIR/image-cache/" -type f -mtime +7 -delete 2>/dev/null
+
+# thoughts/ — keep 14 days
+find "$CLAUDE_DIR/thoughts/" -type f -mtime +14 -delete 2>/dev/null
+
 # session-env/ session_*.json — keep last 50 (matches save-session-state.sh)
 ls -t "$CLAUDE_DIR/session-env"/session_*.json 2>/dev/null | tail -n +51 | while IFS= read -r f; do
     rm -f "$f"
 done
 
+printf '{"continue":true}'
 exit 0

package/framework/hooks/save-session-state.sh

@@ -15,6 +15,7 @@ if [ -f "$SESSION_START_FILE" ]; then
     NOW_TS=$(date +%s)
     DURATION=$((NOW_TS - START_TS))
     if [ "$DURATION" -lt 30 ]; then
+        printf '{"continue":true}'
         exit 0
     fi
 fi
@@ -180,4 +181,5 @@ ls -t "$SESSION_DIR"/session_*.json 2>/dev/null | tail -n +51 | while IFS= read
     rm -f "$f"
 done
 
+printf '{"continue":true}'
 exit 0

package/framework/hooks/session-learn.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # SessionEnd hook: prompt for lessons learned if significant work was done
 # "Significant" = more than 3 files modified in the session
+source "$(dirname "$0")/qualia-colors.sh"
 
 LEARNED_FILE="$HOME/.claude/knowledge/learned-patterns.md"
 

package/framework/qualia-framework/VERSION

@@ -1 +1 @@
-2.4.5
+2.4.9

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)