egm-bootstrap

1# EGM Peanuts and Hay Bootstrap (`egm-bootstrap`)
2 
3When running in Codex or ChatGPT Work, first read [Codex integration](../../docs/codex.md).
4In Claude Code or Cowork, read `${CLAUDE_PLUGIN_ROOT}/docs/claude.md` first.
5 
6## Overview
7 
8This skill automates the creation, correction, formatting, and correctness
9verification of Elephant-and-Goldfish Model (EGM) compliant `README.md` files
10across a directory tree. It establishes clear architectural contracts
11(interfaces, invariants, and side effects) for both human developers and AI
12assistants.
13 
14*   **Peanuts**: Leaf-level Component Package READMEs containing specific file
15    contracts.
16*   **Hay**: Parent-level Repository Blueprints that roll up child interface
17    contracts into high-altitude indexes.
18 
19## Delegation
20 
21A Goldfish runs in a fresh context with no conversation history. Spawn each
22subagent with your harness's subagent tool (Antigravity: `invoke_subagent`; Claude Code: `Agent`; Codex: `spawn_agent`). Each subagent is defined in `agents/<file>.md`, and its
23frontmatter `name` (for example `egm-zoom-out`) is the subagent type to request
24where your harness registers named subagents. Otherwise spawn a general-purpose
25subagent and tell it to read that persona file first. Pass the prompt verbatim
26and wait for the report. If your harness cannot nest subagents,
27use direct dispatch instead of the synthesizer. See `docs/harnesses.md`.
28If your harness has no subagent tool, run the scout steps inline.
29 
30## Inputs
31…