O repositório
→ é o contrato.

O agente produz código o dia inteiro. Sem o repositório amarrado ao ciclo, esse código é fumaça: ninguém revisa, ninguém valida, ninguém entrega. O ciclo do repositório transforma trabalho solto em contrato auditável.

4 fasesdetect, setup, review, deploy
1 contratogit segura cada passo do trabalho
end-to-enddo repo vazio ao deploy validado
Legenda de coresAs 4 fases do ciclo
Detect Repo
Setup GitHub
CodeRabbit
CI/CD
Sem amarra

Mapa da aula

Use este mapa para entender a sequência da aula antes de entrar nos detalhes.

Legenda de coresAs 4 fases do ciclo
Detect Reporeconhecer o estado antes de agir
Setup GitHubconectar remoto e autoria
CodeRabbitreviewer automático no PR
CI/CDpipeline que valida e entrega
Sem amarratrabalho sem git vira fumaça

O repositório é o contrato

Git não é backup, é contrato. Cada commit é uma promessa rastreável. Cada PR é um ponto de revisão. Sem essa amarra, o trabalho do agente não tem onde se ancorar nem como ser auditado.

A regra que sustenta a aulaO ciclo SDC só vale quando amarrado ao repositório. Story vira branch, trabalho vira commit, entrega vira PR revisado, deploy vira pipeline. Sem git no centro, o agente produz e ninguém consegue dizer o que mudou, quem revisou, ou se está pronto.

Trabalho solto

  • Agente edita arquivos sem branch nem commit.
  • Ninguém sabe o que mudou entre uma sessão e outra.
  • Revisão é olhar no olho, sem PR nem reviewer.
  • Deploy é copiar arquivo na mão, sem pipeline.

Trabalho amarrado ao repo

  • Cada story vira branch, cada passo vira commit.
  • O diff conta a história do que mudou e por quê.
  • CodeRabbit revisa o PR antes do humano.
  • CI/CD valida e entrega de forma determinística.
Pedro Valério (co-founder, aula-06)Eu vou montar o ciclo do repositório do zero aqui, end-to-end. Detecta o repo, conecta no GitHub, bota o CodeRabbit pra revisar, amarra o CI/CD. No fim, o agente não toca em nada que não passe por esse contrato.

O caminho da aula

Três movimentos: entender o repositório como contrato, ver o setup end-to-end ao vivo, e montar o seu próprio ciclo num repo novo.

As 4 fases em ordem

1. Detect Reporeconhece se é repo novo, existente, com ou sem remoto.
2. Setup GitHubcria o remoto, conecta, define a autoria do trabalho.
3. CodeRabbitliga o reviewer automático no fluxo de PR.
4. CI/CDamarra o pipeline que valida e entrega.

[ a ] Você vai sair sabendo

  • Por que git é contrato e não backup.
  • O que cada uma das 4 fases entrega.
  • Onde o CodeRabbit e o CI/CD entram no fluxo.

[ b ] Você vai sair fazendo

O setup de um repositório novo do zero, com detect, GitHub, CodeRabbit e CI/CD amarrados.

Cluster 1 / 3repositório é contrato · as 4 fases do ciclo · git no centro do SDC

Você tem o mapa. Agora vê o setup end-to-end ao vivo, do repo vazio ao deploy.

Caso Real

O setup end-to-end ao vivo

Pedro montou o ciclo do zero numa aula: repo vazio, GitHub conectado, CodeRabbit revisando, CI/CD entregando. O que parecia infraestrutura virou uma sequência de 4 passos.

Do repo vazio ao deploy validado

Montar o ciclo parece tarefa de especialista de infra. Em 4 passos ordenados, vira rotina que qualquer operador faz no início de cada projeto.

