Contributing

This repository is in an early planning and migration phase.

Contribution Priorities

improve the migration plan
improve documentation structure and clarity
help normalize reusable platform patterns
reduce hard-coded assumptions in the reference implementation as it migrates

Contribution Expectations

follow the repository standards
keep changes aligned to the current roadmap
prefer incremental migration over unnecessary rewrites
document significant architectural decisions
ensure documentation stays in sync with source layout changes

Pull Request Guidance

keep pull requests focused in scope
explain why the change is needed
call out any assumptions, risks, or unresolved questions
include validation notes when code, docs, or automation behavior changes

Early Repository Guidance

do not claim support for a deployment category that only has placeholders
do not break the original reference implementation during migration
do not introduce toolchain-specific divergence without first updating the shared model or roadmap