This folder keeps durable reference material only. Temporary plans and handoff notes should live outside the repo or be deleted after the implementation lands.
DESIGN.md— architecture, runtime modes, local tooling, and adapter boundaries.FOUNDRY_PARITY.md— explicit behavior contract for the Foundry surfaces emulated locally.DIAGRAMS.md— Mermaid diagrams for dataset, stream, keepalive, and local-emulated flows.
RELEASE.md— Foundry configuration, Sources/egress, environment variables, probes, and publish workflow notes.TROUBLESHOOTING.md— common deployment/local harness failures and how to diagnose them.
devx/foundry-cmgo-cli-output-captures.md— normalized terminal captures from fresh generated dataset and stream starters.
use-cases/milwaukee-resolution.md— deterministic catalog-resolution dogfood case against real Milwaukee retailer parquet data.
screenshots/— Foundry UI screenshots referenced from the root README and release/troubleshooting docs as needed.