# {{projectName}} — Claude Development Guide

## Project Type
**Default (monorepo scaffold)** — Fastify backend + Prisma ORM + React frontend. Seeded with the canonical **Category + Item** spec (small enough to read in 30 seconds, exercises all the generated-UI rules: lifecycle dropdowns, belongsTo FK dropdowns, FK resolution in list/detail/dashboard). Shared with app-demo's Server Manager "new spec" action so both entry points start from identical source.

## Workflow
```bash
npm run validate          # Validate the spec
npm run build             # Validate + realize (generate code)
npm run setup             # Build + install deps + setup database
npm run dev:backend       # Start backend (terminal 1)
npm run dev:frontend      # Start frontend (terminal 2)
```

## Key Files
- `specs/main.specly` — The specification (edit this)
- `manifests/implementation.yaml` — Technology stack config
- `generated/code/` — Generated output (don't edit)

## Making Changes
1. Edit `specs/main.specly`
2. Run `npm run validate` to check
3. Run `npm run build` to regenerate
4. Run `cd generated/code && npm run db:push` if models changed
5. Run dev servers to test

## Generating Docs & Diagrams
```bash
npm run gen:docs          # Generate documentation
npm run gen:diagrams      # Generate Mermaid diagrams
```

## SpecVerse Reference
- [User Guide](https://github.com/SpecVerse/specverse-self/blob/main/docs/guides/SPECVERSE-SPECIFYING.md)
- [Golden Rules](https://github.com/SpecVerse/specverse-self/blob/main/docs/GOLDEN-RULES.md)