myclaude/skills/sparv

SPARV - Unified Development Workflow (Simplified)

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:

unzip sparv.zip -d ~/.claude/skills/

Quick Start

Run in project root:

~/.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

~/.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.