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.
Files changed (45) hide show
  1. package/README.md +17 -13
  2. package/agents/plan-checker.md +8 -0
  3. package/agents/qa-browser.md +7 -0
  4. package/agents/research-synthesizer.md +4 -1
  5. package/agents/researcher.md +6 -1
  6. package/agents/roadmapper.md +8 -0
  7. package/agents/verifier.md +14 -1
  8. package/agents/visual-evaluator.md +1 -1
  9. package/bin/cli.js +30 -1
  10. package/bin/erp-retry.js +289 -0
  11. package/bin/install.js +12 -6
  12. package/bin/slop-detect.mjs +1 -1
  13. package/bin/state.js +10 -1
  14. package/docs/onboarding.html +621 -0
  15. package/docs/playwright-loop-pilot-results.md +7 -5
  16. package/docs/research/2026-05-11-deep-research.md +189 -0
  17. package/guide.md +5 -6
  18. package/hooks/session-start.js +19 -1
  19. package/package.json +3 -2
  20. package/rules/speed.md +1 -2
  21. package/skills/qualia-discuss/SKILL.md +106 -6
  22. package/skills/qualia-feature/SKILL.md +216 -0
  23. package/skills/qualia-milestone/SKILL.md +73 -1
  24. package/skills/qualia-new/SKILL.md +52 -25
  25. package/skills/qualia-optimize/SKILL.md +1 -1
  26. package/skills/{qualia-polish-loop → qualia-polish}/REFERENCE.md +5 -5
  27. package/skills/qualia-polish/SKILL.md +13 -4
  28. package/skills/{qualia-polish-loop → qualia-polish}/scripts/loop.mjs +2 -2
  29. package/skills/{qualia-polish-loop → qualia-polish}/scripts/playwright-capture.mjs +1 -1
  30. package/skills/qualia-report/SKILL.md +64 -2
  31. package/skills/qualia-road/SKILL.md +10 -11
  32. package/skills/qualia-verify/SKILL.md +16 -0
  33. package/templates/help.html +2 -3
  34. package/templates/project-discovery.md +83 -0
  35. package/templates/project.md +7 -0
  36. package/tests/bin.test.sh +97 -67
  37. package/tests/refs.test.sh +146 -0
  38. package/tests/slop-detect.test.sh +2 -2
  39. package/skills/qualia-polish-loop/SKILL.md +0 -201
  40. package/skills/qualia-prd/SKILL.md +0 -199
  41. package/skills/qualia-quick/SKILL.md +0 -44
  42. package/skills/qualia-task/SKILL.md +0 -98
  43. /package/skills/{qualia-polish-loop → qualia-polish}/fixtures/broken.html +0 -0
  44. /package/skills/{qualia-polish-loop → qualia-polish}/fixtures/clean.html +0 -0
  45. /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.