Contributing

Arqen is early-stage. Contributions should make the public contract clearer, keep adapter behavior aligned, or add evidence for a feature.

Before opening a change:

1. Read README.md, specs/README.md, and the relevant public guide or phase specification.
2. Keep changes inside Arqen; do not modify Watchloom, thingd, or thingd-cloud.
3. Add or update docs and contract tests before introducing new implementation.
4. Run cargo fmt --all -- --check, cargo check --workspace, and cargo test --workspace.
5. For docs, run pnpm install --frozen-lockfile and pnpm build in docs/.

Local agent instructions and editor tooling are intentionally ignored by Git. The versioned README, documentation site, and specifications are the public project contract.

Use focused commits and describe known limitations honestly. See the root contribution guide for the pull request checklist.