Skip to content

[issue-3288][slice-3/6] Total-refactor load-bearing architecture pages - #3320

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

[issue-3288][slice-3/6] Total-refactor load-bearing architecture pages#3320
jwbron merged 3 commits into
mainfrom
egg/issue-3288/slice-3

Conversation

@james-in-a-box

Copy link
Copy Markdown
Contributor

Rewrite the architecture pages whose ledger framing is load-bearing into current-state prose (not a line edit); preserve genuinely useful rationale, reframed and isolated where substantial. Highest judgment cost — isolated into its own slice.

Base PR: #3317

What's in this PR

Commits (3):

.egg-state/brc-history/3288-implement-slice-3.json | 487 ++++++++++++++++++++++++++++++++++++
 .egg-state/brc-history/3288-implement-slice-3.md   | 543 +++++++++++++++++++++++++++++++++++++++++
 docs/architecture/coordination-state.md            |  91 +++----
 docs/architecture/gateway-auto-filter.md           | 245 ++++++++++++-------
 docs/architecture/slice-dag.md                     | 312 +++++++++++------------
 5 files changed, 1363 insertions(+), 315 deletions(-)

This slice

Total-refactor load-bearing architecture pages

Files affected:

  • docs/architecture/gateway-auto-filter.md
  • docs/architecture/coordination-state.md
  • docs/architecture/slice-dag.md
Tasks (3) + acceptance criteria
  • task-3-1: Rewrite docs/architecture/gateway-auto-filter.md: remove the "## What was removed" inventory and the "preserved for context" description of the removed historical Gateway should auto-filter disallowed files on push, and handle pulled cross-role commits #1882 design — keep only what a reader of the current filter needs (a one-line rationale link is acceptable).
    • Acceptance criteria: - gateway-auto-filter.md has no "what was removed" / "preserved for context" historical-record section; current behavior stands alone.
  • task-3-2: Rewrite docs/architecture/coordination-state.md: replace "This page describes the final shape of the Design: coordination state is served, not replicated — retire git/prompt choreography for agent state exchange #3077 invariant. The epic was landed in six slices, all of which have now shipped…" with a direct statement of the current invariant, and convert the Threat/Mitigation/Status tables full of "Retired surface" / "now historical" rows into the current threat model (drop retired rows or fold them into a short rationale note).
    • Acceptance criteria: - coordination-state.md states the current invariant directly with no "landed in six slices" chronology; status tables carry only live rows (retired rows removed or reduced to rationale).
  • task-3-3: Rewrite docs/architecture/slice-dag.md: replace "The implement phase used to run as a single monolithic agent team… The slice-DAG model replaces that…" with a description of the current slice-DAG model. A brief rationale note on why the model exists is fine; the chronology is not. The word "slice" is a live domain concept here — keep it; strip only the change-log narration and slice-NUMBER ledger references.
    • Acceptance criteria: - slice-dag.md describes the current model; "used to… replaces that…" narration is gone; the live "slice" domain term is retained.

Stack

egg and others added 3 commits June 26, 2026 21:46
Rewrite the three load-bearing architecture pages as current-state
snapshots rather than change-log / slice-landing ledgers:

- gateway-auto-filter.md: drop the removed silent-strip rewrite path
  (filtered_push.py, per-commit rewrite, binary re-staging, "What was
  removed") and the "preserved for context" framing; describe the live
  403 restricted_path_modified rejection + commit-authorship registry.
- coordination-state.md: replace the "landed in six slices" table with a
  direct statement of the invariant; collapse the wipe-semantics
  Threat/Status table to the one live designed wipe, folding the retired
  in-memory-backend row into a rationale note.
- slice-dag.md: replace the "used to run as a single monolithic team"
  narration with a current-model description; strip TASK-N / decision-N /
  HITL-iteration / v6 / pre-#2137 ledger references, keeping the live
  "slice" domain term and issue links that serve as rationale.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Address reviewer_contract NACK on task-3-3:
- Describe the shared per-slice integration branch in present tense,
  dropping the 'v6' process-iteration tag.
- Reframe title truncation to current behavior (titles over 70 chars
  truncate at a word boundary), dropping the removed-hard-cut narration.

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 a5c2a8b into main Jun 26, 2026
32 of 34 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