diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 689968c..265ad5a 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -67,6 +67,25 @@ Sentiment calculation: `sentiment = f(averageTaxRate, percentageStaked)`
 - Holder value comes from asymmetric slippage (structural ETH accumulation), NOT from fee reinvestment
 - Low sentiment (bear) → tight around floor, maximum protection
 
+## Push3 Seed Pool
+
+The evolutionary optimizer runs from `tools/push3-evolution/`. Active seeds are tracked in `tools/push3-evolution/seeds/manifest.jsonl` — one JSON object per line (JSONL format).
+
+### `manifest.jsonl` field reference
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `file` | string | ✓ | Filename relative to `seeds/` (e.g. `optimizer_v3.push3`) |
+| `origin` | `"hand-written"` \| `"evolved"` \| `"llm"` | ✓ | How the seed was produced |
+| `date` | string (`YYYY-MM-DD`) | ✓ | ISO 8601 date the entry was added to the manifest |
+| `fitness` | integer \| null | — | Raw fitness score (wei-scale integer). `null` when the seed has not yet been evaluated or the score has been invalidated |
+| `fitness_flags` | string \| null | — | Comma-separated flags that qualify or invalidate the fitness value (e.g. `token_value_inflation,processExecIf_fix`). `null` when no flags apply |
+| `run` | string \| null | — | Zero-padded run identifier from which the seed was admitted (e.g. `"007"`). `null` for `hand-written` and `llm` seeds |
+| `generation` | integer \| null | — | Generation index within the run at which this candidate was produced. `null` for `hand-written` and `llm` seeds |
+| `note` | string \| null | — | Human-readable description of the seed strategy or noteworthy behaviour |
+
+The full machine-readable definition is in `tools/push3-evolution/seeds/manifest.schema.json` (JSON Schema draft 2020-12). `additionalProperties` is `false` — unknown fields are rejected. Only `file`, `origin`, and `date` are required; all other fields are optional but must match the types above when present.
+
 ## Stack
 
 ### On-chain