Rota · action
Começou comoUm diretório com código solto, sem git, sem remoto, sem revisão.
VirouUm repositório com GitHub, CodeRabbit no PR e CI/CD validando cada entrega.
ProvaA partir do setup, nenhum código chega à produção sem passar pelo contrato.
LiçãoO ciclo do repositório é uma sequência de 4 passos, não um projeto de infra.
SituaçãoPedro abre um projeto sem nenhuma amarra de git e monta o ciclo completo na frente da turma.
DecisãoSeguir as 4 fases em ordem: detectar o estado, conectar o GitHub, ligar o CodeRabbit, amarrar o CI/CD.
EvidênciaPedro mostra end-to-end em aula-06, e Klaus demonstra o CI/CD operacional em t2-aula-4.
Mensagem ao alunoFaça esse setup uma vez no início de cada projeto. Depois o ciclo se paga sozinho em cada PR.
ContextoEm aula-06, o setup do repositório é demonstrado do zero; em t2-aula-4, Klaus aprofunda o CI/CD e as boas práticas de git.
Percepção-chaveA ordem importa: detectar antes de conectar, conectar antes de revisar, revisar antes de entregar. Cada fase prepara a próxima.
DecisãoPadronizar o setup como rotina de início de projeto, não como exceção.
1Detectareconhece o estado do repo: novo, sem remoto.
2Conectacria o GitHub e amarra o remoto com autoria.
3Revisaliga o CodeRabbit pra revisar todo PR.
4Entregaamarra o CI/CD que valida e faz o deploy.
4 passoso setup inteiro cabe numa sequência
1 vezfeito no início, vale o projeto todo
Auditávelcada mudança rastreável no git
AntesCódigo solto, sem git, sem revisão, deploy na mão.
DepoisCiclo completo amarrado, cada entrega passa pelo contrato.
LiçãoSetup uma vez, o ciclo se paga em cada PR.
Klaus (operação, t2-aula-4)O CI/CD não é luxo. É o que garante que o que o agente escreveu roda, passa nos testes, e chega na produção do mesmo jeito toda vez. Sem pipeline, cada deploy é uma aposta.

O que cada fase protege

Cada fase do ciclo fecha um buraco diferente. Pular uma deixa um flanco aberto que aparece como retrabalho ou deploy quebrado.

FaseO que protegeSintoma se pularSinal de saúde

Detect Repo

O que protegeagir no estado errado
Sintoma se pularcomando que falha por contexto errado
Sinal de saúdeestado do repo conhecido antes de agir

Setup GitHub

O que protegetrabalho sem rastro
Sintoma se pularninguém sabe quem mudou o quê
Sinal de saúderemoto e autoria amarrados

CodeRabbit

O que protegeerro chegando no humano
Sintoma se pularreview manual cansado deixa passar bug
Sinal de saúdereviewer automático no PR

CI/CD

O que protegedeploy quebrado
Sintoma se pularfunciona na minha máquina e quebra em produção
Sinal de saúdepipeline valida e entrega igual
Quanto retrabalho cada fase evita (estimativa relativa)
  • Sem nenhuma fase amarrada
    retrabalho máximo
  • Com Detect + GitHub
    rastro garantido
  • Com CodeRabbit no PR
    bugs filtrados
  • Com CI/CD completo
    deploy confiável
Cluster 2 / 3setup end-to-end ao vivo · o que cada fase protege · ordem das 4 fases

Você viu o ciclo montado. Agora a técnica: o pipeline das 4 fases e a sequência de comandos.

Pipeline

Pipeline: as 4 fases com gate

Cada fase tem um output e um gate. Não avança para a próxima sem fechar a anterior. É isso que faz o ciclo ser contrato e não sugestão.

1. Detect Repo

Reconhece o estado: é repo novo ou existente? Tem remoto? Tem branch principal definida?

Fase 1 · Outputestado-do-repo: novo | existente, com/sem remoto
Fase 2 · GateVocê sabe o estado antes de rodar qualquer comando que assume contexto?

2. Setup GitHub

Cria o repositório remoto, conecta, define a autoria do trabalho e a branch principal.

Fase 1 · Outputremoto conectado, autoria e branch definidas
Fase 2 · GateUm push chega no remoto certo com a autoria correta?

3. CodeRabbit

Liga o reviewer automático para revisar cada PR antes do humano olhar.

Fase 1 · OutputCodeRabbit ativo no fluxo de PR
Fase 2 · GateAbrir um PR dispara a revisão automática?

4. CI/CD

Amarra o pipeline que roda testes, valida e entrega de forma determinística.

Fase 1 · Outputpipeline que valida e faz deploy
Fase 2 · GateUm merge dispara a validação e a entrega igual toda vez?

A sequência de setup

Os passos concretos para amarrar um repositório novo ao ciclo, em ordem.

◇▶ signal_plus_action

Amarrar um repositório novo ao ciclo

Use no início de todo projeto novo, antes de o agente tocar no código.

detect→github→coderabbit→cicd
  1. detect — Verifica se há git, remoto e branch principal. Define o estado de partida.
  2. github — Cria o repositório no GitHub, conecta o remoto, ajusta a autoria.
  3. coderabbit — Instala o CodeRabbit para revisar cada PR automaticamente.
  4. cicd — Configura o pipeline de CI/CD para validar e entregar.

