# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Agent Workflow Rules

- **Commit after every task**: When a task is complete, stage all changed files and create a git commit before marking the task done.
- **Keep documentation current**: Update `CLAUDE.md` with any new commands, architecture details, or setup steps introduced by your task. Update `PRD.md` only if scope/design decisions changed.
- **Mark tasks in td**: `td start <id>` when beginning, `td close <id>` when done.

## Task Management

This project uses `td` (a local CLI) for task tracking. At the start of each session:

```bash
td usage --new-session   # required at conversation start or after /clear
td usage -q              # quick check for subsequent reads
```

Optional session labeling:
```bash
td session "name"        # label the current session
td session --new         # force a new session in the same terminal context
```

Task state is stored in `.todos/issues.db` (SQLite).

## Development

**Run production stack (Docker):**
```bash
docker compose up
```

**Run development stack with live reload (Docker):**
```bash
docker compose -f docker-compose.yml -f docker-compose.dev.yml up
```

**Frontend only (Vite dev server):**
```bash
cd client && npm install && npm run dev
```

**Backend only (nodemon):**
```bash
cd server && npm install && npm run dev
```