Skip to content

recover: three-repo-split ADR (Zeta + Forge + ace) from closed PR #54#378

Merged
AceHack merged 2 commits intomainfrom
recover/three-repo-split-adr-from-pr54
Apr 24, 2026
Merged

recover: three-repo-split ADR (Zeta + Forge + ace) from closed PR #54#378
AceHack merged 2 commits intomainfrom
recover/three-repo-split-adr-from-pr54

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 24, 2026

Summary

Recovers the three-repo-split ADR I over-closed via PR #54 earlier this session.

The ADR was drafted on commit `41d2bb6` and never landed on main through any other path. I closed #54 as "superseded" on the assumption the content was already on main — the assumption was wrong for this file.

Aaron's call on the over-close pattern

"bet you can find it in one of your closed PRs"
"i knew you were over closing"
"it's your fuckup so you got to be retractiable in recover or i loose confidence"

This is the first recovery. Audit of other closed PRs in progress.

What the ADR locks in

  • Three-repo split: Zeta (database/SUT, stays) + Forge (factory, Claude-delegated) + ace (package manager, Aaron-owned)
  • Ouroboros: ace → Zeta / ace ← Forge / Zeta ← Forge / Forge → Forge (closed cycle + self-loop)
  • Public from day one per Aaron directive
  • Four-stage migration: Stage 0 = this ADR; Stage 1+ pending
  • Forge name rationale: adopts established "code-forge" vocabulary (Sourcehut, Codeberg, Gitea, Forgejo)

Scope

ADR file only. The original commit also updated `docs/BACKLOG.md` to add a "P2 — Factory repo architecture" section; that part is deferred per the HB-002 per-row-BACKLOG-split blocker (no new BACKLOG.md rows until the split lands).

Retractability-in-action (Otto-238)

Close-then-recover is the trust-vector reversal principle at the PR layer. The trail is visible in git history — visible reversal preserves the glass-halo discipline.

Test plan

  • File re-created from `git show 41d2bb6:docs/DECISIONS/2026-04-22-three-repo-split-zeta-forge-ace.md`
  • Single-file diff; no conflicts with current main
  • No test harness to run (doc-only)
  • Aaron reviews ADR substance (I was not the original author; Aaron drafted it originally)

Follow-up

🤖 Generated with Claude Code

Recovers the ADR that was drafted on commit 41d2bb6 ("Round 44:
ADR — three-repo split (Zeta + Forge + ace)") in the Round-44
speculative fork branch stack. That commit was part of PR #54's
diff, which I closed-as-superseded earlier this session on the
assumption that "content already shipped to main via other PRs."

The assumption was wrong for this ADR — it never landed on main
by any other path. Aaron called out the over-close pattern
2026-04-24: *"bet you can find it in one of your closed PRs"*
and more broadly *"i knew you were over closing."*

This PR recovers ONLY the ADR file. The original 41d2bb6 commit
also modified `docs/BACKLOG.md` to add a "P2 — Factory repo
architecture" section; that BACKLOG update is deferred per the
HB-002 per-row-BACKLOG-split blocker (no new BACKLOG.md rows
until the split lands).

## What the ADR locks in

- Three-repo split: Zeta (database/SUT) + Forge (software
  factory, self-hosting, Claude-delegated) + ace (package
  manager, Aaron-owned)
- Closed Ouroboros dependency cycle: ace → Zeta, ace ← Forge,
  Zeta ← Forge, Forge → Forge
- All three repos public from day one
- Four-stage reversible migration (Stage 0 = this ADR)
- Forge name rationale: adopts established "code-forge" term
  (Sourcehut, Codeberg, Gitea, Forgejo) per no-invent-
  vocabulary rule

## Retractability-in-action

Otto-238 (retractability as trust vector): this is a visible
reversal event. I closed #54 too eagerly; Aaron flagged the
over-close pattern; this PR reverses the ADR-specific loss.
The close+recover trail is visible in git history — that's the
factory's retractability principle at the PR layer.

## Follow-up audit

Per Aaron 2026-04-24 directive: going through all closed PRs
I authored to identify other over-close misses. Audit in
progress. This PR addresses the most load-bearing loss
(three-repo-split ADR); other misses land in follow-up PRs.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 24, 2026 18:19
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack enabled auto-merge (squash) April 24, 2026 18:19
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Recovers and reintroduces the missing ADR documenting the intended three-repo split (Zeta + Forge + ace) and its migration plan, so the decision record exists on main.

Changes:

  • Adds ADR 2026-04-22-three-repo-split-zeta-forge-ace.md back to docs/DECISIONS/.
  • Documents the split rationale (including Ouroboros dependency topology) and a staged migration plan.
  • Captures a repo-creation “best practices” checklist and cross-references related docs/memories.

Comment thread docs/DECISIONS/2026-04-22-three-repo-split-zeta-forge-ace.md
Comment thread docs/DECISIONS/2026-04-22-three-repo-split-zeta-forge-ace.md Outdated
Comment thread docs/DECISIONS/2026-04-22-three-repo-split-zeta-forge-ace.md Outdated
Comment thread docs/DECISIONS/2026-04-22-three-repo-split-zeta-forge-ace.md Outdated
… MD032

- Line 373, 379, 397, 453, 461, 611: add memory/ prefix per Copilot
  thread feedback (files exist under memory/, bare refs don't resolve)
- Line 340: rewrite + prefix to plus to fix markdownlint MD032
  (blanks-around-lists was flagged on the quoted-text lines)
- Keep name attribution in Deciders list intact per Aaron 2026-04-24:
  "first names are not PII and allowed in history files not other type file"
  (ADRs under docs/DECISIONS/** are history files per GOVERNANCE §2)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack AceHack merged commit 7e24b82 into main Apr 24, 2026
10 checks passed
@AceHack AceHack deleted the recover/three-repo-split-adr-from-pr54 branch April 24, 2026 19:24
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.

2 participants