Conversation
…ned) Opens gap #5 of the Frontier bootstrap readiness roadmap. Creates docs/frontier-readiness/ directory + the audit seed with: - Three-class framework: factory-generic / zeta-library- specific / both-coupled - Section-by-section schema for each audited file - Audit progress tracker (16 primary surfaces queued) - First audit: CLAUDE.md (classified "both"; 3 refactor notes flagged for pre-split edit; goes to Frontier post- split) - Composes with gap #1 (multi-repo split execution) — classification enables mechanical separation Cadence: opportunistic on-touch + 1-2 files per dedicated tick until all primary surfaces are audited. Attribution: Otto (loop-agent PM hat). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Gap #5 opens with PR #179: docs/frontier-readiness/ directory created, factory-vs-zeta-separation-audit.md seeded with the three-class framework (factory-generic / zeta-library- specific / both-coupled) + schema + 16-surface queue. First file audited: CLAUDE.md → "both (coupled)". Three surgical refactor edits flagged for pre-split execution. Estimated refactor effort: S. Load-bearing for gap #1 (multi-repo split) — classification enables mechanical separation rather than split-time re-classification. Attribution: Otto (loop-agent PM hat). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e91c932d5d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| the specific library Zeta was originally built for. | ||
|
|
||
| The eventual multi-repo split (per | ||
| `docs/research/multi-repo-refactor-shapes-2026-04-23.md`) |
There was a problem hiding this comment.
Replace reference to absent multi-repo refactor document
This audit is framed as load-bearing for gap #1, but it cites docs/research/multi-repo-refactor-shapes-2026-04-23.md, which is not present in the repository (repo-wide file search for that path returns no match). That makes the prerequisite design uninspectable for anyone following this document and undermines the claim that split execution can be done mechanically from auditable inputs.
Useful? React with 👍 / 👎.
| - Per-user memory | ||
| `project_frontier_becomes_canonical_bootstrap_home_stop_signal_when_ready_agent_owns_construction_2026_04_23.md` | ||
| — the authorization under which this audit runs |
There was a problem hiding this comment.
Remove non-repo per-user memory citation from audit basis
The "Composes with" section depends on a per-user memory file name that is not tracked in the repo, so other contributors cannot read or validate the stated authorization context. For a governance/audit artifact, this creates a reproducibility gap: the document cites a required input that is inaccessible to everyone except the original session context.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Pull request overview
Seeds the Frontier bootstrap readiness work by introducing a “factory vs Zeta” separation-audit document intended to classify monorepo surfaces ahead of the eventual multi-repo split.
Changes:
- Add a new
docs/frontier-readiness/documentation surface for split-readiness work. - Introduce a three-class classification framework (factory-generic / zeta-library-specific / both) plus a per-file audit schema.
- Perform the first audit entry (CLAUDE.md) including refactor notes needed prior to split execution.
|
|
||
| **Status:** seed v0 — framework + first doc classified. Grows tick-by-tick. | ||
| **Purpose:** closes gap #5 of the Frontier bootstrap readiness roadmap (BACKLOG P0). | ||
| **Owner:** Otto (loop-agent PM hat); reviewer consultation as sections mature. |
| The eventual multi-repo split (per | ||
| `docs/research/multi-repo-refactor-shapes-2026-04-23.md`) | ||
| separates these into sibling repos. Frontier will host the | ||
| factory substrate; Zeta will keep the library. |
| class | ||
| - **Refactor notes**: what needs to change before the split | ||
| can cleanly separate this file (if class is "both") | ||
| - **Audit date + auditor**: traceability |
| Claude Code user would reach for," not Zeta-library content | ||
| itself. | ||
|
|
||
| **Length:** 267 lines. |
| ## Composes with | ||
|
|
||
| - `docs/BACKLOG.md` — "Frontier bootstrap readiness roadmap" | ||
| P0 row, gap #5 |
| - Per-user memory | ||
| `project_frontier_becomes_canonical_bootstrap_home_stop_signal_when_ready_agent_owns_construction_2026_04_23.md` | ||
| — the authorization under which this audit runs |
Continues gap #5 cadence (1-2 files per dedicated tick). PR #179 (seed) merged; audit substrate now on main. AGENTS.md classified both (coupled): 15 sections broken down, 6 surgical refactor edits flagged, effort M. Post-split location: Frontier as authoritative onboarding template. PR #180 armed for auto-merge. Hypothesis from first two audits: onboarding substrate is uniformly "both (coupled)" — mostly factory-shape with embedded Zeta-examples. If holds for next several files, refactor scope becomes mechanical. Attribution: Otto (loop-agent PM hat). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Summary
docs/frontier-readiness/directory.docs/frontier-readiness/factory-vs-zeta-separation-audit.mdwith the three-class framework + audit schema + first file classified (CLAUDE.md → "both").What the audit does
For each file in the monorepo, classify as one of three classes before the multi-repo split (gap #1) executes:
factory-genericzeta-library-specificboth (coupled)First audit — CLAUDE.md
Classification: both (coupled) — file lives in Frontier post-split; three surgical refactor edits flagged before split execution:
Result<_, DbspError>example to a generic result-type illustrationdotnet build -c Release/dotnet test Zeta.slngate (Zeta-library-specific); replace with a generic "your project's build/test gate" pointeropenspec/changes/"intentionally unused" directiveEstimated refactor effort: S — isolated surgical edits.
Why this matters for gap #1 (multi-repo split)
Without this audit, the split would require re-classification at split-time (high risk, high blast radius). With this audit, the split becomes mechanical: factory-generic files move, zeta-library-specific files stay, "both" files get pre-refactored.
Cadence
Opportunistic on-touch + 1-2 dedicated per tick until all ~16 primary surfaces are audited. Does NOT execute the split (that's gap #1).
Test plan
Attribution
Otto (loop-agent PM hat); no specialist persona hats worn for this substrate-building work.
🤖 Generated with Claude Code