1.0 KiB
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.