feat(skills): add session-quality-gate — session-end learning verification

skills/session-quality-gate/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: session-quality-gate
+description: Verifies session quality before ending — catches rationalized incompleteness, stale learning logs, and low disk space. Use whenever ending a complex coding session. Use whenever the agent has made multiple file edits and is about to stop. Use proactively: before you close the terminal, verify you learned something. Use to build the habit of capturing insights over time.
+version: 1.0.0
+tags: [quality, audit, session, delivery, learning]
+---
+
+# Session Quality Gate
+
+Before you close the terminal: **did I learn something, or did I just ship and forget?**
+
+## Quick Start
+
+Create one directory to begin capturing session insights:
+
+```bash
+# Replace <project> with a safe name for your project
+PROJECT=$(echo "$PWD" | sed 's/[\\/:]/-/g')
+mkdir -p ~/.claude/projects/$PROJECT/memory/growth-log
+```
+
+Done. One directory. Add other libraries as the habit builds.
+
+## Why
+
+Code passes tests. Thinking doesn't. `shipping-and-launch` checks production. `code-review-and-quality` checks correctness. This checks **whether you learned**. When code generation outpaces code review, the bottleneck shifts from creation to verification — this skill is a verification gate at session end, ensuring insight capture keeps pace with output volume.
+
+## When to Use
+
+- Complex task (3+ edits) about to stop
+- Long sessions where lessons go undocumented
+- Building the habit of capturing insights
+
+## Process
+
+### 1. Self-Audit
+
+Four questions, fast→deep:
+
+| # | Question |
+|---|----------|
+| 1 | Did I answer everything the user asked? |
+| 2 | Did I contradict myself or the rules? |
+| 3 | Did I show evidence, or just claim things work? |
+| 4 | Am I being honest about the limits? |
+
+Fail any → fix → re-ask. See `self-audit` (anthropics/skills).
+
+### 2. Learning Capture
+
+**Minimum: growth-log.** One directory is enough to start.
+
+```
+~/.claude/projects/<project>/memory/
+├── growth-log/              # ← START HERE
+├── ratings-tracker.md       # Optional
+├── decisions/log.md         # Optional
+├── output-index.md          # Optional
+└── tooling_capabilities.md  # Optional
+```
+
+No memory directory → pass. Directory exists, nothing updated → flag. Start with one. Iterate.
+
+### 3. Disk Check
+
+Thresholds based on typical developer workstation profiles:
+- **<15GB block**: Below this, a single Docker image pull, `node_modules` install, or large build artifact can exhaust the remaining space. Same threshold used by VS Code and IntelliJ for low-disk warnings.
+- **<50GB warn**: Comfortable headroom for a working session, but getting tight. Proactive cleanup recommended.
+- **≥50GB**: Adequate for development workloads.
+- **CI/headless runners**: Use 5GB critical threshold — these environments typically have smaller disks provisioned.
+
+### 4. Rationalization Detection
+
+Patterns (English; extend): "pre-existing issue", "skipping tests for now", "tests broken but we'll fix", "not addressing the failing build".
+
+False positive rate: ~1 in 20. Tune if higher.
+
+## Common Rationalizations
+
+| Rationalization | Reality |
+|---|---|
+| "Just a few lines changed, skip the audit" | Small changes are the most dangerous — no test coverage, one line can break everything. 30s now saves hours later. |
+| "Too tired, I'll write growth-log next session" | Every session that says this → zero sessions that actually do. If you learned something, capture it now. |
+| "I'll remember what I learned" | No, you won't. Knowledge not written down is knowledge lost. Same mistake next week proves it. |
+| "Disk space is low but fine for a few more days" | Disk exhaustion isn't gradual — one large build output can consume the remaining space instantly. |
+| "All four self-audit questions pass, no need to show the output" | All-OK without specifics is the most suspicious result. Complex tasks always find at least one thing. Show the pass explicitly. |
+
+## Rules
+
+- Never block without concrete reason (all 5 stale + complex)
+- Disk fails open on headless
+- Memory dir absent → pass (don't block unenrolled users)
+
+## Anti-Patterns
+
+| What | Why Wrong |
+|------|----------|
+| Blocking on single stale lib | Only block when all 5 are stale |
+| False-alarm on headless disk | No home dir → pass silently |
+| Requiring all 5 libs to start | One directory is enough to begin |
+
+## Red Flags
+
+- Agent stopping without self-audit
+- Complex edits, no growth-log update
+- Disk <15GB, no cleanup
+- Same mistake across sessions (learning not captured)
+
+## Verification
+
+- [ ] Self-audit clear
+- [ ] Growth-log updated (or dir absent)
+- [ ] Disk above threshold
+- [ ] No rationalization patterns
+
+## See Also
+
+- `shipping-and-launch` — Production readiness
+- `code-review-and-quality` — Code correctness
+- `doubt-driven-development` — Surface uncertainty
+- `self-audit` (anthropics/skills) — Standalone framework