qualia-framework 2.4.5 → 2.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/README.md +1 -1
  2. package/bin/cli.js +1 -1
  3. package/framework/agents/qualia-debugger.md +1 -1
  4. package/framework/agents/qualia-executor.md +4 -4
  5. package/framework/agents/qualia-plan-checker.md +2 -2
  6. package/framework/agents/qualia-roadmapper.md +2 -2
  7. package/framework/agents/qualia-verifier.md +1 -1
  8. package/framework/hooks/migration-validate.sh +13 -10
  9. package/framework/hooks/pre-deploy-gate.sh +14 -12
  10. package/framework/qualia-framework/VERSION +1 -1
  11. package/framework/qualia-framework/bin/collect-metrics.sh +8 -12
  12. package/framework/qualia-framework/bin/qualia-tools.js +1 -1
  13. package/framework/qualia-framework/references/decimal-phase-calculation.md +4 -4
  14. package/framework/qualia-framework/references/model-profile-resolution.md +1 -1
  15. package/framework/qualia-framework/references/phase-argument-parsing.md +3 -3
  16. package/framework/qualia-framework/references/planning-config.md +5 -5
  17. package/framework/qualia-framework/references/verification-patterns.md +1 -1
  18. package/framework/qualia-framework/templates/codebase/structure.md +10 -10
  19. package/framework/qualia-framework/templates/phase-prompt.md +10 -10
  20. package/framework/qualia-framework/workflows/add-phase.md +2 -2
  21. package/framework/qualia-framework/workflows/add-todo.md +3 -3
  22. package/framework/qualia-framework/workflows/audit-milestone.md +3 -3
  23. package/framework/qualia-framework/workflows/check-todos.md +2 -2
  24. package/framework/qualia-framework/workflows/complete-milestone.md +4 -4
  25. package/framework/qualia-framework/workflows/diagnose-issues.md +1 -1
  26. package/framework/qualia-framework/workflows/discovery-phase.md +5 -5
  27. package/framework/qualia-framework/workflows/discuss-phase.md +4 -4
  28. package/framework/qualia-framework/workflows/execute-plan.md +8 -8
  29. package/framework/qualia-framework/workflows/help.md +2 -2
  30. package/framework/qualia-framework/workflows/insert-phase.md +3 -3
  31. package/framework/qualia-framework/workflows/map-codebase.md +2 -2
  32. package/framework/qualia-framework/workflows/new-milestone.md +6 -6
  33. package/framework/qualia-framework/workflows/pause-work.md +2 -2
  34. package/framework/qualia-framework/workflows/plan-milestone-gaps.md +2 -2
  35. package/framework/qualia-framework/workflows/plan-phase.md +5 -5
  36. package/framework/qualia-framework/workflows/quick.md +2 -2
  37. package/framework/qualia-framework/workflows/remove-phase.md +2 -2
  38. package/framework/qualia-framework/workflows/research-phase.md +4 -4
  39. package/framework/qualia-framework/workflows/resume-project.md +2 -2
  40. package/framework/qualia-framework/workflows/set-profile.md +2 -2
  41. package/framework/qualia-framework/workflows/settings.md +2 -2
  42. package/framework/qualia-framework/workflows/update.md +10 -10
  43. package/framework/qualia-framework/workflows/verify-phase.md +5 -5
  44. package/framework/qualia-framework/workflows/verify-work.md +4 -4
  45. package/framework/scripts/sync-to-framework.sh +1 -1
  46. package/framework/skills/qualia-add-todo/SKILL.md +1 -1
  47. package/framework/skills/qualia-check-todos/SKILL.md +1 -1
  48. package/framework/skills/qualia-debug/SKILL.md +2 -2
  49. package/framework/skills/qualia-discuss-phase/SKILL.md +2 -2
  50. package/framework/skills/qualia-framework-audit/SKILL.md +1 -1
  51. package/framework/skills/qualia-list-phase-assumptions/SKILL.md +1 -1
  52. package/framework/skills/qualia-new-milestone/SKILL.md +4 -4
  53. package/framework/skills/qualia-optimize/SKILL.md +1 -1
  54. package/framework/skills/qualia-pause-work/SKILL.md +1 -1
  55. package/framework/skills/qualia-plan-milestone-gaps/SKILL.md +1 -1
  56. package/framework/skills/qualia-progress/SKILL.md +1 -1
  57. package/framework/skills/qualia-quick/SKILL.md +1 -1
  58. package/framework/skills/qualia-research-phase/SKILL.md +2 -2
  59. package/framework/skills/qualia-resume-work/SKILL.md +1 -1
  60. package/framework/skills/qualia-review/SKILL.md +1 -1
  61. package/package.json +1 -1
