Merge branch 'codex/claude-factory-native' into codex/merge-recent-branches

# Conflicts:
#	cli/README.md
#	docs/workflows/session-lifecycle.md
This commit is contained in:
Boden Fuller
2026-04-02 15:54:48 -04:00
22 changed files with 770 additions and 437 deletions
+10 -7
View File
@@ -14,8 +14,8 @@ Just describe what you want:
| Say This | What Happens |
|----------|--------------|
| "Continue working on X" | Loads context, shows progress, finds next task when runtime hooks are available |
| "I need to add Y" | Checks for plan, guides you if needed |
| "Continue working on X" | `CLAUDE.md` provides the startup surface; hooks recover handoff and stage any factory state silently |
| "I need to add Y" | If no startup goal exists yet, the first substantive prompt can be captured as silent factory intake for later explicit `/rpi` or `ao knowledge brief` use |
| "I'm done for today" | Saves progress, offers retrospective |
| "What should I work on?" | Shows status, suggests next task |
| "Where was I?" | Shows last session, current state, blockers |
@@ -83,7 +83,7 @@ with `ao codex ensure-stop`.
| Mode | Start | Closeout | Notes |
|------|-------|----------|-------|
| Hook-capable | Natural language, `/session-start`, or startup hooks | Natural language, `/session-end`, or session-end hooks | Best fit for Claude/OpenCode when hooks are installed |
| Hook-capable | Natural language, `/session-start`, or startup hooks | Natural language, `/session-end`, or session-end hooks | Best fit for Claude/OpenCode when hooks are installed; `CLAUDE.md` is the startup surface and hooks stage state silently |
| Codex hookless fallback | `ao factory start --goal "<goal>"`, `ao codex start`, or skill-driven `ao codex ensure-start` | `ao codex stop` or skill-driven `ao codex ensure-stop` | No startup/session-end hook surface under `~/.codex`; lifecycle is explicit |
| Manual fallback | `ao inject`, `ao lookup` | `ao forge transcript`, `ao flywheel close-loop` | Lowest-level portable path |
@@ -96,10 +96,10 @@ with `ao codex ensure-stop`.
│ SESSION START │
│ "Continue the API work" or /session-start │
├─────────────────────────────────────────────────────────────┤
│ • Load bundle (if exists) │
│ • Read claude-progress.json │
│ • Show: last session, current work, next steps │
│ • Suggest: next feature to work on │
│ • Recover handoff / tracker goal when available │
│ • Keep operator framing in CLAUDE.md │
│ • Stage factory goal / briefing files silently │
│ • Mark missing-goal sessions for prompt-time intake │
└─────────────────────────────────────────────────────────────┘
│
▼
@@ -107,6 +107,8 @@ with `ao codex ensure-stop`.
│ WORK │
│ "Add the validation layer" or just start coding │
├─────────────────────────────────────────────────────────────┤
│ • First substantive prompt can become silent factory intake│
│ • Run /rpi or ao knowledge brief explicitly when needed │
│ • Implement features │
│ • Fix bugs │
│ • Research when needed │
@@ -306,6 +308,7 @@ Next time, just say "continue the caching work" and I'll pick up where you left
| `ao codex start` | Start an explicit Codex hookless session | Start of work in Codex |
| `ao codex stop` | Close out a Codex session without runtime hooks | End of work in Codex |
| `ao codex status` | Inspect Codex lifecycle and flywheel health | Any time in Codex |
| Natural-language goal | Native factory intake when hooks are installed | Preferred operator entrypoint in Claude/OpenCode |
| `/session-start` | Initialize session, load context | Start of work in hook-capable runtimes |
| `/session-end` | Save progress, close gracefully | End of work in hook-capable runtimes |
| `/progress-update` | Update progress files | During work |