Conteúdo detalhado
📊 O que o audit faz
O /os-coach audit é o comando que você roda a qualquer momento para pressionar o seu OS contra a realidade. Ele relê o seu objetivo no memory.md, abre a pasta de verdade (não o que a memória diz que tem) e pontua as seis camadas contra aquele objetivo específico. Depois entrega os três próximos movimentos de maior alavancagem e salva o relatório em OS-AUDIT.md.
🌱 Novo aqui?
Auditar aqui é só "dar uma nota honesta a cada parte". Scorecard é o boletim: uma tabela com a nota de cada camada e o porquê. Alavancagem (leverage) é "o quanto um movimento empurra você em direção ao objetivo" — o audit ordena os próximos passos do que rende mais para o que rende menos.
📊 O que é
Uma avaliação amarrada ao seu objetivo. A pergunta nunca é "isto é um bom OS em geral?", e sim "esta camada me leva ao MEU objetivo?".
- •Pontua as 6 camadas em 4 níveis.
- •Dá os 3 movimentos de maior alavancagem, em ordem.
- •Escreve OS-AUDIT.md (guardável) e realimenta o loop.
Por que aprender
Porque construir é só metade. Sem auditar, você acumula camadas sem saber se elas atacam o objetivo — e o OS apodrece em silêncio (Módulo 1.1: cultive, não instale). O audit é o que transforma "fiz um monte de arquivos" em "estou de fato mais perto de nunca mais perder um prazo".
Conceitos-chave
🏅 A escala de 4 níveis
Cada camada recebe um de quatro níveis. Seja honesto: a maioria dos OS no começo está quase toda em Missing ou Started, e isso é normal. A escala mostra a direção, não dá nota pra te envergonhar.
Como ler: a meta não é "tudo Compounding já". É subir um degrau por vez na camada que mais empurra seu objetivo. Uma camada Solid que melhora sozinha (substrato que cresce, skill versionada, audits que realimentam) chega a Compounding.
Não existe, ou é um placeholder vazio.
Existe mas é fina, genérica, ou responde só parte do que o objetivo precisa (ex.: mostra "vence em breve" mas não "já está atrasado").
Real, específica e passa o done-check inteiro da camada (responde toda a pergunta difícil, não só a metade fácil).
Sólida E melhora sozinha com o tempo (o substrato cresce, as skills são versionadas, os audits realimentam).
Por que aprender
Porque a escala te dá vocabulário pra ver progresso real. "Started" não é fracasso: é o sinal de que falta uma parte específica — e o audit te diz qual. Saber a diferença entre Started e Solid é o que evita confundir "tem um arquivo" com "resolve o problema".
Conceitos-chave
🎯 O teste do não-genérico
A regra que mantém o audit útil: toda linha tem que falhar se colada na auditoria de um estranho. Se uma frase serviria pra qualquer OS, ela é genérica e está banida — reescreva com os seus arquivos, seus nomes e o seu objetivo reais. Uma auditoria genérica é uma auditoria fracassada.
✗ Genérico (banido)
"Adicione mais documentação ao seu substrato."
Serve pra qualquer um. Não move ninguém.
✓ Específico (exigido)
"Seu objetivo é recuperar assinantes que cancelaram, mas substrate/ só tem sources.md e um compendium.md vazio. O movimento de maior alavancagem é puxar os últimos 90 dias de mensagens de cancelamento pra substrate/churn/ e destilar os três motivos mais comuns."
💡 A sacada
Cada recomendação cita um nome de arquivo real, uma lacuna real e o objetivo real. Se você consegue trocar o seu OS pelo de outra pessoa sem mudar a frase, ela não vale.
Por que aprender
Porque é exatamente o que torna o OS Coach diferente de um conselho de internet. Conselho genérico você já tem de sobra; o que move a agulha é "no SEU arquivo X falta Y pra atingir Z". Esse é também o teste que você usa pra saber se um audit foi bem feito — o seu ou o de qualquer ferramenta.
Conceitos-chave
🥇 Os 3 movimentos de maior alavancagem
O audit não te dá uma lista infinita. Ele te dá três movimentos, em ordem de alavancagem — não em ordem de camada. A prioridade segue uma lógica clara, em que a regra de cima vence quando duas competem:
Como ler: a regra dura só fura a fila se o estrago for iminente ou não-reversível (dinheiro errado, dado vazando, prazo colado). Fora isso, a ordem natural é substrato → skills → agentes. Nunca recomende um agente antes das skills que ele orquestraria.
1. Regra dura faltante é #1 só se o pior caso for iminente/irreversível. Senão, fica abaixo do substrato.
2. Senão, lacunas de substrato vencem. Bastidor fraco = tudo o resto sobre areia.
3. Skills só importam quando o substrato consegue alimentá-las.
4. Agentes por último. Nunca antes das skills que orquestrariam.
✓ Ordenar por alavancagem
- ✓Ataca o gargalo do objetivo.
- ✓Substrato fraco antes de skills.
- ✓Regra dura só fura a fila se urgente.
✗ Ordenar por camada
- ✗Polir a camada 1 "porque é a primeira".
- ✗Agente bonito sobre substrato vazio.
- ✗Gastar hora longe do gargalo real.
Por que aprender
Porque ordenar por alavancagem é o que te faz avançar com pouco esforço. Sem essa lógica, você gasta energia polindo a camada errada (um agente bonito sobre um substrato vazio). Com ela, cada hora investida ataca o gargalo de verdade do seu objetivo.
Conceitos-chave
📷 Exemplo guiado · start + Identidade
Vamos ver um caso real, condensado (do README do OS Coach). Uma fotógrafa de casamento solo quer parar de perder prazos. Os clientes aparecem como Casal A, Casal B porque ela marcou os nomes como sensíveis — então o coach guarda handles não-identificadores no lugar dos nomes reais.
Você digita:
/os-coach start vivo perdendo prazos de cliente e quero nunca mais
perder uma data de entrega
O coach confirma o objetivo, prepara a pasta e faz três perguntas curtas: pra quem é, a única pergunta que você gostaria de só poder fazer a ele, e uma coisa que ele deve sempre fazer + uma que nunca. Você responde: só pra mim; "o que vence nos próximos 10 dias e do que eu já estou atrasada"; sempre me avisar dentro de 3 dias de uma data contratada; nunca mandar mensagem a um cliente sem minha aprovação. Ele então escreve a Identidade:
CLAUDE.md (gerado)
# Quem eu sou Sou o sistema operacional de uma fotógrafa de casamento solo. Existo para que nenhuma entrega de cliente atrase jamais. ... ## Recusas duras (nunca) - Nunca mando mensagem a um cliente sem você ler e aprovar antes. - Nunca deixo um prazo passar em silêncio. Se algo está em risco, eu trago à tona, alto e claro.
Por que aprender
Porque mostra a camada de Identidade nascendo das suas próprias palavras: o objetivo vira a missão, e o "sempre/nunca" vira recusas concretas. Repare que os handles ("Casal A") já entram em cena na partida — proteger o dado sensível não é um passo separado, é o jeito padrão do coach trabalhar.
Conceitos-chave
🗂️ Exemplo guiado · next + Substrato
A fotógrafa digita /os-coach next. Isso abre o Substrato: o coach pergunta onde ficam as reservas e o que é sensível, e então constrói um tracker que calcula os dois prazos a partir da data de cada casamento (prévia = casamento + 1 semana; galeria completa = casamento + 6 semanas) e já responde a pergunta na hora:
Resposta do coach (na hora)
Dentro de 3 dias, sua linha de "sempre avisar" disparou: - Casal B, galeria completa vence 2026-07-01 (faltam 3 dias) A vencer dentro de 10 dias: - Casal C, prévia vence 2026-07-02 (faltam 4 dias)
🔎 Repare no detalhe
O tracker responde "o que vence em breve" — mas ainda não responde "do que já estou atrasada", porque ela não marcou o que já foi entregue. Guarde isso: é exatamente o que vai segurar o Substrato em Started no audit do próximo tópico.
Por que aprender
Porque mostra um Substrato que já gera valor real (responde "vence em breve") mas ainda é parcial. Essa nuance — responder metade da pergunta difícil — é o coração da diferença entre Started e Solid. O OS é útil desde cedo, e o audit aponta com precisão o que falta pra ficar inteiro.
Conceitos-chave
🧮 Exemplo guiado · audit + scorecard
A fotógrafa digita /os-coach audit. O coach lê os arquivos de verdade e produz o boletim. Veja como cada nível aparece amarrado ao caso dela — sem nenhuma frase genérica:
Scorecard
| Camada | Nota | Por quê |
|---|---|---|
| Identity | Solid | O CLAUDE.md declara a missão e duas recusas. |
| Substrate | Started | O tracker responde "vence em breve", mas não "já atrasada" até você marcar o que foi entregue. |
| Rules | Missing | Os handles dos clientes agora vivem na pasta, sem nada impedindo um backup público. |
Os três movimentos que mais importam
Rules: escreva rules/never.md (nunca fazer backup público desta pasta). Um vazamento não se desfaz, e uma galeria vence em 3 dias.
Substrate: marque quais galerias já saíram, pra que "vence em breve" também responda "já atrasada".
Skills: transforme a checagem de prazos em um comando repetível.
⚠️ Por que a regra furou a fila
Substrate normalmente vem antes de Rules. Mas aqui o pior caso é iminente e irreversível: os handles estão na pasta, sem nada barrando um backup público, e há uma entrega em 3 dias. Pela lógica de prioridade do Tópico 4, isso joga a regra dura faltante para o movimento nº 1.
Depois do audit, a pasta dela fica assim:
A pasta do OS (handles, nunca nomes reais)
photo-os/ ├── CLAUDE.md # Identidade, a alma ├── memory.md # onde você parou ├── substrate/ │ ├── sources.md # onde vivem os dados reais │ └── compendium.md # o tracker de prazos └── OS-AUDIT.md # o scorecard mais recente
Por que aprender
Porque este é o audit inteiro num caso só: notas honestas amarradas aos arquivos dela, a regra dura furando a fila por ser irreversível e iminente, e três movimentos concretos em ordem. Cada arquivo é real, ancorado no objetivo dela e dela para guardar — exatamente o resultado que você quer do seu próprio audit.
Conceitos-chave
🔁 Feedback no loop + copy-run
O audit não é um beco sem saída: ele realimenta o loop. Depois de pontuar, o coach atualiza o memory.md — anexa a manchete datada ao audit_log, re-carimba a data e reescreve o bloco de status das camadas a partir das notas. E salva o relatório completo em OS-AUDIT.md pra você guardar. Os três movimentos viram o seu próximo next.
O ciclo fechado
Construa
Camadas com start / next, uma de cada vez.
Audite
Contra o objetivo: scorecard + os três movimentos.
Edite
Seus arquivos (eles são seus) e ataque o movimento nº 1.
Re-audite
Veja a nota subir. O loop não acaba: o OS é cultivado, não instalado.
🌱 Novo aqui?
Você pode e deve editar à mão o que o coach cria — os arquivos são seus. O fluxo recomendado: edite, depois rode /os-coach audit de novo pra ver como suas mudanças pontuam contra o objetivo. O write-back garante que a próxima sessão já saiba da última nota.
Objetivo: rodar o audit no seu próprio OS e receber o scorecard + os três movimentos amarrados ao seu objetivo.
Cole no Claude Code (dentro da pasta do seu OS):
/os-coach audit
O coach gera, na sua pasta:
OS-AUDIT.md # scorecard das 6 camadas + 3 movimentos + o que já funciona
Como verificar: abra OS-AUDIT.md e aplique o teste do não-genérico — cada linha deveria citar um arquivo seu e o seu objetivo. Se alguma frase serviria pra qualquer OS, peça pra reescrever. Depois ataque só o movimento nº 1 e rode /os-coach audit de novo pra ver a nota daquela camada subir.
Por que aprender
Porque é aqui que a Trilha 4 vira hábito, não evento. Construir uma vez é fácil; auditar, atacar o nº 1 e re-auditar é o que mantém o OS vivo e cada vez mais perto do objetivo — exatamente a mentalidade de "cultivo" da Trilha 1. Com isso você está pronto para a Trilha 5, onde aplica tudo a domínios reais.
Conceitos-chave
✅ Resumo do módulo
Próxima trilha:
5.1 — Tax & Bookkeeping OS 🧾 (domínios reais & produção)