qualia-framework 3.4.0 → 3.6.0

package/hooks/pre-push.js

@@ -1,44 +1,104 @@
 #!/usr/bin/env node
-// ~/.claude/hooks/pre-push.js — update tracking.json with last commit + timestamp.
-// PreToolUse hook on `git push*` commands. state.js handles phase/status sync;
-// this just stamps the file so the ERP sees fresh commit info on every push.
-// Cross-platform (Windows/macOS/Linux).
+// ~/.claude/hooks/pre-push.js — stamp tracking.json + commit it before push.
+// PreToolUse hook on `git push*` commands. The stamp is included in the push
+// via a small bot commit (no-verify, bot author) so the ERP — which reads
+// tracking.json straight from git — sees fresh data on every push.
+//
+// Cross-platform (Windows/macOS/Linux). No external dependencies.
+//
+// History rationale: a previous version (≤v3.4.1) wrote the stamp to
+// tracking.json and then `git add`-ed it, but the actual `git push` ran on
+// the snapshot already prepared by Claude Code's tool dispatcher — so the
+// stamp never made it onto the wire. This rewrite creates a real commit so
+// the next `git push` it spawned by Claude Code includes it.
 
 const fs = require("fs");
 const path = require("path");
+const os = require("os");
 const { spawnSync } = require("child_process");
 
 const _traceStart = Date.now();
-
+const HOME = os.homedir();
 const TRACKING = path.join(".planning", "tracking.json");
+const BOT_AUTHOR = "Qualia Framework <bot@qualia.solutions>";
+const SHELL = process.platform === "win32";
 
