# nagent_review_v3_20260619 — Mike Acton's nagent, the 24-commit evolution + case studies

**Status:** Draft (Phase 1 setup complete; cluster sections pending)
**Initialized:** 2026-06-19
**Owner:** Tier 1 Orchestrator (sole author; Tier 2 executing per `plan_v3.md`)
**Spec pair:** `spec_v3.md` + `plan_v3.md` (in the same track directory)
**Lineage:** Supersedes `nagent_review_v2_3_20260612.md` (4,969 lines, the v2.3 canonical review). v2.3 is preserved as historical.
**Source state:** `macton/nagent@a1f0680` (2026-06-18 23:51:28 UTC) + the two case-study repos at `main`.

> **Reading guide.** v3 covers the 24 new nagent commits on `macton/nagent@main` between `eb6be32a` (2026-06-12) and `a1f0680` (2026-06-18), and the two case-study repos that didn't exist at v2.3 baseline: [`macton/pep-copt`](https://github.com/macton/pep-copt) and [`macton/differentiable-collisions-optc`](https://github.com/macton/differentiable-collisions-optc). The 11 clusters are: Campaigns (§1), Conversation safety net (§2), Hooks (§3), Project-local roots (§4), Provider expansion (§5), Delegation rewrite (§6), Robustness (§7), Operating rules (§8), Case-study methodology (§9), PEP case study (§10), Collisions case study (§11).

> **Lineage note.** v2.3's 14-pattern analysis stands; v3 does not delete it. Where v3 updates a v2.3 pattern, the cluster section calls out the update explicitly. Where v3 introduces a new pattern, the cluster section cites the v2.3 pattern it does NOT replace (if any).

## §0 TL;DR

(filled in by Phase 13; placeholder — v3 covers the 24-commit nagent evolution between `eb6be32a` and `a1f0680`, plus two case-study repos that demonstrate nagent's per-turn proof harness in production. Three entirely new first-class subsystems land: Campaigns, Conversation safety net, and Hooks. The case-study methodology (4 prompts + proof harness + optimization log + committed-input sha256 freeze) is itself a reusable abstraction. Updates to existing patterns: 6 providers instead of 5 (Together added), delegation rewrite fixes a recursion bug, robustness commits harden the loop, and the operating-rules get a new Q9 for "sampling justifies replacing the machine.")

## §1 Campaigns

(filled in by Phase 2 — covers `24cf16d`, `199a36b`, `f3ec090`, `c1d2cad`, `6443d70`, `7a7e242`)

## §2 Conversation safety net

(filled in by Phase 3 — covers `38d3d4f`, `6426a67`)

## §3 Hooks

(filled in by Phase 4 — covers `a4fb141` + both case-study harness scripts)

## §4 Project-local roots

(filled in by Phase 5 — covers `54c8741`, `557dd39`, `0b9d1a2`, `023e23a`)

## §5 Provider expansion

(filled in by Phase 6 — covers `bdfa2a6`, `5075f6e`, `2edc7ee`)

## §6 Delegation rewrite

(filled in by Phase 7 — covers `d56f0f0`, `65787a6`, `315fe9e`)

## §7 Robustness

(filled in by Phase 8 — covers `065168c`, `6b762da`, `12c35b7`, `49e07f3`)

## §8 Operating rules

(filled in by Phase 9 — covers `a1f0680` + cross-refs Fable)

## §9 Case-study methodology

(filled in by Phase 10 — the 5-element pattern + GPT-5.5 note + sibling-review cross-refs)

## §10 PEP case study

(filled in by Phase 11 — `macton/pep-copt` deep-dive: 2.04× speedup, byte-identical output)

## §11 Collisions case study

(filled in by Phase 12 — `macton/differentiable-collisions-optc` deep-dive: 102× speedup, distance-tolerance match contract)

## §12 Decisions

Pointer to `decisions.md` (filled in by Phase 13). The full candidate list: v2.3's 16 + v3's new ~10-14, with v2.3 → v3 status mapping (PROMOTE / SUPERSEDE / STILL-OPEN / WITHDRAW) at the top of `decisions.md`.

## §13 Cross-references

Pointer to `nagent_takeaways_v3_20260619.md` for the bridge to v2.3 takeaways + the sibling reviews:
- `fable_review_20260617` — Fable's analysis of Mythos system prompt (touchpoint: §8 Operating rules)
- `intent_dsl_survey_20260612` — the 10 prior-art clusters (touchpoint: §9 Case-study methodology)
- `superpowers_review_20260619` — the superpowers plugin review (touchpoint: §9 Case-study methodology, process parallel via the `brainstorming` skill)

## §14 References

(filled in incrementally as clusters commit — see `state.toml` `[v3_tasks]` for per-phase commit SHAs)