Puedes copiar mi estructura. No puedes copiar mis decisiones.
En la pieza anterior separé el trabajo con agentes en tres capas: el prompt resuelve el turno que tiene delante, el comando vuelve repetible una operación y el sistema conserva contexto, decisiones e historia. Prometí mostrar cómo se conectan.
Empiezo por la parte incómoda: la estructura se copia en una tarde.
El esqueleto completo
AGENTS.md reglas de operación del agente
ORCHESTRATOR.md qué contexto cargar según el tipo de solicitud
CLAUDE.md punto de entrada de la herramienta
DOCTRINE.md principios que cambian poco
KNOWLEDGE.md quién soy y qué restricciones son durables
ROADMAP.md prioridades vigentes
campaigns/ objetivo, métricas, criterio de éxito y de abandono
councils/ marcos de análisis por dominio
decisions/ las decisiones difíciles de revertir
reviews/ historia fechada
ideas/ lo capturado que todavía no es compromiso
.claude/commands/ las operaciones que repito
Doce entradas. Ninguna es difícil de reproducir, y si alguien quiere ese árbol funcionando esta misma tarde, puede tenerlo.
Con el árbol vacío, el agente responde exactamente igual que antes. Con más pasos intermedios.
Un esqueleto vacío no decide nada
Un DOCTRINE.md sin principios propios no frena ninguna solicitud. Un
ROADMAP.md sin prioridades reales no puede señalar que lo que estoy pidiendo
desplaza otra cosa. Un campaigns/ sin criterio de abandono escrito antes de ver
resultados no protege de nada, porque el criterio se ajusta solo cuando los
números empiezan a doler.
La estructura es la parte visible. Lo que produce el resultado son las decisiones que la llenan, y hay cuatro que nadie puede tomar en tu lugar.
1. Qué principio te va a costar algo
Un principio que nunca te ha impedido hacer lo que querías no es un principio, es decoración.
“Valida antes de construir” solo tiene valor el día que pido ponerme a construir y el sistema me devuelve la contradicción con esa línea. Si el principio está redactado para quedar bien, el agente lo va a citar sin usarlo nunca.
2. Cuál es la fuente canónica de cada dato
Cuando dos archivos dicen cifras distintas, el modelo no tiene forma de saber cuál manda. Va a elegir la más reciente, la más específica o la que aparezca primero en el contexto, y ninguna de las tres es una regla.
En mi sistema hay una sola fuente por dato y está escrita. La regla cuando dos se contradicen no es resolver el empate: es mostrar el conflicto y detenerse antes de sobrescribir.
3. Qué se puede reescribir y qué no
De todo mi sistema, una sola sección es mutable: la lista de pendientes abiertos. Se reescribe entera cada día porque su función es que ningún compromiso dependa de recordar una conversación.
El resto de la historia no se toca. Una conclusión distinta crea un archivo nuevo que enlaza al anterior. Si todo es editable, el sistema pierde lo único que un chat no te da: poder ver que cambiaste de opinión, cuándo y con qué evidencia.
4. Cuándo el sistema tiene que frenarte
Esta me costó cuatro días.
Durante la primera semana de este experimento saqué conclusiones sobre el alcance de publicaciones que llevaban horas publicadas. Que el canal se estaba cerrando. Que el contenido técnico circulaba menos. Que la conversión se había multiplicado.
Al día siguiente, una publicación de tres días atrás casi cuadruplicó su alcance y las tres conclusiones se cayeron juntas. El fallo no fue leer mal un número: fue no exigir una edad mínima antes de comparar. De ahí salió la regla que hoy está escrita en el sistema: nada se compara antes de 72 horas, y antes de eso las cifras se registran pero no se interpretan.
Esa regla no existía en ningún archivo hasta que me costó cuatro días de conclusiones falsas. Ningún template me la iba a entregar, porque nace de mi error, no de la estructura.
Por eso lo que importa no es el repositorio
El CLAUDE.md que dejé gratis es el artefacto. Se copia, se pega y funciona a
medias, porque describe reglas que sirven para mi forma de trabajar.
Lo que hace la diferencia es la entrevista que llena los archivos vacíos: qué principios son innegociables para ti, qué restricciones no se negocian aunque haya una oportunidad enfrente, qué prioridades están vigentes este trimestre, qué dato manda cuando dos fuentes se contradicen y en qué condiciones el sistema debe mostrarte que te estás contradiciendo.
Sin esa parte, quien copie la estructura recibe un esqueleto y no sabe con qué llenarlo.
El lunes publico la versión completa
Estoy terminando la versión del sistema que se puede entregar: la estructura exportada limpia, los marcos de análisis, las plantillas de decisión y de revisión, los comandos de operación y el onboarding.
El onboarding es la parte que importa y es la que más trabajo me está costando dejar en condiciones de que la use alguien que no soy yo. Es la entrevista que llena los archivos vacíos: qué principios te van a costar algo, qué restricciones no se negocian, qué prioridades están vigentes, qué fuente manda cuando dos se contradicen. Sin esa parte, entregar la estructura es entregar un esqueleto.
Sale el lunes. El aviso lo mando por correo, a la misma lista donde entrego el
CLAUDE.md comentado.
Si quieres recibirlo, empieza por ahí: descargar el material.
Artículos relacionados
Le pedí a mi agente abrir otra campaña. Me devolvió un no.
Una idea técnicamente atractiva apareció justo cuando los números incomodaban. Mi sistema de decisión hizo algo más útil que ayudarme a construirla: comparó la idea con mis prioridades y la detuvo.
Un buen prompt sigue siendo una instrucción desechable
Un prompt resuelve una tarea. Para operar trabajo repetible con agentes hacen falta instrucciones, contexto, memoria y un lugar donde guardar el resultado.
Google escribió la especificación de lo que yo hacía mal
El 12 de junio Google Cloud publicó el Open Knowledge Format. Llevo meses operando un sistema de conocimiento en Markdown con el mismo patrón, y la especificación me mostró tres cosas que hice mal. Ninguna es un detalle.