79573df7cb
20 specialized agents, 10 skills, 17 slash commands, 6 plugins, 12 hooks with scripts, 8 rule sets, 3 CLAUDE.md templates, 14 MCP server configs, and interactive setup installer.
54 lines
1.8 KiB
Markdown
54 lines
1.8 KiB
Markdown
# Project Name
|
|
|
|
One-line description of the project's purpose.
|
|
|
|
## Stack
|
|
- **Language**: TypeScript 5.x
|
|
- **Framework**: Next.js 15 (App Router)
|
|
- **Database**: PostgreSQL with Prisma ORM
|
|
- **Testing**: Vitest + Playwright
|
|
- **Package Manager**: pnpm
|
|
|
|
## Commands
|
|
- `pnpm install` - Install dependencies
|
|
- `pnpm dev` - Start dev server at localhost:3000
|
|
- `pnpm build` - Production build
|
|
- `pnpm test` - Run unit tests with Vitest
|
|
- `pnpm test:e2e` - Run Playwright end-to-end tests
|
|
- `pnpm lint` - Run ESLint
|
|
- `pnpm typecheck` - Run TypeScript compiler check
|
|
- `pnpm db:migrate` - Run database migrations
|
|
- `pnpm db:seed` - Seed the database
|
|
|
|
## Project Structure
|
|
```
|
|
src/
|
|
app/ - Next.js App Router pages and layouts
|
|
components/ - Reusable React components
|
|
lib/ - Business logic and utilities
|
|
server/ - Server-side code (API, database, auth)
|
|
types/ - Shared TypeScript type definitions
|
|
prisma/ - Database schema and migrations
|
|
tests/ - Test files mirroring src/ structure
|
|
```
|
|
|
|
## Conventions
|
|
- Conventional commits: `type(scope): message`
|
|
- Feature branches: `feature/short-description`, merge via PR
|
|
- Server components by default, `'use client'` only when needed
|
|
- Validate API inputs with Zod schemas
|
|
- Handle loading, error, and empty states in all UI components
|
|
- No `any` types. Use `unknown` with type guards
|
|
- 80% minimum test coverage on new code
|
|
|
|
## Environment Variables
|
|
- `DATABASE_URL` - PostgreSQL connection string
|
|
- `NEXTAUTH_SECRET` - Auth session encryption key
|
|
- `NEXTAUTH_URL` - Base URL for auth callbacks
|
|
|
|
## Key Decisions
|
|
- Cursor-based pagination for all list endpoints
|
|
- Repository pattern for data access layer
|
|
- Error responses follow `{ error: { code, message, details } }` format
|
|
- All dates stored and transmitted as ISO 8601 UTC strings
|