Onboarding

O primeiro dia de um novo desenvolvedor na AEX é planejado. Do acesso à primeira entrega, sem fricção. Este roteiro leva você do zero à sua primeira tarefa em produção — percorrendo o fluxo completo enquanto ainda está começando.

Meta: até o fim da primeira semana, você já entregou uma tarefa pequena e real, da branch ao deploy.

---

Como funciona

O onboarding é conduzido em conjunto pelo novo desenvolvedor e pelo seu Tech Lead. As seções abaixo estão em ordem: cada uma habilita a próxima.

---

1. Acessos e credenciais

Sem acesso, nada começa. O Tech Lead garante que tudo esteja liberado no primeiro dia.

• E-mail corporativo e identidade da empresa.
• Convite e acesso ao GitHub (organização e repositórios do seu squad).
• Convite e acesso ao ClickUp (workspace da engenharia).
• Acesso às ferramentas de infraestrutura conforme o projeto: Coolify, Supabase.
• Acesso às ferramentas de IA: Cursor, Claude, ChatGPT.
• Permissões corretas em cada ferramenta (nível adequado ao seu papel).

---

2. Ferramentas

Entenda como a AEX usa cada ferramenta antes de operá-las. Leia as guias em tools/:

• cursor.md — ambiente de desenvolvimento com IA.
• claude.md — uso do Claude no dia a dia.
• github.md — fluxo e configuração no GitHub.
• coolify.md e supabase.md — infraestrutura, conforme o projeto.
• n8n.md — automações, quando aplicável.

---

3. Gestão no ClickUp

Toda a gestão da engenharia vive no ClickUp. Se um trabalho não está lá, ele não existe.

• Localize o Roadmap, a Sprint atual e o Backlog do seu squad.
• Entenda a hierarquia: Milestone → tarefa principal → subtarefas.
• Entenda os status oficiais das tarefas e a ordem em que elas caminham.
• Leia o padrão completo em CLICKUP_STANDARD.

---

4. Comunicação

• Entre nos canais de comunicação do time e nos canais específicos de cada projeto.
• Conheça os rituais do squad (planejamento, revisão, dailies, quando houver).
• Saiba quem é seu Tech Lead e como pedir ajuda.

---

5. Leitura obrigatória

A base que garante que você e a IA sigam o mesmo padrão.

• Este handbook — filosofia, estrutura, fluxo e carreira.
• Os standards/ — as regras oficiais que valem para todo projeto.
• O CLAUDE.md da engenharia — como a IA atua nos nossos repositórios.
• A documentação do projeto ao qual você foi alocado (README, PROJECT_CONTEXT, ARCHITECTURE, etc.).

---

6. Setup local

• Clone o repositório do projeto.
• Configure o ambiente a partir do .env.example (nunca use segredos reais fora do cofre).
• Suba o projeto localmente seguindo o README.md dele.
• Rode o projeto com Docker, quando aplicável.
• Confirme que a aplicação executa sem erros na sua máquina.

---

7. Primeira entrega

Uma tarefa pequena e real para percorrer o fluxo completo — da branch ao deploy — ainda no começo. É assim que você aprende o processo fazendo.

• Pegue uma tarefa pequena atribuída pelo seu Tech Lead no ClickUp.
• Crie a branch seguindo o BRANCH_STANDARD.
• Escreva o código no padrão e faça commits seguindo o COMMIT_STANDARD.
• Atualize a documentação afetada — documentação faz parte da entrega.
• Abra o Pull Request e passe pelo checklist de code review.
• Após aprovação, acompanhe o deploy até produção.

---

Pronto ao fim da primeira semana

Você concluiu o onboarding quando:

• Tem acesso a todas as ferramentas necessárias.
• Entende o fluxo oficial de desenvolvimento e a gestão no ClickUp.
• Rodou o projeto localmente.
• Entregou uma primeira tarefa real, da branch à produção.

---

Para quem conduz o onboarding (Tech Lead)

• Garanta todos os acessos antes do primeiro dia.
• Escolha com antecedência uma primeira tarefa pequena, real e de baixo risco.
• Acompanhe de perto a primeira entrega e use-a para ensinar o padrão na prática.
• Esteja disponível para desbloquear rápido — o objetivo é fluxo sem fricção.