@@ -28,7 +28,7 @@ Claude's training data is 6-18 months stale. Always verify.
28
28
  2. **Official docs** - When Context7 lacks coverage
29
29
  3. **WebSearch LAST** - For comparisons and trends only
30
30
 
31
- See /home/qualia/.claude/qualia-engine/templates/discovery.md `<discovery_protocol>` for full protocol.
31
+ See /home/qualia/.claude/qualia-framework/templates/discovery.md `<discovery_protocol>` for full protocol.
32
32
  </source_hierarchy>
33
33
 
34
34
  <process>
@@ -107,7 +107,7 @@ For: Choosing between options, new external integration.
107
107
 
108
108
  5. **Cross-verify:** Any WebSearch finding → confirm with Context7/official docs.
109
109
 
110
- 6. **Create DISCOVERY.md** using /home/qualia/.claude/qualia-engine/templates/discovery.md structure:
110
+ 6. **Create DISCOVERY.md** using /home/qualia/.claude/qualia-framework/templates/discovery.md structure:
111
111
 
112
112
  - Summary with recommendation
113
113
  - Key findings per option
@@ -126,7 +126,7 @@ For: Architectural decisions, novel problems, high-risk choices.
126
126
 
127
127
  **Process:**
128
128
 
129
- 1. **Scope the discovery** using /home/qualia/.claude/qualia-engine/templates/discovery.md:
129
+ 1. **Scope the discovery** using /home/qualia/.claude/qualia-framework/templates/discovery.md:
130
130
 
131
131
  - Define clear scope
132
132
  - Define include/exclude boundaries
@@ -160,7 +160,7 @@ For: Architectural decisions, novel problems, high-risk choices.
160
160
 
161
161
  6. **Create comprehensive DISCOVERY.md:**
162
162
 
163
- - Full structure from /home/qualia/.claude/qualia-engine/templates/discovery.md
163
+ - Full structure from /home/qualia/.claude/qualia-framework/templates/discovery.md
164
164
  - Quality report with source attribution
165
165
  - Confidence by finding
166
166
  - If LOW confidence on any critical finding → add validation checkpoints
@@ -184,7 +184,7 @@ Ask: What do we need to learn before we can plan this phase?
184
184
  </step>
185
185
 
186
186
  <step name="create_discovery_scope">
187
- Use /home/qualia/.claude/qualia-engine/templates/discovery.md.
187
+ Use /home/qualia/.claude/qualia-framework/templates/discovery.md.
188
188
 
189
189
  Include:
190
190
 
@@ -111,7 +111,7 @@ Phase: "API documentation"
111
111
  Phase number from argument (required).
112
112
 
113
113
  ```bash
114
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init phase-op "${PHASE}")
114
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "${PHASE}")
115
115
  ```
116
116
 
117
117
  Parse JSON for: `commit_docs`, `phase_found`, `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded_phase`, `has_research`, `has_context`, `has_plans`, `has_verification`, `plan_count`, `roadmap_exists`, `planning_exists`.
@@ -439,7 +439,7 @@ options:
439
439
 
440
440
  **After all 5 dimensions discussed:**
441
441
 
442
- Generate DESIGN.md using the template from `@/home/qualia/.claude/qualia-engine/templates/DESIGN.md`, populating sections with the user's decisions.
442
+ Generate DESIGN.md using the template from `@/home/qualia/.claude/qualia-framework/templates/DESIGN.md`, populating sections with the user's decisions.
443
443
 
444
444
  Write to `.planning/DESIGN.md` in the current project (NOT in the phase directory -- DESIGN.md is project-level).
445
445
 
@@ -509,12 +509,12 @@ Created: .planning/DESIGN.md (design decisions)
509
509
  Commit phase context (uses `commit_docs` from init internally):
510
510
 
511
511
  ```bash
512
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs(${padded_phase}): capture phase context" --files "${phase_dir}/${padded_phase}-CONTEXT.md"
512
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs(${padded_phase}): capture phase context" --files "${phase_dir}/${padded_phase}-CONTEXT.md"
513
513
  ```
514
514
 
515
515
  If DESIGN.md was created/updated, include it in the commit:
516
516
  ```bash
517
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs(${padded_phase}): capture phase context" --files "${phase_dir}/${padded_phase}-CONTEXT.md" ".planning/DESIGN.md"
517
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs(${padded_phase}): capture phase context" --files "${phase_dir}/${padded_phase}-CONTEXT.md" ".planning/DESIGN.md"
518
518
  ```
519
519
 
520
520
  Confirm: "Committed: docs(${padded_phase}): capture phase context"
@@ -6,7 +6,7 @@ Execute a phase prompt (PLAN.md) and create the outcome summary (SUMMARY.md).
6
6
  Read STATE.md before any operation to load project context.
7
7
  Read config.json for planning behavior settings.
