> ## Documentation Index > Fetch the complete documentation index at: https://docs.synkrony.ai/llms.txt > Use this file to discover all available pages before exploring further. # Modo AI > Automatize tarefas de desenvolvimento com inteligência artificial # Modo AI O **Modo AI** é uma funcionalidade revolucionária do Synkrony que utiliza inteligência artificial para automatizar tarefas de desenvolvimento. Com ele, você descreve o que precisa fazer e a IA planeja, implementa e cria Pull Requests automaticamente. > O Modo AI é powered by **Kanbino**, nosso agente de IA baseado em Claude da Anthropic. *** ## Como Funciona O Modo AI transforma tarefas descritas em texto em código pronto para revisão através de um fluxo simples e eficiente: ``` Descrição da Tarefa → Planejamento IA → Revisão do Plano → Execução → Pull Request ``` ### O Fluxo Completo Crie uma tarefa no Synkrony com uma descrição clara do que você precisa. Quanto mais detalhes e contexto você fornecer, melhor será o resultado. **Boas práticas:** * Descreva o comportamento esperado * Inclua requisitos específicos * Mencione arquivos ou módulos relacionados * Adicione exemplos quando aplicável Clique no botão **"Executar com AI"** na tarefa. O Synkrony irá acionar o Kanbino para processar sua solicitação. A IA começará a analisar seu projeto e entender o contexto. O Kanbino analisa sua codebase e gera um **plano de implementação** detalhado. Revise as etapas propostas antes da execução. Você pode: * **Confirmar** o plano → A IA executa automaticamente * **Pedir alterações** → A IA revisa o plano com seu feedback * **Fazer perguntas** → A IA esclarece pontos do plano Após aprovar o plano, a IA implementa o código automaticamente. Acompanhe o progresso em tempo real diretamente no Synkrony. Durante a execução, a IA: * Lê os arquivos necessários * Implementa as mudanças * Executa testes quando disponível * Aplica linters e formatters Ao finalizar, um **Pull Request** é criado automaticamente com todas as mudanças. Revise o código como faria com qualquer PR. O PR inclui: * Descrição das mudanças realizadas * Arquivos modificados/criados * Commits organizados por etapa Após o merge do PR, você pode avaliar a qualidade do trabalho da IA. Seu feedback nos ajuda a melhorar continuamente o sistema. *** ## Interação em Tempo Real Durante todo o processo, você interage com a IA através de um chat em tempo real: ### Durante o Planejamento * **Perguntas da IA:** A IA pode fazer perguntas para entender melhor o requisito * **Esclarecimentos:** Responda dúvidas da IA para refinar o plano * **Sugestões:** A IA pode sugerir abordagens alternativas ### Durante a Execução * **Progresso ao vivo:** Veja cada etapa sendo executada * **Mensagens da IA:** A IA explica o que está fazendo * **Logs detalhados:** Acompanhe comandos executados e arquivos modificados ### Após a Execução * **Pull Request:** PR criado automaticamente no seu repositório * **Feedback:** Avalie a qualidade do trabalho (1-5 estrelas) * **Comentários:** Deixe feedback textual para melhorias futuras *** ## Quando Usar o Modo AI O Modo AI é ideal para diversos cenários do dia a dia de desenvolvimento: ### Casos de Uso Recomendados Implementações com requisitos claros e escopo bem delimitado. Ex: adicionar um campo em um formulário, criar um endpoint simples. Corrigir issues específicas com descrição detalhada do comportamento indesejado e do esperado. Melhorar estrutura de código existente mantendo comportamento, como extrair métodos ou reorganizar componentes. Criar testes unitários, de integração ou end-to-end para funcionalidades existentes. Adicionar ou atualizar docstrings, comentários e documentação de código. Atualizar dependências, modificar configurações ou fazer mudanças incrementais. ### Quando Evitar O Modo AI pode não ser a melhor escolha para: * **Arquiteturas complexas:** Mudanças que exigem decisões arquiteturais significativas * **Tarefas vagas:** Descrições sem contexto suficiente ou requisitos mal definidos * **Mudanças muito grandes:** Alterações que afetam múltiplos módulos simultaneamente *** ## Benefícios do Modo AI ### Para Desenvolvedores * **Produtividade:** Automatize tarefas repetitivas e foque no que realmente importa * **Padrão de código:** A IA segue as convenções do seu projeto automaticamente * **Aprendizado:** Veja como a IA aborda problemas e aprenda novas técnicas * **Velocidade:** De tarefas que levariam horas para minutos ### Para Times * **Consistência:** Código gerado segue os mesmos padrões da equipe * **Code Review:** PRs criados pela IA passam pelo mesmo processo de revisão * **Escalabilidade:** Execute múltiplas tarefas em paralelo * **Transparência:** Acompanhe cada etapa da execução em tempo real ### Para Empresas * **Redução de custos:** Otimize o tempo da equipe em tarefas operacionais * **Time-to-market:** Entrega mais rápida de features * **Qualidade:** A IA executa testes e linters antes de criar o PR * **Conhecimento acumulado:** A IA aprende com o contexto do seu projeto *** ## Fluxo de Revisão do Plano A revisão do plano é uma etapa crítica onde você garante que a IA entendeu corretamente o requisito. ### O Que Avaliar 1. **Compreensão do requisito:** A IA entendeu o que você precisa? 2. **Abordagem técnica:** A estratégia proposta faz sentido? 3. **Arquivos afetados:** Os arquivos listados são os corretos? 4. **Etapas:** O plano está completo e na ordem certa? ### Como Dar Feedback * **Se o plano está correto:** Clique em "Confirmar" para aprovar * **Se precisa de ajustes:** Clique em "Pedir alterações" e descreva o que mudar * **Se tem dúvidas:** Faça perguntas no chat para esclarecer pontos ### Ciclo de Revisão ``` Plano Gerado → Você Avalia → Confirmar? → Execução ↓ Não → Pedir Alterações → Plano Revisado → Você Avalia Novamente ``` A IA pode refazer o plano quantas vezes for necessário até que você esteja satisfeito. *** ## Coleta de Feedback Após a conclusão da tarefa, coletamos seu feedback para melhorar o sistema: > Seu feedback é essencial para treinar e melhorar o Kanbino! *** ## Limites de Execução A quantidade de execuções do Modo AI depende do seu plano: | Plano | Execuções/Mês | | ------------ | -------------- | | Free Forever | 2 totais | | Standard | 3 totais | | AI Mode | 30 por usuário | | Enterprise | Ilimitadas | As execuções são contadas por **tarefa completa** - desde o planejamento até a criação do Pull Request. *** ## Dicas para Melhores Resultados ### 1. Descrições Claras **Ruim:** > "Adicionar botão" **Bom:** > "Adicionar um botão de 'Cancelar' no formulário de criação de tarefa que redireciona o usuário para a página do projeto e exibe uma mensagem de confirmação usando o toast padrão do sistema." ### 2. Forneça Contexto Inclua informações sobre: * Stack tecnológico utilizado * Padrões de arquitetura do projeto * Convenções de nomenclatura * Dependências e libs que devem ser usadas ### 3. Defina Requisitos Especifique claramente: * Comportamentos esperados * Casos de borda * Validações necessárias * Testes que devem ser criados ### 4. Use Tarefas Focadas Divida tarefas grandes em subtarefas menores e mais específicas. Tarefas focadas geram melhores resultados. ### 5. Revise o Plano com Cuidado A etapa de revisão do plano é sua oportunidade de corrigir o curso antes que a IA comece a implementar. Dedique tempo a essa etapa. *** ## Segurança e Privacidade O Modo AI foi projetado com segurança em mente: * **Isolamento:** Cada execução roda em ambiente isolado * **Permissões:** A IA só acessa repositórios autorizados * **Transparência:** Todas as mudanças ficam no git para revisão * **Controle:** Você aprova o plano antes da execução * **Code Review:** PRs passam pelo mesmo processo de revisão humana *** ## ❓ FAQ **O Modo AI substitui desenvolvedores?** Não. O Modo AI é uma ferramenta de produtividade que automatiza tarefas repetitivas e bem definidas, permitindo que desenvolvedores foquem em problemas mais complexos. **Posso confiar no código gerado pela IA?** Sempre revise o código como faria com qualquer PR. A IA segue padrões do projeto, mas erros podem ocorrer. O code review humano continua essencial. **O que acontece se a IA cometer um erro?** Você pode solicitar correções através do chat ou fazer as alterações manualmente no PR. O feedback ajuda a IA a aprender. **Posso usar o Modo AI em qualquer projeto?** Sim, desde que o projeto esteja conectado ao GitHub e tenha a integração configurada. **A IA aprende com meu projeto?** Sim, a IA analisa seu código para entender padrões, convenções e contexto do projeto. **Quanto tempo leva uma execução?** Depende da complexidade da tarefa. Tarefas simples podem levar 5-10 minutos, enquanto tarefas complexas podem levar 30-40 minutos. *** ## Documentação Técnica Quer saber mais sobre a configuração técnica e arquitetura do Modo AI? Confira a documentação do [Kanbino](/kanbino).