Ugrás a fő tartalomra

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.