ADR-005: Generated Content Persists Only via Pull Requests
- Status: Accepted
- Date: 2026-08-12
Context & Problem Statement
Automated generation pipelines should not write directly to the default repository branch (main). Direct automated commits bypass peer review, risk breaking static builds, and undermine human ownership.
Decision
Generated content persists strictly through GitHub pull requests:
- Automated jobs push to ephemeral
docs-gen/<contract>-<target>branches. - PRs carry full automated validation reports (schema, link check, hash verification).
- GitHub branch protection requires human review approval before merging into
main. Auto-merge is strictly disabled for generation PRs.