mirror of
https://github.com/storytold/craft-anything.git
synced 2026-11-21 20:08:24 +00:00
1.6 KiB
1.6 KiB
Contributing
Thanks for helping. The rules every change follows (people and AI agents alike) are in AGENTS.md; the mistakes they come from are in docs/pitfalls.md. In short:
- Pick work from docs/ROADMAP.md (
cargo xtask pendinglists what's open). Claim it first as claims.md describes, with a comment on its issue, so nobody else does the same work. - One change per PR, on a branch named
feature/,bugfix/,docs/,test/,refactor/orchore/plus the roadmap id (feature/r1.4-provider-key-ui). PRs are squash-merged, so the title is the commit message: plain English, what changed for the person or developer. - Where things go: docs/extending.md (tools, target kinds, checks, coding agents, engines, plugins).
- Never crash, safe Rust only, every external program through
craft_anything_platform::process, no secrets or personal data anywhere. Everything is our own work: no code, names or wording copied from other projects.
Before you ask for review:
cargo xtask fmt # this workspace's targets, as cargo fmt --all, in batches Windows takes
cargo test -p <crates you touched>
cargo clippy -p <crates> --all-targets -- -D warnings
cargo xtask layers
cargo xtask secrets
Enable the secret-scan hook once per clone: git config core.hooksPath .githooks.
Code is dual-licensed under MIT or Apache-2.0 (LICENSE-MIT, LICENSE-APACHE); by contributing you agree your work is licensed the same way.