greprag 5.65.2 → 5.65.3

package/skill/templates/codex-chip-spawn.md

@@ -6,12 +6,13 @@ authority.
 
 ## Identity first
 
-For any coordinated multi-chip mission, rename the orchestrating task before
-spawning children:
+Choose the mission shape before naming the current task:
 
-```text
-LEAD: <Mission>
-```
+- **Quick mode:** rename the current task `LEAD: <Mission>` before spawning
+  1–2 children. No separate leader task exists.
+- **Leader mode:** rename the current initiating task `PLANNER: <Mission>`
+  before creating a separate `LEAD: <Mission>` task. Once a separate LEAD
+  exists, the PLANNER never presents itself as the LEAD.
 
 Then name children with the exact ordinal schema:
 
@@ -21,10 +22,15 @@ Chip B: <Specific Purview>
 Chip C: <Specific Purview>
 ```
 
-In quick mode, the current task renames itself `LEAD: <Mission>` and directly
-spawns 1–2 children. It is the **implicit LEAD**; no separate leader task is
-created. In Leader mode, the initiator creates a separate `LEAD: <Mission>`
-task, and that LEAD spawns and manages the children.
+The identity transition happens before the first child creation. In Leader
+mode the `PLANNER:` task creates only the dedicated `LEAD:` first; that LEAD
+then spawns and manages `Chip A/B/C`.
+
+<!-- adr: adr/codex-lead-native-goal.md -->
+A dedicated `LEAD: <Mission>` task must create a native top-level mission goal
+with `create_goal`, then run `get_goal` and verify the active goal names the
+mission before any child fanout. This is Codex-native mission tracking, not a
+GrepRAG durable manifest, lease, or permission gate.
 
 ## Three primitives
 
@@ -52,12 +58,12 @@ dispatch `Chip A` and `Chip B` directly.
 - Children are writable ordinary chips. Do not add a read-only role, lease,
   mandatory nested goal, or delivery-proof gate.
 - Role models come from the Codex model policy slots: `chip.worker`,
-  `chip.leader`, `chip.advisor`, and `chip.mechanic`. Inspect the active policy
-  with `greprag codex models show`; override a single child only with explicit
-  `--model` / `--effort` flags when needed.
+  `chip.leader`, `chip.planner`, `chip.advisor`, and `chip.fix`. Inspect the
+  active policy with `greprag codex models show`; override a single child only
+  with explicit `--model` / `--effort` flags when needed.
 - Select the role slot from the first-line title before dispatch:
-  `Chip A/B/C` -> `chip.worker`, `LEAD` -> `chip.leader`, `ADVISOR` ->
-  `chip.advisor`, and `MECHANIC` -> `chip.mechanic`. ABOUT TO call
+  `Chip A/B/C` -> `chip.worker`, `LEAD` -> `chip.leader`, `PLANNER` ->
+  `chip.planner`, `ADVISOR` -> `chip.advisor`, and `FIX` -> `chip.fix`. ABOUT TO call
   `codex_app__create_thread`? STOP - pass that slot as top-level `model` and
   `thinking`; never rely on Codex Desktop defaults for a visible chip.
 - An `ADVISOR: <Purview>` child is a lead-facing consultant. It reports
@@ -76,11 +82,16 @@ dispatch `Chip A` and `Chip B` directly.
 
 Use this when the work is more than the quick 1–2-chip shape, or when shared
 files, contracts, ordering, integration, or a seam require a dedicated
-orchestrator. The initiator creates the separate `LEAD: <Mission>` task first.
-That LEAD decomposes the mission, assigns exact `Chip A/B/C: <Specific Purview>`
+orchestrator. The initiator renames itself `PLANNER: <Mission>`, then creates
+the separate `LEAD: <Mission>` task first. That LEAD decomposes the mission,
+assigns exact `Chip A/B/C: <Specific Purview>`
 titles, dispatches ordinary writable chips, reconciles their reports, and owns
 integration checks and cleanup.
 
+Before dispatching any child, the LEAD creates and verifies its native
+top-level mission goal (`create_goal` -> `get_goal`). Child fanout starts only
+after that verified goal exists.
+
 Load `greprag load chip-leader` for the mission worksheet before dispatch.
 
 ## Codex Desktop dispatch route
@@ -146,10 +157,9 @@ dedicated `LEAD: <Mission>` task.
 ## FIX missions — the one landing exception
 
 Landing authority follows the MISSION SHAPE, not the harness
-(adr/codex-landing-doctrine.md). Every chip shape above (`Chip A/B/C`, `LEAD`,
-`ADVISOR`, `MECHANIC`) keeps the parent-owned landing: commit, native reply
-with archive clearance, and the parent reviews, integrates, archives, and
-cleans up.
+(adr/codex-landing-doctrine.md). Every non-FIX chip shape above (`Chip A/B/C`,
+`LEAD`, `PLANNER`, `ADVISOR`) keeps the parent-owned landing: commit, native reply with
+archive clearance, and the parent reviews, integrates, archives, and cleans up.
 
 A mission whose first line begins `FIX:` — emitted by `greprag fix spawn`
 (grepragOS law 4) — is the ONE exception: it carries its own Phase 3
@@ -189,9 +199,13 @@ Chip <Label>: <Specific Purview>
 ## Setup — do this FIRST
 Stay in the Codex-provided isolated worktree; do not create a second worktree.
 Read AGENTS.md and the session-start recap, then inspect the current repo state.
-No leases, read-only mode, or goals.
-If the exact first-line title is `MECHANIC: <Mission>`, make `greprag load
-mechanic` the first Setup action before diagnosis or edits.
+If the exact first-line title is `LEAD: <Mission>`, create a native top-level
+mission goal with `create_goal`, then run `get_goal` and verify the active goal
+names this mission before any child fanout.
+No leases, read-only mode, or GrepRAG goal gates.
+If the exact first-line title is `FIX: <one friction unit>`, make `greprag
+load mechanic` the first Setup action before diagnosis or edits; mechanic is
+the doctrine, not the visible task identity.
 If the exact first-line title is `ADVISOR: <Purview>`, report consultation to
 the LEAD only: strategic findings, questions, tradeoffs, and recommendations.
 Do not write operator-facing completion language or decide/spawn worker chips.
@@ -217,5 +231,6 @@ and cleans up.
 
 The first line is the exact visible title, alone. Substitute the appropriate
 discoverability label: `Chip A: <Specific Purview>`, `LEAD: <Mission>`,
-`ADVISOR: <Purview>`, or `MECHANIC: <Mission>`. These labels do not change
-execution authority.
+`PLANNER: <Mission>`, `ADVISOR: <Purview>`, or `FIX: <one friction unit>`. These labels do not change
+execution authority, except that FIX carries the one-friction Phase 3 contract
+printed by `greprag fix spawn`.