PTENES
MÓDULO 7.1

🏠 Fase 1 — Casa: dónde vive tu asistente digital

Antes de darle cualquier tarea real, tu asistente necesita una dirección fija: una carpeta propia y organizada, con un archivo de instrucciones que lee por sí solo cada vez que empieza a trabajar. Este módulo construye esa base: los cimientos sobre los que se apoyarán las fases 2, 3 y 4 del capstone.

6
Temas
30
Minutos
Principiante
Nivel
Práctico
Tipo
0 de 60%
1

🏠 Por qué tu asistente necesita una casa propia

¿Eres nuevo aquí? Una carpeta (también llamada directorio) es solo un “cajón” dentro de tu computadora donde se guardan juntos los archivos. Una carpeta puede tener otras carpetas dentro — como un cajón con divisiones. A lo largo del curso ya usaste carpetas de proyecto independientes para cada Build. Ahora es diferente: vas a crear UNA carpeta fija, que se convertirá en la dirección permanente de tu asistente digital.

Piénsalo así: hasta aquí, Claude Code fue una herramienta independiente — la abrías en una carpeta, resolvías algo y la cerrabas. A partir de esta Trilha 7, se convierte en un empleado digital de verdad: y todo empleado de verdad tiene un escritorio fijo, con sus propios cajones, donde guarda lo que necesita para trabajar todos los días. Sin ese escritorio, vuelve a aprenderlo todo desde cero en cada conversación; con él, llega, lee lo que está guardado allí y ya sabe en qué quedó la última tarea.

💡 Concepto principal

La «casa» es una carpeta única y permanente en tu computadora, no una carpeta de proyecto que borras después. Guarda quién eres, cómo debe trabajar el asistente, qué está haciendo ahora y el historial de lo que ya se decidió.

  • •Sin hogar: cada sesión empieza desde cero, tienes que volver a explicarlo todo.
  • •Con todo preparado: el asistente abre la carpeta, lee el CLAUDE.md (tópico 3) y ya entiende el contexto.

✓ Empleado con escritorio propio

  • ✓Tiene un lugar fijo para guardar contexto, decisiones y material de apoyo
  • ✓Consulta el historial antes de repetir una pregunta que ya respondiste
  • ✓Sabes exactamente dónde buscar lo que ya hizo

✗ Herramienta aislada

  • ✗Cada conversación está en una carpeta diferente, sin hilo conductor
  • ✗Vuelves a explicar a qué se dedica tu negocio cada vez que necesitas algo
  • ✗No queda nada registrado: las decisiones se pierden entre sesiones
2

🗂️ El mapa de la carpeta: seis cajones con una función cada uno

Dentro de la casa, no dejas todo suelto: lo separas en subcarpetas, cada una con una función clara. Seis son suficientes para empezar; ninguna requiere nada complejo, solo disciplina para poner cada cosa en el lugar correcto:

📁 mi-asistente/ el hogar — carpeta raíz 📄 CLAUDE.md — el índice 📁 contexto/ quién eres, negocio, equipo 📁 reglas-y-skills/ cómo debe trabajar 📁 proyectos/ lo que está haciendo ahora 📁 registro-de- decisões/ historial de "por qué" 📁 referencias/ materiales de apoyo 📁 archivo/ cosas antiguas — nunca eliminar El CLAUDE.md queda arriba y APUNTA a cada cajón; no copia su contenido dentro de él

Leyenda: la raíz de la casa guarda un único archivo de instrucciones (CLAUDE.md) y seis subcarpetas con funciones fijas — cada material tiene su cajón y el índice sabe dónde está cada uno.

🔍 Por dentro de cada cajón

  • contexto/ — quién eres, a qué se dedica tu negocio, quiénes integran el equipo (ej.: negocio.md, time.md).
  • reglas-y-skills/ — cómo debe comportarse el asistente: tono de voz, procesos fijos, las skills que usa.
  • proyectos/ — una subcarpeta por cada proyecto activo, con lo que está en curso ahora.
  • registro-de-decisiones/ — un historial fechado de lo que se decidió y por qué (evita preguntarse "¿por qué lo hicimos así?").
  • referencias/ — materiales de apoyo: hojas de cálculo modelo, enlaces, PDFs, capturas de pantalla.
  • archivo/ — ¿Eres nuevo aquí? "Archivar" es guardar algo que ya no está activo sin borrarlo; puede ser útil más adelante. Nunca elimines lo que se haya movido aquí.
