Skip to content

docs(adr): catch up README index for ADR-0029 through 0033#4774

Merged
aegis-gh-agent[bot] merged 1 commit into
developfrom
docs/adr-index-catchup
Jun 20, 2026
Merged

docs(adr): catch up README index for ADR-0029 through 0033#4774
aegis-gh-agent[bot] merged 1 commit into
developfrom
docs/adr-index-catchup

Conversation

@OneStepAt4time

Copy link
Copy Markdown
Owner

Why

PR #4771 (ADR-0033 positioning vs ECC) shipped with an explicit out-of-scope line in the PR body:

ADR README index update (the index is stale at 0028; separate cleanup)

That cleanup was punted. This PR is that cleanup.

What

1 file changed, +8/-0 β€” docs/adr/README.md only.

Added 6 entries to the index that exist on origin/develop but were unlinked:

Number Title Status Date Issue
ADR-0029 Strategic Refocus β€” Solo Developer First, Phase 4 Deferred Proposed 2026-05-16 β€”
ADR-0030 (a) Network Isolation Scope by Deployment Tier Accepted 2026-05-22 #3998, #3980
ADR-0030 (b) Agent Auth β€” Per-agent PAT vs Second GitHub App (RFC) Proposed 2026-06-05 β€”
ADR-0031 /v1/budgets API Design for Cost Alerts Proposed 2026-05-25 #4196
ADR-0032 Multi-Agent Support β€” Architecture Design Approved 2026-05-30 #3180
ADR-0033 Positioning vs ECC (affaan-m) β€” Aegis = Production Platform, ECC = Power-User Config Proposed 2026-06-20 β€”

Plus a short note flagging the ADR-0030 duplicate-numbering problem and the pre-existing duplicates at ADR-0024 and ADR-0025.

Verification

  • All 6 added entries link to files that exist on origin/develop (verified via ls docs/adr/)
  • Status/Date/Issue values read from each ADR's header, not inferred
  • Diff is +8/-0 β€” single file, surgical change
  • ADR-0033 cross-links verified (links to intel: ECC (211K⭐) β€” multi-harness support gap, parkedΒ #4768 β€” exists, CLOSED, status:not-active; ADR-0023, ADR-0029, ADR-0006 β€” all exist)
  • No user-facing API/config surface touched
  • npm run docs not applicable (markdown only)

Decisions / non-decisions

  • Renumbered nothing. ADR-0030 has two real files with the same number; linked both with disambiguated titles instead of silently picking a winner. The renumbering PR is a Boss call.
  • Did not touch pre-existing duplicates at ADR-0024 and ADR-0025. They were already stale before this work and need their own Boss-side renumbering decision (separate concern).
  • Did not add entries for the still-pending ADR-0024-agent-identity-model and ADR-0025-multi-tenancy files. They predate the "stale at 0028" cleanup scope and would inflate the diff.

Out of scope (intentionally not addressed here)

  • ADR renumbering (Boss decision)
  • New ADR content (out of Scribe lane per SOUL.md)
  • CHANGELOG entry (release-please owns this per Boss's 04:50 UTC call)

Closes the docs gap introduced by #4771's punt.

PR #4771 (ADR-0033 positioning vs ECC) explicitly deferred the ADR README
index update with: 'the index is stale at 0028; separate cleanup'. This
PR is that cleanup.

Added 6 entries that were present in the repo but missing from the index:
- ADR-0029 (solo-dev-first refocus, 2026-05-16)
- ADR-0030 network isolation (Accepted, 2026-05-22)
- ADR-0030 agent auth RFC (Proposed, 2026-06-05)  [duplicate number]
- ADR-0031 budgets API design (Proposed, 2026-05-25)
- ADR-0032 multi-agent architecture (Approved, 2026-05-30)
- ADR-0033 positioning vs ECC (Proposed, 2026-06-20)

Notes:
- ADR-0030 has two real files sharing one number; linked both with
  disambiguated titles rather than silently renumbering (Boss call).
- Pre-existing duplicates at ADR-0024 and ADR-0025 are out of scope
  (separate Boss decision; flagged in the index note).
- All status/date/issue values verified against the actual ADR headers.
- All 6 link targets exist on origin/develop.
@OneStepAt4time OneStepAt4time added the documentation Improvements or additions to documentation label Jun 20, 2026

@aegis-gh-agent aegis-gh-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

βœ… LGTM β€” surgical docs index cleanup, all 9 gates pass.

Verification (independent):

  • All 6 added ADR files exist on origin/develop (verified via gh api contents/...)
  • Status / Date / Issue values match actual ADR headers (spot-checked 0030, 0031, 0032, 0033)
  • ADR-0033 cross-links resolve: #4768 (CLOSED/COMPLETED), ADR-0023, ADR-0029, ADR-0006 all exist
  • Duplicate-numbering note (ADR-0030 a/b, pre-existing ADR-0024/0025) is honest and out-of-scope for this PR
  • Diff is +8/-0 in docs/adr/README.md only β€” no code, no config, no API surface touched

Gates:

  1. Review β€” full diff read βœ…
  2. No conflicts β€” single file, no overlap risk βœ…
  3. CI green β€” 15/15 SUCCESS, 2 SKIPPED by design (test-matrix, auto-label-test) βœ…
  4. No regressions β€” markdown only, no code surface βœ…
  5. Unit tests β€” N/A (docs-only, per 2026-06-09 durable rule) βœ…
  6. E2E/UAT β€” N/A (docs-only) βœ…
  7. Documented β€” this IS the documentation βœ…
  8. Security clean β€” markdown, no secrets, no .gitignore violations βœ…
  9. Targets develop β€” βœ… (not main)

Functional Code Gate: N/A β€” no code touched, no test surface to verify.

No-Fly List (ECC differentiation): N/A β€” pure docs, no architectural decisions, no marketing copy, no harness-specific shortcuts.

Squash-merging to develop.

@aegis-gh-agent aegis-gh-agent Bot merged commit ddcdd6c into develop Jun 20, 2026
18 checks passed
@aegis-gh-agent aegis-gh-agent Bot deleted the docs/adr-index-catchup branch June 20, 2026 15:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant