[issue-3288][slice-2/6] De-ledger docs/architecture line-edit pages - #3319
Merged
Conversation
Rewrite the architecture corpus to describe current state, not the SDLC process that produced it. Convert slice/TASK-keyed change-log narration into present-tense behavioral descriptions; remove 'historical record' sections that no longer describe live code; keep GitHub issue links only where they justify why the current design is shaped the way it is. brc-memory.md becomes a present-tense snapshot of the BRC memory mechanism (slice chronology and 'flipped the default' framing dropped). orchestrator.md's BRC consensus-wrapper and per-event composer sections are rewritten to the current orchestrator-owned event-loop model (the in-pod wait loop, capped-restart template, and rollback-by-slice ledger are gone), plus de-ledgered slice-restart hardening, upstream-routing summary, env-var table, and scattered slice/TASK refs. overseer-calibration-corpus.md, upstream-routing.md, and context-discipline.md have slice/TASK ledger and used-to/now narration stripped; retained links read as rationale. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Rename '## 2. The AC-3 contract' to '## 2. The detector contract' to drop the residual SDLC acceptance-criterion id from the doc, matching the de-ledger pass that already stripped the other AC-3 references. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The slice-2 de-ledger of docs/architecture/orchestrator.md renamed two
headings ('Wait-filter construction' -> 'Wake conditions', 'Rollback
plan' -> 'Rollback posture'). Three inbound cross-doc anchor links still
pointed at the old slugs. Repoint them to the new slugs and align the
link text with the destination headings.
Co-Authored-By: Claude Opus 4.8 <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
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.
Sentence-level de-ledgering of the architecture pages that need edits rather than a rewrite. Strip slice/TASK ids; rewrite "used to… now…" into present-tense current behavior; keep issue links that justify the current design, reframed as rationale.
Base PR: #3317
What's in this PR
Commits (3):
This slice
De-ledger docs/architecture line-edit pages
Files affected:
docs/architecture/brc-memory.mddocs/architecture/orchestrator.mddocs/architecture/overseer-calibration-corpus.mddocs/architecture/upstream-routing.mddocs/architecture/context-discipline.mdTasks (2) + acceptance criteria
Stack
issue-3288egg/issue-3288/slice-1