Tutorial 1 Orientation pt BR

Tutorial 1 · Orientação

Meta: colocar o projeto no ar, conhecer seu agente de IA e rodar a barreira de testes uma vez — para que tudo o que vem depois seja automático.

← Voltar para Início · Próximo: Tutorial 2 Como o Código Funciona

---

1. Por que um app de piada?

Aprender a trabalhar com um agente de código é mais fácil quando o código é pequeno, real e de baixo risco. LockedIn CLI é as três coisas:

• Pequeno: um arquivo de núcleo, um ponto de entrada, uma suíte de testes, zero dependências.
• Real: ele se instala como o comando global lockedin e se comporta como uma CLI de IA genuína.
• Baixo risco: é sátira. Se seu agente deixar os humblebrags 20% mais humildes, ninguém recebe um alerta às 3 da manhã.

Essa combinação te deixa focar na habilidade de verdade: descrever bem uma mudança, deixar o agente fazer o trabalho e verificar o resultado.

2. Pegue o código

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

Confira sua versão do Node (precisa de 18+):

node --version

Não há nada para instalar — sem npm install de dependências, porque não há nenhuma. Isso é deliberado: menos peças móveis, mais aprendizado.

3. Execute

Experimente a coisa real:

node bin/lockedin.js            # o splash + banner
node bin/lockedin.js post       # um post de "thought leadership" gerado
node bin/lockedin.js aura       # escaneia sua aura profissional
node bin/lockedin.js            # (sem args) te leva direto para a sessão de chat

Digite /help dentro da sessão, explore um pouco e depois /exit. Tudo o que você vê é gerado localmente a partir de pools de palavras — sem rede, sem contas. Lista completa de comandos: Referência de Comandos.

4. Rode a barreira de testes

Este é o comando mais importante de todo o tutorial:

npm test

Você deve ver uma parede de checks verdes terminando em algo como pass 318. Essa suíte é sua rede de segurança. A partir daqui, o fluxo de trabalho é sempre:

mude algo → npm test → só publique se estiver verde.

5. Conheça seu agente

Abra seu agente de código na pasta do projeto para que ele possa ver os arquivos. Com o GitHub Copilot CLI, isso é:

copilot

Depois, para se situar, peça ao agente para orientar você (não para mudar nada ainda). Tente um prompt como:

"Me dê um tour de dois parágrafos por este repositório: para que serve cada arquivo e pasta de nível superior, e como eu rodo o app e os testes. Não mude nada."

Compare a resposta dele com o que você viu nos passos 3–4. Ficar confortável em pedir ao agente para explicar antes de editar é um hábito essencial — vamos usar bastante isso.

---

✅ Experimente com seu agente

1. Pergunte ao agente: "O que node bin/lockedin.js reflect 'meu café estava frio' imprime, e qual arquivo decide essa saída?" Confirme a resposta rodando o comando você mesmo.
2. Peça a ele para rodar a suíte de testes e reportar o resultado: "Rode npm test e me diga quantos checks passam."

Você já viu o app, os testes e o agente. A seguir, vamos ver por que este código é tão amigável para agentes — o design que te deixa entregar mudanças com confiança.

Próximo: Tutorial 2 Como o Código Funciona