Skip to main content

Contributing

Thank you for your interest in contributing to the Agent Definition Language (ADL) specification!

:::tip Ways to Get Involved

  • Report issues or suggest improvements
  • Submit example ADL documents
  • Contribute to profile specifications
  • Build tools and implementations :::

Ways to Contribute​

Specification Feedback​

  • Open issues for clarification requests
  • Propose changes via pull requests
  • Participate in discussions

Examples​

  • Submit new example ADL documents
  • Improve existing examples with better documentation
  • Add examples for specific use cases

Profiles​

  • Propose new domain-specific profiles
  • Contribute to existing profile specifications
  • Provide feedback on profile requirements

Implementations​

  • Build tools that consume or produce ADL
  • Create validators, linters, or converters
  • Develop integrations with existing platforms

Contribution Process​

1. Open an Issue​

Before making significant changes, open an issue to discuss:

  • The problem you're solving
  • Your proposed approach
  • Any questions or concerns

2. Fork and Branch​

git clone https://github.com/agent-definition-language/specification.git
cd specification
git checkout -b feature/your-feature-name

3. Make Changes​

  • Follow existing code style and conventions
  • Update documentation as needed
  • Add tests if applicable

4. Commit with Conventional Commits​

Use Conventional Commits format:

feat(spec): add support for conditional permissions
fix(examples): correct JSON syntax in production example
docs(profiles): clarify governance profile requirements

Types:

  • feat: New feature
  • fix: Bug fix
  • docs: Documentation changes
  • refactor: Code refactoring
  • test: Test additions/updates
  • chore: Maintenance tasks

5. Submit Pull Request​

  • Reference related issues
  • Describe your changes clearly
  • Be responsive to review feedback

Code of Conduct​

This project follows a code of conduct. By participating, you agree to uphold respectful and inclusive behavior.

License​

Contributions are licensed under Apache 2.0, consistent with the project license.

Questions?​

Open an issue or start a discussion. We're happy to help!