PTENES
MÓDULO 7.2 · FASE 2 DEL CAPSTONE

🎙️ Fase 2 — Vida: la entrevista que se convierte en contexto

Este es el módulo más importante de todo el curso. No es el más difícil técnicamente: es el que decide si el asistente que construiste en la Fase 1 se convierte en un empleado de verdad o se queda como un chatbot genérico con un nombre bonito. Reserva tiempo, no te apresures.

6
Temas
40
Minutos
Capstone
Nivel
Práctico
Tipo
0 de 60%
1

🧩 Por qué la entrevista importa más que cualquier técnica

¿Eres nuevo aquí? Aquí «contexto" no es un archivo cualquiera: es el conjunto de información que el agente lee antes de actuar: quién eres, a qué se dedica tu negocio, quién más participa en las decisiones y qué es urgente hoy. Sin esto, el agente no tiene de dónde sacar un criterio: solo devuelve respuestas genéricas, del tipo que cualquier chatbot le da a cualquier persona.

En la Fase 1 (módulo 7.1) montaste la casa: la carpeta, el CLAUDE.md raíz, la estructura de directorios. Ese es el esqueleto: necesario, pero vacío. La Fase 2 es lo que llena esa casa de gente: quién vive allí, qué hace cada persona, qué le importa a cada una. Es la diferencia entre entregarle una oficina vacía a un empleado nuevo y sentarte con él media hora para explicarle cómo funciona realmente la empresa.

💡 Concepto principal

La técnica sin contexto produce un agente educado, pero inútil. El contexto sin técnica es un cuaderno de notas. Juntos son lo que marca la diferencia entre «responder preguntas» y «actuar por ti».

  • •Un agente sin contexto responde «depende de tu caso» a todo, porque no conoce tu caso.
  • •Un agente con contexto real ya sabe que prefieres las reuniones cortas, que tu socia aprueba las compras de más de R$ 2 mil y que los viernes por la tarde no se envían mensajes urgentes.
Escucha
Qué hace la entrevista
Juicio
Qué le aporta al agente
Acción
En qué se convierte
Tú
Quién valida siempre
2

🙋 Área 1 — Quién eres

La primera área de la entrevista no trata sobre el negocio, sino sobre ti: tu rol, tu forma de trabajar, lo que valoras. Un asistente que no sabe si eres el dueño que decide todo por su cuenta o un gerente que responde ante otra persona se equivocará en el tono de cada recomendación que haga.

🔍 Preguntas de ejemplo

  • Rol: "¿Tomas la decisión final en las cosas del día a día o hay alguien por encima de ti que debe aprobar?"
  • Estilo de trabajo: "¿Prefieres revisar cada paso antes de que actúe o ver el resultado terminado y corregirlo después?"
  • Valores: "¿Hay algo que NUNCA aceptarías que se hiciera en tu nombre, aunque técnicamente funcionara? (ej.: prometer un plazo que no se puede cumplir, hablar mal de un competidor)"
  • Rutina real: "¿A qué hora del día sueles tomar las decisiones importantes y a qué hora solo quieres que te dejen en paz?"

💡 Consejo práctico

Las respuestas vagas del tipo "me gusta que las cosas estén bien hechas" no ayudan en nada. Pide un ejemplo concreto: "cuéntame una vez en que alguien hizo una tarea de forma incorrecta — ¿qué estaba mal exactamente?" La respuesta concreta es el material que el asistente realmente puede usar.

3

🏢 Área 2 y 3 — El negocio y el equipo

Después de ti, el asistente necesita entender qué hace que el negocio exista: qué vende, a quién y cómo entra el dinero. No es una redacción institucional, sino una explicación práctica, como se la explicarías a un sobrino de 15 años que nunca ha oído hablar de tu sector.

Y justo después viene el equipo: quién más participa en las decisiones y, sobre todo, quién decide qué. Esto evita un error clásico: que el asistente «apruebe» en tu nombre algo que en realidad era decisión de otra persona.

Pregunta "¿quién aprueba los gastos?" Respuesta "por encima de R$2k, mi socia" contexto/ quem-sou-eu.md negocio.md time-decisoes.md ... Asistente más capaz ya sabe a quién escalarlo

Leyenda: cada pregunta respondida de verdad se convierte en un archivo dentro de contexto/, y es este archivo —no la conversación que ya pasó— el que el agente vuelve a leer antes de cada tarea nueva.

