Para quem desenvolve
O projeto foi montado para que o primeiro PR dê certo
Esta página só aponta o caminho. As regras moram no repositório, e é lá que elas mudam: aqui não há cópia.
Veja o sistema funcionando
Uma chamada inteira com o motor simulado, sem chave de IA e sem operadora. Precisa de Docker.
No seu computador git clone https://github.com/DeskLabs-OpenSource/DeskVoice.git && cd DeskVoice pnpm install && pnpm demoAbra o repositório no seu assistente de código
A skill
deskvoice-contribuirmede antes do PR o que a revisão e o CI medem depois, e arma os hooks de git.Escolha uma peça
Ferramenta, motor de voz e rotina moram cada um no próprio arquivo e são descobertos pela pasta. Seu PR não disputa uma lista central com o PR de outra pessoa.
- Adicionar uma ferramenta que o agente usa durante a chamada
- Adicionar um motor de voz
- Issues marcadas como boas para começar
Rode a verificação antes de abrir o PR
Lint, tipos, cercas e testes. O check do seu PR só mede o seu diff: se o CI ficar vermelho por algo que você não tocou, a falha é do projeto, e a mensagem do job diz isso.
pnpm verify
Onde está cada regra
- O guia de contribuiçãoCONTRIBUTING.md
Ramos, commits, o que o CI reprova e o que só a revisão vê.
- As convençõesAGENTS.md
A autoridade para pessoa e para assistente de código.
- A arquiteturaARCHITECTURE.md
O caminho de uma ligação, em uma página.
- O roadmapROADMAP.md
As frentes abertas, cada uma com tamanho e ponto de entrada no código.
- A governançaGOVERNANCE.md
Quem decide o quê, e a fila de merge.
- Os créditosCREDITS.md
O que o projeto deve a outros projetos.
- A doutrinadocs/doctrine
As leis do projeto, cada uma com o erro que a originou.
Dúvida que não é bug? Abra uma discussão. Achou uma falha de segurança? Siga o SECURITY.md, sem abrir issue pública.