Para Quem é Isto e Como Usar Este Manual

Público Principal

Este manual é escrito principalmente para praticantes — as pessoas que constroem, entregam e mantêm software todos os dias. Embora os princípios do desenvolvimento agentic tenham ampla aplicabilidade em todo o trabalho do conhecimento, este manual foca especificamente em equipes de software engineering que operam em ambientes Agile.

O público principal é qualquer pessoa em uma disciplina de software engineering trabalhando dentro de uma equipe Agile:

• Software Engineers (frontend, backend, full-stack) — Os praticantes que trabalharão mais diretamente com AI agents em seu fluxo de trabalho diário
• QA and Test Engineers — Profissionais repensando estratégias de teste quando agents podem gerar e executar testes autonomamente
• DevOps and Platform Engineers — Equipes construindo a infraestrutura e as ferramentas que possibilitam os fluxos de trabalho agentic
• Technical Leads e Staff Engineers — Praticantes seniores definindo os patterns, guardrails e normas para a colaboração humano-agent

Público Secundário

Diversos papéis fora da equipe de engineering direta também encontrarão este manual valioso:

• Engineering Managers — Líderes responsáveis pela produtividade da equipe, desenvolvimento de habilidades e estratégia de adoção
• Product Managers — Stakeholders que precisam entender como os fluxos de trabalho agentic mudam a estimativa, o escopo e os prazos de entrega
• CTOs e VP Engineering — Executivos tomando decisões estratégicas sobre ferramentas, governança e prontidão organizacional

Além da Software Engineering

Os princípios deste manual — clareza de context, trabalho orientado por especificações, colaboração humano-agent — aplicam-se amplamente a todo o trabalho do conhecimento: redação técnica, análise de dados, design, pesquisa e muito mais. No entanto, este manual se concentra em software engineering para fornecer orientação concreta e acionável, em vez de generalizações abstratas.

Estrutura do Manual

Este manual está organizado em capítulos que se complementam, mas cada capítulo também pode ser lido independentemente:

1. Introdução (você está aqui) — O que é o desenvolvimento agentic e por que ele importa
2. Primeiros Passos — Configurando seu ambiente e executando seu primeiro fluxo de trabalho agentic
3. Fundamentos — Blocos de construção de AI agentic e sistemas multi-agent
4. O Framework de Desenvolvimento Agentic — A camada de orquestração, pilares centrais e a evolução de Agile para Agentic
5. Modelo de Equipe — A estrutura de Hybrid Squad, definições de papéis e desenvolvimento de talentos
6. Infraestrutura Operacional — O Agent Workbench, gerenciamento de context e estrutura de avaliação
7. Operações — Rotinas de governança, cerimônias, métricas e um estudo de caso ponta a ponta

Como Ler

Leitura Sequencial

Comece do início e siga cada capítulo em ordem. Isso é recomendado se você é novo no desenvolvimento agentic e deseja uma compreensão abrangente.

Leitura de Referência

Vá para tópicos específicos usando a navegação lateral. Cada página é suficientemente autocontida para ser útil por si só, com links cruzados para conteúdo relacionado quando um context mais profundo for necessário.

Referências Cruzadas

Ao longo do manual, você encontrará links para outros recursos neste site:

• Patterns — Abordagens comprovadas para desafios comuns do desenvolvimento agentic
• Templates — Templates prontos para uso em fluxos de trabalho agentic
• Playbooks — Guias passo a passo para cenários específicos
• Glossary — Definições de termos chave usados em todo o site

Essas referências cruzadas conectam o conteúdo conceitual do manual com recursos práticos e acionáveis.

Contribuindo

Este manual é open source e aceita contribuições. Se você gostaria de melhorar o conteúdo existente, adicionar novos capítulos ou corrigir erros, verifique as diretrizes de contribuição no repositório do manual.