🔍 Preguntas de ejemplo

  • El negocio: "Si tuviera que explicar tu negocio a alguien en una frase, ¿qué no puede faltar? ¿Y cómo entra el dinero: venta directa, suscripción, comisión?"
  • Para quién: "¿Quién es el cliente típico? ¿Puedes describir en dos o tres frases quién suele comprarte?"
  • El equipo: "Además de ti, ¿quién más participa en el día a día? ¿De qué se encarga cada persona?"
  • Quién decide qué: "¿Hay alguna decisión que solo tú tomas y nunca delegas? ¿Y alguna que decide otra persona, aunque tú estés al tanto?"
4

⏱️ Áreas 4 y 5 — Prioridades y comunicación

¿Eres nuevo aquí? Urgente e importante no son lo mismo: urgente es lo que necesita una respuesta hoy (un cliente enojado, una cuenta por vencer); importante es lo que cambia el rumbo del negocio, aunque no haya prisa (planificar el próximo trimestre). Un asistente que confunde ambas cosas se convierte en una sirena de falsas alarmas, o, peor aún, ignora lo que realmente merecía atención.

El área de comunicación define el «acento» del asistente: cuándo debe resumir en una línea y cuándo debe dar detalles; si el tono es formal o informal; si envía un mensaje al final del día o solo cuando se lo pidas.

🔍 Preguntas de ejemplo

  • Prioridades: "¿Qué está en llamas esta semana? ¿Y qué es importante, pero puede esperar un mes?"
  • Urgencia real: "¿Qué cosas de tu rutina realmente merecen interrumpirte en el momento y cuáles pueden esperar hasta el final del día?"
  • Tono: "Cuando lees un resumen, ¿prefieres que vaya directo al grano ('faltan 3 días, resuélvelo') o prefieres todo el contexto antes de la conclusión?"
  • Cuándo ser breve o detallado: "¿En qué tipo de temas solo quieres el resultado y en cuáles quieres ver todo el razonamiento antes de confiar?"

✓ Respuesta útil

  • ✓"De verdad, solo es urgente cuando un cliente se queja o un pago vence hoy."
  • ✓"Envíame un resumen de 3 líneas a las 18 h; si se trata de una decisión de dinero, avísame en el momento."

✗ Respuesta que no ayuda

  • ✗"Todo es más o menos urgente, depende."
  • ✗"Prefiero que use su criterio" (el criterio no se convierte en un archivo: se convierte en una suposición).
5

🔐 Área 6 — Qué delegar y el prompt que guía la entrevista

La última área es la más delicada: lo que puede hacer el asistente solo, y lo que necesita tu aprobación antes de empezar a ejecutar. Esto se conecta directamente con los permisos que ya configuraste en el módulo 0.6: aquí traduces esas reglas técnicas al lenguaje de negocio: "puede responder correos simples por su cuenta, pero solo después de que yo apruebe los presupuestos superiores a R$ 500."

🔍 Preguntas de ejemplo

  • "¿Qué tipo de tarea confiarías a ciegas, sin revisarla antes?"
  • "¿Qué tipo de tarea NUNCA puede hacerse sin tu aprobación, aunque parezca obvio?"
  • "¿Hay algún monto que sirva como límite (por encima de ese monto, siempre pedir aprobación)?"

Ahora viene el bloque práctico de esta fase: un prompt completo, listo para pegar en Claude Code, para que él mismo conduzca esta entrevista contigo —pregunta por pregunta, área por área— y guarde los archivos de contexto en el lugar correcto.

Objetivo: generar los archivos de contexto guiando la entrevista COPY-RUN
Você vai conduzir comigo uma entrevista estruturada para gerar os arquivos de
contexto do meu assistente digital, dentro da pasta contexto/ do meu projeto
.

Regras da conversa:
- Faça UMA pergunta de cada vez. Espere minha resposta antes de seguir.
- Se minha resposta ficar vaga ou genérica, peça um exemplo concreto antes
  de continuar (ex.: "me dá um caso real que isso aconteceu").
- Não invente nada que eu não te disse. Se eu não souber responder algo
  agora, anote como "em aberto" e siga em frente.
- Ao final de cada área, mostre um resumo do que você entendeu e pergunte
  se está correto antes de salvar.

Cubra estas 6 áreas, nesta ordem, uma pergunta por vez dentro de cada:

1. QUEM SOU EU — meu papel, meu jeito de trabalhar, meus valores e o que eu
   nunca aceitaria que fosse feito em meu nome.
2. O NEGÓCIO — o que ele faz, para quem, como o dinheiro entra.
3. O TIME — quem mais participa, quem decide o quê.
4. PRIORIDADES — o que é urgente essa semana vs. o que é importante mas
   pode esperar.
5. COMUNICAÇÃO — tom, formalidade, quando eu quero resumo curto e quando
   quero o detalhe todo.