8
8
 
9
- @/home/qualia/.claude/qualia-engine/references/git-integration.md
9
+ @/home/qualia/.claude/qualia-framework/references/git-integration.md
10
10
  </required_reading>
11
11
 
12
12
  <process>
@@ -15,7 +15,7 @@ Read config.json for planning behavior settings.
15
15
  Load execution context (uses `init execute-phase` for full context):
16
16
 
17
17
  ```bash
18
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init execute-phase "${PHASE}")
18
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init execute-phase "${PHASE}")
19
19
  ```
20
20
 
21
21
  Extract from init JSON: `executor_model`, `commit_docs`, `phase_dir`, `phase_number`, `plans`, `summaries`, `incomplete_plans`.
@@ -69,7 +69,7 @@ If `IS_FRONTEND=true`: load design quality standards.
69
69
 
70
70
  ```bash
71
71
  if [ "$IS_FRONTEND" = "true" ]; then
72
- DESIGN_REF=$(cat /home/qualia/.claude/qualia-engine/references/design-quality.md 2>/dev/null)
72
+ DESIGN_REF=$(cat /home/qualia/.claude/qualia-framework/references/design-quality.md 2>/dev/null)
73
73
  FRONTEND_SKILL=$(cat /home/qualia/.claude/skills/frontend-master/SKILL.md 2>/dev/null)
74
74
  fi
75
75
  ```
@@ -256,7 +256,7 @@ For `type: tdd` plans — RED-GREEN-REFACTOR:
256
256
 
257
257
  Errors: RED doesn't fail → investigate test/existing feature. GREEN doesn't pass → debug, iterate. REFACTOR breaks → undo.
258
258
 
259
- See `/home/qualia/.claude/qualia-engine/references/tdd.md` for structure.
259
+ See `/home/qualia/.claude/qualia-framework/references/tdd.md` for structure.
260
260
  </tdd_plan_execution>
261
261
 
262
262
  <task_commit>
@@ -308,7 +308,7 @@ Display: `CHECKPOINT: [Type]` box → Progress {X}/{Y} → Task name → type-sp
308
308
 
309
309
  After response: verify if specified. Pass → continue. Fail → inform, wait. WAIT for user — do NOT hallucinate completion.
310
310
 
311
- See /home/qualia/.claude/qualia-engine/references/checkpoints.md for details.
311
+ See /home/qualia/.claude/qualia-framework/references/checkpoints.md for details.
312
312
  </step>
313
313
 
314
314
  <step name="checkpoint_return_for_orchestrator">
@@ -346,11 +346,11 @@ fi
346
346
  grep -A 50 "^user_setup:" .planning/phases/XX-name/{phase}-{plan}-PLAN.md | head -50
347
347
  ```
348
348
 
349
- If user_setup exists: create `{phase}-USER-SETUP.md` using template `/home/qualia/.claude/qualia-engine/templates/user-setup.md`. Per service: env vars table, account setup checklist, dashboard config, local dev notes, verification commands. Status "Incomplete". Set `USER_SETUP_CREATED=true`. If empty/missing: skip.
349
+ If user_setup exists: create `{phase}-USER-SETUP.md` using template `/home/qualia/.claude/qualia-framework/templates/user-setup.md`. Per service: env vars table, account setup checklist, dashboard config, local dev notes, verification commands. Status "Incomplete". Set `USER_SETUP_CREATED=true`. If empty/missing: skip.
350
350
  </step>
351
351
 
352
352
  <step name="create_summary">
353
- Create `{phase}-{plan}-SUMMARY.md` at `.planning/phases/XX-name/`. Use `/home/qualia/.claude/qualia-engine/templates/summary.md`.
353
+ Create `{phase}-{plan}-SUMMARY.md` at `.planning/phases/XX-name/`. Use `/home/qualia/.claude/qualia-framework/templates/summary.md`.
354
354
 
355
355
  **Frontmatter:** phase, plan, subsystem, tags | requires/provides/affects | tech-stack.added/patterns | key-files.created/modified | key-decisions | duration ($DURATION), completed ($PLAN_END_TIME date).
356
356
 
@@ -387,7 +387,7 @@ More plans → update plan count, keep "In progress". Last plan → mark phase "
387
387
  Task code already committed per-task. Commit plan metadata:
388
388
 
389
389
  ```bash
390
- 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 .planning/ROADMAP.md
390
+ 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 .planning/ROADMAP.md
391
391
  ```
392
392
  </step>
393
393
 
@@ -18,7 +18,7 @@ Display the complete Qualia command reference. Output ONLY the reference content
18
18
  Qualia evolves fast. Update periodically:
19
19
 
20
20
  ```bash
