idea182-implementation/AGENTS.md

GravityWeave - Agent Guidelines and Architecture

Architecture

• Language: Python 3.8+
• Minimal package: gravityweave
• Core modules: registry, plan_delta (CRDT), ledger, adapters, solver
• Additional coordination modules: delta_synopsis, dtn, mission simulator

Tech stack

• Standard library (hashlib, hmac, json, time)
• pytest for tests

Testing and CI

• Run tests and build with bash test.sh.
• test.sh builds the package (python3 -m build) and runs pytest -q.

Contribution rules

• Small incremental changes preferred.
• Follow existing patterns; keep public API names stable.
• Add unit tests for any new behavior.

Packaging

• pyproject.toml defines build metadata and is required for packaging.