Home pt BR

LockedIn CLI — um tutorial de tema satírico para construir com um agente de IA

🌎 Idioma: Português (Brasil) — veja todos os 33 idiomas

Bem-vindo(a). Esta wiki é um tutorial prático e amigável para iniciantes para construir uma ferramenta de linha de comando real com um assistente de código de IA agêntico — usando um exemplo bem bobo para tornar o aprendizado divertido.

O exemplo é o LockedIn CLI: uma falsa "CLI de IA" que faz paródia das ferramentas de desenvolvimento da era da IA e do "thought leadership" das redes profissionais. Ele tem um splash com gradiente, uma sessão de chat interativa, slash commands e um modelo que "pensa" muito — e produz absolutamente nenhum valor profissional, de propósito. Por trás das piadas, porém, é um projeto Node.js limpo e bem testado, ideal para aprender.

A brincadeira é uma ferramenta de ensino. Você vai rir das caixas de entrada lotadas de spam de recrutadores enquanto absorve, discretamente, arquitetura, testes e — o mais importante — como direcionar um agente de IA para escrever e alterar código real por você.

---

Para quem é isso

• Novo(a) em programação agêntica / assistida por IA. Talvez você já tenha usado um assistente de chat, mas ainda não dirigiu um agente que edita arquivos, executa testes e publica mudanças. Vamos com calma nessa parte.
• Confortável com os fundamentos de programação. Você sabe ler JavaScript, usar um terminal e acompanhar uma função. O código aqui é intermediário; as partes de IA são para iniciantes. (Não é preciso experiência prévia com frameworks — isto é Node puro, sem dependências.)

Qualquer agente de código capaz funciona. Os exemplos usam o GitHub Copilot CLI (o mesmo agente que escreveu este projeto), mas o fluxo de trabalho também se aplica a outros agentes.

A única regra: a barreira de testes 🧪

Este projeto tem uma regra rígida, e todo o tutorial gira em torno dela:

Nada é publicado a menos que npm test passe.

Um agente de IA pode escrever muito código muito rapidamente. A suíte de validação é como você mantém o controle sobre isso. Você vai aprender a fazer o agente trabalhar atrás dessa barreira: descreva a mudança, deixe que ele adicione testes, deixe que implemente, e só aceite o trabalho quando a suíte estiver verde.

Como usar este tutorial

Percorra os capítulos em ordem. Cada um é curto, termina com um exercício "Experimente com seu agente" e se apoia no anterior.

1. Tutorial 1 Orientação — configure o projeto, execute-o, conheça seu agente e rode a barreira de testes pela primeira vez.
2. Tutorial 2 Como o Código Funciona — a arquitetura que torna este projeto fácil (e seguro) de alterar para um agente: um núcleo puro e testável; aleatoriedade com semente; e a suíte de testes.
3. Tutorial 3 Sua Primeira Tarefa com o Agente — o evento principal: adicione um comando totalmente novo de ponta a ponta direcionando o agente, com testes primeiro.
4. Tutorial 4 Prompts e Revisão — crie prompts como um líder, revise os diffs do agente, itere e mantenha o ritmo entre sessões.
5. Tutorial 5 Localização — como a CLI fala 33 idiomas, e como direcionar um agente para adicionar mais um (i18n, paridade de chaves, layout de largura dupla e marcas combinantes).

Prefere a documentação de piada "dentro do universo"? Ela está em Referência de Comandos (o "manual" satírico original). Usa tecnologia assistiva? Veja Acessibilidade — a CLI tem modos de leitor de tela, alto contraste e baixa distração.

Contribuindo com um agente de código

Contribuições são bem-vindas. Clone o repositório e abra-o com qualquer agente de código capaz, como Claude Code, Cursor ou Codex. Diga a ele para seguir as instruções do repositório e estes tutoriais, revise as mudanças dele e rode npm test antes de enviar. Estes são exemplos, não recomendações nem integrações embutidas.

---

Pré-requisitos em resumo

• Node.js 18+ (Linux, macOS ou Windows — é idêntico nos três).
• git, e um assistente de código com capacidade de agente (por exemplo, GitHub Copilot CLI).
• ~30–60 minutos e senso de humor.

Pronto(a)? Vá para Tutorial 1 Orientação.

---

_{Sátira. O LockedIn CLI é uma paródia das ferramentas de linha de comando da era da IA e da cultura do "thought leadership" — não é afiliado, endossado ou representativo do LinkedIn, nem de qualquer empresa real. Escrito por um grande modelo de linguagem (GitHub Copilot CLI, Claude Opus 4.8) sob a direção de um humano, e licenciado sob GPL-3.0-or-later. Execute lockedin legal para o aviso legal completo.}