21
- npx qualia-engine-cc@latest
21
+ npx qualia-framework-cc@latest
22
22
  ```
23
23
 
24
24
  ## Core Workflow
@@ -322,7 +322,7 @@ Update Qualia to latest version with changelog preview.
322
322
  - Displays changelog entries for versions you've missed
323
323
  - Highlights breaking changes
324
324
  - Confirms before running install
325
- - Better than raw `npx qualia-engine-cc`
325
+ - Better than raw `npx qualia-framework-cc`
326
326
 
327
327
  Usage: `/qualia:update`
328
328
 
@@ -48,7 +48,7 @@ fi
48
48
  Load phase operation context:
49
49
 
50
50
  ```bash
51
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init phase-op "${after_phase}")
51
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "${after_phase}")
52
52
  ```
53
53
 
54
54
  Check `roadmap_exists` from init JSON. If false:
@@ -80,7 +80,7 @@ Verify that the target phase exists in the roadmap:
80
80
  Calculate next decimal phase number:
81
81
 
82
82
  ```bash
83
- DECIMAL_INFO=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phase next-decimal "${after_phase}")
83
+ DECIMAL_INFO=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phase next-decimal "${after_phase}")
84
84
  ```
85
85
 
86
86
  Extract from JSON:
@@ -104,7 +104,7 @@ Convert the phase description to a kebab-case slug.
104
104
 
105
105
  Use `generate-slug` command (init phase-op provides `phase_slug` for existing phase, but this is a new phase):
106
106
  ```bash
107
- slug=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js generate-slug "$description" --raw)
107
+ slug=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js generate-slug "$description" --raw)
108
108
  ```
109
109
 
110
110
  Phase directory name: `{decimal-phase}-{slug}`
@@ -26,7 +26,7 @@ Documents are reference material for Claude when planning/executing. Always incl
26
26
  Load codebase mapping context:
27
27
 
28
28
  ```bash
29
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init map-codebase)
29
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init map-codebase)
30
30
  ```
31
31
 
32
32
  Extract from init JSON: `mapper_model`, `commit_docs`, `codebase_dir`, `existing_maps`, `has_maps`, `codebase_dir_exists`.
@@ -262,7 +262,7 @@ Continue to commit_codebase_map.
262
262
  Commit the codebase map:
263
263
 
264
264
  ```bash
265
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: map existing codebase" --files .planning/codebase/*.md
265
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: map existing codebase" --files .planning/codebase/*.md
266
266
  ```
267
267
 
268
268
  Continue to offer_next.
@@ -71,13 +71,13 @@ Keep Accumulated Context section from previous milestone.
71
71
  Delete MILESTONE-CONTEXT.md if exists (consumed).
72
72
 
73
73
  ```bash
74
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: start milestone v[X.Y] [Name]" --files .planning/PROJECT.md .planning/STATE.md
74
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: start milestone v[X.Y] [Name]" --files .planning/PROJECT.md .planning/STATE.md
75
75
  ```
76
76
 
77
77
  ## 7. Load Context and Resolve Models
78
78
 
79
79
  ```bash
80
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init new-milestone)
80
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init new-milestone)
81
81
  ```
82
82
 
83
83
  Extract from init JSON: `researcher_model`, `synthesizer_model`, `roadmapper_model`, `commit_docs`, `research_enabled`, `current_milestone`, `project_exists`, `roadmap_exists`.
@@ -126,7 +126,7 @@ Focus ONLY on what's needed for the NEW features.
126
126
 
127
127
  <output>
128
128
  Write to: .planning/research/{FILE}
129
- Use template: /home/qualia/.claude/qualia-engine/templates/research-project/{FILE}
129
+ Use template: /home/qualia/.claude/qualia-framework/templates/research-project/{FILE}
130
130
  </output>
131
131
  ", subagent_type="qualia-project-researcher", model="{researcher_model}", description="{DIMENSION} research")
132
132
  ```
@@ -150,7 +150,7 @@ Synthesize research outputs into SUMMARY.md.
150
150
  Read: .planning/research/STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md
151
151
 
152
152
  Write to: .planning/research/SUMMARY.md
153
- Use template: /home/qualia/.claude/qualia-engine/templates/research-project/SUMMARY.md
153
+ Use template: /home/qualia/.claude/qualia-framework/templates/research-project/SUMMARY.md
154
154
  Commit after writing.
155
155
  ", subagent_type="qualia-research-synthesizer", model="{synthesizer_model}", description="Synthesize research")
156
156
  ```
@@ -236,7 +236,7 @@ If "adjust": Return to scoping.
236
236
 
237
237
  **Commit requirements:**
238
238
  ```bash
