Contributing

Thank you for your interest in contributing to AI Mantras. This framework is built collaboratively with AI and human contributors working together. Your contributions help expand the cognitive toolkit available for AI collaboration.

Quick Links

Creating Personas Step-by-step guide to adding new domain experts, orchestrators, or evaluators.

Creating Patterns How to add new reasoning structures and thinking templates.

Creating Skills How to add actionable capabilities for personas.

Extending MCP Server Technical guide for MCP modifications and enhancements.

Getting Started

Read the philosophy - Understand how we build AI Mantras with AI
Review existing components - Study 2-3 examples in the category you want to contribute to
Choose your contribution - See “What We’re Looking For” below
Follow the guide - Use the appropriate developer documentation

Branch Naming

Create a branch for your contribution:

git checkout -b <type>/<description>

Type	When to Use	Example
`feature/`	New personas, patterns, or skills	`feature/new-persona-judge`
`fix/`	Bug fixes or corrections	`fix/clara-typo`
`docs/`	Documentation improvements	`docs/improve-readme`
`refactor/`	Code restructuring	`refactor/mcp-tools`

What We’re Looking For

High Priority

New personas - Domain experts, orchestrators, or evaluators that fill gaps
New patterns - Reasoning structures that complement existing ones
New skills - Capabilities that expand what personas can do
MCP improvements - Tools, resources, or performance enhancements

Always Welcome

Bug fixes - Corrections to existing content
Documentation - Clarity and completeness improvements
Examples - Real-world usage examples
Testing - Validation scenarios and test coverage

Pull Request Process

Create your branch using the naming convention above
Make your changes following the appropriate guide
Update related files (manifest, indexes, etc.)
Test your changes
Push and create PR with a clear description

PR Description Template

## Summary
[Brief description of what this PR adds/changes]

## Type
- [ ] New persona
- [ ] New pattern
- [ ] New skill
- [ ] MCP enhancement
- [ ] Bug fix
- [ ] Documentation

## Checklist
- [ ] Followed the relevant creation guide
- [ ] Updated manifest (if applicable)
- [ ] Updated index files (if applicable)
- [ ] Tested changes
- [ ] All existing tests pass

## Related Issues
[Link any related issues]

Code of Conduct

We maintain a respectful, collaborative environment:

Be constructive - Feedback should help improve contributions
Be inclusive - Welcome contributors of all backgrounds
Be patient - Not everyone has the same context or experience
Be honest - If something doesn’t work, say so kindly

Questions?

GitHub Issues - For bugs, feature requests, or questions
Pull Request Comments - For contribution-specific discussions
Email - [email protected] for other inquiries

License

By contributing, you agree that your contributions will be licensed under the Mozilla Public License 2.0.