Synkra AIOX Community

🇧🇷 Versão em Português

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

Star the repository
Read the README
Set up your development environment
Introduce yourself in Discussions

Find Your First Contribution

Look for issues labeled good-first-issue
Check help-wanted for more complex tasks
Browse open 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

Issue Tracker

For bug reports and feature requests:

aiox-core Issues - Core framework
aiox-squads Issues - AIOX Squads
mcp-ecosystem Issues - MCP tools

How to Contribute

Code Contributions

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Make your changes
Run tests (npm test)
Submit a Pull Request

See 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 for details on creating your own Squad.

Community Roles

Contributors

Anyone who has contributed to AIOX in any way.

Listed in our Contributors page
Mentioned in release notes for significant contributions

Maintainers

Core team members who review PRs and guide the project:

@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.

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:

Open a Discussion with [RFC] prefix
Community provides feedback
Maintainers make final decision
Decision is documented

Code of Conduct

We follow the Contributor Covenant. Please read and respect it.

Report violations to: conduct@SynkraAI.com

Getting Help

Stuck on something?

Check the Documentation
Search existing Discussions
Ask in Q&A Discussions
Open a Troubleshooting discussion

Found a bug?

Search existing issues
If new, open a bug report

Have an idea?

Check if it exists in Ideas
If new, share your idea
Read our Feature Request Process for detailed guidelines

Project Roadmap

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

ROADMAP.md - High-level vision and planned features
GitHub Project - Detailed tracking board

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

Voting on ideas in Discussions
Proposing new features via the RFC process
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:

Quick Ideas - Open a Discussion in the "Ideas" category
RFC Process - For significant features, write an RFC using our template
Community Voting - Use :+1: reactions to show support
Implementation - Approved ideas move to our backlog

See Feature Request Process for complete details.

Resources

Learning AIOX

External Resources

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
Changelog: 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