16 lines
1.0 KiB
Markdown
16 lines
1.0 KiB
Markdown
# 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.
|