The readiness check
for the agent era.
One command scores how well an AI agent can work in your repo, shows you the gaps with evidence, and fixes them in a tight, verifiable loop. Runs locally. Bring your own model.
$npx spectra scan .$ spectra scan .Make a change. Verify. Correct. Repeat.
Spectra optimises for the thing that lets an agent work unsupervised: a fast, machine-runnable feedback loop it can trust.
Detect
Repo type, toolchain and the checks an agent can actually run.
Verify
typecheck, lint and test — run on demand, results
trusted.
Fix
Agents work in worktrees with diff previews and a kill switch.
From scan to merged, on the command line.
$ spectra scan .→ assessing six readiness lenses against ./payments-api✔ agent context 35 · no AGENTS.md at repo root→ readiness 61/100 · 5 high-impact actions
$ spectra plan --from-scan→ ordering 5 actions by impact, mapping dependencies✔ added AGENTS.md ↑ blocks 3 downstream fixes→ plan ready · review with `spectra review`
$ spectra run --interactive→ worktree: ../.spectra/wt-agents-md✔ diff ready · 1 file changed (+38 −0)→ approve? [y] apply [s] steer [q] quit
# .github/workflows/readiness.yml- run: spectra scan . --min-score 60✔ fails the build if readiness regresses- run: spectra report --md >> $GITHUB_STEP_SUMMARY
Findings you can act on.
FAIL tribal knowledge ▰▰▰▰▰▱▱▱▱▱ 48 timeout = 3000 // don't change — no rationale recorded PASS verifiability ▰▰▰▰▰▰▰▰▱▱ 82 typecheck script present · 0 errors · suite runs in 11s WARN reproducibility ▰▰▰▰▰▰▱▱▱▱ 64 No pinned runtime (.nvmrc / .tool-versions) detected PASS structure ▰▰▰▰▰▰▰▱▱▱ 71 2 files over 1,000 lines · likely load-bearing FAIL agent context ▰▰▰▰▱▱▱▱▱▱ 35 No AGENTS.md or .cursor/rules found at repo root WARN safety ▰▰▰▰▰▰▱▱▱▱ 58 Test suite contains a live HTTP client — unguarded ──────── overall 61/100 · material gaps · run `spectra plan`
What “ready” actually measures.
- 01
Tribal Knowledge
The unwritten rules baked into the codebase.
- 02
Verifiability
Type checks, lint, and tests an agent can run on demand.
- 03
Reproducibility
Toolchain, dependencies, and environment pinned down.
- 04
Structure & Reasonability
Module boundaries and naming that hold up.
- 05
Agent Context
Rules, recipes, and conventions close to the work.
- 06
Safety & Blast Radius
Knowing where to tread carefully.
Get your readiness score now.
Free for solo use · macOS, Windows, Linux · bring your own model key