AGENTS.md
Workspace
core/owns the engine, CLI, daemon, SDK, native helpers, and releases. Run Cargo there; apply relevantcore/CODING_STANDARDS.mdrules when changing core code.dashboard/owns Ployz Cloud: web, worker, durable workflows, and self-host packaging. Run pnpm there.- Before designing a feature, read the affected project's
DESIGN.md. A change that fights one of its bets needs aDESIGN.mdamendment justifying the exception — or a redesign. docs/user/describes shipped behavior from the user's point of view. Check it before deciding how something works today, and update it when user-visible behavior changes.- Prove changes on the real artifact: dashboard UI with the
verify-dashboardskill (addSERVERS=1for runtime UI), and anything needing real Machines (daemon, Docker, WireGuard, ZFS, moves) with theverify-serverskill, before reaching for cloud VMs. - When changing domain behavior, terminology, or ownership boundaries, follow docs/agents/domain.md.
Change workflow
- GitHub CI is the PR gate. Locally, run only focused checks: typecheck, lint, fmt, and the tests for the code you changed. Don't run a full suite (
pnpm pr:check,pnpm test,cargo nextest run, workspace clippy) locally, except to reproduce a CI failure.
Draw a diagram where one picture compresses many words: how systems relate, flows, forks. Show UI with screenshots or prototypes, never ASCII.