# CLAUDE.md — Waggle Community Edition > Read [`AGENTS.md`](AGENTS.md) in full before touching code. It is the canonical operating > contract for this branch and wins on conflict. This file only adds Claude-specific notes. ## Before you start - Check the decision records in [`docs/oss/adr/`](docs/oss/adr/README.md) for anything your task touches: memory, monetization, team mode, self-learning, WhatsApp, analytics. - Find the work package your task belongs to (0.x, P0.x, P1.x, P2.x) and stay inside it. - Compare your verification results with [`docs/oss/baseline.md`](docs/oss/baseline.md). ## Local servers - A sidecar on `:3333` may already be running and serving the root `dist/`. Check with `lsof -i :3333 -sTCP:LISTEN` before starting one. Do not start a second instance. - `npm run build`, `npm run build:all` and the Playwright e2e web server rewrite the root `dist/`; a running sidecar then returns 404 for the new assets until it restarts. Ask before doing either if you did not start that sidecar. ## Working with subagents - Mechanical removals across many files (tiers, KVARK, Stripe) suit background agents. Review their diffs before committing and run the verification commands from `AGENTS.md`. - Use read-only agents for broad searches; keep their conclusions, not the file dumps. ## Writing - Code, comments, commit messages and repository docs are in English. - Log defects of the commercial product in `docs/oss/upstream-fixes.md` in the same commit as the fix (`AGENTS.md`, section 3, rule 9).