Skip to main content

Contribution Guide

On this page

Development Workflow

  1. Create a narrowly scoped branch from the target branch; do not include unrelated changes.
  2. Confirm the contract from the code, tests, and current ADRs before changing the implementation and tests at the same layer.
  3. Split files that exceed 600 lines; separate DTOs from store entities, and explicitly publish events after the transaction commits.
  4. Run the pre-commit checks required by CLAUDE.md, then submit an MR and state which branches of behavior remain uncovered and the status of external acceptance testing.

ADRs

Use ADRs for long-term architectural decisions. Record the context, decision, consequences, and supersession relationships.

Was this page helpful?