mirror of
https://github.com/cexll/myclaude.git
synced 2026-02-14 03:31:58 +08:00
97 lines
2.5 KiB
Markdown
97 lines
2.5 KiB
Markdown
# 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:
|
|
|
|
```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.*
|