qualia-framework-v2 2.0.0

package/skills/qualia-verify/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: qualia-verify
+description: "Goal-backward verification — checks if the phase ACTUALLY works, not just if tasks completed. Spawns verifier agent."
+---
+
+# /qualia-verify — Verify a Phase
+
+Spawn a verifier agent to check if the phase goal was achieved. Does NOT trust build summaries — greps the actual codebase.
+
+## Usage
+`/qualia-verify` — verify the current built phase
+`/qualia-verify {N}` — verify specific phase
+
+## Process
+
+### 1. Load Context
+
+```bash
+echo "---PLAN---"
+cat .planning/phase-{N}-plan.md 2>/dev/null
+echo "---PREVIOUS---"
+cat .planning/phase-{N}-verification.md 2>/dev/null || echo "NONE"
+```
+
+### 2. Spawn Verifier (Fresh Context)
+
+```
+◆ QUALIA ► VERIFYING Phase {N}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Spawning verifier...
+```
+
+```
+Agent(prompt="
+Read your role: @agents/verifier.md
+
+Phase plan with success criteria:
+@.planning/phase-{N}-plan.md
+
+{If re-verification: Previous verification with gaps:}
+{@.planning/phase-{N}-verification.md}
+
+Verify this phase. Write report to .planning/phase-{N}-verification.md
+", subagent_type="general-purpose", description="Verify phase {N}")
+```
+
+### 3. Present Results
+
+Read the verification report. Present:
+
+**If PASS:**
+```
+◆ QUALIA ► Phase {N} VERIFIED ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  All {count} criteria passed.
+
+  → Run: /qualia-plan {N+1}
+```
+
+**If FAIL:**
+```
+◆ QUALIA ► Phase {N} GAPS FOUND
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Passed: {pass_count}
+  Failed: {fail_count}
+
+  Gaps:
+    ✗ {gap 1 — specific description}
+    ✗ {gap 2 — specific description}
+
+  → Run: /qualia-plan {N} --gaps
+```
+
+### 4. Update State
+
+Update STATE.md: verification result
+Update tracking.json: verification → "pass" or "fail"

package/statusline.sh

@@ -0,0 +1,93 @@
+#!/bin/bash
+# Qualia status line — teal branded, shows phase + context + git
+input=$(cat)
+
+MODEL=$(echo "$input" | jq -r '.model.display_name')
+DIR=$(echo "$input" | jq -r '.workspace.current_dir')
+PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
+DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // 0')
+AGENT=$(echo "$input" | jq -r '.agent.name // empty')
+WORKTREE=$(echo "$input" | jq -r '.worktree.name // empty')
+
+# Teal palette
+T='\033[38;2;0;206;209m'       # Primary teal
+TG='\033[38;2;0;170;175m'      # Teal glow (darker)
+TD='\033[38;2;0;130;135m'      # Teal dim
+W='\033[38;2;220;225;230m'     # White
+DIM='\033[38;2;80;90;100m'     # Dim gray
+GREEN='\033[38;2;52;211;153m'  # Success green
+YELLOW='\033[38;2;234;179;8m'  # Warning
+RED='\033[38;2;239;68;68m'     # Error
+RESET='\033[0m'
+
+# Context bar with teal gradient
+if [ "$PCT" -ge 80 ]; then BAR_COLOR="$RED"
+elif [ "$PCT" -ge 50 ]; then BAR_COLOR="$YELLOW"
+else BAR_COLOR="$T"; fi
+
+BAR_WIDTH=10
+FILLED=$((PCT * BAR_WIDTH / 100))
+EMPTY=$((BAR_WIDTH - FILLED))
+BAR=""
+[ "$FILLED" -gt 0 ] && printf -v FILL "%${FILLED}s" && BAR="${FILL// /━}"
+[ "$EMPTY" -gt 0 ] && printf -v PAD "%${EMPTY}s" && BAR="${BAR}${PAD// /╌}"
+
+# Git branch (cached for speed)
+CACHE="/tmp/qualia-git-cache"
+if [ ! -f "$CACHE" ] || [ $(($(date +%s) - $(stat -c %Y "$CACHE" 2>/dev/null || echo 0))) -gt 3 ]; then
+  BRANCH=""
+  CHANGES=0
+  if git rev-parse --git-dir > /dev/null 2>&1; then
+    BRANCH=$(git branch --show-current 2>/dev/null)
+    CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+  fi
+  echo "$BRANCH|$CHANGES" > "$CACHE"
+fi
+IFS='|' read -r BRANCH CHANGES < "$CACHE"
+
+# Qualia phase from tracking.json
+PHASE_INFO=""
+TRACKING=".planning/tracking.json"
+if [ -f "$TRACKING" ]; then
+  PHASE=$(jq -r '.phase // 0' "$TRACKING" 2>/dev/null)
+  TOTAL=$(jq -r '.total_phases // 0' "$TRACKING" 2>/dev/null)
+  STATUS=$(jq -r '.status // ""' "$TRACKING" 2>/dev/null)
+  if [ "$TOTAL" -gt 0 ]; then
+    # Phase progress mini-bar
+    PDONE=$((PHASE * 100 / TOTAL))
+    PFILL=$((PDONE / 25))
+    PEMPT=$((4 - PFILL))
+    PBAR=""
+    [ "$PFILL" -gt 0 ] && printf -v PF "%${PFILL}s" && PBAR="${PF// /●}"
+    [ "$PEMPT" -gt 0 ] && printf -v PE "%${PEMPT}s" && PBAR="${PBAR}${PE// /○}"
+    PHASE_INFO="${T}${PBAR}${RESET} ${W}P${PHASE}/${TOTAL}${RESET} ${TG}${STATUS}${RESET}"
+  fi
+fi
+
+# Duration
+MINS=$((DURATION_MS / 60000))
+SECS=$(((DURATION_MS % 60000) / 1000))
+[ "$MINS" -gt 0 ] && DUR="${MINS}m" || DUR="${SECS}s"
+
+# Cost
+COST_FMT=$(printf '$%.2f' "$COST")
+
+# Line 1: Project + Git + Phase
+LINE1="${T}◆${RESET} ${W}${DIR##*/}${RESET}"
+if [ -n "$BRANCH" ]; then
+  if [ "$CHANGES" -gt 0 ]; then
+    LINE1="${LINE1} ${DIM}on${RESET} ${TG}${BRANCH}${RESET} ${YELLOW}~${CHANGES}${RESET}"
+  else
+    LINE1="${LINE1} ${DIM}on${RESET} ${TG}${BRANCH}${RESET}"
+  fi
+fi
+[ -n "$AGENT" ] && LINE1="${LINE1} ${DIM}│${RESET} ${T}⚡${AGENT}${RESET}"
+[ -n "$WORKTREE" ] && LINE1="${LINE1} ${DIM}│${RESET} ${TD}⎇ ${WORKTREE}${RESET}"
+[ -n "$PHASE_INFO" ] && LINE1="${LINE1} ${DIM}│${RESET} ${PHASE_INFO}"
+
+# Line 2: Context bar + Cost + Duration + Model
+LINE2="${BAR_COLOR}${BAR}${RESET} ${DIM}${PCT}%${RESET} ${DIM}│${RESET} ${DIM}${COST_FMT}${RESET} ${DIM}│${RESET} ${DIM}${DUR}${RESET} ${DIM}│${RESET} ${TD}${MODEL}${RESET}"
+
+printf '%b\n' "$LINE1"
+printf '%b\n' "$LINE2"

