Preparar o terreno

Criar o repositório no GitHub

O objetivo deste capítulo não é escrever código. É sair do zero absoluto e montar um projeto pronto para ser planejado e executado com agente.

Por isso, o começo é manual de propósito. Antes de envolver a IA, você mesmo cria o repositório no GitHub. Isso ajuda a entender onde o projeto nasce, qual é a URL oficial dele e como a sua pasta local vai se conectar ao remoto.

Abra o GitHub no navegador e siga este passo a passo:

1. Clique em New repository.
2. Escolha um nome curto e claro, como meu-jornal-hn ou [NOME_DO_REPO].
3. Adicione uma descrição simples do projeto.
4. Marque Public se quiser publicar depois no GitHub Pages.
5. Deixe Add a README file, Add .gitignore e Choose a license desmarcados. Vamos criar esses arquivos depois, já com o projeto aberto e com mais contexto.
6. Clique em Create repository.

Clonar no terminal

Com o repositório criado, o próximo passo é trazer esse projeto para a sua máquina. No GitHub, clique em Code, copie a URL HTTPS e rode os comandos no terminal.

cd ~/projetos
git clone https://github.com/seu-usuario/[NOME_DO_REPO].git
cd [NOME_DO_REPO]
git remote -v
git status

Se o repositório estiver vazio, isso é normal: o git clone vai criar a pasta e o git status pode mostrar algo como No commits yet. O importante aqui é confirmar que a pasta local está ligada ao repositório certo no GitHub.

Abrir na ferramenta escolhida

Com a pasta local pronta, abra esse diretório na ferramenta em que você vai trabalhar. O ponto importante aqui é abrir a raiz do projeto, não arquivos soltos.

As ferramentas de IA para desenvolvimento se dividem em três categorias principais, e todas funcionam bem para este projeto:

• IDEs com IA integrada (Cursor, Windsurf): ambiente completo com editor de código, terminal e agente no mesmo lugar. Boa escolha se você quer tudo integrado.
• CLIs de IA no terminal (Claude Code, OpenCode): agente que opera diretamente pelo terminal, lê e edita arquivos, roda comandos. Boa escolha se você já tem um editor preferido.
• Assistentes de IDE (GitHub Copilot, Codeium, etc.): sugestões inline dentro de IDEs como VS Code ou JetBrains. Funciona, mas exige mais gerenciamento manual de contexto.

Qualquer uma dessas categorias vai servir. O que importa é que o agente consiga enxergar a raiz do projeto e operar nos arquivos.

Bônus: instalar e autenticar o GitHub CLI

Esse passo é opcional, mas vale muito a pena. O GitHub CLI (gh) permite acessar o GitHub direto do terminal: autenticar sua conta, abrir repositórios, ver issues e trabalhar com PRs sem sair do ambiente de desenvolvimento.

Os caminhos mais comuns de instalação são:

• macOS: brew install gh
• Windows: winget install --id GitHub.cli
• Linux: usar os pacotes oficiais da sua distribuição na documentação do GitHub CLI

gh auth login
gh auth status

No fluxo interativo, a sequência mais comum é:

1. Escolher GitHub.com.
2. Escolher HTTPS como protocolo do Git.
3. Selecionar autenticação via navegador.
4. Concluir o login no browser quando o GitHub abrir.

gh auth setup-git

Esse comando configura o Git para usar as credenciais do GitHub CLI. Se der certo, o gh auth status deve mostrar sua conta autenticada.

Se você terminou este capítulo, já fez o essencial do setup: criou o repositório remoto, conectou a cópia local e abriu o projeto na ferramenta. No próximo capítulo, vamos usar essa base para criar os três arquivos de planejamento que vão guiar o agente: ROADMAP.md, AGENTS.md ou CLAUDE.md, e DEV_PLAN.md.

git add .
git commit -m "[resuma o que foi feito neste capitulo]"
git push