-try {
-  if (fs.existsSync(TRACKING)) {
-    const r = spawnSync("git", ["log", "--oneline", "-1", "--format=%h"], {
-      encoding: "utf8",
-      timeout: 3000,
-    });
-    const lastCommit = ((r.stdout || "").trim());
-    const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
-
-    const t = JSON.parse(fs.readFileSync(TRACKING, "utf8"));
-    if (lastCommit) t.last_commit = lastCommit;
-    t.last_updated = now;
-    fs.writeFileSync(TRACKING, JSON.stringify(t, null, 2) + "\n");
-
-    spawnSync("git", ["add", TRACKING], { timeout: 3000 });
+function git(args, opts = {}) {
+  return spawnSync("git", args, {
+    encoding: "utf8",
+    timeout: 5000,
+    shell: SHELL,
+    ...opts,
+  });
+}
+
+function atomicWrite(file, content) {
+  const tmp = `${file}.tmp.${process.pid}`;
+  fs.writeFileSync(tmp, content);
+  fs.renameSync(tmp, file);
+}
+
+function inGitRepo() {
+  const r = git(["rev-parse", "--is-inside-work-tree"], { stdio: ["ignore", "pipe", "ignore"] });
+  return r.status === 0 && (r.stdout || "").trim() === "true";
+}
+
+function commitStamp() {
+  if (!fs.existsSync(TRACKING)) return { skipped: "no-tracking-file" };
+  if (!inGitRepo()) return { skipped: "not-a-git-repo" };
+
+  // Read current commit + stamp
+  const head = git(["log", "--oneline", "-1", "--format=%h"]);
+  const lastCommit = ((head.stdout || "").trim());
+  const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
+
+  // Mutate tracking.json (atomic). Tolerate CRLF on Windows-edited files.
+  let raw, parsed;
+  try {
+    raw = fs.readFileSync(TRACKING, "utf8");
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    return { skipped: "tracking-unreadable", error: err.message };
   }
-} catch (err) {
-  process.stderr.write(`WARNING: tracking sync failed: ${err.message}\n`);
+
+  const before = JSON.stringify({ last_commit: parsed.last_commit, last_updated: parsed.last_updated });
+  if (lastCommit) parsed.last_commit = lastCommit;
+  parsed.last_updated = now;
+  parsed.last_pushed_at = now;
+  const after = JSON.stringify({ last_commit: parsed.last_commit, last_updated: parsed.last_updated });
+  if (before === after) return { skipped: "no-change" };
+
+  atomicWrite(TRACKING, JSON.stringify(parsed, null, 2) + "\n");
+
+  // Commit so the stamp is part of the push that's about to happen.
+  // --no-verify: skip user pre-commit hooks (this is a bot commit).
+  // --no-gpg-sign: don't pop a signing prompt for a chore commit.
+  // --author: attribute to bot, not user.
+  const add = git(["add", TRACKING]);
+  if (add.status !== 0) return { skipped: "git-add-failed", error: add.stderr };
+
+  const commit = git([
+    "commit",
+    "--no-verify",
+    "--no-gpg-sign",
+    "--author", BOT_AUTHOR,
+    "-m", `chore(track): ERP sync ${now}`,
+  ]);
+  if (commit.status !== 0) {
+    // If commit failed (e.g., empty diff because git's auto-CRLF normalized
+    // the only change to nothing), restore the file to keep the working tree
+    // clean and move on. Not fatal.
+    return { skipped: "git-commit-failed", error: (commit.stderr || commit.stdout || "").trim() };
+  }
+  return { committed: true, sha: lastCommit, ts: now };
 }
 
-function _trace(hookName, result, extra) {
+function _trace(result, extra) {
   try {
-    const os = require("os");
-    const traceDir = path.join(os.homedir(), ".claude", ".qualia-traces");
+    const traceDir = path.join(HOME, ".claude", ".qualia-traces");
     if (!fs.existsSync(traceDir)) fs.mkdirSync(traceDir, { recursive: true });
     const entry = {
-      hook: hookName,
+      hook: "pre-push",
       result,
       timestamp: new Date().toISOString(),
       duration_ms: Date.now() - _traceStart,
@@ -49,5 +109,12 @@ function _trace(hookName, result, extra) {
   } catch {}
 }
 
-_trace("pre-push", "allow");
+try {
+  const result = commitStamp();
+  _trace("allow", result);
+} catch (err) {
+  // Never block a push — log and exit clean.
+  _trace("allow", { error: err.message });
+}
+
 process.exit(0);

package/hooks/session-start.js

@@ -14,6 +14,12 @@ const { spawnSync } = require("child_process");
 
 const _traceStart = Date.now();
 
+// ANSI colors used by the no-project welcome panel. Defined here because this
+// file does not import qualia-ui (the hook must run even on a broken install).
+const TEAL = "\x1b[38;2;0;206;209m";
+const DIM = "\x1b[38;2;80;90;100m";
+const RESET = "\x1b[0m";
+
 const HOME = os.homedir();
 const UI = path.join(HOME, ".claude", "bin", "qualia-ui.js");
 const STATE_FILE = path.join(".planning", "STATE.md");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qualia-framework",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "Claude Code workflow framework by Qualia Solutions. Plan, build, verify, ship.",
   "bin": {
     "qualia-framework": "./bin/cli.js"

package/skills/qualia-build/SKILL.md

@@ -61,7 +61,7 @@ Spawn a fresh builder subagent:
 
 ```
 Agent(prompt="
-Read your role: @agents/builder.md
+Read your role: @~/.claude/agents/builder.md
 
 Project context:
 @.planning/PROJECT.md

package/skills/qualia-map/SKILL.md

@@ -47,28 +47,28 @@ Map 4 dimensions in parallel for speed. Each writes one file in `.planning/codeb
 
 ```
 Agent 1: Architecture scanner
-  Task(prompt="
+  Agent(prompt="
   Scan the current codebase and produce .planning/codebase/architecture.md.
   Identify: entry points, folder structure, module boundaries, data flow.
   Focus on WHAT the codebase does, not HOW to fix it.
   ", subagent_type="general-purpose", description="Architecture scan")
 
 Agent 2: Stack detector
-  Task(prompt="
+  Agent(prompt="
   Detect the tech stack. Read package.json, requirements.txt, Gemfile, etc.
   Produce .planning/codebase/stack.md listing: runtime, framework, key libraries,
   database, hosting, CI. Include version numbers.
   ", subagent_type="general-purpose", description="Stack detection")
 
 Agent 3: Conventions analyzer
-  Task(prompt="
+  Agent(prompt="
   Analyze code style and conventions. Sample 10-15 files across the codebase.
   Produce .planning/codebase/conventions.md listing: naming, component patterns,
   file organization, import style, test style, commit message format.
   ", subagent_type="general-purpose", description="Conventions analysis")
 
 Agent 4: Concerns scanner
-  Task(prompt="
+  Agent(prompt="
   Scan for code quality concerns — NOT to fix, just to document.
   Look for: TODO/FIXME, deprecated APIs, outdated dependencies, missing tests,
   security smells (hardcoded secrets, no input validation).

package/skills/qualia-optimize/SKILL.md

@@ -140,7 +140,7 @@ For EVERY finding, output in this exact format:
 - **Fix**: [concrete fix suggestion]
 - **Severity**: CRITICAL | HIGH | MEDIUM | LOW
 </task>",
-  subagent_type="frontend-agent",
+  subagent_type="general-purpose",
   description="Frontend optimization analysis"
 )
 ```
@@ -193,7 +193,7 @@ For EVERY finding, output:
 - **Fix**: [concrete suggestion]
 - **Severity**: CRITICAL | HIGH | MEDIUM | LOW
 </task>",
-  subagent_type="backend-agent",
+  subagent_type="general-purpose",
   description="Backend optimization analysis"
 )
 ```
@@ -240,7 +240,7 @@ For EVERY finding, output:
 - **Fix**: [concrete suggestion]
 - **Severity**: CRITICAL | HIGH | MEDIUM | LOW
 </task>",
-  subagent_type="performance-oracle",
+  subagent_type="general-purpose",
   description="Performance optimization analysis"
 )
 ```
@@ -274,7 +274,7 @@ Output:
 - **Pattern consolidation** (where Wave 1 findings share a root cause)
 - Each finding in the same format: What/Where/Why/Fix/Severity
 </task>",
-  subagent_type="architecture-strategist",
+  subagent_type="general-purpose",
   description="Architecture synthesis"
 )
 ```

package/skills/qualia-quick/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qualia-quick
-description: "Fast path for small tasks — bug fixes, tweaks, hot fixes. Skips full phase planning."
+description: "Fast path for small tasks — bug fixes, tweaks, hot fixes. Skips full phase planning. Trigger on 'quick fix', 'small change', 'tweak', 'hot fix', 'one-line fix', 'quick edit', 'small bug'."
 ---
 
 # /qualia-quick — Quick Task

package/skills/qualia-verify/SKILL.md

@@ -31,7 +31,7 @@ node ~/.claude/bin/qualia-ui.js spawn verifier "Goal-backward check..."
 
 ```
 Agent(prompt="
-Read your role: @agents/verifier.md
+Read your role: @~/.claude/agents/verifier.md
 
 Phase plan with success criteria AND verification contracts:
 @.planning/phase-{N}-plan.md
@@ -56,7 +56,7 @@ If frontend:
 
 ```
 Agent(prompt="
-Read your role: @agents/qa-browser.md
+Read your role: @~/.claude/agents/qa-browser.md
 
 Phase plan: @.planning/phase-{N}-plan.md
 Existing verification: @.planning/phase-{N}-verification.md

package/templates/help.html

@@ -37,6 +37,22 @@
     -webkit-font-smoothing: antialiased;
   }
 
+  /* ─── Version Pill (top-right) ───────────── */
+  .version-pill {
+    position: fixed;
+    top: 1rem;
+    right: 1rem;
+    z-index: 10;
+    padding: 0.3rem 0.75rem;
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-radius: 999px;
+    font-family: var(--font-mono);
+    font-size: 0.7rem;
+    color: var(--teal);
+    letter-spacing: 0.04em;
+  }
+
   /* ─── Header ─────────────────────────────── */
   .header {
     padding: clamp(2rem, 6vw, 4rem) clamp(1.5rem, 5vw, 4rem);
@@ -134,6 +150,12 @@
     color: var(--text-subtle);
     margin-bottom: 0.75rem;
   }
+  .cmd-group-note {
+    font-size: 0.78rem;
+    color: var(--text-subtle);
+    margin: -0.5rem 0 0.75rem 0;
+    font-style: italic;
+  }
   .cmd {
     display: flex;
     gap: 1rem;
@@ -150,7 +172,7 @@
     font-size: 0.85rem;
     color: var(--teal);
     white-space: nowrap;
-    min-width: 160px;
+    min-width: 200px;
   }
   .cmd-desc {
     font-size: 0.85rem;
@@ -244,6 +266,14 @@
     color: var(--text-subtle);
   }
   .footer strong { color: var(--teal); font-weight: 500; }
+  .footer-version {
+    display: block;
+    margin-top: 0.5rem;
+    font-family: var(--font-mono);
+    font-size: 0.7rem;
+    color: var(--text-subtle);
+    letter-spacing: 0.04em;
+  }
 
   /* ─── Responsive ─────────────────────────── */
   @media (max-width: 640px) {
@@ -251,6 +281,7 @@
     .cmd-name { min-width: unset; }
     .road { flex-direction: column; align-items: flex-start; }
     .road-arrow { display: none; }
+    .version-pill { top: 0.5rem; right: 0.5rem; font-size: 0.65rem; }
   }
 
   @media (prefers-reduced-motion: reduce) {
@@ -260,11 +291,13 @@
 </head>
 <body>
 
+<div class="version-pill">v3.6.0</div>
+
 <div class="header">
   <div class="header-content">
     <h1><span>Qualia</span> Framework</h1>
     <p>Plan, build, verify, ship. The AI-powered workflow for Qualia Solutions.</p>
-    <div class="version">v{{VERSION}}</div>
+    <div class="version">v3.6.0 &middot; 26 skills</div>
   </div>
 </div>
 
@@ -293,73 +326,106 @@
     </div>
   </section>
 
-  <!-- Commands -->
+  <!-- Skills -->
   <section>
-    <h2>Commands</h2>
+    <h2>Skills (26)</h2>
 
+    <!-- Road (core flow) -->
     <div class="cmd-group">
-      <h3>Navigation</h3>
+      <h3>Road &mdash; Core Flow</h3>
+      <p class="cmd-group-note">The seven steps every project walks through.</p>
+      <div class="commands">
+        <div class="cmd"><span class="cmd-name">/qualia-new</span><span class="cmd-desc">Set up a new project from scratch &mdash; deep questioning, parallel research, REQUIREMENTS.md, ROADMAP.md, approval gate. Use when starting any new client project.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-plan</span><span class="cmd-desc">Plan the current phase &mdash; spawns planner, validates with plan-checker in a revision loop (max 3), optionally runs discuss/research first. Use when ready to plan a phase.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-build</span><span class="cmd-desc">Execute the current phase &mdash; spawns builder subagents per task with wave-based parallelization. Fresh context per task.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-verify</span><span class="cmd-desc">Goal-backward verification &mdash; checks if the phase ACTUALLY works, not just if tasks completed. Spawns verifier agent.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Design and UX pass &mdash; anti-AI-slop, genuine craft, responsive, accessible. Run after all phases are verified.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-ship</span><span class="cmd-desc">Deploy to production &mdash; quality gates, commit, push, deploy, verify. Use when ready to go live.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-handoff</span><span class="cmd-desc">Client delivery &mdash; credentials, handover doc, final update. Use after shipping.</span></div>
+      </div>
+    </div>
+
+    <!-- Phase Depth (optional) -->
+    <div class="cmd-group">
+      <h3>Phase Depth &mdash; Optional</h3>
+      <p class="cmd-group-note">Used before / around /qualia-plan when a phase needs deeper context.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia</span><span class="cmd-desc">What should I do next? Reads project state, tells you the exact command.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-idk</span><span class="cmd-desc">Same as /qualia. For when you're stuck.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-resume</span><span class="cmd-desc">Pick up where you left off from a previous session.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-pause</span><span class="cmd-desc">Save progress. Creates .continue-here.md for next session.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-discuss</span><span class="cmd-desc">Capture phase decisions, trade-offs, and constraints BEFORE planning. Use for complex phases with regulatory, compliance, or architectural stakes. Creates .planning/phase-{N}-context.md that planner honors as locked input.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-research</span><span class="cmd-desc">Deep-research a niche domain or library BEFORE planning a specific phase. Spawns the researcher agent with Context7/WebFetch access. Writes to .planning/phase-{N}-research.md.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-map</span><span class="cmd-desc">Map an existing codebase to infer architecture, stack, conventions, and what's already built. For brownfield projects &mdash; run BEFORE /qualia-new so Validated requirements get inferred from existing code.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-milestone</span><span class="cmd-desc">Close out a completed milestone and prep the next one. Archives the current milestone's artifacts, updates REQUIREMENTS.md to mark v1 requirements Complete, and creates the next milestone roadmap.</span></div>
       </div>
     </div>
 
+    <!-- Quality -->
     <div class="cmd-group">
-      <h3>Project Setup</h3>
+      <h3>Quality</h3>
+      <p class="cmd-group-note">Diagnose, audit, optimize, polish, test.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-new</span><span class="cmd-desc">Interactive wizard. Asks about client, scope, design, stack. Creates everything.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-debug</span><span class="cmd-desc">Structured debugging &mdash; symptom gathering, diagnosis confirmation, root cause analysis. Trigger on 'debug', 'find bug', 'fix error', 'something is broken'.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-review</span><span class="cmd-desc">Production audit with scored diagnostics. Runs real commands, scores findings by severity. Trigger on 'review', 'audit', 'code review', 'security check'.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-optimize</span><span class="cmd-desc">Deep optimization pass &mdash; reads .planning/ AND codebase to find performance, design, UI, backend, and frontend issues. Spawns parallel specialist agents. Supports --perf, --ui, --backend, --alignment, --fix flags.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Design and UX pass &mdash; anti-AI-slop, genuine craft, responsive, accessible. Run after all phases are verified.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-test</span><span class="cmd-desc">Generate or run tests for client projects. Trigger on 'write tests', 'add tests', 'test this', 'test coverage'.</span></div>
       </div>
     </div>
 
+    <!-- Quick Paths -->
     <div class="cmd-group">
-      <h3>Build Loop</h3>
+      <h3>Quick Paths</h3>
+      <p class="cmd-group-note">Lightweight alternatives when the full road is overkill.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-plan</span><span class="cmd-desc">Plan the current phase. AI generates tasks with success criteria.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-build</span><span class="cmd-desc">Build it. Fresh AI agent per task, parallel waves.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-verify</span><span class="cmd-desc">Verify it actually works. Greps code, scores on 4 dimensions.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-quick</span><span class="cmd-desc">Fast path for small tasks &mdash; bug fixes, tweaks, hot fixes. Skips full phase planning.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-task</span><span class="cmd-desc">Build a single task &mdash; more structured than /qualia-quick, lighter than /qualia-build. Spawns a fresh builder agent for one focused task.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-design</span><span class="cmd-desc">One-shot design transformation &mdash; critiques, fixes, polishes, hardens, makes responsive. No reports, no choices, just makes it professional.</span></div>
       </div>
     </div>
 
+    <!-- Knowledge -->
     <div class="cmd-group">
-      <h3>Quick Work</h3>
+      <h3>Knowledge</h3>
+      <p class="cmd-group-note">Persist learnings and log work.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-quick</span><span class="cmd-desc">Skip planning. For bug fixes, tweaks, hot fixes under 1 hour.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-task</span><span class="cmd-desc">One focused task. More structured than quick, lighter than build.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-learn</span><span class="cmd-desc">Save a learning, pattern, fix, or client preference to the knowledge base. Persists across projects and sessions.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-report</span><span class="cmd-desc">Generate session report and commit to repo. Mandatory before clock-out.</span></div>
       </div>
     </div>
 
+    <!-- Session -->
     <div class="cmd-group">
-      <h3>Design & Quality</h3>
+      <h3>Session</h3>
+      <p class="cmd-group-note">Hand off and resume context cleanly.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-design</span><span class="cmd-desc">One-shot design fix. Reads DESIGN.md, kills AI slop, makes it professional.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-polish</span><span class="cmd-desc">Full design pass. Typography, color, states, motion, a11y, responsive, hardening.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-review</span><span class="cmd-desc">Production audit. Security, performance, reliability. Scored diagnostics.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-pause</span><span class="cmd-desc">Save session context for seamless handoff. Creates .continue-here.md so the next session picks up exactly where you left off.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-resume</span><span class="cmd-desc">Restore context from a previous session. Reads .continue-here.md or STATE.md, summarizes where you left off, routes to next action.</span></div>
       </div>
     </div>
 
+    <!-- Navigation -->
     <div class="cmd-group">
-      <h3>Ship & Deliver</h3>
+      <h3>Navigation</h3>
+      <p class="cmd-group-note">When you don't know what to do next.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-ship</span><span class="cmd-desc">Quality gates, commit, push, deploy to Vercel, post-deploy verification.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-handoff</span><span class="cmd-desc">Client delivery. Credentials, docs, handover package.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-report</span><span class="cmd-desc">Log your session. Mandatory before clock-out. Uploads to ERP.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia</span><span class="cmd-desc">Smart router &mdash; reads project state, classifies your situation, tells you the exact next command. Use whenever you're unsure about your next step.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-idk</span><span class="cmd-desc">Alias for /qualia. The smart router handles all 'idk', 'what now', 'I'm stuck' situations.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-help</span><span class="cmd-desc">Open the Qualia Framework reference guide in the browser. A beautiful themed HTML page with all commands, rules, services, and the road.</span></div>
       </div>
     </div>
 
+    <!-- Meta -->
     <div class="cmd-group">
-      <h3>Debugging & Learning</h3>
+      <h3>Meta</h3>
+      <p class="cmd-group-note">Extend the framework itself.</p>
       <div class="commands">
-        <div class="cmd"><span class="cmd-name">/qualia-debug</span><span class="cmd-desc">Structured debugging. Symptom &rarr; diagnosis &rarr; root cause &rarr; fix.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-learn</span><span class="cmd-desc">Save a pattern, fix, or client preference to the knowledge base.</span></div>
-        <div class="cmd"><span class="cmd-name">/qualia-test</span><span class="cmd-desc">Generate or run tests. Auto-detects framework.</span></div>
+        <div class="cmd"><span class="cmd-name">/qualia-skill-new</span><span class="cmd-desc">Author a new Qualia skill or agent. Generates the SKILL.md, registers it in the right location, and optionally ships to the framework repo.</span></div>
       </div>
     </div>
+  </section>
 
+  <!-- CLI -->
+  <section>
+    <h2>CLI (Terminal)</h2>
     <div class="cmd-group">
-      <h3>CLI (Terminal)</h3>
       <div class="commands">
         <div class="cmd"><span class="cmd-name">qualia-framework install</span><span class="cmd-desc">Install or reinstall the framework.</span></div>
         <div class="cmd"><span class="cmd-name">qualia-framework update</span><span class="cmd-desc">Update to the latest version.</span></div>
@@ -470,6 +536,7 @@
 <div class="footer">
   <strong>Welcome to the future with Qualia.</strong><br>
   Qualia Solutions &mdash; Nicosia, Cyprus
+  <span class="footer-version">qualia-framework v3.6.0 &middot; 26 skills</span>
 </div>
 
 </body>

package/templates/tracking.json

@@ -3,6 +3,9 @@
   "client": "",
   "type": "",
   "assigned_to": "",
+  "team_id": "",
+  "project_id": "",
+  "git_remote": "",
   "milestone": 1,
   "phase": 0,
   "phase_name": "",
@@ -14,14 +17,20 @@
   "verification": "pending",
   "gap_cycles": {},
   "blockers": [],
+  "session_started_at": "",
   "last_updated": "",
+  "last_pushed_at": "",
   "last_commit": "",
+  "build_count": 0,
+  "deploy_count": 0,
   "deployed_url": "",
   "notes": "",
+  "submitted_by": "",
   "lifetime": {
     "tasks_completed": 0,
     "phases_completed": 0,
     "milestones_completed": 0,
-    "total_phases": 0
+    "total_phases": 0,
+    "last_closed_milestone": 0
   }
 }