# CrisisGuard - Agents & Architecture

- Architecture: modular Python package under crisisguard/ with a minimal Graph-of-Contracts, LocalPlan/SharedSignals/PlanDelta models, and two starter adapters. A governance log anchors actions via cryptographic hashes.
- Tech stack: Python 3.8+, dataclasses, JSON, hashing, and a tiny in-memory registry. Adapters are plain Python modules intended to be swapped with real implementations.
- Testing: pytest-based tests validating contract registry and delta application. test.sh runs pytest after optional build to verify packaging works.
- Commands you should know:
- Build: python -m build
- Test: bash test.sh
- Run quick checks: rg 'LocalPlan|PlanDelta' -n crisisguard -S
- Run adapters locally: python -m crisisguard.toy_scenario.disaster_scenario

- Rules:
- Do not rely on network services for the core tests. The toy scenario runs in-memory.
- Keep changes minimal and well-documented. Follow the small-change principle.
- If you introduce new components, add tests and update AGENTS.md accordingly.