qualia-framework 2.4.5 → 2.4.9

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 (85) hide show
  1. package/README.md +1 -1
  2. package/bin/cli.js +1 -1
  3. package/framework/CLAUDE.md +14 -17
  4. package/framework/agents/backend-agent.md +1 -1
  5. package/framework/agents/frontend-agent.md +2 -2
  6. package/framework/agents/qualia-debugger.md +1 -1
  7. package/framework/agents/qualia-executor.md +4 -4
  8. package/framework/agents/qualia-plan-checker.md +2 -2
  9. package/framework/agents/qualia-roadmapper.md +2 -2
  10. package/framework/agents/qualia-verifier.md +1 -1
  11. package/framework/agents/test-agent.md +1 -1
  12. package/framework/hooks/auto-format.sh +2 -1
  13. package/framework/hooks/block-env-edit.sh +5 -1
  14. package/framework/hooks/migration-validate.sh +13 -10
  15. package/framework/hooks/notification-speak.sh +1 -0
  16. package/framework/hooks/pre-compact.sh +1 -0
  17. package/framework/hooks/pre-deploy-gate.sh +14 -12
  18. package/framework/hooks/qualia-colors.sh +4 -4
  19. package/framework/hooks/retention-cleanup.sh +10 -0
  20. package/framework/hooks/save-session-state.sh +2 -0
  21. package/framework/hooks/session-learn.sh +1 -0
  22. package/framework/qualia-framework/VERSION +1 -1
  23. package/framework/qualia-framework/bin/collect-metrics.sh +8 -12
  24. package/framework/qualia-framework/bin/qualia-tools.js +1 -1
  25. package/framework/qualia-framework/references/decimal-phase-calculation.md +4 -4
  26. package/framework/qualia-framework/references/model-profile-resolution.md +1 -1
  27. package/framework/qualia-framework/references/phase-argument-parsing.md +3 -3
  28. package/framework/qualia-framework/references/planning-config.md +5 -5
  29. package/framework/qualia-framework/references/verification-patterns.md +1 -1
  30. package/framework/qualia-framework/templates/codebase/structure.md +10 -10
  31. package/framework/qualia-framework/templates/phase-prompt.md +10 -10
  32. package/framework/qualia-framework/workflows/add-phase.md +2 -2
  33. package/framework/qualia-framework/workflows/add-todo.md +3 -3
  34. package/framework/qualia-framework/workflows/audit-milestone.md +3 -3
  35. package/framework/qualia-framework/workflows/check-todos.md +2 -2
  36. package/framework/qualia-framework/workflows/complete-milestone.md +4 -4
  37. package/framework/qualia-framework/workflows/diagnose-issues.md +1 -1
  38. package/framework/qualia-framework/workflows/discovery-phase.md +5 -5
  39. package/framework/qualia-framework/workflows/discuss-phase.md +4 -4
  40. package/framework/qualia-framework/workflows/execute-plan.md +8 -8
  41. package/framework/qualia-framework/workflows/help.md +2 -2
  42. package/framework/qualia-framework/workflows/insert-phase.md +3 -3
  43. package/framework/qualia-framework/workflows/map-codebase.md +2 -2
  44. package/framework/qualia-framework/workflows/new-milestone.md +6 -6
  45. package/framework/qualia-framework/workflows/pause-work.md +2 -2
  46. package/framework/qualia-framework/workflows/plan-milestone-gaps.md +2 -2
  47. package/framework/qualia-framework/workflows/plan-phase.md +5 -5
  48. package/framework/qualia-framework/workflows/quick.md +2 -2
  49. package/framework/qualia-framework/workflows/remove-phase.md +2 -2
  50. package/framework/qualia-framework/workflows/research-phase.md +4 -4
  51. package/framework/qualia-framework/workflows/resume-project.md +2 -2
  52. package/framework/qualia-framework/workflows/set-profile.md +2 -2
  53. package/framework/qualia-framework/workflows/settings.md +2 -2
  54. package/framework/qualia-framework/workflows/update.md +10 -10
  55. package/framework/qualia-framework/workflows/verify-phase.md +5 -5
  56. package/framework/qualia-framework/workflows/verify-work.md +4 -4
  57. package/framework/rules/context7.md +7 -4
  58. package/framework/rules/speed.md +2 -3
  59. package/framework/scripts/sync-to-framework.sh +1 -1
  60. package/framework/skills/animate/SKILL.md +3 -3
  61. package/framework/skills/bolder/SKILL.md +3 -3
  62. package/framework/skills/colorize/SKILL.md +3 -3
  63. package/framework/skills/delight/SKILL.md +3 -3
  64. package/framework/skills/design-quieter/SKILL.md +3 -3
  65. package/framework/skills/distill/SKILL.md +3 -3
  66. package/framework/skills/qualia-add-todo/SKILL.md +1 -1
  67. package/framework/skills/qualia-check-todos/SKILL.md +1 -1
  68. package/framework/skills/qualia-debug/SKILL.md +2 -2
  69. package/framework/skills/qualia-discuss-phase/SKILL.md +2 -2
  70. package/framework/skills/qualia-framework-audit/SKILL.md +1 -1
  71. package/framework/skills/qualia-list-phase-assumptions/SKILL.md +1 -1
  72. package/framework/skills/qualia-new-milestone/SKILL.md +4 -4
  73. package/framework/skills/qualia-optimize/SKILL.md +7 -7
  74. package/framework/skills/qualia-pause-work/SKILL.md +1 -1
  75. package/framework/skills/qualia-plan-milestone-gaps/SKILL.md +1 -1
  76. package/framework/skills/qualia-production-check/SKILL.md +0 -314
  77. package/framework/skills/qualia-progress/SKILL.md +1 -1
  78. package/framework/skills/qualia-quick/SKILL.md +1 -1
  79. package/framework/skills/qualia-research-phase/SKILL.md +2 -2
  80. package/framework/skills/qualia-resume-work/SKILL.md +1 -1
  81. package/framework/skills/qualia-review/SKILL.md +1 -1
  82. package/framework/teams/review-team.md +75 -0
  83. package/framework/teams/ship-team.md +86 -0
  84. package/package.json +1 -1
  85. package/framework/skills/qualia-workflow/SKILL.md +0 -130
