# Contributing to benzuko

Thanks for helping build benzuko. This guide gets you productive fast.

## Getting started
```bash
git clone https://github.com/your-org/benzuko.git
cd benzuko
cp .env.example .env.local
npm install
npm run dev
```

## Branching & commits
- Branch from `main`: `feat/…`, `fix/…`, `docs/…`, `chore/…`.
- Use [Conventional Commits](https://www.conventionalcommits.org):
  `feat(p2p): add completion-rate filter`.

## Before you push
```bash
npm run lint
npm run typecheck
npm run test
```
All three must pass. CI runs the same checks plus the Playwright E2E suite.

## Pull requests
- Keep PRs focused and small.
- Fill out the PR template checklist.
- Update `docs/` and `CHANGELOG.md` when behavior changes.

## Code style
- TypeScript strict mode, no `any` without justification.
- Atomic Design for components (`atoms` → `molecules` → `organisms` → `templates`).
- Server Components by default; add `'use client'` only when needed.
- Prettier + ESLint are the source of truth — run `npm run format`.