Curso de Agente de Codificação Pi: Fluxos de Trabalho Minimalistas no Terminal

Introdução ao Pi

• O que é o Pi e sua filosofia de minimalismo e controle
• Comparação com Claude Code, Codex CLI e Cursor
• As quatro ferramentas internas: read (ler), write (escrever), edit (editar) e bash
• Quando escolher o Pi em vez de agentes mais robustos

Instalação e Configuração

• Instalação do Pi via npm e outros gerenciadores de pacotes
• Configuração de chaves de API para mais de 15 provedores suportados
• Definição do diretório de trabalho e arquivos de contexto
• Execução do Pi em ambientes locais e com Docker

Fluxos de Trabalho no Terminal

• Geração de código a partir de prompts simples
• Leitura e edição precisa de arquivos
• Execução segura de comandos bash dentro do agente
• Gestão do estado da sessão e redefinições de contexto

Criação de Habilidades Personalizadas (Custom Skills)

• Compreensão da API de habilidades em TypeScript
• Desenvolvimento de operações personalizadas de read, write e edit
• Integração com a execução de bash para fluxos de trabalho especializados
• Testes e depuração isolados das habilidades

Modelos de Prompt e Temas

• Adaptação dos prompts do sistema para diferentes linguagens e frameworks
• Criação de modelos de prompt reutilizáveis para padronização da equipe
• Pacotamento de temas como módulos compartilháveis

Extensão do Pi com Pacotes npm

• Empacotamento de habilidades como pacotes pi
• Publicação no npm e Git
• Instalação de pacotes contribuídos pela comunidade
• Gestão de versões de dependências e compatibilidade

Flexibilidade de Provedores

• Mudança entre backends como Anthropic, OpenAI, Google e outros
• Otimização para custo, velocidade e qualidade conforme a tarefa
• Execução exclusivamente local de modelos para proteger código sensível

Casos de Uso Práticos

• Workflows de geração automatizada de testes
• Refatoração de código legado por meio de cadeias de habilidades customizadas
• Geração e manutenção de documentação
• Integração com CI com sobrecarga mínima do agente

Segurança e Controle

• Compreensão dos limites do prompt do sistema de 300 palavras
• Aprovação manual para operações de escrita
• Sandboxes para execução de bash em ambientes não confiáveis
• Auditoria registrada de todas as ações do agente

Resumo e Próximos Passos

• Revisão dos princípios de minimalismo, controle e extensibilidade
• Recursos da comunidade e diretrizes de contribuição
• Tópicos avançados para usuários experientes do Pi