239
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: define milestone v[X.Y] requirements" --files .planning/REQUIREMENTS.md
239
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: define milestone v[X.Y] requirements" --files .planning/REQUIREMENTS.md
240
240
  ```
241
241
 
242
242
  ## 10. Create Roadmap
@@ -311,7 +311,7 @@ Success criteria:
311
311
 
312
312
  **Commit roadmap** (after approval):
313
313
  ```bash
314
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files .planning/ROADMAP.md .planning/STATE.md .planning/REQUIREMENTS.md
314
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: create milestone v[X.Y] roadmap ([N] phases)" --files .planning/ROADMAP.md .planning/STATE.md .planning/REQUIREMENTS.md
315
315
  ```
316
316
 
317
317
  ## 11. Done
@@ -86,13 +86,13 @@ Be specific enough for a fresh Claude to understand immediately.
86
86
 
87
87
  Use `current-timestamp` for last_updated field. You can use init todos (which provides timestamps) or call directly:
88
88
  ```bash
89
- timestamp=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js current-timestamp full --raw)
89
+ timestamp=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js current-timestamp full --raw)
90
90
  ```
91
91
  </step>
92
92
 
93
93
  <step name="commit">
94
94
  ```bash
95
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "wip: [phase-name] paused at task [X]/[Y]" --files .planning/phases/*/.continue-here.md
95
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "wip: [phase-name] paused at task [X]/[Y]" --files .planning/phases/*/.continue-here.md
96
96
  ```
97
97
  </step>
98
98
 
@@ -65,7 +65,7 @@ Gap: Flow "View dashboard" broken at data fetch
65
65
  Find highest existing phase:
66
66
  ```bash
67
67
  # Get sorted phase list, extract last one
68
- PHASES=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phases list)
68
+ PHASES=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phases list)
69
69
  HIGHEST=$(echo "$PHASES" | jq -r '.directories[-1]')
70
70
  ```
71
71
 
@@ -132,7 +132,7 @@ mkdir -p ".planning/phases/{NN}-{name}"
132
132
  ## 8. Commit Roadmap Update
133
133
 
134
134
  ```bash
135
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs(roadmap): add gap closure phases {N}-{M}" --files .planning/ROADMAP.md
135
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs(roadmap): add gap closure phases {N}-{M}" --files .planning/ROADMAP.md
136
136
  ```
137
137
 
138
138
  ## 9. Offer Next Steps
@@ -5,7 +5,7 @@ Create executable phase prompts (PLAN.md files) for a roadmap phase with integra
5
5
  <required_reading>
6
6
  Read all files referenced by the invoking prompt's execution_context before starting.
7
7
 
8
- @/home/qualia/.claude/qualia-engine/references/ui-brand.md
8
+ @/home/qualia/.claude/qualia-framework/references/ui-brand.md
9
9
  </required_reading>
10
10
 
11
11
  <process>
@@ -15,7 +15,7 @@ Read all files referenced by the invoking prompt's execution_context before star
15
15
  Load all context in one call:
16
16
 
17
17
  ```bash
18
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init plan-phase "$PHASE")
18
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init plan-phase "$PHASE")
19
19
  ```
20
20
 
21
21
  Parse JSON for: `researcher_model`, `planner_model`, `checker_model`, `research_enabled`, `plan_checker_enabled`, `commit_docs`, `phase_found`, `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded_phase`, `has_research`, `has_context`, `has_plans`, `plan_count`, `planning_exists`, `roadmap_exists`.
@@ -38,7 +38,7 @@ mkdir -p ".planning/phases/${padded_phase}-${phase_slug}"
38
38
  ## 3. Validate Phase
39
39
 
40
40
  ```bash
41
- PHASE_INFO=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "${PHASE}")
41
+ PHASE_INFO=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "${PHASE}")
42
42
  ```
43
43
 
44
44
  **If `found` is false:** Error with available phases. **If `found` is true:** Extract `phase_number`, `phase_name`, `goal` from JSON.
@@ -73,9 +73,9 @@ Display banner:
73
73
  ### Spawn qualia-phase-researcher
74
74
 
75
75
  ```bash
76
- PHASE_DESC=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "${PHASE}" | jq -r '.section')
76
+ PHASE_DESC=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "${PHASE}" | jq -r '.section')
77
77
  REQUIREMENTS=$(cat .planning/REQUIREMENTS.md 2>/dev/null | grep -A100 "## Requirements" | head -50)
78
- STATE_SNAP=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state-snapshot)
78
+ STATE_SNAP=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state-snapshot)
79
79
  # Extract decisions from state-snapshot JSON: jq '.decisions[] | "\(.phase): \(.summary) - \(.rationale)"'
80
80
  ```
81
81
 
@@ -28,7 +28,7 @@ If empty, re-prompt: "Please provide a task description."
28
28
  **Step 2: Initialize**
29
29
 
30
30
  ```bash
