Conteúdo detalhado
🍕 A pizza do Tax OS — ~34% contexto
Lembra da metáfora do gráfico de pizza da Trilha 1? Aqui ela ganha números. No Tax & Bookkeeping OS, a maior fatia não é "agentes" nem "skills" — é contexto, com ~34%. A identidade, que parecia o ponto de partida natural, vira a menor fatia (8%). Saber ler essa distribuição é o que evita gastar energia na camada errada.
🌱 Novo aqui?
Contexto é o conhecimento que o OS guarda e injeta na conversa quando precisa — aqui, as leis e os padrões de auditoria. PII (do inglês Personally Identifiable Information) é dado pessoal sensível, como CPF/SIN ou número de conta. Ledger é o livro-razão: a lista categorizada de todas as transações.
Como ler: cada fatia é uma das 6 camadas; o tamanho mostra quanto do seu esforço aquele domínio pede. No Tax OS, mais de um terço é contexto (em teal, a maior). Os agentes (em ciano) são uma fatia pequena — entram só para julgar e revisar.
✓ Onde investir aqui
- ✓Compêndio de leis e padrões de auditoria (contexto).
- ✓Pipeline que converte PDFs e poupa janela de contexto.
- ✓Ganchos para PII e separação de contas.
✗ Onde NÃO desperdiçar
- ✗Uma identidade longa e poética (8% — corte ao osso).
- ✗Um enxame de agentes antes de ter o compêndio.
- ✗Skills genéricas sem contexto fiscal por trás.
Por que aprender
Porque a pizza é o seu mapa de prioridades. Quando você sabe que o contexto vale 34%, para de tentar "consertar" o OS com mais agentes e vai cavar onde realmente importa: o conhecimento fiscal. Esse raciocínio — "qual camada importa mais aqui?" — se repete em todos os domínios da trilha.
Conceitos-chave
📚 Contexto: dores de auditoria + compêndio de leis
O contexto do Tax OS nasce de uma engenharia reversa do pior cenário. O autor conta que era leigo em impostos e começou perguntando: "quais foram as piores auditorias que já aconteceram no meu país?". Varrer YouTube e a legislação atrás desses pesadelos, e depois agregar tudo num compêndio, é o que dá ao OS um entendimento real do seu sistema tributário.
🌱 Novo aqui?
Um compêndio (ou playbook) é um documento de referência destilado que junta muitas fontes num lugar só. Harvesting é o ato de coletar essas fontes (transcrições, leis, conselhos de advogados) antes de destilar.
🔎 O que entra no compêndio fiscal
- Cenários de auditoria — os erros de classificação que mais derrubam gente.
- Legislação por jurisdição — lei da sua província/estado e do país.
- Zona cinza vs preto-no-branco — o que é seguro e o que é arriscado.
- Pode rodar pela empresa? — quando uma despesa pessoal vira despesa de negócio.
💡 A regra de ouro fiscal
Sempre que houver dúvida entre a "zona cinza" e o "preto-no-branco", tenda para o preto-no-branco. O compêndio existe justamente para te empurrar para a classificação segura — assim você não precisa torcer para não cair numa auditoria.
Por que aprender
Porque é a fatia de 34%. Sem esse contexto, o modelo só te dá a resposta genérica do Google — e em impostos isso é perigoso. Reverter o pior caso e destilar num compêndio transforma o medo difuso do taxman em uma lista concreta de armadilhas a evitar.
Conceitos-chave
📄 Pipeline PDF→texto: raw → converted → sintetizado
Extratos bancários costumam vir em PDF — e PDF cru é veneno para a janela de contexto: ocupa muito espaço e confunde o modelo. A solução é uma esteira de três pastas: o PDF entra em raw/, vira markdown limpo em converted/ e, por fim, é resumido em synthesized/. Só os resumos entram no contexto.
Como ler: o dado flui da esquerda (cru, em teal) para a direita (sintetizado, em ciano). É o mesmo padrão raw → sintetizado da Trilha 1, aplicado a impostos: você guarda tudo em raw/, mas só injeta os nuggets de synthesized/.
Recriação ilustrativa — a pasta do pipeline
tax-os/substrate/ ├── raw/ # PDFs originais (nunca editados) │ └── extrato-2026-05.pdf ├── converted/ # markdown espelho, 1 por PDF │ └── extrato-2026-05.md └── synthesized/ # só os nuggets entram no contexto └── resumo-2026.md
Por que aprender
Porque é o que torna a revisão mensal barata e confiável. Jogar o PDF inteiro no contexto estoura a janela e gera erro; converter e sintetizar mantém o histórico cru a salvo em raw/ e deixa o modelo trabalhar só com o essencial. Você verá esse pipeline como copy-run no tópico 7.
Conceitos-chave
🔁 Skill: revisão mensal (extrato → ledger → auto-envio)
A tarefa mais repetida do domínio é a revisão de fim de mês — e o que mais se repete é o melhor candidato a virar skill. Essa skill pega o extrato já convertido, categoriza cada transação num ledger, prepara o envio ao contador e dispara alertas de gasto fora do padrão.
A esteira da revisão mensal
Ler o extrato convertido
A skill abre o markdown de converted/ daquele mês — não o PDF cru.
Categorizar no ledger
Cada transação recebe categoria e a flag de pessoal/negócio, seguindo o compêndio.
Alertar e preparar o envio
Gastos fora do padrão viram alertas; o resumo fica pronto para o contador, com as transações que você precisa explicar.
💡 Dica de cadência
O autor lembra que, fora do fim do ano fiscal, o Tax OS quase não precisa de contexto novo. Rode a skill uma vez por mês e deixe o sistema dormir no resto — não há necessidade de mantê-lo "ligado" o tempo todo.
Por que aprender
Porque é onde o OS paga por si mesmo. Transformar horas de planilha em uma skill de um comando libera seu tempo e reduz o erro humano de classificação — exatamente o erro que dispara auditorias. E, como toda skill, ela nunca está "pronta": no post-mortem da sessão você a ajusta.
Conceitos-chave
🚧 Regras & ganchos: pessoal≠negócio, PII, moeda
Aqui dinheiro e dados sensíveis entram em cena — e por isso a regra pode não bastar. Lembre da distinção da Trilha 1: regra é uma sugestão forte (placa "não entre"); gancho é determinístico (porta trancada). No Tax OS, as três cercas críticas são: nunca misturar pessoal e negócio, bloquear PII e converter tudo para uma moeda.
✓ Vira gancho (determinístico)
- ✓Bloquear push pro GitHub se houver PII (SIN, conta, certidão).
- ✓Recusar qualquer escrita que misture conta pessoal e de negócio.
- ✓Converter todo valor para uma moeda única antes de somar.
✗ Fica só como regra "mole"
- ✗"Tente preferir a classificação conservadora" (preferência, não trava).
- ✗"Escreva o resumo num tom claro" (estilo, não segurança).
- ✗"Use bullets no relatório" (formato, reversível).
⚠️ O erro a evitar
Deixar a proteção de PII como regra "mole" no CLAUDE.md. Num contexto longo, o modelo pode "esquecer" a sugestão e subir um número de conta para um repositório. Dado sensível e dinheiro pedem gancho — algo que falha fechado, não um pedido educado.
Por que aprender
Porque é o princípio "determinístico onde dói" em ação. Você decide a dedo o que é inquebrável (PII, separação de contas, moeda) e o que pode ser só preferência. Errar essa fronteira é o que transforma uma conveniência em risco real de vazamento ou de erro fiscal.
Conceitos-chave
🤖 Agentes: estrategista tributário + revisor cético
Os agentes são só ~10% da pizza, mas têm um papel preciso: julgar. São dois. O estrategista tributário sugere a melhor classificação dentro da lei; o revisor cético é o advogado do diabo que "te xinga antes do contador" — ele tenta achar o furo na sua classificação antes que um auditor real ache.
Estrategista tributário
Lê o compêndio e propõe a classificação mais vantajosa que ainda fica no "preto-no-branco". Orquestra a skill de revisão.
Revisor cético
Assume a voz do auditor: questiona cada transação duvidosa e exige justificativa antes de o resumo sair para o contador.
💡 O review gate
O revisor cético é um portão de revisão: nada vai para o contador sem passar por ele. É o mesmo padrão que você verá no Support OS e no Consulting OS — um agente adversarial que protege a saída.
Por que aprender
Porque mostra agentes no seu lugar certo: poucos, no fim da linha, só para julgar. Promover um agente faz sentido aqui porque a revisão fiscal é uma rotina que você já faria à mão — e o revisor cético dá a você a chance de errar em casa, de graça, em vez de errar na auditoria.
Conceitos-chave
⚙️ Prático: pipeline PDF de extrato → markdown
Hora de pôr a mão na massa. O prompt abaixo é copy-run: cole no Claude Code (com sua pasta do Tax OS aberta) e ele monta a esteira raw → converted → synthesized do tópico 3. Troque os trechos marcados com <...> pelos seus valores.
🎯 Objetivo
Fazer o Claude Code criar as três pastas e converter cada extrato em PDF num markdown limpo e num resumo mensal — sem misturar contas e sem escrever fora dessas pastas.
Você é meu engenheiro de dados do Tax OS. Monte um pipeline que transforme extratos bancários em PDF em markdown limpo, em três pastas. Contexto: - Pasta dos PDFs crus: <./substrate/raw/> - Moeda de destino: <CAD> - Meu ano fiscal: de <janeiro> a <dezembro> Faça passo a passo, listando o plano e esperando meu "ok" antes de CADA escrita: 1. Crie a estrutura: substrate/raw/ substrate/converted/ substrate/synthesized/ 2. Para cada PDF em raw/, extraia o texto e salve um .md espelho em converted/ (mesmo nome do arquivo), com uma tabela: data | descrição | valor | moeda. 3. Converta todo valor para <CAD> e marque com [conv] quando houver conversão. 4. NUNCA misture conta pessoal e de negócio: separe em converted/pessoal/ e converted/negocio/ pela conta de origem. 5. Gere substrate/synthesized/resumo-<2026>.md com: total por categoria, os 3 maiores gastos e as transações que eu preciso explicar ao contador. 6. NÃO escreva nada fora dessas três pastas. Se encontrar PII (nº de conta, CPF/SIN), mascare antes de salvar e me avise.
✅ Como verificar que funcionou
- 1.converted/ tem exatamente um .md para cada PDF de raw/.
- 2.Nenhum valor aparece sem moeda; os convertidos estão marcados com [conv].
- 3.Existem as subpastas pessoal/ e negocio/ — nada misturado.
- 4.synthesized/resumo-2026.md traz total por categoria e a lista de explicações.
- 5.Nada foi gravado fora das três pastas, e nenhum nº de conta apareceu em claro.
💡 Próximo passo
Depois que o pipeline rodar, peça ao Claude: "destile esta conversa num slash command /extrato que recebe o mês como argumento". É o reverse meta-prompting da Trilha 3 transformando o passo a passo numa skill reutilizável.
Por que aprender
Porque teoria sem execução apodrece. Rodar este copy-run materializa a fatia de 34% de contexto: você sai do módulo com a esteira de dados de pé, pronta para a skill de revisão mensal — e com o hábito de sempre definir objetivo, bloco copiável e como verificar.
Conceitos-chave
✅ Resumo do módulo
Próximo módulo:
5.2 — Sales OS 📈 (a pizza onde ferramentas e skills sobem ao topo)