Contributions are most effective when they begin with a small fixture that demonstrates the intended input and expected analysis result. Open an issue to discuss larger changes, keep parser and report contract changes explicit, and update relevant docs with every user-facing workflow change.
- Run the project's compile target from the Makefile.
- Exercise a command-line example against a fixture.
- Keep output stable, readable and structured for downstream tooling.
- Describe the motivation, data shape and report impact in the pull request.
Reviewers look for clear domain modeling, deterministic calculations, useful diagnostics and examples that reflect proposed behavior.