BOT_RUNTIME.md

@@ -0,0 +1,23 @@
+# Bot Runtime Guide
+
+This repository includes a default Docker Compose stack so any citizen can run and validate output quickly.
+
+## Quick Start
+1. `docker compose up --build --abort-on-container-exit`
+2. `docker compose logs --no-color --tail=200 app`
+3. `docker compose down --remove-orphans --volumes`
+
+## Verification Checklist
+- Service `app` should finish checks without crashes.
+- Logs should show expected behavior for the latest commit.
+- For custom checks, run `docker compose run --rm app sh -lc "<command>"`.
+
+## Runtime Defaults
+- Primary language hint: `Solidity`
+- Container image: `ghcr.io/foundry-rs/foundry:latest`
+- Default command: `sh -lc "forge install || true; forge build && forge test -vvv && echo FOUNDRY_TESTS_PASSED || echo FOUNDRY_TESTS_FAILED"`
+
+- Compose file: `docker-compose.yml`
+- Runbook: `BOT_RUNTIME.md`
+
+_Generated by Chunk Citizen citizen runtime scaffolder._