feat(adr): promote ADR-0004 (Renovate) to canonical org-tier#7
Merged
Conversation
ADR-0004 governs Renovate adoption with a shared org baseline. It was
previously authored in NWarila/terraform-runner-template's docs/
decision-records/org/ as a forward-looking mirror of an org decision
that hadn't yet been canonicalized here. Promotion to canonical
finalises the decision's home and lets every adopting consumer mirror
it through drift-gate.
Wording updates relative to the template-resident draft:
- "NWarila/.github" path references → "nwarila-platform/.github"
(the draft predated the canonical's move from a user account to
the nwarila-platform org).
- "NWarila/* repositories" → "nwarila-platform/* repositories".
- The "shared baseline sets terraform.rangeStrategy: pin" claim is
softened to "stack-specific settings are intentionally NOT in the
org baseline; they live in the corresponding type-template's own
renovate.json5". Reflects the three-tier ADR model from ADR-0001
where Terraform-specific decisions belong in the template tier.
- Cross-reference to ADR-0005 updated from a same-repo link to a
cross-repo link to NWarila/terraform-runner-template (where
ADR-0005, "pin Terraform and provider versions exactly", is being
moved as the inaugural template-tier ADR).
- Confirmation §6 ("override discipline") now explicitly distinguishes
repo-tier from template-tier overrides.
Implementation gap (acknowledged):
- The baseline file `nwarila-platform/.github/.github/renovate.json5`
referenced by this ADR does not yet exist on canonical. Creating
it (and refactoring consumer renovate configs to extend it) is a
deliberate follow-up: the ADR captures the decision; its
implementing PRs will be tracked in the §"Implementing PRs"
section as they land.
What this PR ships:
- docs/decision-records/0004-use-renovate-for-dependency-updates.md
- baseline-manifest.json: 10 → 11 entries (adds 0004 mirror).
- docs/decision-records/README.md Index: row added for 0004.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Promotes ADR-0004 ("Use Renovate for Dependency Updates with Shared Org Baseline") from its forward-looking draft in `NWarila/terraform-runner-template/docs/decision-records/org/` to the canonical at `nwarila-platform/.github/docs/decision-records/0004-...`.
Renovate is org-wide concern (any repo with deps benefits) — this is the right tier for it.
What changed in the wording vs the template-resident draft
What this PR does NOT do
Test plan
🤖 Generated with Claude Code