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. Name each bet your change touches in the PR body, and the choice it changed. If you cross a red flag, argue it there. Edit a bet only when the bet itself changes. 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. - Opening, reviewing, verifying and landing PRs: follow docs/agents/landing.md.
Draw a diagram where one picture compresses many words: how systems relate, flows, forks. Show UI with screenshots or prototypes, never ASCII.