# README Bootstrap

Creates directory README files across a repository subtree.

- Repository: https://github.com/google/elephant-goldfish-model (8873 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/elephant-goldfish-model --skill egm-bootstrap -g -a claude-code -y`
Codex: `npx skills add google/elephant-goldfish-model --skill egm-bootstrap -g -a codex -y`
Cursor: `npx skills add google/elephant-goldfish-model --skill egm-bootstrap -g -a cursor -y`
Gemini CLI: `npx skills add google/elephant-goldfish-model --skill egm-bootstrap -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add google/elephant-goldfish-model`

## Description

Bootstrap directory README.md files across a repository subtree.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# EGM Peanuts and Hay Bootstrap (`egm-bootstrap`)

When running in Codex or ChatGPT Work, first read [Codex integration](../../docs/codex.md).
In Claude Code or Cowork, read `${CLAUDE_PLUGIN_ROOT}/docs/claude.md` first.

## Overview

This skill automates the creation, correction, formatting, and correctness
verification of Elephant-and-Goldfish Model (EGM) compliant `README.md` files
across a directory tree. It establishes clear architectural contracts
(interfaces, invariants, and side effects) for both human developers and AI
assistants.

*   **Peanuts**: Leaf-level Component Package READMEs containing specific file
    contracts.
*   **Hay**: Parent-level Repository Blueprints that roll up child interface
    contracts into high-altitude indexes.

## Delegation

A Goldfish runs in a fresh context with no conversation history. Spawn each
subagent 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
frontmatter `name` (for example `egm-zoom-out`) is the subagent type to request
where your harness registers named subagents. Otherwise spawn a general-purpose
subagent and tell it to read that persona file first. Pass the prompt verbatim
and wait for the report. If your harness cannot nest subagents,
use direct dispatch instead of the synthesizer. See `docs/harnesses.md`.
If your harness has no subagent tool, run the scout steps inline.

## Inputs

The rest: https://github.com/google/elephant-goldfish-model/blob/HEAD/distributions/claude/skills/egm-bootstrap/SKILL.md