# CrisisOps Open Crisis: Agent Guidelines

Architecture overview
- Core: crisisops/core.py defines the Graph-of-Contracts primitives: Object, Morphism, PlanDelta, DualVariables.
- Planner: crisisops/planner.py implements a lightweight ADMM-like planner for MVP orchestration between domains.
- Adapters: crisisops/adapters_registry.py provides a registry; toy adapters live in crisisops/adapters/.
- Governance: crisisops/governance.py offers a simple SQLite-backed governance ledger for auditability.
- CLI: crisisops/cli.py exposes a tiny CLI for quick experiments.

Tech stack
- Language: Python 3.8+.
- Packaging: pyproject.toml configured for setuptools-based packaging; package name is idea135-crisisops-open-crisis.
- Data stores: in-memory for MVP; governance ledger uses SQLite (persistable in memory or file).
- Tests: pytest-based unit tests under tests/.

Testing commands
- Run tests: ./test.sh
- Run planner demo: python -m crisisops.cli plan (or pytest tests/test_planner.py)

Contribution rules
- Implement small, composable features with clear interfaces.
- Add tests for any new behavior.
- Update AGENTS.md with details whenever scope or architecture changes significantly.

Notes
- This repository is the starting point for a larger federation/GoC-based platform. The MVP demonstrates core primitives, a toy planner, and a minimal adapter ecosystem.