diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index f42c302..506289b 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -126,6 +126,10 @@ harb/
 ├── kraiken-lib/       # Shared TypeScript helpers (bigint math, ABIs, encoding) for frontend and indexer
 │   └── src/           # abis, format, ids, position, snatch, staking, subgraph, taxRates, version
 ├── containers/        # Docker configs, entrypoints
+├── tools/             # Developer utilities
+│   ├── push3-transpiler/  # Compiles Push3 programs to Solidity Optimizer
+│   ├── push3-evolution/   # Evolutionary optimizer: fitness, mutation, seed generation
+│   └── deploy-optimizer.sh  # Script to deploy a new Optimizer version
 ├── docs/              # This file, PRODUCT-TRUTH.md
 └── .woodpecker/       # CI pipeline configs
 ```