Flow Memory is intentionally modular. Contributions should preserve the cognitive-loop boundary between perception, memory, reasoning, action, evaluation, learning, and economic settlement.
- Fork the repository.
- Create a feature branch.
- Add tests for behavior changes.
- Run:
python -m unittest discover -s tests- Open a pull request with a concise description of the architecture impact.
- Keep high-risk execution behind typed permissions.
- Do not introduce hidden network calls into the core loop.
- Keep external systems behind adapters.
- Prefer deterministic tests for kernel components.
- Mark experimental neural, blockchain, or robotics integrations as optional extras.