Menu
One-time contributor setup — run `make setup` (npm install + compile + index), verify `npx --no-install spec-spine --version` works, verify governed reads (`npx spec-spine registry status-report`).
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
Run the project's local CI loop (`make ci`) and automatically fix discovered issues using concurrent agents
Run dead-code and duplicate-code detection across the npm/TypeScript surface, get categorized cleanup recommendations
Create a git commit with an impact-focused conventional commit message
Execute a plan file step-by-step with progress tracking and phase checkpoints
Initialize a spec-spine project session by executing the cross-agent New Sessions protocol declared in AGENTS.md.
| name | setup |
| description | One-time contributor setup — run `make setup` (npm install + compile + index), verify `npx --no-install spec-spine --version` works, verify governed reads (`npx spec-spine registry status-report`). |
| allowed-tools | Bash, Read |
Get a fresh clone operational. After this completes, /init can report lifecycle and structural counts through the spec-spine CLI (no ad-hoc parsing of .derived/**/*.json — see spec 000).
make setup is the canonical contributor entry point. It runs npm install (which pulls the spec-spine CLI as a devDependency), compiles the spec-registry shards, and builds the codebase-index shards. This skill runs it and then verifies the CLI and governed reads actually work.
make setupmake setup
This is the single source of truth for contributor setup — never duplicate its steps here. If a new prerequisite or build target is needed, add it to make setup (and any CI workflow that runs it) rather than hard-coding npm install invocations into this skill.
Halt on non-zero exit and surface the failing step verbatim. make check-deps (run as the first step of make setup) enumerates host prerequisites (node, npm, git) so a missing tool will name itself.
Confirm the CLI installed correctly:
npx --no-install spec-spine --version
If this fails, npm install did not complete successfully. Instruct the user to re-run make setup. Do NOT fall back to ad-hoc parsing of .derived/**/*.json.
Smoke-test the same calls /init makes. Passing here means /init will work on this clone:
npx --no-install spec-spine index check
npx --no-install spec-spine registry status-report --json
npx --no-install spec-spine registry list --json | head -5
If npx spec-spine index check exits non-zero the index is stale — run make spine-index and re-check. Do not parse .derived/**/*.json directly to "verify" success; that violates the governed-reads rule (spec 000 FR-09).
Report exactly:
## setup: <project-name>
**make setup:** {ok / failed at <step>}
**spec-spine CLI:** {version string / MISSING — run npm install}
**Governed reads verified:**
- index check: {fresh / stale — run make spine-index}
- registry status-report: {N specs across <statuses>}
- registry list: {N spec ids}
Next: run `/init` to load full session context.
If any step failed, surface the exact command, exit code, and last 20 lines of stderr. Do not invent counts — only report values that came back from the CLI.
make setup owns the build steps. This skill does not duplicate or reorder them..derived/**/*.json directly in any verification step. Use npx spec-spine verbs.npm install is a no-op when the lock file is satisfied.