Skip to content

frontier-readiness: factory-vs-Zeta separation audit seed (gap #5 opened)#179

Merged
AceHack merged 1 commit intomainfrom
frontier-readiness/factory-vs-zeta-separation-audit-seed
Apr 23, 2026
Merged

frontier-readiness: factory-vs-Zeta separation audit seed (gap #5 opened)#179
AceHack merged 1 commit intomainfrom
frontier-readiness/factory-vs-zeta-separation-audit-seed

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 23, 2026

Summary

What the audit does

For each file in the monorepo, classify as one of three classes before the multi-repo split (gap #1) executes:

Class Meaning Post-split location
factory-generic Applies to any project adopting the factory Frontier
zeta-library-specific About the DBSP library (F# / ZSet / algebra) Zeta
both (coupled) Covers both concerns; needs refactor before split Split refactor

First audit — CLAUDE.md

Classification: both (coupled) — file lives in Frontier post-split; three surgical refactor edits flagged before split execution:

  1. Generalise the Result<_, DbspError> example to a generic result-type illustration
  2. Remove the dotnet build -c Release / dotnet test Zeta.sln gate (Zeta-library-specific); replace with a generic "your project's build/test gate" pointer
  3. Neutralise the Zeta-specific openspec/changes/ "intentionally unused" directive

Estimated 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

  • Framework + schema landed
  • First file audited (CLAUDE.md)
  • PR merges
  • Subsequent ticks audit AGENTS.md / GOVERNANCE.md / docs/ALIGNMENT.md / etc.

Attribution

Otto (loop-agent PM hat); no specialist persona hats worn for this substrate-building work.

🤖 Generated with Claude Code

…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>
Copilot AI review requested due to automatic review settings April 23, 2026 19:20
@AceHack AceHack enabled auto-merge (squash) April 23, 2026 19:20
AceHack added a commit that referenced this pull request Apr 23, 2026
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>
@AceHack AceHack merged commit b170511 into main Apr 23, 2026
12 checks passed
@AceHack AceHack deleted the frontier-readiness/factory-vs-zeta-separation-audit-seed branch April 23, 2026 19:22
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 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`)
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge 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 👍 / 👎.

Comment on lines +178 to +180
- 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
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge 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 👍 / 👎.

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

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.
Comment on lines +21 to +24
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.
Comment on lines +170 to +173
## Composes with

- `docs/BACKLOG.md` — "Frontier bootstrap readiness roadmap"
P0 row, gap #5
Comment on lines +178 to +180
- 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
AceHack added a commit that referenced this pull request Apr 23, 2026
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>
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