# Synkra AIOX Community

> 🇧🇷 [Versão em Português](COMMUNITY-PT.md)

Welcome to the Synkra AIOX community!

We're building the future of AI-orchestrated development together.

## Our Values

- **Collaboration over competition** - We grow together
- **Inclusion** - Everyone is welcome regardless of experience level
- **Transparency** - Open discussions, open decisions
- **Quality** - We care about doing things right

## Getting Started

### First Steps

1. Star the repository
2. Read the [README](README.md)
3. Set up your [development environment](CONTRIBUTING.md#getting-started)
4. Introduce yourself in [Discussions](https://github.com/SynkraAI/aiox-core/discussions)

### Find Your First Contribution

- Look for issues labeled [`good-first-issue`](https://github.com/SynkraAI/aiox-core/labels/good-first-issue)
- Check [`help-wanted`](https://github.com/SynkraAI/aiox-core/labels/help-wanted) for more complex tasks
- Browse [open Discussions](https://github.com/SynkraAI/aiox-core/discussions) to help others

## Communication Channels

### GitHub Discussions (Primary)

Our main communication hub for all AIOX repositories:

- **Announcements** - Project updates from maintainers
- **General** - General discussions about AIOX
- **Ideas** - Propose new features and improvements
- **Q&A** - Get help with technical questions
- **Show and Tell** - Share your projects using AIOX
- **Troubleshooting** - Get help with problems
- **Squads** - Discussions about AIOX Squads (modular agent teams)
- **MCP Ecosystem** - Discussions about MCP tools and integrations

[Join the Discussion](https://github.com/SynkraAI/aiox-core/discussions)

### Issue Tracker

For bug reports and feature requests:

- [aiox-core Issues](https://github.com/SynkraAI/aiox-core/issues) - Core framework
- [aiox-squads Issues](https://github.com/SynkraAI/aiox-squads/issues) - AIOX Squads
- [mcp-ecosystem Issues](https://github.com/SynkraAI/mcp-ecosystem/issues) - MCP tools

## How to Contribute

### Code Contributions

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Run tests (`npm test`)
5. Submit a Pull Request

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.

### Non-Code Contributions

We value all types of contributions:

- **Documentation** - Fix typos, improve explanations
- **Translation** - Help translate docs
- **Bug Reports** - Report issues you find
- **Ideas** - Share your thoughts on improvements
- **Design** - UI/UX suggestions
- **Advocacy** - Blog posts, talks, tutorials

### Squads

Create and share your own Squads (modular AI agent teams)!

Squads are specialized teams of AI agents that work together on specific domains:
- **ETL Squad** - Data collection and transformation
- **Creator Squad** - Content generation

See [docs/Squads.md](docs/Squads.md) for details on creating your own Squad.

## Community Roles

### Contributors

Anyone who has contributed to AIOX in any way.
- Listed in our [Contributors page](https://github.com/SynkraAI/aiox-core/graphs/contributors)
- Mentioned in release notes for significant contributions

### Maintainers

Core team members who review PRs and guide the project:

- [@SynkraAI](https://github.com/SynkraAI) - Project Lead

### Becoming a Maintainer

Active contributors may be invited to become maintainers. We look for:
- Consistent quality contributions
- Helpful community interactions
- Understanding of project goals

## Recognition

### Contributors Wall

All contributors are recognized in our [Contributors page](https://github.com/SynkraAI/aiox-core/graphs/contributors).

### Release Credits

Significant contributions are credited in release notes.

## Governance

### Decision Making

- **Minor decisions**: Maintainers can decide
- **Major decisions**: Discussed in GitHub Discussions
- **Breaking changes**: Require RFC process

### RFC Process

For significant changes:

1. Open a Discussion with `[RFC]` prefix
2. Community provides feedback
3. Maintainers make final decision
4. Decision is documented

### Code of Conduct

We follow the [Contributor Covenant](CODE_OF_CONDUCT.md). Please read and respect it.

Report violations to: conduct@SynkraAI.com

## Getting Help

### Stuck on something?

1. Check the [Documentation](docs/)
2. Search [existing Discussions](https://github.com/SynkraAI/aiox-core/discussions)
3. Ask in Q&A Discussions
4. Open a Troubleshooting discussion

### Found a bug?

1. Search [existing issues](https://github.com/SynkraAI/aiox-core/issues)
2. If new, [open a bug report](https://github.com/SynkraAI/aiox-core/issues/new?template=bug_report.md)

### Have an idea?

1. Check if it exists in [Ideas](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas)
2. If new, [share your idea](https://github.com/SynkraAI/aiox-core/discussions/new?category=ideas)
3. Read our [Feature Request Process](docs/FEATURE_PROCESS.md) for detailed guidelines

## Project Roadmap

Want to know where AIOX is headed? Check out our public roadmap:

- [ROADMAP.md](ROADMAP.md) - High-level vision and planned features
- [GitHub Project](https://github.com/orgs/SynkraAI/projects/1) - Detailed tracking board

The roadmap is updated monthly and reflects community input. You can influence our direction by:

1. **Voting** on ideas in [Discussions](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas)
2. **Proposing** new features via the [RFC process](/.github/RFC_TEMPLATE.md)
3. **Contributing** directly to planned features

> Roadmap items are plans, not commitments. Priorities may shift based on community needs and technical constraints.

### Feature Request Process

We have a structured process for proposing new features:

1. **Quick Ideas** - Open a Discussion in the "Ideas" category
2. **RFC Process** - For significant features, write an RFC using our [template](/.github/RFC_TEMPLATE.md)
3. **Community Voting** - Use :+1: reactions to show support
4. **Implementation** - Approved ideas move to our backlog

See [Feature Request Process](docs/FEATURE_PROCESS.md) for complete details.

## Resources

### Learning AIOX

- [Getting Started Guide](docs/getting-started.md)
- [Architecture Overview](docs/architecture.md)
- [User Guide](.aiox-core/user-guide.md)

### External Resources

- [AIOX GitHub Organization](https://github.com/SynkraAI)
- [Changelog](CHANGELOG.md)

## Internationalization

We welcome contributions in all languages!

- Documentation is primarily in English
- Community discussions can be in any language
- Portuguese (PT-BR) translations are appreciated

## Project Status

- Current Version: See [releases](https://github.com/SynkraAI/aiox-core/releases)
- Changelog: [CHANGELOG.md](CHANGELOG.md)

---

## Questions?

Can't find what you're looking for?
Open a Discussion or reach out to the community!

**Thank you for being part of the AIOX community!**

---

*This document is maintained by the AIOX community.*
*Last updated: 2025-12-09*