Files
waggle-os/CLAUDE.md
shumeiko.it 369d8269c1 docs: rewrite AGENTS.md and CLAUDE.md for the community edition
The previous contract described the commercial release: tiers, Stripe,
KVARK, the Windows Solo qualification gate and the hive-mind mirror sync.
It told agents to preserve monetization, which the community edition
removes. The new contract states the scope status of every package, the
conversion rules, the build and verification commands and the working
rules. CLAUDE.md now only adds Claude-specific notes.
2026-10-15 18:35:58 +02:00

32 lines
1.5 KiB
Markdown

# 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).