qualia-framework 5.5.0 → 5.9.0
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 +17 -13
- package/agents/plan-checker.md +8 -0
- package/agents/qa-browser.md +7 -0
- package/agents/research-synthesizer.md +4 -1
- package/agents/researcher.md +6 -1
- package/agents/roadmapper.md +8 -0
- package/agents/verifier.md +14 -1
- package/agents/visual-evaluator.md +1 -1
- package/bin/cli.js +30 -1
- package/bin/erp-retry.js +289 -0
- package/bin/install.js +12 -6
- package/bin/slop-detect.mjs +1 -1
- package/bin/state.js +10 -1
- package/docs/onboarding.html +621 -0
- package/docs/playwright-loop-pilot-results.md +7 -5
- package/docs/research/2026-05-11-deep-research.md +189 -0
- package/guide.md +5 -6
- package/hooks/session-start.js +19 -1
- package/package.json +3 -2
- package/rules/speed.md +1 -2
- package/skills/qualia-discuss/SKILL.md +106 -6
- package/skills/qualia-feature/SKILL.md +216 -0
- package/skills/qualia-milestone/SKILL.md +73 -1
- package/skills/qualia-new/SKILL.md +52 -25
- package/skills/qualia-optimize/SKILL.md +1 -1
- package/skills/{qualia-polish-loop → qualia-polish}/REFERENCE.md +5 -5
- package/skills/qualia-polish/SKILL.md +13 -4
- package/skills/{qualia-polish-loop → qualia-polish}/scripts/loop.mjs +2 -2
- package/skills/{qualia-polish-loop → qualia-polish}/scripts/playwright-capture.mjs +1 -1
- package/skills/qualia-report/SKILL.md +64 -2
- package/skills/qualia-road/SKILL.md +10 -11
- package/skills/qualia-verify/SKILL.md +16 -0
- package/templates/help.html +2 -3
- package/templates/project-discovery.md +83 -0
- package/templates/project.md +7 -0
- package/tests/bin.test.sh +97 -67
- package/tests/refs.test.sh +146 -0
- package/tests/slop-detect.test.sh +2 -2
- package/skills/qualia-polish-loop/SKILL.md +0 -201
- package/skills/qualia-prd/SKILL.md +0 -199
- package/skills/qualia-quick/SKILL.md +0 -44
- package/skills/qualia-task/SKILL.md +0 -98
- /package/skills/{qualia-polish-loop → qualia-polish}/fixtures/broken.html +0 -0
- /package/skills/{qualia-polish-loop → qualia-polish}/fixtures/clean.html +0 -0
- /package/skills/{qualia-polish-loop → qualia-polish}/scripts/score.mjs +0 -0
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: qualia-task
|
|
3
|
-
description: "Single focused task with a FRESH builder subagent spawn — 1-3 hours, 1-5 files, atomic commit, validation contract. Heavier than /qualia-quick (which runs inline with no spawn) but lighter than /qualia-build (which needs a phase plan). Use when the user says 'build this one thing', 'add a component', 'implement this feature', 'qualia-task', or for any 1-5 file feature outside a full phase."
|
|
4
|
-
allowed-tools:
|
|
5
|
-
- Bash
|
|
6
|
-
- Read
|
|
7
|
-
- Write
|
|
8
|
-
- Edit
|
|
9
|
-
- Agent
|
|
10
|
-
- AskUserQuestion
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
# /qualia-task — Single Task Builder
|
|
14
|
-
|
|
15
|
-
Build one thing properly. Fresh builder context, atomic commit, but no phase plan needed.
|
|
16
|
-
|
|
17
|
-
## Usage
|
|
18
|
-
`/qualia-task` — describe what to build interactively
|
|
19
|
-
`/qualia-task {description}` — build it directly
|
|
20
|
-
|
|
21
|
-
## When to Use
|
|
22
|
-
- One feature, 1-5 files, clear scope, 1-3 hours of work
|
|
23
|
-
- Adding a single feature, component, API route, or integration
|
|
24
|
-
- Refactoring one module
|
|
25
|
-
- Building something specific someone asked for
|
|
26
|
-
|
|
27
|
-
## Process
|
|
28
|
-
|
|
29
|
-
### 1. Clarify
|
|
30
|
-
|
|
31
|
-
If no description provided, ask: **"What do you want to build?"**
|
|
32
|
-
|
|
33
|
-
Then use AskUserQuestion:
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
question: "How complex is this task?"
|
|
37
|
-
header: "Scope"
|
|
38
|
-
options:
|
|
39
|
-
- label: "Small (1-2hrs)"
|
|
40
|
-
description: "Single file or component, straightforward implementation"
|
|
41
|
-
- label: "Medium (2-3hrs)"
|
|
42
|
-
description: "Multiple files, some integration work, needs testing"
|
|
43
|
-
- label: "Large (3hrs+)"
|
|
44
|
-
description: "Significant feature, multiple components — use /qualia-plan instead"
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
If "Large" — suggest `/qualia-plan` instead. Ask if they want to proceed anyway.
|
|
48
|
-
|
|
49
|
-
### 2. Task Spec
|
|
50
|
-
|
|
51
|
-
Write a quick task spec (don't save to file, just confirm with user):
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
node ~/.claude/bin/qualia-ui.js banner task
|
|
55
|
-
node ~/.claude/bin/qualia-ui.js info "What: {what to build}"
|
|
56
|
-
node ~/.claude/bin/qualia-ui.js info "Files: {files to create/modify}"
|
|
57
|
-
node ~/.claude/bin/qualia-ui.js info "Done: {what done looks like}"
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
Ask: **"Good to build?"**
|
|
61
|
-
|
|
62
|
-
### 3. Build
|
|
63
|
-
|
|
64
|
-
Spawn a builder agent with the task:
|
|
65
|
-
|
|
66
|
-
```
|
|
67
|
-
Agent(subagent_type: "qualia-builder")
|
|
68
|
-
|
|
69
|
-
Task: {task description}
|
|
70
|
-
Files: {files to create/modify}
|
|
71
|
-
Acceptance Criteria: {observable completion criteria, 1-3 bullet points}
|
|
72
|
-
|
|
73
|
-
Context: Read PROJECT.md if it exists. Follow all rules (security, frontend, deployment).
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
The builder runs in fresh context — reads before writing, follows rules, commits atomically.
|
|
77
|
-
|
|
78
|
-
### 4. Verify
|
|
79
|
-
|
|
80
|
-
After the builder finishes:
|
|
81
|
-
- Run `npx tsc --noEmit` if TypeScript
|
|
82
|
-
- Quick smoke test if applicable
|
|
83
|
-
- Review what was built
|
|
84
|
-
|
|
85
|
-
### 5. Report
|
|
86
|
-
|
|
87
|
-
```bash
|
|
88
|
-
node ~/.claude/bin/qualia-ui.js divider
|
|
89
|
-
node ~/.claude/bin/qualia-ui.js ok "Task: {description}"
|
|
90
|
-
node ~/.claude/bin/qualia-ui.js ok "Files: {files changed}"
|
|
91
|
-
node ~/.claude/bin/qualia-ui.js ok "Commit: {commit hash}"
|
|
92
|
-
node ~/.claude/bin/qualia-ui.js end "TASK COMPLETE"
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
```bash
|
|
96
|
-
node ~/.claude/bin/state.js transition --to note --notes "{task description}" --tasks-done 1
|
|
97
|
-
```
|
|
98
|
-
Do NOT manually edit STATE.md or tracking.json — state.js handles both.
|
|
File without changes
|
|
File without changes
|
|
File without changes
|