@@ -37,10 +37,10 @@ Output: [What artifacts will be created]
37
37
  </objective>
38
38
 
39
39
  <execution_context>
40
- @/home/qualia/.claude/qualia-engine/workflows/execute-plan.md
41
- @/home/qualia/.claude/qualia-engine/templates/summary.md
40
+ @/home/qualia/.claude/qualia-framework/workflows/execute-plan.md
41
+ @/home/qualia/.claude/qualia-framework/templates/summary.md
42
42
  [If plan contains checkpoint tasks (type="checkpoint:*"), add:]
43
- @/home/qualia/.claude/qualia-engine/references/checkpoints.md
43
+ @/home/qualia/.claude/qualia-framework/references/checkpoints.md
44
44
  </execution_context>
45
45
 
46
46
  <context>
@@ -75,7 +75,7 @@ Output: [What artifacts will be created]
75
75
  <done>[Acceptance criteria]</done>
76
76
  </task>
77
77
 
78
- <!-- For checkpoint task examples and patterns, see @/home/qualia/.claude/qualia-engine/references/checkpoints.md -->
78
+ <!-- For checkpoint task examples and patterns, see @/home/qualia/.claude/qualia-framework/references/checkpoints.md -->
79
79
  <!-- Key rule: Claude starts dev server BEFORE human-verify checkpoints. User only visits URLs. -->
80
80
 
81
81
  <task type="checkpoint:decision" gate="blocking">
@@ -268,7 +268,7 @@ TDD features get dedicated plans with `type: tdd`.
268
268
  → Yes: Create a TDD plan
269
269
  → No: Standard task in standard plan
270
270
 
271
- See `/home/qualia/.claude/qualia-engine/references/tdd.md` for TDD plan structure.
271
+ See `/home/qualia/.claude/qualia-framework/references/tdd.md` for TDD plan structure.
272
272
 
273
273
  ---
274
274
 
@@ -372,9 +372,9 @@ Output: Working dashboard component.
372
372
  </objective>
373
373
 
374
374
  <execution_context>
375
- @/home/qualia/.claude/qualia-engine/workflows/execute-plan.md
376
- @/home/qualia/.claude/qualia-engine/templates/summary.md
377
- @/home/qualia/.claude/qualia-engine/references/checkpoints.md
375
+ @/home/qualia/.claude/qualia-framework/workflows/execute-plan.md
376
+ @/home/qualia/.claude/qualia-framework/templates/summary.md
377
+ @/home/qualia/.claude/qualia-framework/references/checkpoints.md
378
378
  </execution_context>
379
379
 
380
380
  <context>
@@ -497,7 +497,7 @@ user_setup:
497
497
 
498
498
  **Result:** Execute-plan generates `{phase}-USER-SETUP.md` with checklist for the user.
499
499
 
500
- See `/home/qualia/.claude/qualia-engine/templates/user-setup.md` for full schema and examples
500
+ See `/home/qualia/.claude/qualia-framework/templates/user-setup.md` for full schema and examples
501
501
 
502
502
  ---
503
503
 
@@ -564,4 +564,4 @@ Task completion ≠ Goal achievement. A task "create chat component" can complet
564
564
  5. Gaps found → fix plans created → execute → re-verify
565
565
  6. All must_haves pass → phase complete
566
566
 
567
- See `/home/qualia/.claude/qualia-engine/workflows/verify-phase.md` for verification logic.
567
+ See `/home/qualia/.claude/qualia-framework/workflows/verify-phase.md` for verification logic.
@@ -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 "0")
32
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init phase-op "0")
33
33
  ```
34
34
 
35
35
  Check `roadmap_exists` from init JSON. If false:
@@ -79,7 +79,7 @@ Convert the phase description to a kebab-case slug.
79
79
 
80
80
  Use `init phase-op` which provides `phase_slug` computed from phase name, or call:
81
81
  ```bash