6. O QUE DELEGAR — o que você pode fazer sozinho, e o que precisa da minha
   aprovação antes de agir (inclua uma linha de valor em dinheiro se eu
   te der uma).

Ao terminar cada área, salve um arquivo Markdown separado dentro de
contexto/ (ex.: contexto/quem-sou-eu.md, contexto/negocio.md,
contexto/time-decisoes.md, contexto/prioridades.md, contexto/comunicacao.md,
contexto/delegacao.md). NÃO junte tudo em um arquivo único — arquivos
separados por área facilitam eu revisar e atualizar cada um depois.

Antes de escrever qualquer arquivo, me avise que vai escrever e mostre
o conteúdo. NUNCA inclua senha, chave de API, token ou dado pessoal de
terceiros nesses arquivos — se eu mencionar algo assim sem querer, avise
e sugira remover.

Comece pela área 1, pergunta 1.

Cómo verificar: al final, abre la carpeta contexto/ y verifica que existan 6 archivos separados (uno por área), cada uno con respuestas concretas —no genéricas— y sin datos sensibles.

🔒 Aviso de privacidad — obligatorio

Estos archivos están en una carpeta local de tu computadora — NO se suben a ningún lugar a menos que tú lo decidas (por ejemplo, si haces una copia de seguridad en la nube en el módulo 7.5). Aun así, nunca pongas en ellos:

  • ✗Contraseñas, claves de API, tokens de acceso — eso va en una variable de entorno (módulo 4.4), nunca en texto suelto.
  • ✗Datos personales de terceros sin consentimiento (CPF, dirección, salud de clientes o empleados), aunque parezca «solo un ejemplo».
  • ✗Cualquier cosa que no le mostrarías a un empleado nuevo el primer día.
6

🔁 La entrevista nunca "termina" del todo

La primera ronda es la más larga: cubre las 6 áreas de una vez, con calma. Pero tu negocio cambia: se incorpora gente nueva al equipo, las prioridades de un trimestre no son las del siguiente, te das cuenta de que delegaste demasiado (o demasiado poco) una tarea. La entrevista vuelve en revisiones puntuales, no en maratones repetidas.

1

Primera ronda — amplia

Las 6 áreas completas, con el prompt de este módulo. Reserva unos 40 minutos, sin prisa: aquí es donde nace la mayor parte del valor.

2

Primeras semanas — ajustes finos

En la práctica, notas que el resumen diario es demasiado largo o que el asistente pidió aprobación para algo que podía haber hecho por su cuenta. Vuelves al archivo de esa área específica y lo ajustas.

3

Hitos del negocio — revisión puntual

¿Contrataste a alguien, cambiaste de proveedor o empezó una temporada alta? Es hora de revisar time-decisoes.md o prioridades.md — no el archivo entero, solo el área que cambió.

4

Continuo — nunca "cerrado"

No existe una versión final. El contexto acompaña la vida del negocio: precisamente eso es lo que la Fase 5 (Backup y control de versiones, módulo 7.5) ayuda a mantener en orden con el tiempo.

✓ Entrevista bien hecha

  • ✓Respuestas concretas, con un ejemplo real ("el cliente X llamó para quejarse por un retraso")
  • ✓6 archivos separados por área — fáciles de encontrar y actualizar
  • ✓Una explicación clara de qué necesita aprobación

✗ Entrevista apresurada

  • ✗Respuestas genéricas ("me gusta que todo esté organizado") sin ejemplos
  • ✗Un único archivo gigante que mezcla las 6 áreas
  • ✗Ninguna regla de aprobación: por defecto, el asistente decide todo por sí solo

💡 Consejo práctico

Después de la primera ronda, vuelve a leer los 6 archivos en voz alta como si se los explicaras a un empleado de verdad. Si alguna frase suena extraña al decirla en voz alta, probablemente también sea demasiado vaga para el agente.

Verificación rápida (opcional): ¿por qué separar los archivos de contexto por área, en vez de usar un único archivo?

✅ Resumen del módulo

✓
El contexto es lo que marca la diferencia entre ejecutar y solo conversar: sin él, el asistente es un chatbot genérico.
✓
6 áreas lo cubren todo: quién eres, negocio, equipo, prioridades, comunicación, qué delegar.
✓
El prompt copy-run guía la entrevista por ti y ya guarda los archivos separados en contexto/.
✓
Nunca incluyas datos sensibles en estos archivos — se quedan en local, pero el cuidado depende de ti.
✓
La entrevista se repite para hacer ajustes puntuales, nunca «termina» del todo.

Próximo módulo:

7.3 — Fase 3: Manos, dándole al asistente las herramientas para actuar sobre el contexto que acaba de aprender.