package/templates/plan.md

@@ -0,0 +1,28 @@
+---
+phase: {N}
+goal: "{phase goal}"
+tasks: {count}
+waves: {count}
+---
+
+# Phase {N}: {Name}
+
+Goal: {what must be true when done}
+
+## Task 1 — {title}
+**Wave:** 1
+**Files:** {files to create or modify}
+**Action:** {exactly what to build}
+**Context:** Read @{file references}
+**Done when:** {observable, testable criterion}
+
+## Task 2 — {title}
+**Wave:** 1
+**Files:** {files}
+**Action:** {what to build}
+**Done when:** {criterion}
+
+## Success Criteria
+- [ ] {truth 1 — what the user can do}
+- [ ] {truth 2}
+- [ ] {truth 3}

package/templates/project.md

@@ -0,0 +1,22 @@
+# {Project Name}
+
+## Client
+{client name}
+
+## What We're Building
+{description}
+
+## Requirements
+- [ ] {requirement 1}
+- [ ] {requirement 2}
+- [ ] {requirement 3}
+
+## Out of Scope
+- {exclusion 1}
+
+## Stack
+Next.js 16+ / React 19 / TypeScript / Supabase / Vercel
+
+## Decisions
+| Decision | Why |
+|----------|-----|

package/templates/state.md

@@ -0,0 +1,27 @@
+# Project State
+
+## Project
+See: .planning/PROJECT.md
+
+## Current Position
+Phase: 1 of {N} — {Phase Name}
+Status: ready to plan
+Assigned to: {employee}
+Last activity: {date} — Project initialized
+
+Progress: [░░░░░░░░░░] 0%
+
+## Roadmap
+| # | Phase | Goal | Status |
+|---|-------|------|--------|
+| 1 | {name} | {goal} | ready |
+| 2 | {name} | {goal} | — |
+| 3 | {name} | {goal} | — |
+
+## Blockers
+None.
+
+## Session
+Last session: {date}
+Last worked by: {employee}
+Resume: —

package/templates/tracking.json

@@ -0,0 +1,19 @@
+{
+  "project": "",
+  "client": "",
+  "type": "",
+  "assigned_to": "",
+  "phase": 0,
+  "phase_name": "",
+  "total_phases": 0,
+  "status": "setup",
+  "wave": 0,
+  "tasks_done": 0,
+  "tasks_total": 0,
+  "verification": "pending",
+  "blockers": [],
+  "last_updated": "",
+  "last_commit": "",
+  "deployed_url": "",
+  "notes": ""
+}