ZX Control · Guia do Colaborador

Criar e atualizar Setups do ZX Control sem saber programar

Você conversa com o Claude em português. Ele faz todo o trabalho técnico — git, terminal, código. Você nunca digita comando e não consegue quebrar nada.

🔒 Tudo que você faz vira um “pedido de aprovação”. Nada vai pro ar sem o Rafael revisar.
Configuração inicial

Uma vez só

Você faz isso na primeira vez e nunca mais.

1
Abra claude.ai/code no navegador.
2
Faça login com o usuário e a senha que o Rafael te passou.
3
Quando pedir, clique em conectar o GitHub e autorize. (É onde os setups ficam guardados.)
Fluxo principal

Criar um Setup NOVO

O Rafael prepara o repositório (30 segundos) e te manda o link. Você começa no passo 2.

1
RafaelCria o repositório a partir do molde e aplica as proteções. Te envia o link.
2
VocêAbra o claude.ai/code e abra o repositório que o Rafael mandou.
Vamos criar o Setup N do ZX Control sobre [tema que o Rafael passou]. Leia o CLAUDE.md e me conduza.
3
VocêDeixe o Claude trabalhar. Ele faz perguntas e monta tudo.
4
VocêPeça pra validar:
valida o setup
5
VocêPeça pra abrir o pedido de aprovação:
abre o Pull Request
6
VocêAvise o Rafael que está pronto. Ele revisa, aprova e publica pros alunos.
Fluxo principal

Atualizar um Setup que JÁ existe

Mais simples ainda — não precisa criar nada.

1
VocêNo claude.ai/code, abra o repositório do setup que quer mexer.
2
VocêDiga o que mudar:
Neste setup, corrige / adiciona [o que for]. Leia o CLAUDE.md antes.
3
Vocêvalida o setup → abre o Pull Request → avise o Rafael.
Como funciona por trás

Você não precisa decorar regras

🤖 O Claude já sabe as regras

As 12 regras do ZX Control vivem dentro do repositório. O Claude lê sozinho e segue.

✅ A validação confere tudo

Ao abrir o Pull Request, um “fiscal” automático checa as 12 regras. Se algo estiver errado, aparece vermelho.

🔒 Nada vai pro ar sem aprovação

Você só propõe. O Rafael é o único que aprova e publica. Impossível quebrar a produção.

🙅 Você nunca usa o terminal

Git, comandos, deploy — tudo é o Claude. Você só conversa em português.

Perguntas comuns

FAQ

Preciso digitar comandos no terminal?
Não. Você só conversa com o Claude. Ele cuida do terminal, do git e de tudo.
E se a validação reclamar de alguma coisa?
Peça pro Claude corrigir: “corrige os erros que a validação apontou”. Ele resolve e valida de novo.
Posso quebrar a produção ou os alunos?
Não. Você só abre um pedido (Pull Request). Nada entra no ar até o Rafael aprovar.
O que é um “Pull Request”?
É um pedido de revisão: você propõe uma mudança e o Rafael decide se entra. Como mandar um documento pra aprovação.
Travei e não sei o que fazer.
Escreva pro Claude: “estou perdido, me explica o próximo passo de forma simples”. Se ainda travar, chame o Rafael.