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. Read ../../craftrules/AGENTS.md and the standards it lists for your task.
3. 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.