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

1.5 KiB

CLAUDE.md — Waggle Community Edition

Read 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/ 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 :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).