CLAUDE.md.template

# Project Instructions

> Customize this for your project. Keep it short - Claude reads this every session.

## Tech Stack

- **Frontend:** [React/Vue/etc.]
- **Backend:** [Node/Python/etc.]
- **Database:** [PostgreSQL/etc.]
- **Key libraries:** [list important ones]

## Project Structure

```
src/
├── components/    # React components
├── hooks/         # Custom hooks
├── utils/         # Helper functions
└── api/           # API client
```

## Commands

```bash
npm run dev        # Start dev server
npm test           # Run tests
npm run build      # Production build
```

## Project Rules

<!-- Add rules specific to YOUR project -->

- Use `Button` from `@/components/ui`, not raw `<button>`
- API responses are camelCase (transformed from snake_case)
- State management: Zustand (not Redux)
- Styling: Tailwind only, no inline styles

## Patterns to Follow

<!-- Show examples from YOUR codebase -->

```typescript
// How we fetch data in this project
const { data, error } = useSWR('/api/users', fetcher);

// How we handle forms
const form = useForm<FormData>({ resolver: zodResolver(schema) });
```

## Don't Do

<!-- Project-specific things to avoid -->

- Don't create new API routes without adding to `api/index.ts`
- Don't use `localStorage` directly - use our `useStorage` hook
- Don't add dependencies without checking with the team

## Quality Checks

This project uses [vibe-and-thrive](https://github.com/allthriveai/vibe-and-thrive):

- **While coding:** Claude Code hooks warn about issues in real-time
- **At commit:** Pre-commit hooks block secrets, debug statements, etc.
- **On demand:** Run `/vibe-check` or `/review` anytime