# Contributing to dir_spec
Thank you for your interest in contributing to dir_spec! Whether you're fixing a bug, adding a feature, improving
documentation, or just asking questions -- all contributions are welcome.
## Before You Start
Please read and agree to the following before contributing:
- **[Code of Conduct][coc]** -- how we treat each other
- **[AI Use Policy][ai-policy]** -- expectations around AI-assisted contributions
By submitting a contribution you acknowledge that you have read and agree to these policies and practices.
## Getting Oriented
| [Security Policy][security] | Reporting vulnerabilities responsibly |
| [Code Style Guide][style] | Formatting rules and code organization conventions |
| [Tasks][tasks] | Running builds, tests, formatting, and linting with mise |
| [Testing][testing] | How to write and organize tests |
| [Commits][commits] | Conventional commit format and scoping rules |
## Ways to Contribute
- **Report a bug** -- [open an issue][new-issue] with steps to reproduce
- **Suggest a feature** -- start a discussion or issue describing the problem you'd like solved
- **Fix a bug or implement a feature** -- check the issue tracker for open items, or bring your own idea
- **Improve documentation** -- typos, missing context, better examples -- it all helps
- **Write or improve tests** -- more coverage makes the project more reliable for everyone
- **Review pull requests** -- thoughtful review is just as valuable as writing code
- **Report a security vulnerability** -- follow the [Security Policy][security] instead of filing a public issue
## Questions?
If something is unclear, open a discussion or issue -- we're happy to help.
[ai-policy]: https://github.com/aaronmallen/dir_spec/blob/main/docs/policy/ai.md
[coc]: https://github.com/aaronmallen/dir_spec/blob/main/docs/policy/code-of-conduct.md
[commits]: https://github.com/aaronmallen/dir_spec/blob/main/docs/dev/commits.md
[new-issue]: https://github.com/aaronmallen/dir_spec/issues/new
[security]: https://github.com/aaronmallen/dir_spec/blob/main/docs/policy/security.md
[style]: https://github.com/aaronmallen/dir_spec/blob/main/docs/dev/code-style.md
[tasks]: https://github.com/aaronmallen/dir_spec/blob/main/docs/dev/tasks.md
[testing]: https://github.com/aaronmallen/dir_spec/blob/main/docs/dev/testing.md