mirror of
https://github.com/storytold/deckcraft.git
synced 2026-10-31 05:56:55 -06:00
Dylan M. Taylor
97db282daf
AGENTS.md (and CLAUDE.md where present) gets a CI workflows section: workflows only call craft-common-actions at @main, with no other jobs; feature and fix PRs don't touch CI and link or open a craft-common-actions issue (a PR only for a small fix that is safe for every app and does not increase CI time); legacy jobs aren't added to and move only as their own task, staying until a shared workflow runs them. windows-arm64.yml moves from its SHA pin to @main. The pinned revision is on craft-common-actions main and the workflow (and the actions it calls) is identical there, so nothing changes in behaviour.
27 lines
1.9 KiB
Markdown
27 lines
1.9 KiB
Markdown
# DeckCraft — working notes for Claude
|
|
|
|
Read [AGENTS.md](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`.
|
|
|
|
## CI workflows
|
|
- Workflows in `.github/workflows/` call the shared workflows in [`storytold/craft-common-actions`](https://github.com/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.
|