-
Notifications
You must be signed in to change notification settings - Fork 1
frontier-readiness: gap #5 audit — AUTONOMOUS-LOOP.md + WONT-DO.md (batched) #186
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -53,17 +53,15 @@ For each audited file: | |||||||||||
|
|
||||||||||||
| ### Files audited | ||||||||||||
|
|
||||||||||||
| - **CLAUDE.md** (below, this seed fire) | ||||||||||||
| - **CLAUDE.md** (below, seed fire) | ||||||||||||
| - **AGENTS.md** (below, Otto-9 fire) | ||||||||||||
| - **docs/CONFLICT-RESOLUTION.md** (below, Otto-12 fire) — note: GOVERNANCE.md audit landing separately via PR #181 | ||||||||||||
| - **docs/CONFLICT-RESOLUTION.md** (below, Otto-12 fire) | ||||||||||||
| - **docs/AUTONOMOUS-LOOP.md** (below, Otto-15 fire) | ||||||||||||
| - **docs/WONT-DO.md** (below, Otto-15 fire) — also GOVERNANCE.md on PR #181, AGENT-BEST-PRACTICES.md on PR #184, ALIGNMENT.md on PR #185 | ||||||||||||
|
|
||||||||||||
| ### Files to audit (not yet classified; add rows as they land) | ||||||||||||
|
|
||||||||||||
| - `docs/ALIGNMENT.md` | ||||||||||||
| - `docs/AGENT-BEST-PRACTICES.md` | ||||||||||||
| - `docs/GLOSSARY.md` | ||||||||||||
| - `docs/WONT-DO.md` | ||||||||||||
| - `docs/AUTONOMOUS-LOOP.md` | ||||||||||||
| - `docs/FACTORY-HYGIENE.md` | ||||||||||||
| - `docs/ROUND-HISTORY.md` | ||||||||||||
| - `docs/TECH-RADAR.md` | ||||||||||||
|
|
@@ -284,6 +282,106 @@ surgically extract. The rest of the persona roster is | |||||||||||
| already factory-generic by design (named personas with | ||||||||||||
| generic scopes applicable to any factory adopter). | ||||||||||||
|
|
||||||||||||
| ## Audit — docs/AUTONOMOUS-LOOP.md | ||||||||||||
|
|
||||||||||||
| **Overall classification:** **factory-generic** — Otto's own | ||||||||||||
| operating spec is purely Claude Code harness discipline with | ||||||||||||
| no Zeta-library content. | ||||||||||||
|
|
||||||||||||
| **File location post-split:** Frontier as-is. | ||||||||||||
|
|
||||||||||||
| **Length:** 483 lines. **9 sections.** | ||||||||||||
|
|
||||||||||||
| ### Section-by-section breakdown | ||||||||||||
|
|
||||||||||||
| | Section | Class | Notes | | ||||||||||||
| |---|---|---| | ||||||||||||
| | Preamble (tick cadence, self-direction) | factory-generic | Universal autonomous-loop framing. | | ||||||||||||
| | "Mechanism — native Claude Code scheduled tasks" | factory-generic | `CronCreate` / `CronList` / `CronDelete` — Claude Code v2.1.72+ native tools; ralph-loop plugin differentiation. All harness-level. | | ||||||||||||
| | "The registered tick" | factory-generic | `<<autonomous-loop>>` sentinel + `* * * * *` cadence. | | ||||||||||||
| | "The every-tick checklist" | factory-generic | Triage / audit / commit / tick-history / CronList / visibility. Universal loop discipline. | | ||||||||||||
| | "Escalation on failure" | factory-generic | | | ||||||||||||
| | "Session-restart recovery" | factory-generic | Session-compaction + re-armed-cron discipline. | | ||||||||||||
| | "What this discipline does NOT do" | factory-generic | Scope-boundary discipline. | | ||||||||||||
| | "Related artifacts" | factory-generic (file-path pointers transfer) | | | ||||||||||||
| | "History" | factory-generic | Evolution log of the loop discipline. | | ||||||||||||
|
|
||||||||||||
| ### Refactor notes | ||||||||||||
|
|
||||||||||||
| Before the split: **zero** substantive edits required. The | ||||||||||||
| spec is pure Claude Code harness discipline; Frontier | ||||||||||||
| adopters using Claude Code inherit verbatim. Adopters using | ||||||||||||
| a different harness (Codex, Gemini, etc.) would need an | ||||||||||||
| equivalent spec — but that's content creation for them, not | ||||||||||||
| content extraction from Zeta. | ||||||||||||
|
|
||||||||||||
| Estimated refactor effort: **~0** (zero). The cleanest | ||||||||||||
| factory-generic file audited so far. | ||||||||||||
|
|
||||||||||||
| ### Classification rationale | ||||||||||||
|
|
||||||||||||
| AUTONOMOUS-LOOP.md is Otto's own spec — the cron-tick | ||||||||||||
| discipline that runs the factory's self-direction. The spec | ||||||||||||
| is Claude Code harness-level by design; no Zeta-library | ||||||||||||
| content appears anywhere. Adopters get this file verbatim | ||||||||||||
| and their autonomous-loop runs the same way. | ||||||||||||
|
|
||||||||||||
| ## Audit — docs/WONT-DO.md | ||||||||||||
|
|
||||||||||||
| **Overall classification:** **both (coupled)** — the | ||||||||||||
| declined-work-log shape is factory-generic (entry template, | ||||||||||||
| status vocabulary, revisit criteria); the specific entries | ||||||||||||
| are heavily Zeta-library-specific (algorithm decisions, | ||||||||||||
| engineering patterns, DBSP-library out-of-scope items). | ||||||||||||
|
|
||||||||||||
| **File location post-split:** Template (shape + preamble + | ||||||||||||
| status vocab + entry schema) → Frontier. Zeta-specific | ||||||||||||
| entries → Zeta repo's own WONT-DO.md at split time. | ||||||||||||
|
|
||||||||||||
| **Length:** 626 lines. **6 top-level sections.** | ||||||||||||
|
||||||||||||
| **Length:** 626 lines. **6 top-level sections.** | |
| **Shape:** Medium-sized policy log with a factory-generic | |
| preamble/status vocabulary, several substantive declined-work | |
| sections, and a factory-generic "How to add an entry" | |
| appendix. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Reclassify persona section as split-coupled content
Marking Personas and emulation as factory-generic is inconsistent with the source it summarizes: docs/WONT-DO.md contains a maintainer-specific active-instance entry (including a named individual and project-local memory path), so treating this section as transferable will cause split planning to move project-specific policy into Frontier instead of keeping it in Zeta or templating it. This can misdirect the gap #1 extraction workflow and propagate non-generic content to adopters.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The recorded line count for
docs/AUTONOMOUS-LOOP.mdlooks stale. In the current tree it is 484 lines (not 483), so this audit entry will drift as the target file changes. Consider either updating the number or removing hard-coded line counts to avoid ongoing maintenance churn.