82
- slug=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js generate-slug "$description" --raw)
82
+ slug=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js generate-slug "$description" --raw)
83
83
  ```
84
84
 
85
85
  Phase directory name: `{two-digit-phase}-{slug}`
@@ -12,7 +12,7 @@ Read all files referenced by the invoking prompt's execution_context before star
12
12
  Load todo context:
13
13
 
14
14
  ```bash
15
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init todos)
15
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init todos)
16
16
  ```
17
17
 
18
18
  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.
83
83
 
84
84
  Generate slug for the title:
85
85
  ```bash
86
- slug=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js generate-slug "$title" --raw)
86
+ slug=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js generate-slug "$title" --raw)
87
87
  ```
88
88
 
89
89
  Write to `.planning/todos/pending/${date}-${slug}.md`:
@@ -118,7 +118,7 @@ If `.planning/STATE.md` exists:
118
118
  Commit the todo and any updated state:
119
119
 
120
120
  ```bash
121
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js commit "docs: capture todo - [title]" --files .planning/todos/pending/[filename] .planning/STATE.md
121
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js commit "docs: capture todo - [title]" --files .planning/todos/pending/[filename] .planning/STATE.md
122
122
  ```
123
123
 
124
124
  Tool respects `commit_docs` config and gitignore automatically.
@@ -11,21 +11,21 @@ Read all files referenced by the invoking prompt's execution_context before star
11
11
  ## 0. Initialize Milestone Context
12
12
 
13
13
  ```bash
14
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init milestone-op)
14
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init milestone-op)
15
15
  ```
16
16
 
17
17
  Extract from init JSON: `milestone_version`, `milestone_name`, `phase_count`, `completed_phases`, `commit_docs`.
18
18
 
19
19
  Resolve integration checker model:
20
20
  ```bash
21
- CHECKER_MODEL=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js resolve-model qualia-integration-checker --raw)
21
+ CHECKER_MODEL=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js resolve-model qualia-integration-checker --raw)
22
22
  ```
23
23
 
24
24
  ## 1. Determine Milestone Scope
25
25
 
26
26
  ```bash
27
27
  # Get phases in milestone (sorted numerically, handles decimals)
28
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js phases list
28
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js phases list
29
29
  ```
30
30
 
31
31
  - Parse version from arguments or detect current from ROADMAP.md
@@ -12,7 +12,7 @@ Read all files referenced by the invoking prompt's execution_context before star
12
12
  Load todo context:
13
13
 
14
14
  ```bash
15
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init todos)
15
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init todos)
16
16
  ```
17
17
 
18
18
  Extract from init JSON: `todo_count`, `todos`, `pending_dir`.
@@ -154,7 +154,7 @@ If todo was moved to done/, commit the change:
154
154
 
155
155
  ```bash
156
156
  git rm --cached .planning/todos/pending/[filename] 2>/dev/null || true
157
- 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
157
+ 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
158
158
  ```
159
159
 
160
160
  Tool respects `commit_docs` config and gitignore automatically.
@@ -133,7 +133,7 @@ Extract one-liners from SUMMARY.md files using summary-extract:
133
133
  ```bash
134
134
  # For each phase in milestone, extract one-liner
135
135
  for summary in .planning/phases/*-*/*-SUMMARY.md; do
136
- node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js summary-extract "$summary" --fields one_liner | jq -r '.one_liner'
136
+ node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js summary-extract "$summary" --fields one_liner | jq -r '.one_liner'
137
137
  done
138
138
  ```
139
139
 
@@ -373,7 +373,7 @@ Update `.planning/ROADMAP.md` — group completed milestone phases:
373
373
  Extract completed milestone details to archive.
374
374
 
375
375
  1. Create `.planning/milestones/v[X.Y]-ROADMAP.md`
376
- 2. Read `/home/qualia/.claude/qualia-engine/templates/milestone-archive.md` template
376
+ 2. Read `/home/qualia/.claude/qualia-framework/templates/milestone-archive.md` template
377
377
  3. Extract from ROADMAP.md: all phases in milestone (by number range), full phase details, plan lists with checkmarks
378
378
  4. Extract from PROJECT.md: key decisions, validated requirements
379
379
  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.
599
599
  Use `init milestone-op` for context, or load config directly:
600
600
 
601
601
  ```bash
602
- INIT=$(node /home/qualia/.claude/qualia-engine/bin/qualia-tools.js init execute-phase "1")
602
+ INIT=$(node /home/qualia/.claude/qualia-framework/bin/qualia-tools.js init execute-phase "1")
603
603
  ```
604
604
 
605
605
  Extract `branching_strategy`, `phase_branch_template`, `milestone_branch_template` from init JSON.
@@ -777,7 +777,7 @@ git push origin v[X.Y]
777
777
  Commit milestone completion.
778
778
 
779
779
  ```bash
780
- 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
780
+ 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
781
781
  ```
782
782
  ```
783
783
 
@@ -158,7 +158,7 @@ Update status in frontmatter to "diagnosed".
158
158
 
159
159
  Commit the updated UAT.md:
160
160
  ```bash
161
- 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"
161
+ 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"
162
162
  ```
163
163
  </step>
164
164
 
@@ -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.