31
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init quick "$DESCRIPTION")
31
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init quick "$DESCRIPTION")
32
32
  ```
33
33
 
34
34
  Parse JSON for: `planner_model`, `executor_model`, `commit_docs`, `next_num`, `slug`, `date`, `timestamp`, `quick_dir`, `task_dir`, `roadmap_exists`, `planning_exists`.
@@ -213,7 +213,7 @@ Use Edit tool to make these changes atomically
213
213
  Stage and commit quick task artifacts:
214
214
 
215
215
  ```bash
216
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs(quick-${next_num}): ${DESCRIPTION}" --files ${QUICK_DIR}/${next_num}-PLAN.md ${QUICK_DIR}/${next_num}-SUMMARY.md .planning/STATE.md
216
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs(quick-${next_num}): ${DESCRIPTION}" --files ${QUICK_DIR}/${next_num}-PLAN.md ${QUICK_DIR}/${next_num}-SUMMARY.md .planning/STATE.md
217
217
  ```
218
218
 
219
219
  Get final commit hash:
@@ -29,7 +29,7 @@ Exit.
29
29
  Load phase operation context:
30
30
 
31
31
  ```bash
32
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init phase-op "${target}")
32
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "${target}")
33
33
  ```
34
34
 
35
35
  Extract: `phase_found`, `phase_dir`, `phase_number`, `commit_docs`, `roadmap_exists`.
@@ -242,7 +242,7 @@ Update any internal references to reflect new numbering.
242
242
  Stage and commit the removal:
243
243
 
244
244
  ```bash
245
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "chore: remove phase {target} ({original-phase-name})" --files .planning/
245
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "chore: remove phase {target} ({original-phase-name})" --files .planning/
246
246
  ```
247
247
 
248
248
  The commit message preserves the historical record of what was removed.
@@ -8,17 +8,17 @@ Standalone research command. For most workflows, use `/qualia:plan-phase` which
8
8
 
9
9
  ## Step 0: Resolve Model Profile
10
10
 
11
- @/home/qualia/.claude/qualia-engine/references/model-profile-resolution.md
11
+ @/home/qualia/.claude/qualia-framework/references/model-profile-resolution.md
12
12
 
13
13
  Resolve model for:
14
14
  - `qualia-phase-researcher`
15
15
 
16
16
  ## Step 1: Normalize and Validate Phase
17
17
 
18
- @/home/qualia/.claude/qualia-engine/references/phase-argument-parsing.md
18
+ @/home/qualia/.claude/qualia-framework/references/phase-argument-parsing.md
19
19
 
20
20
  ```bash
21
- PHASE_INFO=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "${PHASE}")
21
+ PHASE_INFO=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "${PHASE}")
22
22
  ```
23
23
 
24
24
  If `found` is false: Error and exit.
@@ -39,7 +39,7 @@ echo "$PHASE_INFO" | jq -r '.section'
39
39
  cat .planning/REQUIREMENTS.md 2>/dev/null
40
40
  cat .planning/phases/${PHASE}-*/*-CONTEXT.md 2>/dev/null
41
41
  # Decisions from state-snapshot (structured JSON)
42
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state-snapshot | jq '.decisions'
42
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state-snapshot | jq '.decisions'
43
43
  ```
44
44
 
45
45
  ## Step 4: Spawn Researcher
@@ -11,7 +11,7 @@ Instantly restore full project context so "Where were we?" has an immediate, com
11
11
  </purpose>
12
12
 
13
13
  <required_reading>
14
- @/home/qualia/.claude/qualia-engine/references/continuation-format.md
14
+ @/home/qualia/.claude/qualia-framework/references/continuation-format.md
15
15
  </required_reading>
16
16
 
17
17
  <process>
@@ -20,7 +20,7 @@ Instantly restore full project context so "Where were we?" has an immediate, com
20
20
  Load all context in one call:
21
21
 
22
22
  ```bash
23
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init resume)
23
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init resume)
24
24
  ```
25
25
 
26
26
  Parse JSON for: `state_exists`, `roadmap_exists`, `project_exists`, `planning_exists`, `has_interrupted_agent`, `interrupted_agent_id`, `commit_docs`.
@@ -23,8 +23,8 @@ if $ARGUMENTS.profile not in ["quality", "balanced", "budget"]:
23
23
  Ensure config exists and load current state:
24
24
 
25
25
  ```bash
26
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js config-ensure-section
27
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state load)
26
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js config-ensure-section
27
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state load)
28
28
  ```
29
29
 
30
30
  This creates `.planning/config.json` with defaults if missing and loads current config.
@@ -12,8 +12,8 @@ Read all files referenced by the invoking prompt's execution_context before star
12
12
  Ensure config exists and load current state:
13
13
 
