Project-wide reference for {{PROJECT_NAME}} — structure, tech stack, commands, coding conventions, environment variables, and task management process. Read when you need to understand how the project is organised or how to run it.
Use this skill for project-wide context: structure, stack, conventions, and process.
{{PROJECT_NAME}} is a {{TECH_STACK}} application.
<!-- Add 1-2 sentences describing what the project does and who uses it. -->{{REPO_ROOT_STRUCTURE}}
| Layer | Technology |
|---|---|
| Frontend |
| <!-- e.g. Next.js 15, React 19, TypeScript --> |
| Backend | <!-- e.g. Next.js API Routes, Node.js --> |
| Database | <!-- e.g. PostgreSQL + Prisma --> |
| Testing | <!-- e.g. Vitest, Playwright --> |
| Deployment | <!-- e.g. Vercel, Railway, Fly.io --> |
| Auth | <!-- e.g. Auth.js v5, Clerk, JWT --> |
# Development
npm run dev # start dev server
# Build
npm run build # production build
# Verification (run after every non-trivial change)
{{CHECK_COMMAND}} # build + test + lint — must be green before marking any task done
# Tests
npx vitest run # all tests
npx vitest run <file> # single test file
npx vitest # watch mode
# Database
npx prisma db push # sync schema to DB
npx prisma generate # regenerate client after schema change
npx prisma studio # visual DB browser
| Variable | Required | Description |
|---|---|---|
DATABASE_URL | ✅ | PostgreSQL connection string |
| <!-- fill in --> |
See .env.example for a complete list with example values.
{{AUTH_PATTERN}}
{{DB_IMPORT_PATTERN}}
Every query must include: {{DB_SCOPE_PATTERN}}
{{LOGGER_PATTERN}}
{{STYLE_APPROACH}}
Tasks live in tasks/todo.md. Lessons live in tasks/lessons.md.
tasks/todo.mdCHANGELOG.mdtasks/lessons.md immediatelyLessons are periodically distilled into skill files via /distill-lessons so they're seen at point-of-use.