Project Spine for Next.js

Project Spine inspects your Next.js repo and compiles AGENTS.md, CLAUDE.md, copilot-instructions.md, and a Cursor project rule that actually track the App Router conventions in your tree — not the Pages Router your agent half-remembers from 2023.

What Spine detects in a Next.js repo

• App Router vs Pages Router
• Server / client component boundaries
• Route groups, parallel routes, intercepted routes
• Middleware + CSP usage
• Drizzle / Prisma / Vercel Postgres data layer

Get started

$ npm install -g project-spine@beta
$ spine inspect --repo .
✓ detected Next.js 14/15/16 (App Router)
$ spine compile --brief ./brief.md --repo .
✓ wrote AGENTS.md, CLAUDE.md, copilot-instructions.md, project-spine.mdc

Templates that fit Next.js

• saas-marketingMarketing site scaffold with hero, pricing, legal.
• app-dashboardAuthenticated dashboard with role-aware routes.

Guardrails Spine compiles for Next.js

• Core Web Vitals gates with real Next metrics
• CSP + nonce expectations surfaced as rules
• Image + font optimization defaults
• Route-level a11y guardrails