Skip to content

[issue-3288][slice-2/6] De-ledger docs/architecture line-edit pages - #3319

Merged
jwbron merged 4 commits into
mainfrom
egg/issue-3288/slice-2
Jun 26, 2026
Merged

[issue-3288][slice-2/6] De-ledger docs/architecture line-edit pages#3319
jwbron merged 4 commits into
mainfrom
egg/issue-3288/slice-2

Conversation

@james-in-a-box

Copy link
Copy Markdown
Contributor

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):

.egg-state/brc-history/3288-implement-slice-2.json | 684 +++++++++++++++++++++++++++++++++
 .egg-state/brc-history/3288-implement-slice-2.md   | 853 +++++++++++++++++++++++++++++++++++++++++
 docs/architecture/brc-memory.md                    | 306 +++++++--------
 docs/architecture/context-discipline.md            |  23 +-
 docs/architecture/orchestrator.md                  | 666 +++++++++++++-------------------
 docs/architecture/overseer-calibration-corpus.md   | 111 +++---
 docs/architecture/upstream-routing.md              | 138 ++++---
 7 files changed, 2069 insertions(+), 712 deletions(-)

This slice

De-ledger docs/architecture line-edit pages

Files affected:

  • docs/architecture/brc-memory.md
  • docs/architecture/orchestrator.md
  • docs/architecture/overseer-calibration-corpus.md
  • docs/architecture/upstream-routing.md
  • docs/architecture/context-discipline.md
Tasks (2) + acceptance criteria
  • task-2-1: De-ledger docs/architecture/brc-memory.md: replace "Introduced by BRC consensus: replace agent-held waits with deterministic event-pump + durable agent memory (durable fix for #2906) #2908, slice-1.", "Slice-1 lands the writer… lands in slice-3. Slice-4 flipped the default…", "Added in BRC context discipline: protected directive root + queryable environment, bounded by a deterministic threshold reseed #3200 slice-5." with present-tense descriptions of the current BRC-memory mechanism. Keep an issue link only where it explains why the design exists.
    • Acceptance criteria: - brc-memory.md describes the current mechanism with no slice-NUMBER / "lands in slice-N" / "flipped the default" chronology; retained links read as rationale.
  • task-2-2: De-ledger docs/architecture/orchestrator.md (highest density) and the remaining lower-density architecture line-edit pages (overseer-calibration-corpus.md, upstream-routing.md, context-discipline.md). Convert the behavioral sections keyed on slice/TASK ids ("slice-4 TASK-4-5", "TASK-4-1 used to clear only…") and the slice-1→slice-4 "slice lifecycle" change-log section into descriptions of current behavior; strip slice/TASK ids and "used to… now…" narration from the others; keep issue links only as rationale.
    • Acceptance criteria: - orchestrator.md "slice lifecycle"/rollout narration is replaced by a current-behavior description; no slice-N/TASK-N references remain except reviewer-accepted live-machinery naming. - overseer-calibration-corpus.md, upstream-routing.md, and context-discipline.md carry no slice/TASK ledger references; retained links are rationale.

Stack

egg and others added 3 commits June 26, 2026 21:26
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>
@jwbron
jwbron changed the base branch from egg/issue-3288/slice-1 to main June 26, 2026 22:42
@jwbron
jwbron merged commit 15fd980 into main Jun 26, 2026
22 of 24 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant