Quickstart

Cómo construir
tu propio Agnes

Una guía para configurar tu sistema de trabajo con IA en Claude o Codex. Tres sesiones de trabajo. Cada una termina con algo que ya puedes usar.

Qué es Agnes

Un sistema de gestión estratégica que vive como archivos de texto plano en una carpeta. Tu herramienta de IA lee esos archivos al inicio de cada sesión y actúa como interlocutor con contexto acumulado.

Para qué sirve

Tener un lugar donde las decisiones, preguntas, oportunidades y aprendizajes queden conectados entre sí — no dispersos en docs sueltos o en tu cabeza.

Este documento

Una guía de setup. El sistema se construye mientras lo usas: cada sesión produce algo útil y deja el sistema un paso más avanzado. No hay setup previo.

Starter Kit — todo lo que necesitas para empezar
Carpeta con estructura base, plantillas y 8 funciones preconfiguradas, incluyendo /holi para el setup inicial. Descomprime, renombra si quieres y abre la carpeta en Claude o Codex.
Descargar ZIP
Requisitos
Claude Code o Codex — elige una herramienta que pueda trabajar con archivos en una carpeta local Una carpeta propia — empieza sin información confidencial y agrega contexto gradualmente
Entorno agéntico — lee antes de empezar

Claude Code y Codex son agentes con acceso a los archivos de la carpeta donde trabajan. Pueden leerlos, crearlos y modificarlos. Antes de usarlos, asegúrate de tener los permisos necesarios en tu organización, especialmente si vas a incluir información sensible o confidencial.

Las tres sesiones de setup
Sesión 1 Primera pregunta estratégica 60–90 min
Qué produce esta sesión
  • CLAUDE.md — instrucciones de rol, tono y protocolo generadas por /holi
  • vision.md y preguntas-abiertas.md — con tu contexto y primera pregunta
  • Una respuesta a la pregunta estratégica que elijas

El starter kit ya incluye la estructura base. Esta sesión arranca con /holi, un script que configura el sistema en 10 minutos mediante preguntas guiadas. Después, la primera pregunta estratégica real.

  • Elegir, instalar e iniciar sesión en una herramienta: Claude Code —también disponible con interfaz gráfica— o Codex en la aplicación de escritorio. Si prefieres terminal, consulta la guía de Codex CLI.
  • Descargar y descomprimir agnes-base.zip. Renombra la carpeta si quieres; ese será el hogar de tu sistema.
  • Abrir la carpeta como proyecto o espacio de trabajo local. Si usas terminal: cd mi-sistema y luego claude o codex.
  • Escribir /holi y responder las preguntas — al terminar, el sistema genera tu CLAUDE.md personalizado
  • Con el sistema configurado, traer una pregunta estratégica real: "Voy a contarte más sobre mi trabajo. A partir de lo que te cuente, completa vision.md y preguntas-abiertas.md, y luego ayúdame con esta pregunta: [tu pregunta real]. Contexto adicional: [3–4 oraciones sobre lo que haces]."
  • Leer los archivos generados y ajustar lo que no refleje bien tu realidad
  • Escribir /guardar — el sistema propone qué guardar en el log y qué archivos actualizar, y lo ejecuta tras confirmación
Al terminar esta sesión

El sistema está configurado con tu contexto. Tu agente tiene instrucciones personalizadas y los primeros archivos tienen contenido real.

Sesión 2 Primera decisión difícil ~60 min
Qué produce esta sesión
  • Una decisión postergada, analizada y registrada
  • strategy.md — prioridades reales del periodo
  • logs/[fecha].md — primer registro de conversación

Trae una decisión que llevas días o semanas postergando. El agente ya tiene el contexto de la sesión anterior: esta vez conectará la decisión con lo que ya sabe de tu trabajo. Al final, el razonamiento queda documentado.

  • Abrir tu herramienta en la misma carpeta y traer la decisión: "Basándote en lo que ya sabes de mí, ayúdame a pensar esta decisión: [la decisión]. A medida que conversamos, ve construyendo strategy.md con las prioridades que vayan emergiendo."
  • Al terminar, pedirle: "Guarda el log de esta sesión en logs/[fecha de hoy].md y registra la decisión en decisiones.md"
  • Revisar los archivos generados y corregir lo que no capture bien el razonamiento
  • Escribir /guardar para archivar la conversación en el log del día
