deckcraft/CLAUDE.md

DeckCraft — working notes for Claude

Read AGENTS.md first: its rules (asset policy, clean room, never crash) bind you and win over anything here.

New workspace crates must include [lints] workspace = true in Cargo.toml to inherit [workspace.lints]. Production crate roots must declare the required crate-level lint attributes before modules or other crate items; crate-level //! documentation may precede them.

Start every session

1. Read plan/STATUS.md, then the current milestone in plan/execution-plan.md.
2. Run cargo xtask ci before you change anything, so you know the tree is green.

Habits

• Every user-visible action is a command with tests (crates/engine/src/cmd/*).
• Look at UI changes: deckcraft --sample --control 7990 + ui.screenshot, or deckcraft-cli render.
• Commit after each landed arc (M<n>.<k>: what) and push to origin main.
• Keep ROADMAP.md, the progress docs in docs/ (AGENTS.md §7) and plan/STATUS.md current.
• Don't ask the user questions; record genuinely-theirs decisions in plan/STATUS.md.

CI workflows

• Workflows in .github/workflows/ call the shared workflows in storytold/craft-common-actions at @main, with their inputs and secrets. No other jobs: if no shared workflow does what's needed, it doesn't go here.
• Don't add or change CI in a feature or fix PR. If the existing workflows can't build or test a change, link an existing craft-common-actions issue or PR, or open a new issue, or a PR only for a small fix that is safe for every app and does not increase CI time.
• Some workflow files here still run their own jobs. Don't add to them. Moving a job into craft-common-actions is its own task, never part of another PR, and the job stays here until a shared workflow runs it.