Skip to content

docs: archive completed improvement plan; add ADR 0007 - #101

Merged
aurokin merged 1 commit into
mainfrom
docs/archive-plan-adr0007
May 24, 2026
Merged

docs: archive completed improvement plan; add ADR 0007#101
aurokin merged 1 commit into
mainfrom
docs/archive-plan-adr0007

Conversation

@aurokin

@aurokin aurokin commented May 24, 2026

Copy link
Copy Markdown
Owner

Closes the two documentation loose ends from the session retro.

  1. Archive the improvement plan. docs/post-review-improvement-plan.md is fully merged (PR29 was its last item), so it moves to docs/archive/ alongside the other completed plans and is dropped from the living-docs index — matching the repo's existing convention for finished plans (kept for "why" traceability, not deleted).
  2. Add ADR 0007 — "Generated command reference: ship as a release asset, don't commit it." Captures the decision made while wiring the release docs asset (the spectrum: on-demand / commit+drift-gate / release-asset; why we chose the release asset), so it's discoverable alongside the other six ADRs instead of living only as prose in releasing.md/consuming.md.

Index updates: docs/README.md (ADR line + plan bullet removed), docs/adr/README.md (0007 row), docs/archive/README.md (plan row).

Passed codexrabbit-code-reviewer (verdict: correct, 0.88) — every ADR 0007 claim verified against the actual repo, all cross-refs resolve, no stale references to the moved plan. No code changes.

🤖 Generated with Claude Code

The post-review improvement plan is fully merged (its last item, PR29, shipped),
so move it into docs/archive/ alongside the other completed plans and drop it
from the living-docs index.

Add ADR 0007 recording the decision to ship the generated command reference as
a versioned release asset rather than committing the tree (or committing it
behind a drift gate) — the choice made when wiring the release docs asset.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@aurokin
aurokin merged commit 1a88687 into main May 24, 2026
3 checks passed
@aurokin
aurokin deleted the docs/archive-plan-adr0007 branch May 24, 2026 18:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant