Conteúdo detalhado
📦 Instalar a skill
Instalar o OS Coach é mais simples do que parece: você copia uma pasta para o lugar onde o Claude Code procura suas skills. Um comando, sem build, sem chaves de API, sem dependências. Feito isso, o comando /os-coach passa a existir em qualquer pasta da sua máquina.
🌱 Novo aqui?
Uma skill do Claude Code (o programa de terminal que dá mãos à IA) é uma pasta com instruções que viram um comando de barra, tipo /os-coach. O terminal é a telinha de texto onde você digita comandos. cp -r quer dizer "copiar uma pasta inteira". E ~/.claude/skills/ é a gaveta onde o Claude Code guarda as skills da sua conta.
▶ Copy-run · instalar o OS Coach
Objetivo: deixar o comando /os-coach disponível na sua máquina. Rode no terminal, partindo da pasta onde você baixou/clonou o repositório os-coach.
cp -r <caminho-onde-voce-baixou>/os-coach ~/.claude/skills/
Troque: <caminho-onde-voce-baixou> pelo caminho real (ex.: ~/Downloads). Se já estiver dentro da pasta do repo, use só cp -r os-coach ~/.claude/skills/.
Como verificar: abra o Claude Code numa pasta qualquer e digite /os-coach help. Se ele explicar os comandos, a instalação funcionou. (Se o comando não aparecer, confira se a pasta os-coach ficou direto dentro de ~/.claude/skills/, com o SKILL.md lá dentro.)
Esse é o único pré-passo da trilha inteira. A partir daqui, tudo acontece dentro do Claude Code.
Por que aprender
Porque é a porta de entrada. Sem copiar a skill, nada nesta trilha roda. E o fato de ser um comando só reforça a premissa do curso: um OS é encanamento simples, não engenharia pesada. Você não está instalando um programa, está colocando um arquivo de instruções numa gaveta.
Conceitos-chave
🧭 O que a skill faz
Você roda /os-coach dentro de qualquer pasta e diz o seu objetivo. A skill então faz o trabalho técnico por você, uma camada por vez: ela faz 2 a 3 perguntas em português simples, espera você responder, e só então cria os arquivos e pastas reais — explicando o que fez e por quê. A regra de ouro é clara: a skill constrói; você decide.
✓ O OS Coach FAZ
- ✓Cria os arquivos e pastas por você, com Write/Edit.
- ✓Pergunta pouco, espera, e constrói quando você responde.
- ✓Ancora tudo no seu objetivo real e no que está na pasta.
✗ O OS Coach NÃO faz
- ✗Não fala como manual nem despeja jargão.
- ✗Não joga as 6 camadas de uma vez na sua cara.
- ✗Não decide por você — você é quem escolhe.
💡 Assume que você nunca abriu um terminal
Esse é o ponto que muda tudo: o coach foi desenhado para a pessoa não-técnica. Quando uma palavra técnica é inevitável, ele a define em uma frase com uma analogia do dia a dia. Você responde perguntas simples; ele cuida da parte difícil.
Por que aprender
Porque define o contrato entre você e a ferramenta. Saber que você decide e ela constrói tira o medo de "preciso saber programar" e também te mantém no controle: o OS reflete as suas escolhas, não um template genérico.
Conceitos-chave
⌨️ Os 6 comandos
Todo o teclado desta trilha cabe em seis verbos. Você não precisa decorar nada além disso. Cada um dispara um fluxo diferente da skill.
| Comando | O que faz |
|---|---|
| start <objetivo> | Inicia um OS novo na pasta atual. O valor é o seu objetivo. |
| next | Vai para a próxima camada inacabada e a coacha. |
| layer <nome> | Pula para uma camada específica (identity, substrate, rules, skills, tools, agents). |
| status | Mostra o mapa de progresso a partir da memória. |
| audit | Pontua o OS inteiro contra o objetivo e dá os próximos passos. |
| help | Explica o que faz e lista os comandos (mais o seu status, se já houver). |
🔎 O par que você mais usa
Na prática, 90% da trilha é só start uma vez e next várias vezes, com um audit de tempos em tempos. layer e status são atalhos para quando você quiser pular ou só conferir onde está.
Por que aprender
Porque cada módulo desta trilha é, no fundo, um desses comandos em ação. Conhecer os seis de antemão te dá o mapa: 4.2 é o start, 4.3 a 4.5 são o next repetido, e 4.6 é o audit.
Conceitos-chave
🧠 memory.md — a memória entre sessões
O coração do OS Coach é um arquivo de texto: o memory.md. Ele guarda o seu objetivo, a camada atual, o estado de cada camada e as decisões que você foi tomando. Toda execução o lê primeiro e o atualiza por último.
Recriação ilustrativa — o esqueleto do memory.md
# OS Coach Memory **Goal:** nunca mais perder um prazo de entrega **Current layer:** substrate ## Layer status - Identity: solid # CLAUDE.md pronto - Substrate: in progress # compendium.md a destilar - Rules: not started ... ## Decisions (append, newest last) - 2026-06-29 objetivo capturado, identidade escrita
💡 Por que isso é libertador
Você pode parar no meio de uma camada, fechar tudo, e voltar dias depois numa sessão nova. O coach lê o memory.md, sabe exatamente onde você parou e continua dali. Nada de "por onde eu estava?".
Por que aprender
Porque é o que transforma uma conversa volátil em um projeto persistente. Construir um OS leva mais de uma sentada; o memory.md é o que garante que o progresso sobreviva entre elas. Persistir o estado é, aliás, uma regra de ouro inegociável da skill (próximo tópico).
Conceitos-chave
📜 As 8 regras de ouro
A skill carrega oito regras que ela nunca quebra. Você não precisa decorá-las, mas conhecê-las te diz o que esperar — e quando o coach está se comportando certo.
sem jargão; define com analogia quando precisa.
2-3 perguntas, depois espera.
ela cria os arquivos, não você.
tudo ancorado no objetivo e na pasta.
atualiza o memory.md a cada turno.
"onde você está" + o próximo passo.
em lugar nenhum, nem no chat nem nos arquivos.
handle no lugar do valor real.
💡 A regra que mais protege você
A regra 8 é a guardiã dos seus dados: se você marca um nome, e-mail ou valor como sensível, esse valor exato nunca é escrito num arquivo da pasta. No lugar entra um identificador como "Cliente A". Você vê isso em ação já no módulo 4.2.
Por que aprender
Porque elas são o caráter do coach. Quando ele para e pergunta em vez de adivinhar, ou se recusa a escrever um nome real, não é bug — é a regra funcionando. Conhecê-las te deixa confiar no processo e perceber quando algo saiu do trilho.
Conceitos-chave
🛡️ Os guards
Antes de rodar qualquer fluxo, a skill checa alguns guards — proteções que evitam que ela faça besteira. São eles que explicam por que o coach às vezes para e pergunta em vez de simplesmente agir.
Sem memória + comando que não é start
Se você roda next, status ou audit numa pasta sem OS, ele não adivinha: avisa que nada foi começado e pede /os-coach start <objetivo>.
start com OS já existente
Ele nunca sobrescreve em silêncio. Mostra o objetivo atual e a camada, e pergunta se você quer continuar de onde parou ou começar do zero.
Todas as camadas já solid
Ele não inventa uma sétima camada. Te parabeniza e sugere um audit ou aprofundar uma camada com layer.
Camada que não se aplica ao objetivo
Em vez de inventar trabalho, marca not started com uma linha de motivo e segue em frente.
Por que aprender
Porque os guards são o que torna o coach seguro de usar errado. Você não consegue, sem querer, apagar um OS pronto ou avançar para uma camada sem base. Quando ele te interrompe, é o guard certo te protegendo.
Conceitos-chave
🔁 O loop Ask → Build → Persist → Next → Audit
Tudo na trilha gira no mesmo motor de cinco passos. Você dá só um pequeno passo por turno: o coach pergunta, você responde, ele constrói o arquivo real, persiste no memory.md, aponta o próximo e — quando você quiser — audita, alimentando o ciclo de volta.
Como ler: os quatro passos em âmbar giram em ciclo, e todos passam pelo memory.md no centro (lê primeiro, grava por último). O audit em ciano é opcional: pontua o OS e devolve o resultado ao ciclo. Cada módulo desta trilha é uma volta nessa roda.
▶ Copy-run · sua primeira volta no loop
Objetivo: confirmar que a skill está instalada e ver os comandos com suas próprias palavras. Abra o Claude Code em qualquer pasta e digite:
/os-coach help
Como verificar: o coach deve responder em linguagem simples, explicando o que ele faz e listando os 6 comandos. Se você já tiver começado um OS naquela pasta, ele também mostra o seu status atual. Esse é o sinal verde para ir ao módulo 4.2 e rodar o start de verdade.
Note que help não cria nada nem precisa de um OS — é seguro rodar a qualquer momento.
Por que aprender
Porque o loop é o ritmo de tudo o que vem a seguir. Internalizar "um pequeno passo por turno, sempre persistido" te deixa relaxar: você não precisa segurar o plano inteiro na cabeça. O coach pergunta, você responde, ele constrói. Repita.
Conceitos-chave
✅ Resumo do módulo
Próximo módulo:
4.2 — start: o objetivo vira a Identidade 🎯