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.
1.5 KiB
1.5 KiB
CLAUDE.md — Waggle Community Edition
Read
AGENTS.mdin 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/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.
Local servers
- A sidecar on
:3333may already be running and serving the rootdist/. Check withlsof -i :3333 -sTCP:LISTENbefore starting one. Do not start a second instance. npm run build,npm run build:alland the Playwright e2e web server rewrite the rootdist/; 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.mdin the same commit as the fix (AGENTS.md, section 3, rule 9).