Thank you for your interest in contributing to Agent-Driven Development.
ADD is an open methodology. It improves through real-world usage, honest feedback, and shared experience.
If something in the methodology doesn't work in practice, open an issue. Include:
- What you tried (which artifact, which phase).
- What happened (unexpected result, confusion, friction).
- What you expected.
- Your context (solo dev, team, enterprise; which agent tools you use).
For changes to the methodology (cycle, artifacts, rules, maturity model):
- Open a Discussion first. Explain the problem and your proposed solution.
- If there's consensus, submit a PR with the changes.
- Changes to the Manifesto or Non-Negotiable Rules require broader discussion.
Real-world examples are extremely valuable. To contribute an example:
- Follow the format in
/examples/01-simple-feature/. - Include all artifacts from the cycle.
- Be honest about failures — examples with Failure Reviews are more valuable than perfect first-pass examples.
If you've evolved a template for your domain, share it:
- Submit it as a PR to
/templates/. - Include a brief explanation of what you changed and why.
- Domain-specific templates go in
/templates/domains/(create the directory if needed).
Translations are organized in /docs/{language-code}/. To add a translation:
- Copy the
/docs/en/directory to/docs/{your-language}/. - Translate all files.
- Keep the same file structure and names.
- Be specific. "This doesn't work" is not actionable. "AC-3 in the Constraint Sheet template is confusing because..." is.
- Be honest. If ADD added overhead without value in your case, say so. That's useful data.
- Be constructive. Propose alternatives, not just criticism.
- Respect the core. The Manifesto and Five Nevers are foundational. Propose changes to them only with strong evidence from practice.
Be professional, be respectful, be helpful. This is an engineering community.
All contributions are under the MIT license.