Contenido detallado
🍕 La pizza del Tax OS — ~34% de contexto
¿Recuerdas la metáfora del gráfico circular de la Trilha 1? Aquí adquiere cifras. En el Tax & Bookkeeping OS, la mayor parte no son "agentes" ni "skills": es contexto, con ~34%. La identidad, que parecía el punto de partida natural, se convierte en la porción más pequeña (8%). Saber leer esta distribución es lo que evita que gastes energía en la capa equivocada.
🌱 ¿Nuevo aquí?
Contexto es el conocimiento que el OS guarda e incorpora a la conversación cuando hace falta: aquí, las leyes y los estándares de auditoría. PII (del inglés Información de identificación personal) es un dato personal sensible, como el CPF/SIN o el número de cuenta. Ledger es el libro mayor: la lista categorizada de todas las transacciones.
Cómo leer: cada porción es una de las 6 capas; el tamaño muestra cuánto esfuerzo te exige ese dominio. En Tax OS, más de un tercio es contexto (en teal, la porción más grande). Los agentes (en cian) ocupan una porción pequeña: solo intervienen para evaluar y revisar.
✓ Dónde invertir aquí
- ✓Compendio de leyes y patrones de auditoría (contexto).
- ✓Pipeline que convierte PDFs y ahorra ventana de contexto.
- ✓Ganchos para PII y separación de cuentas.
✗ Dónde NO desperdiciar
- ✗Una identidad larga y poética (8%: recórtala al máximo).
- ✗Un enjambre de agentes antes de tener el compendio.
- ✗Skills genéricas sin contexto fiscal detrás.
Por qué aprender
Porque la pizza es tu mapa de prioridades. Cuando sabes que el contexto vale 34%, dejas de intentar «arreglar» el OS con más agentes y profundizas donde realmente importa: el conocimiento fiscal. Este razonamiento —«¿qué capa importa más aquí?»— se repite en todos los dominios de la trilha.
Conceptos clave
📚 Contexto: problemas de auditoría + compendio de leyes
El contexto del Tax OS nace de una ingeniería inversa del peor escenario. El autor cuenta que no sabía de impuestos y empezó preguntando: "¿cuáles han sido las peores auditorías que han ocurrido en mi país?". Buscar estos problemas en YouTube y en la legislación, y después reunirlo todo en un compendio, es lo que le da al OS una comprensión real de tu sistema tributario.
🌱 ¿Nuevo aquí?
Un compendio (o playbook) es un documento de referencia destilado que reúne muchas fuentes en un solo lugar. Harvesting es el acto de recopilar estas fuentes (transcripciones, leyes, consejos de abogados) antes de destilarlas.
🔎 Qué entra en el compendio fiscal
- Escenarios de auditoría — los errores de clasificación que hacen caer a más personas.
- Legislación por jurisdicción — la ley de tu provincia/estado y del país.
- Zona gris vs. blanco y negro — qué es seguro y qué es arriesgado.
- ¿Puede funcionar en toda la empresa? — cuándo un gasto personal se convierte en un gasto de negocio.
💡 La regla de oro fiscal
Siempre que haya dudas entre la «zona gris» y el «blanco y negro», tienda a lo blanco o negro. El compendio existe precisamente para orientarte hacia una clasificación segura, así no tienes que cruzar los dedos para que no haya una auditoría.
Por qué aprender
Porque es la porción de 34 %. Sin este contexto, el modelo solo te da la respuesta genérica de Google, y en materia de impuestos eso es peligroso. Revertir el peor caso y destilarlo en un compendio transforma el miedo difuso de taxman en una lista concreta de trampas que debes evitar.
Conceptos clave
📄 Pipeline PDF→texto: raw → converted → sintetizado
Los extractos bancarios suelen venir en PDF, y el PDF sin procesar es veneno para la ventana de contexto: ocupa mucho espacio y confunde al modelo. La solución es una flujo de tres carpetas: el PDF entra en raw/, se convierte en Markdown limpio en converted/ y, por último, se resume en synthesized/. Solo los resúmenes entran en el contexto.
Cómo leer: el dato fluye de izquierda (crudo, en teal) a derecha (sintetizado, en cian). Es el mismo patrón raw → sintetizado de la Ruta 1, aplicado a los impuestos: guardas todo en raw/, pero solo inyecta los nuggets de synthesized/.
Recreación ilustrativa — la carpeta del 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 qué aprender
Porque es lo que hace que la revisión mensual sea barata y confiable. Volcar el PDF entero en el contexto satura la ventana y genera errores; convertirlo y sintetizarlo mantiene el historial en bruto a salvo en raw/ y deja que el modelo trabaje solo con lo esencial. Verás este pipeline como copy-run en el tema 7.
Conceptos clave
🔁 Skill: revisión mensual (estado de cuenta → ledger → envío automático)
La tarea más repetida del dominio es la revisión de fin de mes — y lo que más se repite es el mejor candidato para convertirse en skill. Esta skill toma el extracto ya convertido y categoriza cada transacción en un ledger, prepara el envío al contador y dispara alertas de gastos fuera de lo normal.
La rutina de la revisión mensual
Leer el extracto convertido
La skill abre el markdown de converted/ de ese mes —no el PDF sin procesar.
Categorizar en el ledger
Cada transacción recibe una categoría y la marca de personal/negocio, según el compendio.
Alertar y preparar el envío
Los gastos fuera de lo habitual se convierten en alertas; el resumen queda listo para el contador, con las transacciones que necesitas explicar.
💡 Consejo sobre el ritmo
El autor recuerda que, fuera del cierre del año fiscal, el Tax OS casi no necesita contexto nuevo. Ejecuta la skill una vez al mes y deja que el sistema descanse el resto del tiempo — no hay necesidad de mantenerlo "encendido" todo el tiempo.
Por qué aprender
Porque es donde el OS se paga solo. Transformar horas de hojas de cálculo en una skill de un comando libera tu tiempo y reduce el error humano de clasificación, justo el error que desencadena auditorías. Y, como toda skill, nunca está "lista": la ajustas en el post-mortem de la sesión.
Conceptos clave
🚧 Personal≠negocio, PII, moneda
Aquí entran en juego el dinero y los datos sensibles, y por eso la regla puede no ser suficiente. Recuerda la distinción de la Ruta 1: regla es una sugerencia firme (letrero de «no entrar»); gancho es determinista (puerta cerrada). En el Tax OS, las tres barreras críticas son: nunca mezclar lo personal y el negocio, bloquear la PII y convertir todo a una moneda.
✓ Se convierte en gancho (determinístico)
- ✓Bloquear el push a GitHub si hay PII (SIN, cuenta, certificado).
- ✓Rechazar cualquier escritura que mezcle cuentas personales y de negocio.
- ✓Convierte todos los valores a una sola moneda antes de sumarlos.
✗ Queda solo como regla «blanda»
- ✗"Intenta preferir la clasificación conservadora" (preferencia, no bloqueo).
- ✗"Escribe el resumen con un tono claro" (estilo, no seguridad).
- ✗"Usa viñetas en el informe" (formato, reversible).
⚠️ El error que debes evitar
Dejar la protección de PII como una regla «flexible» en el CLAUDE.md. En un contexto largo, el modelo puede "olvidar" la sugerencia y subir un número de cuenta a un repositorio. Los datos sensibles y el dinero requieren gancho — algo que falla de forma segura, no una solicitud amable.
Por qué aprender
Porque es el principio de "determinístico donde duele" en acción. Decides cuidadosamente qué es inquebrantable (PII, separación de cuentas, moneda) y qué puede ser solo una preferencia. Equivocarse en ese límite es lo que convierte una comodidad en un riesgo real de filtración o error fiscal.
Conceptos clave
🤖 Agentes: estratega fiscal + revisor escéptico
Los agentes son solo ~10% de la pizza, pero tienen un papel preciso: evaluar. Son dos. El estratega tributario sugiere la mejor clasificación dentro de la ley; el revisor escéptico es el abogado del diablo que «te insulta antes que el contador»: intenta encontrar el fallo en tu clasificación antes de que lo encuentre un auditor real.
Estratega tributario
Lee el compendio y propone la clasificación más conveniente que aún se mantiene en el "blanco y negro". Coordina la skill de revisión.
Revisor escéptico
Adopta la voz del auditor: cuestiona cada transacción dudosa y exige una justificación antes de que el resumen salga para el contador.
💡 El review gate
El revisor escéptico es un barrera de revisión: nada llega al contador sin pasar por él. Es el mismo patrón que verás en el Support OS y en el Consulting OS: un agente adversarial que protege la salida.
Por qué aprender
Porque muestra a los agentes en el lugar que les corresponde: pocos, al final del proceso y solo para evaluar. Tiene sentido incorporar un agente aquí porque la revisión fiscal es una rutina que ya harías a mano, y el revisor escéptico te da la oportunidad de equivocarte en casa, gratis, en vez de equivocarte en la auditoría.
Conceptos clave
⚙️ Práctico: pipeline de PDF de extracto → Markdown
Hora de ponerse manos a la obra. El prompt de abajo es copy-run: pégalo en Claude Code (con tu carpeta del Tax OS abierta) y armará el flujo de trabajo raw → convertido → sintetizado del tema 3. Cambia los fragmentos marcados con <...> según tus valores.
🎯 Objetivo
Haz que Claude Code cree las tres carpetas y convierta cada extracto en PDF en un markdown limpio y un resumen mensual, sin mezclar cuentas ni escribir fuera de esas carpetas.
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.
✅ Cómo verificar que funcionó
- 1.converted/ tiene exactamente un .md por cada PDF de raw/.
- 2.Ningún valor aparece sin moneda; los convertidos están marcados con [conv].
- 3.Existen las subcarpetas personal/ e negocio/ — nada mezclado.
- 4.synthesized/resumo-2026.md muestra el total por categoría y la lista de explicaciones.
- 5.No se guardó nada fuera de las tres carpetas y no apareció ningún número de cuenta en texto claro.
💡 Siguiente paso
Después de que se ejecute el pipeline, pídele a Claude: "destila esta conversación en un slash command /extrato que recibe el mes como argumento". É o reverse meta-prompting de la Ruta 3, transformando el paso a paso en una skill reutilizable.
Por qué aprender
Porque la teoría sin ejecución se pudre. Ejecutar este copy-run materializa la porción de 34 % del contexto: terminas el módulo con el flujo de datos en marcha, listo para la skill de revisión mensual, y con el hábito de definir siempre objetivo, bloque copiable y cómo verificarlo.
Conceptos clave
✅ Resumen del módulo
Siguiente módulo:
5.2 — Sales OS 📈 (la pizza donde las herramientas y las skills llegan a la cima)