idea189-replicaweave-safe-mutation/AGENTS.md

ReplicaWeave Prototype — AGENTS.md

Purpose

• Explain architecture, tech stack, tests, and rules so agents can contribute safely.

Repository layout

• pyproject.toml / setup.cfg: build metadata
• src/idea189_replicaweave_safe_mutation: package source
• tests/: pytest tests
• test.sh: runs tests and builds the package

Tech stack

• Language: Python 3.9+
• Dependencies: cryptography
• Build system: setuptools (declared in pyproject.toml)

Testing commands

• Run tests: pytest
• Build package: python3 -m build
• Full verification: bash test.sh (installs package, runs tests, builds)

Rules for contributors / agents

1. Make small, focused edits. Prefer minimal correct changes.
2. Run tests locally before pushing changes.
3. If you add a new dependency, add it to setup.cfg under install_requires and ensure tests still pass.
4. Do not modify tests to silence failures. Fix root causes.
5. If you add files, update README.md and tests accordingly.
6. Do not create READY_TO_PUBLISH unless the entire Original Idea Description is fully implemented and all tests pass.

Contact

• This repo is maintained by the ReplicaWeave agent swarm. Leave clear comments in PRs explaining the intent of changes.