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.
- package/README.md +1 -1
- package/bin/cli.js +1 -1
- package/framework/CLAUDE.md +14 -17
- package/framework/agents/backend-agent.md +1 -1
- package/framework/agents/frontend-agent.md +2 -2
- 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/agents/test-agent.md +1 -1
- package/framework/hooks/auto-format.sh +2 -1
- package/framework/hooks/block-env-edit.sh +5 -1
- package/framework/hooks/migration-validate.sh +13 -10
- package/framework/hooks/notification-speak.sh +1 -0
- package/framework/hooks/pre-compact.sh +1 -0
- package/framework/hooks/pre-deploy-gate.sh +14 -12
- package/framework/hooks/qualia-colors.sh +4 -4
- package/framework/hooks/retention-cleanup.sh +10 -0
- package/framework/hooks/save-session-state.sh +2 -0
- package/framework/hooks/session-learn.sh +1 -0
- 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/rules/context7.md +7 -4
- package/framework/rules/speed.md +2 -3
- package/framework/scripts/sync-to-framework.sh +1 -1
- package/framework/skills/animate/SKILL.md +3 -3
- package/framework/skills/bolder/SKILL.md +3 -3
- package/framework/skills/colorize/SKILL.md +3 -3
- package/framework/skills/delight/SKILL.md +3 -3
- package/framework/skills/design-quieter/SKILL.md +3 -3
- package/framework/skills/distill/SKILL.md +3 -3
- 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 +7 -7
- 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-production-check/SKILL.md +0 -314
- 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/framework/teams/review-team.md +75 -0
- package/framework/teams/ship-team.md +86 -0
- package/package.json +1 -1
- 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-
|
|
41
|
-
@/home/qualia/.claude/qualia-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
376
|
-
@/home/qualia/.claude/qualia-
|
|
377
|
-
@/home/qualia/.claude/qualia-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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.
|