← All skills
⌨️

Engineering

Claude Code Project Spec

Hand Claude Code a project spec it can actually build from. Stack, files, behavior, edge cases.

Step 1

Get the skill

Pick one. Copy to paste straight away, or download claude-code-project-spec.md to keep.

Step 2

Paste it into your AI

Save as PROJECT.md in the repo. Open Claude Code, paste spec, iterate. Spec discipline saves debug hours.

Preview the skill· what gets copied
Write a project spec for Claude Code (or Cursor) to build from.

What I want to build: {{ONE_LINE_PRODUCT}}
Stack preference: {{STACK · e.g. Next.js 15 + Tailwind + JSON file storage}}
Where it runs: {{HOST · localhost / Hostinger / Vercel / etc.}}
Authentication: {{AUTH}}
Data persistence: {{DATA}}

Spec structure:
1. Goal (one sentence)
2. Non-goals (what this is NOT, 3 bullets)
3. User journeys (3 to 5 numbered flows)
4. Pages / routes needed (path + purpose)
5. Components needed (name + purpose)
6. Data model (TypeScript types for the records)
7. API endpoints (verb + path + payload + response)
8. Edge cases (5 things to handle: empty state, errors, race conditions, etc.)
9. Out of scope for v1
10. Acceptance test (3 manual steps that prove it works)

Output as a single markdown block. Paste-ready into Claude Code.

Works with: Claude · Claude Code · Cursor · Any model

By Rishi Jain