Contributing
DaoFlow is open source and welcomes contributions. This section covers how to set up your development environment, understand the architecture, write tests, and follow code conventions.
Getting Started
- Fork the repository on GitHub
- Clone your fork
- Follow the Development Setup guide
- Create a feature branch
- Make your changes with tests
- Submit a pull request
Guides
| Guide | Description |
|---|---|
| Development Setup | Local environment setup |
| Architecture Guide | How the codebase is organized |
| Testing | Writing and running tests |
| Code Style | Conventions and formatting |
Contribution Principles
From the AGENTS.md:
- Prefer smaller trusted primitives over large magical abstractions
- Prefer durable records over ephemeral process state
- Prefer explicit permissions over convenience shortcuts
- Prefer structured events over parsing raw log strings later
- Prefer one excellent deployment path over many weak ones
Decision Rule
If a feature increases system complexity, it must clearly improve at least one of:
- Deployment reliability
- Operator clarity
- Backup safety
- Agent safety
- Auditability
If it does not, defer it.