# 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[​](#ways-to-contribute "Direct link to Ways to Contribute")

### Specification Feedback[​](#specification-feedback "Direct link to Specification Feedback")

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

### Examples[​](#examples "Direct link to Examples")

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

### Profiles[​](#profiles "Direct link to Profiles")

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

### Implementations[​](#implementations "Direct link to Implementations")

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

## Contribution Process[​](#contribution-process "Direct link to Contribution Process")

### 1. Open an Issue[​](#1-open-an-issue "Direct link to 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[​](#2-fork-and-branch "Direct link to 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[​](#3-make-changes "Direct link to 3. Make Changes")

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

### 4. Commit with Conventional Commits[​](#4-commit-with-conventional-commits "Direct link to 4. Commit with Conventional Commits")

Use [Conventional Commits](https://www.conventionalcommits.org/) 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[​](#5-submit-pull-request "Direct link to 5. Submit Pull Request")

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

## Code of Conduct[​](#code-of-conduct "Direct link to Code of Conduct")

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

## License[​](#license "Direct link to License")

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

## Questions?[​](#questions "Direct link to Questions?")

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