Al terminar esta sesión

La decisión está tomada y documentada con su contexto. El sistema tiene su primera estrategia del año y su primer log de conversación.

Sesión 3 Primer proyecto o apuesta 45–60 min
Qué produce esta sesión
  • Tu primer proyecto o apuesta registrado en el sistema
  • proyectos/_index.md y proyectos/[nombre]/overview.md actualizados
  • Verificación de que el sistema funciona de extremo a extremo

El sistema ya está configurado. Esta sesión prueba que todo funciona: trae un proyecto, una apuesta o algo que quieres explorar, y deja que tu agente lo estructure y lo conecte con lo que ya existe.

  • Abrir una nueva sesión en la misma carpeta — verificar que el agente lee los archivos del sistema antes de responder
  • Traer un proyecto o apuesta que estés evaluando: "Quiero trabajar sobre este proyecto o apuesta: [descripción]. Ayúdame a pensar si tiene sentido dado lo que ya sabes de mí y, si decidimos registrarlo, crea su overview en proyectos/ y actualiza el índice."
  • Al terminar, escribir /guardar — el sistema propone cómo archivar la conversación en el log del día
  • Confirmar la propuesta de /guardar y revisar que logs/ tenga el archivo del día y que los índices estén actualizados
Al terminar esta sesión

El ciclo completo funciona: pregunta → respuesta → archivos actualizados → log. El sistema tiene contexto acumulado de tres sesiones reales.

Después del setup

Cómo usar el sistema

El sistema no agrega tiempo al día. El tiempo que ahorras en búsqueda de contexto y en reconstruir decisiones pasadas supera con creces el tiempo que toma mantenerlo.

1
Trae los problemas reales
Cuando tengas una decisión difícil o una pregunta sin respuesta, abre tu herramienta en esta carpeta en lugar de empezar un documento desde cero. El agente lee el contexto acumulado antes de responder.
2
Cierra con /guardar
Al terminar una conversación útil, escribe /guardar. El sistema identifica qué cambió, propone los archivos que corresponden y genera el log tras tu confirmación.
3
El contexto se acumula solo
En la siguiente sesión, el agente lee los archivos actualizados y arranca desde donde quedaron. No hay que repetir antecedentes ni reconstruir el estado del trabajo.
Skills recomendados

8 funciones para empezar

Son instrucciones reutilizables que se activan con /nombre. No tienes que aprenderlas todas el primer día: empieza con /holi y /guardar. El ZIP incluye las ocho listas para usar.

/holi
Hace el setup inicial mediante preguntas guiadas y convierte la plantilla en tu propio sistema.
/guardar
Propone cómo archivar una conversación útil y actualiza los archivos después de tu confirmación.
/novedades
Revisa cabos sueltos y te hace tres preguntas priorizadas para recuperar el hilo.
/rumiar
Conecta información dispersa y encuentra ideas no obvias dentro del contexto acumulado.
/podar
Consolida los logs cronológicos en memorias organizadas por tema.
/mantenimiento
Revisa inconsistencias, archivos desactualizados y oportunidades para simplificar el sistema.
/alucinar
Proyecta tu trabajo tres a cinco años para descubrir apuestas más ambiciosas.
/noticias
Construye un digest de noticias según tus fuentes y el contexto actual del sistema.
Mantenimiento
Cada 3–4 semanas · ~1 hora Calibración del sistema

Una revisión periódica para que los archivos no se queden detrás de la realidad. El sistema solo es útil si refleja lo que está pasando — no lo que pasaba hace dos meses.

  • Ejecutar /mantenimiento y revisar junto al agente qué está desactualizado, qué sobra y qué contradicciones existen entre los archivos y la realidad.
  • Revisar preguntas-abiertas.md — ¿alguna pregunta tiene respuesta ya?
  • Si algo se volvió rutina, crear un skill para manejarlo con /nombre
Progreso
0%