Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
58 lines (41 loc) · 1.51 KB

CONTRIBUTING.md

File metadata and controls

58 lines (41 loc) · 1.51 KB
Raw

Contributing to AsDecided

Local setup

The toolchain is pinned by rust/rust-toolchain.toml.

git clone https://github.com/asdecided/core.git
cd core/rust
rustup show
cargo build --workspace --locked

Verify a change

cd rust
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace --release

target/release/decided validate ../decisions/
target/release/decided relationships ../decisions/ --validate

The small Python programs under rust/tools/ and rust/spec/ are repository verification utilities. They are not a Python product engine or installable SDK. Cross-repository compatibility is certified against asdecided-spec.

Documentation expectations

Update docs/ when command behavior, flags, output, or exit codes change. User-visible changes also need an entry under Unreleased in CHANGELOG.md. Machine-readable output is a stable, versioned contract.

Product-knowledge expectations

Behavioral changes should trace to an artifact under decisions/. Keep the corpus green with decided validate, decided relationships --validate, and decided review.

Commit conventions

Follow decisions/prompts/rac-agent-commit-guidelines.md:

<type>(<area>): <imperative summary> [roadmap:vX.Y.Z]

License and sign-off

AsDecided is licensed under Apache-2.0. Contributions must carry a Developer Certificate of Origin sign-off:

git commit -s