@devground/sdd
v1.1.0
Published
spec-flow: the spec-driven development intake skill — classify, enrich and route any change to the right amount of process, installable into any project
Maintainers
Readme
@devground/sdd
spec-flow — the spec-driven development intake skill for Claude Code. It turns a raw, vague change request into a right-sized, professional spec, then routes it to the minimum process the change actually deserves. Infer aggressively, state assumptions, proceed — escalate ceremony only when the change is big or risky enough to earn it.
Install
Into the current project:
npx @devground/sdd
# -> .claude/skills/spec-flow/For all your projects (user-level):
npx @devground/sdd --global
# -> ~/.claude/skills/spec-flow/Existing files are never overwritten — re-run after an upgrade to add new reference files while keeping your local edits.
What it does
Given a change request ("add login", "make this faster", "fix this bug"), the skill:
- Orients via
docs/codemap.md(reading it is mandatory when it exists) and verifies paths against real code. - Classifies along 5 orthogonal axes: type · size · risk · uncertainty · surface.
- Routes to one of 4 tiers (Express → Light → Standard → Full) so a typo skips straight to the fix while a risky migration gets explore + spec + design + ADR.
- Enriches into a dual-audience brief (plain-language summary + technical depth) with the concrete files & routes to touch.
- Emits telemetry (one line per change to
.spec-flow/events.jsonl) so impact is measurable.
Measuring impact
This package ships the skill only. Whether spec-flow actually helps — test-coupling,
code survival, orientation cost, friction — is measured by
@devground/dev-metrics (dev-metrics spec-flow-impact and
dev-metrics orientation), which reads the .spec-flow/events.jsonl telemetry plus git
and transcript history.
Fuente canónica y sincronización
La skill viva se desarrolla en ~/.claude/skills/spec-flow/ (validada en uso real). El
directorio skill/ de este paquete es una copia versionada de esa fuente. Tras un
cambio en la skill canónica, resincroniza el mirror:
node scripts/sync-spec-flow.mjs # o: pnpm --filter @devground/sdd syncEl script copia SKILL.md + references/ desde ~/.claude/skills/spec-flow/; no copia
evals/ (vive solo en la fuente canónica). No se corre en prepublishOnly a propósito: la
fuente está fuera del repo, así que el mirror commiteado es lo que se publica y sincronizar
es un acto deliberado del desarrollador, no un paso de release.
License
MIT
