qualia-framework 2.4.4 → 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.
- package/README.md +1 -1
- package/bin/cli.js +1 -1
- package/framework/agents/qualia-debugger.md +1 -1
- package/framework/agents/qualia-executor.md +4 -4
- package/framework/agents/qualia-plan-checker.md +2 -2
- package/framework/agents/qualia-roadmapper.md +2 -2
- package/framework/agents/qualia-verifier.md +1 -1
- package/framework/hooks/migration-validate.sh +13 -10
- package/framework/hooks/pre-deploy-gate.sh +14 -12
- package/framework/qualia-framework/VERSION +1 -1
- package/framework/qualia-framework/bin/collect-metrics.sh +8 -12
- package/framework/qualia-framework/bin/qualia-tools.js +1 -1
- package/framework/qualia-framework/references/decimal-phase-calculation.md +4 -4
- package/framework/qualia-framework/references/model-profile-resolution.md +1 -1
- package/framework/qualia-framework/references/phase-argument-parsing.md +3 -3
- package/framework/qualia-framework/references/planning-config.md +5 -5
- package/framework/qualia-framework/references/verification-patterns.md +1 -1
- package/framework/qualia-framework/templates/codebase/structure.md +10 -10
- package/framework/qualia-framework/templates/phase-prompt.md +10 -10
- package/framework/qualia-framework/workflows/add-phase.md +2 -2
- package/framework/qualia-framework/workflows/add-todo.md +3 -3
- package/framework/qualia-framework/workflows/audit-milestone.md +3 -3
- package/framework/qualia-framework/workflows/check-todos.md +2 -2
- package/framework/qualia-framework/workflows/complete-milestone.md +4 -4
- package/framework/qualia-framework/workflows/diagnose-issues.md +1 -1
- package/framework/qualia-framework/workflows/discovery-phase.md +5 -5
- package/framework/qualia-framework/workflows/discuss-phase.md +4 -4
- package/framework/qualia-framework/workflows/execute-plan.md +8 -8
- package/framework/qualia-framework/workflows/help.md +2 -2
- package/framework/qualia-framework/workflows/insert-phase.md +3 -3
- package/framework/qualia-framework/workflows/map-codebase.md +2 -2
- package/framework/qualia-framework/workflows/new-milestone.md +6 -6
- package/framework/qualia-framework/workflows/pause-work.md +2 -2
- package/framework/qualia-framework/workflows/plan-milestone-gaps.md +2 -2
- package/framework/qualia-framework/workflows/plan-phase.md +5 -5
- package/framework/qualia-framework/workflows/quick.md +2 -2
- package/framework/qualia-framework/workflows/remove-phase.md +2 -2
- package/framework/qualia-framework/workflows/research-phase.md +4 -4
- package/framework/qualia-framework/workflows/resume-project.md +2 -2
- package/framework/qualia-framework/workflows/set-profile.md +2 -2
- package/framework/qualia-framework/workflows/settings.md +2 -2
- package/framework/qualia-framework/workflows/update.md +10 -10
- package/framework/qualia-framework/workflows/verify-phase.md +5 -5
- package/framework/qualia-framework/workflows/verify-work.md +4 -4
- package/framework/scripts/sync-to-framework.sh +1 -1
- package/framework/skills/qualia-add-todo/SKILL.md +1 -1
- package/framework/skills/qualia-check-todos/SKILL.md +1 -1
- package/framework/skills/qualia-debug/SKILL.md +2 -2
- package/framework/skills/qualia-discuss-phase/SKILL.md +2 -2
- package/framework/skills/qualia-framework-audit/SKILL.md +1 -1
- package/framework/skills/qualia-list-phase-assumptions/SKILL.md +1 -1
- package/framework/skills/qualia-new-milestone/SKILL.md +4 -4
- package/framework/skills/qualia-optimize/SKILL.md +1 -1
- package/framework/skills/qualia-pause-work/SKILL.md +1 -1
- package/framework/skills/qualia-plan-milestone-gaps/SKILL.md +1 -1
- package/framework/skills/qualia-progress/SKILL.md +1 -1
- package/framework/skills/qualia-quick/SKILL.md +1 -1
- package/framework/skills/qualia-research-phase/SKILL.md +2 -2
- package/framework/skills/qualia-resume-work/SKILL.md +1 -1
- package/framework/skills/qualia-review/SKILL.md +1 -1
- 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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
18
|
+
@/home/qualia/.claude/qualia-framework/references/phase-argument-parsing.md
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
PHASE_INFO=$(node /home/qualia/.claude/qualia-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
27
|
-
INIT=$(node /home/qualia/.claude/qualia-
|
|
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-
|
|
16
|
-
INIT=$(node /home/qualia/.claude/qualia-
|
|
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-
|
|
17
|
-
cat "./.claude/qualia-
|
|
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-
|
|
20
|
-
cat /home/qualia/.claude/qualia-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
149
|
+
npx qualia-framework-cc --local
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
**If GLOBAL install (or unknown):**
|
|
153
153
|
```bash
|
|
154
|
-
npx qualia-
|
|
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-
|
|
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-
|
|
22
|
-
@/home/qualia/.claude/qualia-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
@@ -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-
|
|
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-
|
|
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-
|
|
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:
|