Product
One deterministic compile. Every agent file you need.
Project Spine reads a brief, a repo, and optional design tokens and writes AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, a scaffold plan, QA guardrails, and a sprint-1 backlog. All with source pointers back to the inputs, all covered by a drift check you can put in CI.
Pipeline
brief.md ──┐ repo/ ──┼──▶ spine.json ──▶ AGENTS.md + CLAUDE.md + copilot-instructions.md tokens.json ─┤ scaffold-plan.md · qa-guardrails.md · design.md ──┘ sprint-1-backlog.md · rationale.md
Every rule in spine.json carries a source pointer: brief.md#section0/item3, repo-profile#framework, design:tokens.json#color/primary, or inferred:<reason>. Reviewers can audit whya rule exists instead of trusting an LLM's self-report.
Core capabilities
- Agent instructions that reflect reality.Generates
AGENTS.md,CLAUDE.md, and.github/copilot-instructions.mdfrom your actual brief and detected stack. Not generic boilerplate. Switch agents without re-briefing. - Scaffold + QA + sprint-1 in one pass.Route inventory, component plan, QA guardrails, and a sprint-1 backlog with acceptance criteria traced back to your goals. Every generated item has a source pointer to the upstream input.
- Drift-aware by construction.
export-manifest.jsonrecords sha256 of every input and output.spine drift check --fail-on anyturns AGENTS.md into a CI-gated contract, not a README nobody reads. - Design tokens as first-class input.DTCG or Tokens Studio JSON (
--tokens) feeds brand colours, spacing scales, and typography intospine.json. Tokens drift is tracked separately so a re-export from Figma shows up as[input:tokens], not a mystery hash change. - Four starter templates.
saas-marketing,app-dashboard,design-system,docs-portal. Each contributes routes, components, QA, UX, a11y, and agent rules additively, and you can save your own withspine template save. - Hosted workspace for teams.Share templates across client projects, publish branded rationales at
/r/<slug>, push drift reports from CI into a fleet view. GitHub OAuth, bearer tokens hashed, rate-limited. - Agent skills for Claude Code, Codex, Cursor.Ship
skills/with sixSKILL.mdfiles that teach your coding agent the kickoff / drift / template / rationale / workspace flows../skills/install.shsymlinks them into~/.claude/skills.
What it's not
- Not a replacement for a real brief.Generic input produces generic output. Spine compiles what you write; it doesn't guess what you meant.
- Not a refactoring engine.Spine reads your repo to detect stack and conventions. It never rewrites your code.
AGENTS.mdis a contract with the agent. Enforcement lives in the agent and in code review. - Not a replacement for human review.Every compile surfaces warnings with source pointers so review is faster, not skipped.
- Not optimised for million-line monorepos yet.First run under 30 seconds on a typical Next.js / Remix / library repo. Very large trees (10k+ files) haven't been profiled.