3

📇 CLAUDE.md como índice, no como depósito

¿Eres nuevo aquí? O CLAUDE.md es un archivo de instrucciones — un archivo de texto simple que Claude Code lee automáticamente cada vez que abres esa carpeta, sin que tengas que pedírselo. Es como dejar una nota fija en la entrada del escritorio del empleado: "antes de empezar, lee esto".

El error más común es tratar el CLAUDE.md como un depósito: pegar todo dentro —todo el historial de decisiones, todos los detalles del negocio, todas las reglas. Crece y crece hasta convertirse en un archivo enorme que el asistente lee completo cada vez, dedicando tiempo y atención a partes que no tienen que ver con la tarea del momento. Lo correcto es lo contrario: el CLAUDE.md queda conciso e señala a los archivos correctos dentro de las subcarpetas — es el índice del libro, no el libro entero.

# CLAUDE.md — meu-assistente/

## Quem eu sou
Ver `contexto/negocio.md` (o que a empresa faz) e `contexto/time.md` (quem é quem).

## Como trabalhar
- Tom de voz e regras fixas: `regras-e-skills/tom-de-voz.md`
- Skills disponíveis: `regras-e-skills/skills.md`
- Nunca publicar nada sem eu revisar antes (regra permanente)

## O que está ativo agora
Ver `projetos/` — cada subpasta é um projeto em andamento com seu próprio status.

## Decisões importantes
Antes de sugerir mudar algo já decidido, checar `registro-de-decisões/` —
pode já ter sido discutido e descartado por um motivo.

## Nunca fazer
- Não colocar senha, chave de API ou dado de terceiro em nenhum arquivo desta pasta
- Não apagar nada de `arquivo/` sem eu pedir

Ejemplo real y conciso: menos de 20 líneas, y cada sección apunta al archivo correcto en vez de contener todo el contenido.

💡 Consejo práctico

Regla práctica: si una sección del CLAUDE.md supera las 5-6 líneas de contenido real (sin contar los enlaces), es señal de que ese contenido debería pasar a un archivo separado en una subcarpeta, dejando solo una línea de referencia en el índice.

4

🧭 Paso a paso: construye la casa en la práctica

No necesitas crear las carpetas una por una a mano: es más rápido (y más confiable) pedirle al propio Claude Code que arme toda la estructura de una sola vez. Los pasos de abajo muestran el orden lógico, y el bloque copy-run que viene después lo hace todo automáticamente.

1

Elige el lugar y crea la carpeta raíz

Un lugar fijo en tu computadora, fuera de las carpetas temporales — p. ej., dentro de la carpeta «Documentos», una carpeta llamada meu-assistente.

2

Crea las seis subcarpetas del tema 2

contexto, reglas-e-skills, proyectos, registro-de-decisões, referencias, archivo: todas vacías por ahora, cada una con un papel ya definido.

3

Escribe el CLAUDE.md inicial

Simple, apuntando a las subcarpetas, aunque todavía estén casi vacías. Completarás el contenido real en la Fase 2 (módulo 7.2).

4

Abre Claude Code dentro de esa carpeta y comprueba

Pregunta "¿qué entiendes de esta carpeta?" — si describe correctamente la estructura, se está leyendo el CLAUDE.md.

Objetivo

Pedirle a Claude Code que cree la carpeta raíz, las seis subcarpetas y un CLAUDE.md inicial — todo de una vez, en un único prompt.

Bloque para copiar

Crie uma pasta chamada  dentro de .
Dentro dela, crie estas seis subpastas vazias:
contexto, regras-e-skills, projetos, registro-de-decisões, referências, arquivo.

Depois, crie um arquivo CLAUDE.md na raiz dessa pasta com este conteúdo:
um índice curto (menos de 25 linhas) que aponta para cada subpasta, explicando
em uma linha o que cada uma guarda (use o texto do módulo 7.1 do curso
"Seu Funcionário Digital" como referência de estilo — enxuto, sem detalhes
que deveriam estar nos arquivos de dentro das subpastas). Inclua uma seção
"Nunca fazer" avisando para nunca colocar senha, chave de API ou dado de
terceiro em nenhum arquivo desta pasta.

Ao final, me mostre a árvore de pastas criada.

