# Comunidade Synkra AIOX

> 🇺🇸 [English Version](COMMUNITY.md)

Bem-vindo à comunidade Synkra AIOX!

Estamos construindo o futuro do desenvolvimento orquestrado por IA juntos.

## Nossos Valores

- **Colaboração sobre competição** - Crescemos juntos
- **Inclusão** - Todos são bem-vindos independentemente do nível de experiência
- **Transparência** - Discussões abertas, decisões abertas
- **Qualidade** - Nos importamos em fazer as coisas certas

## Começando

### Primeiros Passos

1. Dê uma estrela no repositório
2. Leia o [README](README.md)
3. Configure seu [ambiente de desenvolvimento](CONTRIBUTING-PT.md#começando)
4. Apresente-se nas [Discussões](https://github.com/SynkraAI/aiox-core/discussions)

### Encontre Sua Primeira Contribuição

- Procure issues marcadas com [`good-first-issue`](https://github.com/SynkraAI/aiox-core/labels/good-first-issue)
- Verifique [`help-wanted`](https://github.com/SynkraAI/aiox-core/labels/help-wanted) para tarefas mais complexas
- Navegue pelas [Discussões abertas](https://github.com/SynkraAI/aiox-core/discussions) para ajudar outros

## Canais de Comunicação

### GitHub Discussions (Principal)

Nosso hub principal de comunicação para todos os repositórios AIOX:

- **Anúncios** - Atualizações do projeto pelos mantenedores
- **Geral** - Discussões gerais sobre AIOX
- **Ideias** - Proponha novas funcionalidades e melhorias
- **Q&A** - Obtenha ajuda com questões técnicas
- **Mostre e Conte** - Compartilhe seus projetos usando AIOX
- **Troubleshooting** - Obtenha ajuda com problemas
- **Squads** - Discussões sobre Squads AIOX (equipes modulares de agentes)
- **Ecossistema MCP** - Discussões sobre ferramentas e integrações MCP

[Participe da Discussão](https://github.com/SynkraAI/aiox-core/discussions)

### Rastreador de Issues

Para relatórios de bugs e solicitações de funcionalidades:

- [Issues do aiox-core](https://github.com/SynkraAI/aiox-core/issues) - Framework principal
- [Issues do aiox-squads](https://github.com/SynkraAI/aiox-squads/issues) - Squads AIOX
- [Issues do mcp-ecosystem](https://github.com/SynkraAI/mcp-ecosystem/issues) - Ferramentas MCP

## Como Contribuir

### Contribuições de Código

1. Faça fork do repositório
2. Crie uma branch de feature (`git checkout -b feature/funcionalidade-incrivel`)
3. Faça suas alterações
4. Execute os testes (`npm test`)
5. Submeta um Pull Request

Veja [CONTRIBUTING-PT.md](CONTRIBUTING-PT.md) para diretrizes detalhadas.

### Contribuições Não-Código

Valorizamos todos os tipos de contribuições:

- **Documentação** - Corrija erros de digitação, melhore explicações
- **Tradução** - Ajude a traduzir docs
- **Relatórios de Bugs** - Reporte problemas que encontrar
- **Ideias** - Compartilhe suas ideias sobre melhorias
- **Design** - Sugestões de UI/UX
- **Divulgação** - Posts em blogs, palestras, tutoriais

### Squads

Crie e compartilhe seus próprios Squads (equipes modulares de agentes IA)!

Squads são equipes especializadas de agentes IA que trabalham juntos em domínios específicos:
- **Squad ETL** - Coleta e transformação de dados
- **Squad Creator** - Geração de conteúdo

Veja [docs/Squads.md](docs/Squads.md) para detalhes sobre como criar seu próprio Squad.

## Papéis na Comunidade

### Contribuidores

Qualquer pessoa que contribuiu para o AIOX de qualquer forma.
- Listados em nossa [página de Contribuidores](https://github.com/SynkraAI/aiox-core/graphs/contributors)
- Mencionados nas notas de release para contribuições significativas

### Mantenedores

Membros da equipe principal que revisam PRs e guiam o projeto:

- [@SynkraAI](https://github.com/SynkraAI) - Líder do Projeto

### Tornando-se um Mantenedor

Contribuidores ativos podem ser convidados a se tornarem mantenedores. Procuramos:
- Contribuições de qualidade consistentes
- Interações úteis com a comunidade
- Compreensão dos objetivos do projeto

## Reconhecimento

### Mural de Contribuidores

Todos os contribuidores são reconhecidos em nossa [página de Contribuidores](https://github.com/SynkraAI/aiox-core/graphs/contributors).

### Créditos em Releases

Contribuições significativas são creditadas nas notas de release.

## Governança

### Tomada de Decisão

- **Decisões menores**: Mantenedores podem decidir
- **Decisões maiores**: Discutidas no GitHub Discussions
- **Breaking changes**: Requerem processo de RFC

### Processo de RFC

Para mudanças significativas:

1. Abra uma Discussão com prefixo `[RFC]`
2. Comunidade fornece feedback
3. Mantenedores tomam decisão final
4. Decisão é documentada

### Código de Conduta

Seguimos o [Contributor Covenant](CODE_OF_CONDUCT-PT.md). Por favor, leia e respeite-o.

Reporte violações para: conduct@SynkraAI.com

## Obtendo Ajuda

### Travado em algo?

1. Verifique a [Documentação](docs/)
2. Pesquise [Discussões existentes](https://github.com/SynkraAI/aiox-core/discussions)
3. Pergunte nas Discussões de Q&A
4. Abra uma discussão de Troubleshooting

### Encontrou um bug?

1. Pesquise [issues existentes](https://github.com/SynkraAI/aiox-core/issues)
2. Se for novo, [abra um relatório de bug](https://github.com/SynkraAI/aiox-core/issues/new?template=bug_report.md)

### Tem uma ideia?

1. Verifique se existe em [Ideias](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas)
2. Se for nova, [compartilhe sua ideia](https://github.com/SynkraAI/aiox-core/discussions/new?category=ideas)
3. Leia nosso [Processo de Solicitação de Features](docs/FEATURE_PROCESS.md) para diretrizes detalhadas

## Roadmap do Projeto

Quer saber para onde o AIOX está indo? Confira nosso roadmap público:

- [ROADMAP-PT.md](ROADMAP-PT.md) - Visão de alto nível e funcionalidades planejadas
- [Projeto GitHub](https://github.com/orgs/SynkraAI/projects/1) - Quadro de rastreamento detalhado

O roadmap é atualizado mensalmente e reflete a contribuição da comunidade. Você pode influenciar nossa direção por:

1. **Votando** em ideias nas [Discussões](https://github.com/SynkraAI/aiox-core/discussions/categories/ideas)
2. **Propondo** novas features via o [processo de RFC](/.github/RFC_TEMPLATE.md)
3. **Contribuindo** diretamente para features planejadas

> Itens do roadmap são planos, não compromissos. Prioridades podem mudar baseadas nas necessidades da comunidade e restrições técnicas.

### Processo de Solicitação de Features

Temos um processo estruturado para propor novas features:

1. **Ideias Rápidas** - Abra uma Discussão na categoria "Ideias"
2. **Processo RFC** - Para features significativas, escreva um RFC usando nosso [template](/.github/RFC_TEMPLATE.md)
3. **Votação da Comunidade** - Use reações :+1: para mostrar apoio
4. **Implementação** - Ideias aprovadas vão para nosso backlog

Veja [Processo de Solicitação de Features](docs/FEATURE_PROCESS.md) para detalhes completos.

## Recursos

### Aprendendo AIOX

- [Guia de Início Rápido](docs/getting-started.md)
- [Visão Geral da Arquitetura](docs/architecture.md)
- [Guia do Usuário](.aiox-core/user-guide.md)

### Recursos Externos

- [Organização AIOX no GitHub](https://github.com/SynkraAI)
- [Changelog](CHANGELOG.md)

## Internacionalização

Aceitamos contribuições em todos os idiomas!

- Documentação é principalmente em inglês
- Discussões da comunidade podem ser em qualquer idioma
- Traduções para português (PT-BR) são apreciadas

## Status do Projeto

- Versão Atual: Veja [releases](https://github.com/SynkraAI/aiox-core/releases)
- Changelog: [CHANGELOG.md](CHANGELOG.md)

---

## Dúvidas?

Não consegue encontrar o que está procurando?
Abra uma Discussão ou entre em contato com a comunidade!

**Obrigado por fazer parte da comunidade AIOX!**

---

*Este documento é mantido pela comunidade AIOX.*
*Última atualização: 2025-12-15*