qualia-framework-v2 2.1.1 → 2.3.0

package/skills/qualia-task/SKILL.md

@@ -89,4 +89,7 @@ After the builder finishes:
   Status    ✓ Done
 ```
 
-Update `.planning/tracking.json` notes field if it exists.
+```bash
+node ~/.claude/bin/state.js transition --to note --notes "{task description}"
+```
+Do NOT manually edit STATE.md or tracking.json — state.js handles both.

package/skills/qualia-verify/SKILL.md

@@ -75,5 +75,10 @@ Read the verification report. Present:
 
 ### 4. Update State
 
-Update STATE.md: verification result
-Update tracking.json: verification → "pass" or "fail"
+```bash
+node ~/.claude/bin/state.js transition --to verified --phase {N} --verification {pass|fail}
+```
+If PASS and more phases: state.js auto-advances to the next phase.
+If FAIL and gap_cycles >= 2: state.js returns GAP_CYCLE_LIMIT — tell the employee to escalate.
+If FAIL and gap_cycles < 2: proceed to `/qualia-plan {N} --gaps`.
+Do NOT manually edit STATE.md or tracking.json — state.js handles both.

package/templates/tracking.json

@@ -11,6 +11,7 @@
   "tasks_done": 0,
   "tasks_total": 0,
   "verification": "pending",
+  "gap_cycles": {},
   "blockers": [],
   "last_updated": "",
   "last_commit": "",