Cómo verificar

Abre la carpeta en el explorador de archivos (Finder/Explorador) y comprueba: una carpeta raíz, seis subcarpetas con los nombres correctos y un CLAUDE.md legible en la raíz. Vuelve a abrir Claude Code allí y pregúntale qué entiende de la carpeta; la respuesta debe mencionar la estructura.

5

⚠️ Errores comunes y lo que nunca debes poner en la casa

Dos errores derriban la casa antes incluso de que llegue a levantarse: poner todo en un solo archivo y dejar que el CLAUDE.md se infle. Ambos tienen la misma raíz: la pereza de separar; y ambos empeoran con el tiempo, no mejoran por sí solos.

✗ Todo en un solo archivo

  • ✗Un único "notas.txt" con negocio, decisiones y proyectos mezclados
  • ✗Después de un mes, cuesta encontrar cualquier cosa
  • ✗El asistente necesita leer todo para encontrar un detalle pequeño

✓ Estructura organizada

  • ✓Cada tipo de información en la subcarpeta correcta (tema 2)
  • ✓Encontrar algo es abrir el cajón correcto, no leerlo todo
  • ✓El asistente solo lee el archivo relevante para la tarea

✗ CLAUDE.md gigante

  • ✗200 líneas con todo el historial pegado dentro
  • ✗La información antigua y desactualizada se pierde entre el resto
  • ✗El asistente pierde tiempo procesando lo que no importa ahora

✓ Conciso y directo

  • ✓Menos de 25 líneas, cada sección con un enlace al archivo correcto
  • ✓Fácil de revisar todo de un vistazo
  • ✓El asistente va directamente al archivo que necesita para la tarea

🔒 Privacidad — lo que NUNCA va a la casa

La casa se guarda localmente en tu computadora (no se envía a ningún servidor por sí sola), pero eso no es motivo para descuidarla. Nunca pongas en ningún archivo de esta carpeta:

  • •Contraseñas o claves de API (de cualquier servicio)
  • •Datos personales de clientes o de terceros (CPF, correo electrónico, teléfono sin consentimiento)
  • •Números de tarjetas, contratos confidenciales, información financiera sensible

Si algún día se comparte esa carpeta, se sincroniza con un servicio en la nube o se versiona en un repositorio (Trilha 7, módulo 7.5), todo lo sensible que haya dentro también se compartirá.

6

📈 Cómo evoluciona la casa — y qué viene después

La casa no viene lista desde el principio: crece con el uso. Lo importante es que la estructura de los seis cajones permita ese crecimiento sin convertirse en un desorden, porque cada cosa nueva ya tiene un lugar definido.

Día 1 — Casa creada

Seis subcarpetas casi vacías y un CLAUDE.md conciso que apunta a ellas. Solo el esqueleto (este módulo).

Semana 1 — Contexto completado

contexto/ recibe los primeros archivos reales sobre el negocio y el equipo (módulo 7.2).

Semana 2-3 — Proyectos y manos a la obra

proyectos/ acumula subcarpetas activas; reglas-e-skills/ incorpora las skills del módulo 7.3.

Mes 1 — Primeras archivadas

Los proyectos terminados pasan de proyectos/ a archivo/; registro-de-decisões/ ya tiene un historial útil.

Mes 3+ — Sistema consolidado

La estructura se mantiene igual — solo creció el contenido dentro de cada cajón. Esa es la señal de que el diseño del módulo 7.1 funcionó.

🎯 Concepto principal

  • •7.1 construye la casa (aquí) → 7.2 llena la vida (contexto real) → 7.3 le da manos (skills) → 7.4 permite crecer.
  • •La estructura de carpetas no cambia después — solo el contenido dentro de ella.

Verificación rápida (opcional): ¿cuál es el papel adecuado de CLAUDE.md?

✅ Resumen del módulo

✓
Por qué una casa: carpeta fija y permanente, no una carpeta de proyecto suelta.
✓
Seis cajones: contexto, reglas-e-skills, proyectos, registro-de-decisões, referencias, archivo.
✓
CLAUDE.md: índice conciso que apunta a los archivos correctos: nunca un depósito.
✓
Privacidad: las contraseñas, las claves de API y los datos de terceros nunca van en la carpeta.

Próximo módulo:

7.2 — Fase 2: Vida, llenando el contexto/ con quien realmente eres