14
14
  ```bash
15
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js config-ensure-section
16
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js state load)
15
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js config-ensure-section
16
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js state load)
17
17
  ```
18
18
 
19
19
  Creates `.planning/config.json` with defaults if missing and loads current config values.
@@ -13,11 +13,11 @@ Detect whether Qualia is installed locally or globally by checking both location
13
13
 
14
14
  ```bash
15
15
  # Check local first (takes priority)
16
- if [ -f "./.claude/qualia-engine/VERSION" ]; then
17
- cat "./.claude/qualia-engine/VERSION"
16
+ if [ -f "./.claude/qualia-framework/VERSION" ]; then
17
+ cat "./.claude/qualia-framework/VERSION"
18
18
  echo "LOCAL"
19
- elif [ -f /home/qualia/.claude/qualia-engine/VERSION ]; then
20
- cat /home/qualia/.claude/qualia-engine/VERSION
19
+ elif [ -f /home/qualia/.claude/qualia-framework/VERSION ]; then
20
+ cat /home/qualia/.claude/qualia-framework/VERSION
21
21
  echo "GLOBAL"
22
22
  else
23
23
  echo "UNKNOWN"
@@ -47,14 +47,14 @@ Proceed to install step (treat as version 0.0.0 for comparison).
47
47
  Check npm for latest version:
48
48
 
49
49
  ```bash
50
- npm view qualia-engine-cc version 2>/dev/null
50
+ npm view qualia-framework-cc version 2>/dev/null
51
51
  ```
52
52
 
53
53
  **If npm check fails:**
54
54
  ```
55
55
  Couldn't check for updates (offline or npm unavailable).
56
56
 
57
- To update manually: `npx qualia-engine-cc --global`
57
+ To update manually: `npx qualia-framework-cc --global`
58
58
  ```
59
59
 
60
60
  Exit.
@@ -118,7 +118,7 @@ Exit.
118
118
 
119
119
  ⚠️ **Note:** The installer performs a clean install of Qualia folders:
120
120
  - `skills/qualia/` will be wiped and replaced
121
- - `qualia-engine/` will be wiped and replaced
121
+ - `qualia-framework/` will be wiped and replaced
122
122
  - `agents/qualia-*` files will be replaced
123
123
 
124
124
  (Paths are relative to your install location: `/home/qualia/.claude/` for global, `./.claude/` for local)
@@ -146,12 +146,12 @@ Run the update using the install type detected in step 1:
146
146
 
147
147
  **If LOCAL install:**
148
148
  ```bash
149
- npx qualia-engine-cc --local
149
+ npx qualia-framework-cc --local
150
150
  ```
151
151
 
152
152
  **If GLOBAL install (or unknown):**
153
153
  ```bash
154
- npx qualia-engine-cc --global
154
+ npx qualia-framework-cc --global
155
155
  ```
156
156
 
157
157
  Capture output. If install fails, show error and exit.
@@ -179,7 +179,7 @@ Format completion message (changelog was already shown in confirmation step):
179
179
 
180
180
  ⚠️ Restart Claude Code to pick up the new commands.
181
181
 
182
- [View full changelog](https://github.com/glittercowboy/qualia-engine/blob/main/CHANGELOG.md)
182
+ [View full changelog](https://github.com/glittercowboy/qualia-framework/blob/main/CHANGELOG.md)
183
183
  ```
184
184
  </step>
185
185
 
@@ -18,8 +18,8 @@ Then verify each level against the actual codebase.
18
18
  </core_principle>
19
19
 
20
20
  <required_reading>
21
- @/home/qualia/.claude/qualia-engine/references/verification-patterns.md
22
- @/home/qualia/.claude/qualia-engine/templates/verification-report.md
21
+ @/home/qualia/.claude/qualia-framework/references/verification-patterns.md
22
+ @/home/qualia/.claude/qualia-framework/templates/verification-report.md
23
23
  </required_reading>
24
24
 
25
25
  <process>
@@ -28,14 +28,14 @@ Then verify each level against the actual codebase.
28
28
  Load phase operation context:
29
29
 
30
30
  ```bash
31
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init phase-op "${PHASE_ARG}")
31
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "${PHASE_ARG}")
32
32
  ```
33
33
 
34
34
  Extract from init JSON: `phase_dir`, `phase_number`, `phase_name`, `has_plans`, `plan_count`.
35
35
 
36
36
  Then load phase details and list plans/summaries:
37
37
  ```bash
38
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js roadmap get-phase "${phase_number}"
38
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js roadmap get-phase "${phase_number}"
39
39
  grep -E "^| ${phase_number}" .planning/REQUIREMENTS.md 2>/dev/null
40
40
  ls "$phase_dir"/*-SUMMARY.md "$phase_dir"/*-PLAN.md 2>/dev/null
41
41
  ```
