feat sparv skill

skills/sparv/README.md

@@ -0,0 +1,96 @@
+# SPARV - Unified Development Workflow (Simplified)
+
+[![Skill Version](https://img.shields.io/badge/version-1.0.0-blue.svg)]()
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)]()
+
+**SPARV** is an end-to-end development workflow: maximize delivery quality with minimal rules while avoiding "infinite iteration + self-rationalization."
+
+```
+S-Specify → P-Plan → A-Act → R-Review → V-Vault
+   Clarify     Plan      Execute   Review     Archive
+```
+
+## Key Changes (Over-engineering Removed)
+
+- External memory merged from 3 files into 1 `.sparv/journal.md`
+- Specify scoring simplified from 100-point to 10-point scale (threshold `>=9`)
+- Reboot Test reduced from 5 questions to 3 questions
+- Removed concurrency locks (Claude is single-threaded; locks only cause failures)
+
+## Installation
+
+SPARV is installed at `~/.claude/skills/sparv/`.
+
+Install from ZIP:
+
+```bash
+unzip sparv.zip -d ~/.claude/skills/
+```
+
+## Quick Start
+
+Run in project root:
+
+```bash
+~/.claude/skills/sparv/scripts/init-session.sh --force
+```
+
+Creates:
+
+```
+.sparv/
+├── state.yaml
+├── journal.md
+└── history/
+```
+
+## External Memory System (Two Files)
+
+- `state.yaml`: State (minimum fields: `session_id/current_phase/action_count/consecutive_failures`)
+- `journal.md`: Unified log (Plan/Progress/Findings all go here)
+
+After archiving:
+
+```
+.sparv/history/<session_id>/
+├── state.yaml
+└── journal.md
+```
+
+## Key Numbers
+
+| Number | Meaning |
+|--------|---------|
+| **9/10** | Specify score passing threshold |
+| **2** | Write to journal every 2 tool calls |
+| **3** | Failure retry limit / Review fix limit |
+| **3** | Reboot Test question count |
+| **12** | Default max iterations (optional safety valve) |
+
+## Script Tools
+
+```bash
+~/.claude/skills/sparv/scripts/init-session.sh --force
+~/.claude/skills/sparv/scripts/save-progress.sh "Edit" "done"
+~/.claude/skills/sparv/scripts/check-ehrb.sh --diff --fail-on-flags
+~/.claude/skills/sparv/scripts/failure-tracker.sh fail --note "tests are flaky"
+~/.claude/skills/sparv/scripts/reboot-test.sh --strict
+~/.claude/skills/sparv/scripts/archive-session.sh
+```
+
+## Hooks
+
+Hooks defined in `hooks/hooks.json`:
+
+- PostToolUse: 2-Action auto-write to `journal.md`
+- PreToolUse: EHRB risk prompt (default dry-run)
+- Stop: 3-question reboot test (strict)
+
+## References
+
+- `SKILL.md`: Skill definition (for agent use)
+- `references/methodology.md`: Methodology quick reference
+
+---
+
+*Quality over speed—iterate until truly complete.*