Guias
Contribuir
Escolha uma contribuição, prepare a prova e encontre o guia da sua tarefa.
Por onde começar
Feature nova começa no GitHub Discussions. Defeito começa por uma issue com o comando, a saída real e a versão. Documentação e correções pequenas podem ir direto a um PR. Consulte issues e roadmap antes de começar; comente na issue que pretende assumir.
Prepare uma mudança verificável
O PR explica o problema, a mudança, a prova, a baseline e o risco. Cole a saída real dos comandos. Separe regressões de falhas que já existiam; mudança de comportamento pede teste que reproduza o defeito. Usar o ork é recomendado e opcional. O mantenedor integra com CI verde no commit exato e conduz a publicação.
Os testes de integração exigem ORKMIND_TEST_DATABASE_URL e apagam o banco de testes. Use somente um banco de teste dedicado; consulte o CONTRIBUTING antes de executar a suíte inteira.
pip install -e ".[dev]"
pytest -m "not integration"Um guia por tarefa
O OrkMind ainda não tem uma série própria de guias de contribuição. Use os guias do Orkastery para o fluxo de contribuição e o CONTRIBUTING do OrkMind para os comandos e contratos específicos.
Os guias-fonte estão em português do Brasil. A versão em inglês está prevista antes do lançamento. Contribuições claras em inglês são bem-vindas.
Prazo, revisão e segurança
A meta é uma primeira resposta em até 7 dias para issues e uma primeira revisão no mesmo prazo para PRs. É meta, não garantia. Se passar do prazo, comente no pedido original. Vulnerabilidades vão pelo canal privado indicado em SECURITY.md. Nunca inclua segredos, dados pessoais ou dados de clientes no repositório.