# Engineering guidance

- Edit resources/ as the source; generated copies in applications are consumers.
- Read resources/CODING_STANDARDS.md before changing Java; project architecture
  and metrics apply to consumer backend modules as documented there.
- Keep upstream skills unchanged and retain resources/skills/upstream.json and licenses.
- Keep project-specific configuration, secrets and waivers out of shared defaults.
- Run the bootstrap, formatter, CI/release regression and generated-example checks.
- Never move a published release tag. Document consumer-file changes in UPGRADING.md.
- Architecture and specifications belong to the landscape repository.