GitHub CLI
O primeiro passo é garantir que seu agente de código consiga interagir com o
GitHub. A forma mais direta é a GitHub CLI (gh).
"Me ajude a instalar a GitHub CLI e autenticar com minha conta do GitHub."
Se quiser, instale também o GitHub MCP na sua ferramenta. Ele dá ao agente acesso nativo a issues e PRs. Mas se não funcionar, continue sem. A CLI já é suficiente.
Rode gh auth status no terminal. Sua conta deve aparecer autenticada.
Criar o repositório
"Cria um repo pra mim."
"Crie um repositório público no GitHub chamado 'deezer-explorer' com a descrição 'Site para explorar artistas e discografias via API do Deezer'. Clone localmente e abra a pasta na minha ferramenta de desenvolvimento."
Rode gh repo view de dentro da pasta. As informações do repositório
devem aparecer.
Harness engineering
Harness engineering é preparar o ambiente onde o agente trabalha: contexto, plano, regras e critérios de qualidade. Não é burocracia. É o que impede a IA de viajar.
Antes de pedir código, peça os arquivos que deixam o projeto legível para humanos e para a IA.
"Crie um README.md para este projeto. Inclua: objetivo do site, público, funcionalidades esperadas, como rodar localmente, como testar, como publicar no GitHub Pages e limitações conhecidas. Use linguagem simples, como se fosse para uma pessoa entrando no projeto agora."
"Crie um PLAN.md inicial para implementar o projeto em fases pequenas. Cada fase precisa ter objetivo, critérios de aceite testáveis, validação manual esperada e decisões abertas. Inclua riscos conhecidos, como CORS na API do Deezer. Não implemente nada ainda."
"Crie um arquivo AGENTS.md na raiz do projeto com: visão geral (site estático que consome API do Deezer, publicado no GitHub Pages), seções para comandos do projeto, padrões de qualidade, como atualizar o PLAN.md quando decisões mudarem e regras de operação para o agente. Se eu estiver usando Claude Code, crie CLAUDE.md para esse mesmo papel."
Leia os três arquivos. Se tiver comando que não existe, escopo inventado, promessa vaga ou decisão técnica que você não entende, peça ajuste. Um bom arquivo ajuda você a cobrar o agente depois.
README.md, PLAN.md inicial e AGENTS.md (ou CLAUDE.md no Claude Code) existem, foram lidos e fazem sentido pra você.
Capítulo 1
0 de 3 checkpointsComplete todos os checkpoints para desbloquear o próximo capítulo.
Próximo: Planejar com o agente →