Do estado detectado ao deploy

1

Detect

estado do repo conhecido.

2

GitHub

remoto e autoria amarrados.

3

CodeRabbit

PR revisado automaticamente.

4

CI/CD

validação e deploy determinísticos.

Estados do repositório

Detect Repo existe porque um repositório pode estar em vários estados. Cada estado pede uma ação diferente na hora de amarrar o ciclo.

Repo novo, sem git◇ signal

Inicializa git, cria remoto, amarra o ciclo do zero.

Git local, sem remoto▲ bench

Cria o GitHub e conecta o remoto, depois liga review e CI/CD.

Remoto sem CodeRabbit✦ insight

O git está pronto; falta o reviewer e o pipeline.

Tudo amarrado▶ action

Ciclo completo. Cada PR passa por review e CI/CD.

Não faça

  • Rodar comando que assume remoto antes de detectar o estado.
  • Pular o CodeRabbit e revisar tudo no olho.
  • Fazer deploy na mão sem pipeline determinístico.

Faça

  • Detectar o estado do repo antes de qualquer setup.
  • Deixar o CodeRabbit filtrar o PR antes do humano.
  • Amarrar o CI/CD para deploy igual toda vez.
Não confundaGit como contrato, não git como backup

Backup é guardar uma cópia para emergência.

Esclareça: Contrato é cada commit ser uma promessa rastreável e cada PR um ponto de revisão. O ciclo usa git como contrato.

Não confundaCodeRabbit antes do humano, não no lugar do humano

O reviewer automático parece substituir a revisão.

Esclareça: Ele filtra o óbvio antes, para o humano gastar atenção no que importa. Não elimina o sign-off humano.

Não confundaCI/CD determinístico, não deploy na sorte

Funciona na minha máquina parece prova suficiente.

Esclareça: O pipeline garante que valida e entrega igual toda vez, independente da máquina de quem rodou.

Cluster 3 / 3pipeline das 4 fases com gate · sequência de setup · estados do repositório

Você tem a técnica. Agora a prática: amarre um repositório novo ao ciclo completo.

Prática

Prática: amarre um repositório novo

Pegue um projeto novo e amarre o ciclo completo: detecte o estado, conecte o GitHub, ligue o CodeRabbit e configure o CI/CD.

aula.yaml12 linhas
01# Amarre na ordem. So avance com a fase anterior fechada.02detect_repo: 03  estado: "{novo | local-sem-remoto | remoto-sem-review | completo}"04  ok: false05setup_github: 06  remoto_conectado: false07  autoria_definida: false08coderabbit: 09  ativo_no_pr: false10cicd: 11  pipeline_valida: false12  deploy_deterministico: false

Produz

Trecho copiável para executar ou adaptar.

Portão

Checklist do ciclo (uma marca por fase)
Portão da aulaAntes de seguir para a próxima aula: você amarrou um repositório novo ao ciclo completo, com detect, GitHub, CodeRabbit e CI/CD, e validou com um PR de teste. Se alguma fase ficou aberta, feche antes de passar.
  1. Detecte o estado: Verifique se o projeto tem git, remoto e branch principal. Anote o estado de partida.
  2. Conecte o GitHub: Crie o repositório remoto, conecte e ajuste a autoria do trabalho.
  3. Ligue o CodeRabbit: Instale o CodeRabbit para revisar cada PR antes do humano.
  4. Configure o CI/CD: Amarre um pipeline mínimo que rode testes e faça o deploy.
  5. Valide o ciclo: Abra um PR de teste e confirme que dispara review e que o merge dispara o pipeline.

Glossário

Os termos desta aula em uma frase cada.

Ciclo do repositório

As 4 fases que amarram o trabalho do agente ao git: detect, GitHub, CodeRabbit, CI/CD.

Detect Repo

Reconhecer o estado do repositório (novo, sem remoto, completo) antes de agir.

Setup GitHub

Criar o remoto, conectar e definir a autoria do trabalho no repositório.

CodeRabbit

Reviewer automático que revisa cada PR antes do humano olhar.

CI/CD

Pipeline que valida com testes e entrega o deploy de forma determinística.

Próxima aulaCom o repositório amarrado ao ciclo, o trabalho do agente tem contrato. A seguir, M4 entra no determinismo e no comando: como travar a IA no caminho certo, etapa por etapa.