@@ -166,7 +166,7 @@ REPORT_PATH="$PHASE_DIR/${PHASE_NUM}-VERIFICATION.md"
166
166
 
167
167
  Fill template sections: frontmatter (phase/timestamp/status/score), goal achievement, artifact table, wiring table, requirements coverage, anti-patterns, human verification, gaps summary, fix plans (if gaps_found), metadata.
168
168
 
169
- See /home/qualia/.claude/qualia-engine/templates/verification-report.md for complete template.
169
+ See /home/qualia/.claude/qualia-framework/templates/verification-report.md for complete template.
170
170
  </step>
171
171
 
172
172
  <step name="return_to_orchestrator">
@@ -15,7 +15,7 @@ No Pass/Fail buttons. No severity questions. Just: "Here's what should happen. D
15
15
  </philosophy>
16
16
 
17
17
  <template>
18
- @/home/qualia/.claude/qualia-engine/templates/UAT.md
18
+ @/home/qualia/.claude/qualia-framework/templates/UAT.md
19
19
  </template>
20
20
 
21
21
  <process>
@@ -24,7 +24,7 @@ No Pass/Fail buttons. No severity questions. Just: "Here's what should happen. D
24
24
  If $ARGUMENTS contains a phase number, load context:
25
25
 
26
26
  ```bash
27
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init verify-work "${PHASE_ARG}")
27
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init verify-work "${PHASE_ARG}")
28
28
  ```
29
29
 
30
30
  Parse JSON for: `planner_model`, `checker_model`, `commit_docs`, `phase_found`, `phase_dir`, `phase_number`, `phase_name`, `has_verification`.
@@ -321,7 +321,7 @@ Clear Current Test section:
321
321
 
322
322
  Commit the UAT file:
323
323
  ```bash
324
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "test({phase}): complete UAT - {passed} passed, {issues} issues" --files ".planning/phases/XX-name/{phase}-UAT.md"
324
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "test({phase}): complete UAT - {passed} passed, {issues} issues" --files ".planning/phases/XX-name/{phase}-UAT.md"
325
325
  ```
326
326
 
327
327
  Present summary:
@@ -389,7 +389,7 @@ Spawning parallel debug agents to investigate each issue.
389
389
  ```
390
390
 
391
391
  - Load diagnose-issues workflow
392
- - Follow @/home/qualia/.claude/qualia-engine/workflows/diagnose-issues.md
392
+ - Follow @/home/qualia/.claude/qualia-framework/workflows/diagnose-issues.md
393
393
  - Spawn parallel debug agents for each issue
394
394
  - Collect root causes
395
395
  - Update UAT.md with root causes
@@ -22,7 +22,7 @@ COMPONENTS=(
22
22
  "hooks"
23
23
  "rules"
24
24
  "knowledge"
25
- "qualia-engine"
25
+ "qualia-framework"
26
26
  "scripts"
27
27
  )
28
28
 
@@ -21,7 +21,7 @@ Ensure the todos directory exists:
21
21
  mkdir -p .planning/todos
22
22
  ```
23
23
 
24
- Reference: `~/.claude/qualia-engine/workflows/add-todo.md`
24
+ Reference: `~/.claude/qualia-framework/workflows/add-todo.md`
25
25
 
26
26
  ### 2. Extract Content
27
27
 
@@ -21,7 +21,7 @@ Read all files in `.planning/todos/`. Parse frontmatter for status, area, priori
21
21
 
22
22
  Also read `.planning/STATE.md` and `.planning/ROADMAP.md` for project context.
23
23
 
24
- Reference: `~/.claude/qualia-engine/workflows/check-todos.md`
24
+ Reference: `~/.claude/qualia-framework/workflows/check-todos.md`
25
25
 
26
26
  ### 2. Display List
27
27
 
@@ -20,7 +20,7 @@ Systematic debugging with four modes: interactive symptom-based debugging, deep
20
20
 
21
21
  Load state with `qualia-tools.js`:
22
22
  ```bash
23
- node ~/.claude/qualia-engine/bin/qualia-tools.js phase-op current
23
+ node ~/.claude/qualia-framework/bin/qualia-tools.js phase-op current
24
24
  ```
25
25
 
26
26
  Check for existing debug sessions in `.planning/debug/`.
@@ -59,7 +59,7 @@ Reference: `~/.claude/agents/qualia-debugger.md`
59
59
 
60
60
  Model resolution:
61
61
  ```bash
62
- node ~/.claude/qualia-engine/bin/qualia-tools.js resolve-model qualia-debugger
62
+ node ~/.claude/qualia-framework/bin/qualia-tools.js resolve-model qualia-debugger
63
63
  ```
64
64
 
65
65
  The debugger follows a systematic approach: