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:O Fluxo Completo
Descreva a Tarefa
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
Ative o Modo AI
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.
Revise o Plano
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
Acompanhe a Execução
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
Revise o Pull Request
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
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
Features Bem Definidas
Implementações com requisitos claros e escopo bem delimitado. Ex: adicionar um campo em um formulário, criar um endpoint simples.
Correção de Bugs
Corrigir issues específicas com descrição detalhada do comportamento indesejado e do esperado.
Refatorações
Melhorar estrutura de código existente mantendo comportamento, como extrair métodos ou reorganizar componentes.
Testes Automatizados
Criar testes unitários, de integração ou end-to-end para funcionalidades existentes.
Documentação Técnica
Adicionar ou atualizar docstrings, comentários e documentação de código.
Atualizações Simples
Atualizar dependências, modificar configurações ou fazer mudanças incrementais.
Quando Evitar
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
- Compreensão do requisito: A IA entendeu o que você precisa?
- Abordagem técnica: A estratégia proposta faz sentido?
- Arquivos afetados: Os arquivos listados são os corretos?
- 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
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