talaia
talaia

Tú diriges. La IA construye.
Tu nombre responde de ello.

Talaia es un estándar human-in-charge para el trabajo hecho con IA, y todo lo que afirma cabe en una línea: la máquina puede producir el trabajo; solo una persona puede responder de él. Le da a esa persona un certificado que firmar (bajo una publicación, al pie de un informe, en un commit) y un método que hace honesta la firma.

Leer el manifiestoAplicarlo, solo o en equipoLlevar talaia a tu empresa

English · Español · Català

Manifiesto

Introducción

La IA generativa produce respuestas más deprisa de lo que las personas tardan en pensarlas. Cuando generar sale más barato que pensar, se impone la ley del mínimo esfuerzo: la IA propone, la persona acepta, y la velocidad empieza a sustituir al pensamiento.

Esto trae riesgos fáciles de pasar por alto:

  • El juicio se aleja de la persona. Cuanto más deprisa produce la máquina, más fácil es dejar de cuestionar, de explorar y de decidir con deliberación.
  • La responsabilidad se diluye. Sale trabajo que nadie entiende del todo: código, un informe, una publicación. Cuando falla, «lo escribió la IA» no explica nada: una máquina no puede hacerse cargo de un resultado.
  • La comprensión se erosiona. Los tests pasan, los borradores no se leen y la gente da por bueno lo que no sabe explicar.
  • El diseño se erosiona. La IA es buena produciendo piezas localmente plausibles, pero la plausibilidad local no es coherencia global. Sin alguien que sostenga la intención, la estructura empieza a acumularse en lugar de diseñarse.
  • La apariencia sustituye al valor. El trabajo generado suele parecer completo y correcto, pero parecer correcto no es lo mismo que ser útil, verdadero o digno de hacerse.
  • Los controles existentes se debilitan. Las revisiones, los roles y las definiciones siguen importando, pero tienen que evolucionar cuando las máquinas hacen una parte importante del trabajo.

Nada de esto es un argumento contra la IA. Es un argumento en contra de rendir el juicio a la velocidad.

La IA debería abaratar la producción, no volver opcional el pensamiento.

La pregunta no es si la IA produce el trabajo. Es quién sigue al mando de él.

Qué defendemos

talaia se apoya en una convicción sencilla: la persona humana va primero, y ninguna herramienta puede ocupar el lugar del juicio ni de la responsabilidad humanos.

Dos tipos de torre lo dicen mejor que nosotros.1 Babel: una sola torre, una sola dirección, una sola lengua para todos, levantada hacia arriba en la creencia de que la escala misma era progreso; y cuando cayó, nadie entendía a nadie ni podía explicar qué se había construido. Y las talaies2: las torres de vigía bajas que jalonan la costa mediterránea. Nadie las levantó desde arriba; cada una la construyó un pueblo para vigilar su propio trozo de mar. En cada una hay una persona que responde de lo que ve, y la alarma pasa de torre en torre con fuego. La elección que tenemos delante no es «sí» o «no» a la tecnología; es cuál de las dos torres estamos construyendo: Babel (una sola torre, toda escala, nadie que responda) o las talaies (muchas torres pequeñas, cada una vigilada). La torre de vigía no detiene el mar. Alguien en ella vigila, y responde de lo que pasa.

Manteniendo ese orden, valoramos:3

El juicio humano por encima de la autonomía de la máquina
Una persona que responde por encima de un sistema sin dueño
Entender lo que sale por encima de aceptar lo que funciona
El diseño deliberado por encima de la acumulación generada
Saber cuándo no usarla por encima de usarla porque está ahí
El trabajo que sirve a las personas por encima del que solo parece completo

Una herramienta sirve mejor cuando fortalece a la persona que trabaja, y falla en el momento en que la invita a dejar de estar presente.

talaia se adhiere por completo a The Pro-Human AI Declaration, que también la inspiró.

Qué es la IA

En talaia sabemos que la IA es software, y solo software. No está viva: no tiene una inteligencia ni una percepción comparables a las de una persona, ni espíritu, ni deseos propios. No entiende lo que produce. Imita el lenguaje, el análisis, incluso la empatía y el cuidado, y la imitación puede ser útil; pero su aprendizaje es un ajuste estadístico sobre datos, no el crecimiento de alguien formado por decisiones, errores y tiempo. Y no es neutral: sus respuestas llevan las decisiones y los supuestos de las pocas personas que la diseñaron y entrenaron, así que lo que suena a hecho puede ser su opinión.

Eso hace de talaia algo más que una propuesta sobre cómo trabajar con IA. Es una defensa del trabajo humano con IA: frente a las formas de trabajar que diluyen la responsabilidad, y frente a la sustitución de la gracia, el talento y la personalidad humanos. La IA debería aumentar nuestra inteligencia, a través de la herramienta, no sustituirla. Tenemos mucho más que aportar a este mundo.

Al principio que se sigue de esto lo llamamos human-in-charge: una persona al mando.

Human-in-charge

El principio

Human-in-charge significa que todo uso de la IA tiene una persona al mando: alguien que decidió que existiera, diseñó cómo funciona, lo entiende y responde de él con su nombre. No es una persona puesta en el camino de un sistema para aprobar cada cosa que el sistema produce. Es una persona que está detrás del sistema mismo.

Pensemos en un proceso que usa IA para clasificar mil correos al día. Nadie necesita leer, comprobar y entender mil clasificaciones; eso desharía la razón de haberlo construido. Lo que tiene que ser cierto es que una persona sabe decir para qué sirve el proceso y qué valor aporta, cómo está construido y dónde está la IA en él, qué puede salir mal y qué pasa cuando sale mal, y que el resultado es suyo. La máquina puede actuar mil veces sin que nadie mire. Nunca actúa por su propia autoridad: actúa con la autoridad de la persona que la puso ahí, dentro de los límites que esa persona trazó.

Estar al mando se sostiene en tres niveles, y ninguno de ellos es la salida de una automatización:

  • Responsabilidad. Una persona con nombre responde de lo que hace el sistema, también de lo que hace cuando nadie mira.
  • Diseño. Una persona decidió qué se entrega a la máquina y qué no, conociendo los riesgos y el valor. La estructura se diseñó, no se acumuló.
  • Comprensión. Una persona entiende el código y la estructura que sostienen la IA, y sabe explicar cómo funcionan y por qué sin ayuda de una IA.

Lo sostenemos como una creencia, no como una propuesta. El daño que puede hacer la IA solo se evita cuando todo uso de la IA tiene a una persona al mando, sin excepción, como una obligación y no como una recomendación.

Cómo aplicarlo

La responsabilidad no se le arrebata de golpe a una persona: se cede poco a poco, una delegación sin examinar tras otra, hasta que no queda nada. Cada paso es cómodo. El sistema va moldeando sin hacer ruido cómo trabajamos y cómo decidimos; lo aceptamos hasta que dejamos de verlo, y lo que alguien construyó acaba pareciendo inevitable.4 Lo que se pierde por el camino es la soberanía cognitiva: el juicio propio de una persona. La defensa es la fricción:

  • Detenerse y preguntar quién decidió que esto se entregara a la máquina, y con qué medida sus respuestas cuentan como correctas.
  • Seguir decidiendo, deliberando y dudando, aunque pensar canse y la máquina no se canse.
  • No seguir a ningún oráculo. Ningún gurú, modelo o algoritmo puede cargar con la responsabilidad de elegir.
  • No delegar lo que no se puede optimizar ni reducir a un cálculo.

talaia lo hace practicable llevando el manifiesto y el Certificado de Comprensión a cada trabajo en el que se usa la IA. El manifiesto es el marco y el certificado es la práctica, y se firma sobre lo que hace una persona (el código, la estructura, el diseño de la automatización). Donde no hay un nombre, nadie está al mando.

El Certificado de Comprensión

El Certificado

El Certificado de Comprensión (Certificate of Understanding) es una herramienta para aplicar el manifiesto y el principio human-in-charge en el día a día, para quienes trabajan con IA. Sus afirmaciones quieren resumir la parte accionable del manifiesto.

El texto, con la forma del DCO,5 se publica solo en inglés, su versión canónica:

Certificate of Understanding
Version 1 — talaia.dev/certificate

By signing off on this work, I certify that:

(a) The work was created, in whole or in part, with the
    assistance of an AI, at my direction and to a brief
    that was mine; and

(b) I have read the work in full; I understand what it
    says and why, and can explain it without the help of
    an AI; I have checked what it claims, and its
    opinions and assumptions are mine; and I take
    responsibility for the work and make it my own.

I sign this in keeping with the talaia manifesto: talaia.dev

Dos cláusulas, y la firma significa las dos a la vez: la máquina estuvo aquí, y una persona responde de lo que hizo.6

Contra la coautoría

El certificado registra asistencia, nunca coautoría. Autor no es quien produjo las palabras, sino quien está detrás de ellas. Ser autor es querer decir algo y que se te pidan cuentas por ello. Eso exige un yo con algo en juego, y una máquina no lo tiene.

Algunas herramientas dicen lo contrario. Claude Code, por defecto, termina los commits que escribe con un trailer de git que nombra a la máquina como autora:

Co-Authored-By: Claude <[email protected]>

Estamos en contra de ese uso y de esa definición. El trailer no es solo una etiqueta: GitHub y otros lo leen y muestran a la máquina junto a la persona, como autora del cambio. Llamarla coautora convierte la ayuda en autoría, y reparte la responsabilidad entre una persona y algo que no puede responder de nada.

Cómo usarlo

El texto vive en talaia.dev/certificate y nunca se firma allí. Se firma añadiendo una línea al trabajo:

talaia.dev/certificate — John Doe

Dos partes, en ese orden:

  • La dirección es el certificado. Apunta a un texto fijo, así que la línea significa lo mismo dondequiera que aparezca, y la cláusula (a) ya está en ella: aquí hubo una IA.
  • El nombre es la certificación. Aquí hay una persona, y las dos cláusulas son ciertas de ella.

Añadir la línea es el acto; el gesto es deliberado, y es tuyo.

Bajo una publicación, la línea tal cual. Al pie de un informe, la dirección una vez y un nombre por cada mano, porque el trabajo pasó de mano en mano (del analista a la directora financiera, de la directora financiera al consejo), y cada mano añade su nombre bajo el anterior:

talaia.dev/certificate
John Doe, Director financiero, 2026-09-14
Jane Roe, CEO, 2026-09-16

En un commit, la dirección va en el mensaje y -s escribe el nombre como el trailer Signed-off-by:; la firma de quien revisa la pull request es la siguiente mano:

git commit -s -m "feat: export orders as CSV (#42)" -m "talaia.dev/certificate"
feat: export orders as CSV (#42)

talaia.dev/certificate

Signed-off-by: John Doe <[email protected]>

Las líneas se acumulan, y cada una es una persona que leyó el trabajo entero y responde de él. Esa es la cadena de torres: el fuego pasa, y en cada torre hay alguien vigilando.

Talaia

El manifiesto y el certificado son los mismos para todos. Lo que cambia es quién los adopta, y hay dos maneras de entrar: una persona o un equipo, por su cuenta; o una empresa, en su conjunto.

Para personas y equipos

talaia es abierta y de uso libre, y no hace falta permiso de nadie. El certificado ya lo tienes. Lo que queda es la forma de trabajar que hace honesta la firma: el marco de trabajo, que dice cómo hacer el encargo a la IA, cómo leer lo que devuelve y cuándo firmar: una publicación, un informe, un commit. Para el software hay además una pequeña herramienta que instala las reglas bajo las que trabaja tu agente de IA y comprueba que cada commit lleva una firma. Todo ello está en Personas y equipos.

Para empresas

Una empresa puede hacer suyo el manifiesto: sus valores, compartidos por toda la organización, para que las personas sigan al mando del trabajo que la IA les ayuda a hacer. El certificado es cómo se ve eso, y va en tres direcciones: dentro de la empresa, cada trabajo lleva el nombre de una persona que lo leyó y responde de él; hacia los clientes, se entrega como un sello sobre lo que la empresa entrega; y desde los proveedores, se exige por lo que la empresa recibe.

En la pestaña Empresas están los servicios que ofrecemos para ayudar a las empresas a aplicar talaia, y otros servicios relacionados.

Marco de trabajo

Introducción

El manifiesto dice qué defendemos; el certificado dice qué promete una persona; el marco de trabajo es cómo la promesa se hace posible.

talaia no sustituye tu forma de trabajar; se coloca por debajo de ella. Las historias pueden vivir en Jira, en GitHub Issues o en un fichero de texto; un informe puede seguir siendo un documento de Word; una publicación sigue siendo una publicación. Lo que talaia añade es una frontera entre lo que se puede delegar y lo que tiene que seguir siendo humano:

  • El instrumento puede redactar, construir, probar, iterar e informar.
  • El instrumento no puede diseñar el sistema, decidir qué cuenta como terminado, aceptar su propio trabajo, firmarlo ni sacarlo al mundo. Esos actos son tuyos.

Un resultado que funciona no es un trabajo aceptado.

El marco

Como Scrum o Kanban, talaia es un método antes que una herramienta. A diferencia de ellos, funciona por tareas, no por sprint, así que corre por debajo del proceso que ya tengas.

Tiene cinco pasos. El primero se hace una vez por sistema; los otros cuatro son un ciclo, que se recorre una vez por trabajo:

DESIGN ───▶ ( BRIEF ───▶ BUILD ────▶ WATCH ───▶ SIGN )
persona       persona    instrumento persona    persona, en el propio trabajo
Paso Quién Qué pasa Terminado cuando
Design Tú Escribes qué es el sistema: arquitectura, convenciones, restricciones. Está escrito y lo apruebas.
Brief Tú, con el instrumento Dices qué tiene que ser cierto; el instrumento pregunta por lo que queda suelto. No queda ninguna pregunta abierta.
Build El instrumento Hace lo encargado y muestra la evidencia. El Brief es cierto y la evidencia se ha mostrado.
Watch Tú Lees lo que ha vuelto y te quedas solo con lo que apruebas. Sabes explicar todo lo que te has quedado.
Sign Tú Añades la línea: la dirección y tu nombre. El trabajo lleva tu nombre.

Trabajar con una IA es una conversación: se pide algo, vuelve algo, y el turno siguiente corrige el anterior. El ciclo conserva esa forma: Brief, Build y Watch giran hasta que quedas satisfecho, y el Sign lo cierra. Diriges al principio y respondes al final.

Nada de ello es ceremonia nueva. El Design es lo que ya sabes de tu sistema, puesto por escrito; el Brief es el propio pedir; el Build es el instrumento trabajando dentro de las reglas; el Watch eres tú leyendo lo que ha vuelto; el Sign es la línea que añades. Juntos, los pasos trazan una sola línea: la ejecución se puede delegar; el juicio, no.

Design: la persona dice qué es el sistema

Todavía no se pide nada. El Design es lo que es cierto del sistema, escrito por ti antes del primer Brief:

  1. La arquitectura. Qué es el sistema, de qué está hecho y qué principios mantiene.
  2. Las convenciones. Qué significa aquí «bien hecho»: cómo se hace, se comprueba y se escribe el trabajo.
  3. Las restricciones. Los límites duros: lo que no se puede hacer aunque funcione, y las decisiones que atan lo que viene después.

Todo tipo de trabajo tiene las tres: un código fuente; una publicación (su línea, su libro de estilo, lo que nunca publica); una serie de informes.

Tres reglas lo mantienen tuyo:

  • El instrumento no diseña el sistema. Puede ayudarte a redactar el Design y a darle formato; nunca lo cambia por su cuenta.
  • Cada Brief se lee contra el Design. Si un encargo lo contradice, o el trabajo muestra que está mal o incompleto, el instrumento lo dice y se detiene.
  • Solo tú lo reabres. Una vez detenido, el instrumento no continúa hasta que tú hayas decidido: reescribiendo tú mismo el Design, o dictándole el cambio.

Termina cuando: el Design está escrito y lo apruebas. Hasta entonces no empieza ningún Brief. Firmarlo como firmas cualquier otro trabajo (la línea, tu nombre) es buena práctica; nada lo comprueba.

Brief: la persona dice qué significa «terminado»

Todavía no se produce nada. El Brief no es una reunión ni un formulario: es tu encargo, con tus propias palabras, y la conversación que lo sigue.

  1. Dices qué quieres: qué tiene que ser cierto cuando el trabajo esté terminado.
  2. El instrumento lee el encargo contra el Design y el proyecto (el código, las fuentes con las que trabaja) y devuelve lo que queda suelto: una contradicción, una pregunta abierta, una decisión que el encargo deja por tomar.
  3. Tú respondes. El instrumento no toma ninguna de esas decisiones por sí mismo: nada de diseño, de arquitectura ni de orden superior, y ningún cambio sustancial: una librería sustituida, una estructura rehecha, una capacidad añadida o quitada.

Termina cuando: no queda ninguna pregunta abierta. Mientras quede una, el Brief sigue girando. Cuando no queda ninguna, el instrumento empieza el Build por su cuenta, sin pedir permiso: el encargo, qué significa «terminado» y cada decisión ya son tuyos.

Build: el instrumento trabaja

Aquí no se decide nada. El instrumento trabaja según el Brief, bajo siete reglas:

  1. Lo más pequeño. Lo mínimo que hace cierto el Brief.
  2. Ni más ni menos de lo encargado. Ninguna funcionalidad, abstracción o «mejora» que nadie pidió; nada de lo pedido se queda fuera en silencio.
  3. Lo que escribió una persona se queda como lo escribió. El contenido hecho a mano no se toca, sobre todo tu edición de algo que produjo el instrumento. Esa edición es una decisión, y el turno siguiente trabaja alrededor de ella, no por encima. Solo una petición explícita la reabre.
  4. La prueba primero. Donde el trabajo se puede probar, el test que falla se escribe antes del trabajo y se muestra fallando; donde no, la comprobación se nombra antes de empezar. Los tests y las comprobaciones nunca se borran, se saltan ni se debilitan.
  5. Cada afirmación viene con su evidencia. «Los tests pasan» solo cuenta como la salida real de tests que se ejecutaron. «Según los datos» solo cuenta con la fuente al lado.
  6. El trabajo sigue siendo vigilable. Lo bastante pequeño para leerse entero de una sentada, lo bastante coherente para explicarse sin ayuda. Cuando crece más allá de eso, se divide.
  7. Iterar, nunca insistir. Si el mismo fallo sobrevive a dos intentos, el instrumento se detiene y te devuelve la decisión.

Termina cuando: lo encargado es cierto y su evidencia se ha mostrado, o dos intentos han fallado y la decisión vuelve a ti.

Watch: la persona vigila

El Watch ocurre donde ya está el trabajo: el diff en tu editor, el documento en tu pantalla, el borrador en el chat.

  1. Lee cada parte que vas a aceptar. Si no sabes explicar un fragmento, un párrafo, una cifra, no lo aceptes: pregunta, o rehazlo a mano.
  2. Comprueba la evidencia, no la afirmación. Los tests se ejecutaron delante de ti, con su salida real; las fuentes se abren; los números se pueden rastrear. Lo que siga marcado como sin verificar lo verificas tú o se quita.
  3. Quédate solo con lo que apruebas. En código, fragmento a fragmento, aceptando (stage) los que pasan; en un documento, párrafo a párrafo, dejando fuera el resto.
  4. Devuelve el resto. Todo o una parte: vuelve a dar la vuelta al ciclo hasta que sea lo que pediste.

Las herramientas pueden escalar la lectura, nunca el juicio. Diffs semánticos, asistentes de revisión, resumidores: usa lo que te ayude a leer; la decisión de aceptar sigue siendo tuya.

Termina cuando: has leído todo lo que te has quedado, sabes explicarlo y nada en ello sigue sin verificar.

Sign: la persona responde de ello

Añades la línea (la dirección y tu nombre) en el propio trabajo; en software, el commit.

El instrumento no firma, no publica, no escribe la historia. En software: ni add, ni commit, ni push, ni merge. Ningún comando de git que cambie el estado, nunca.

Termina cuando: el trabajo lleva tu nombre. El instrumento itera; tú decides cuándo termina el ciclo, y la firma es esa decisión.

Garantía

Cualquiera puede añadir la línea sin haber leído una palabra del Build. Ninguna máquina lo detectará, y el marco de trabajo no finge que alguna lo hará. Lo que la línea cambia es lo que el trabajo es: quien lo recibe lo lee como tuyo (no de la máquina, no un borrador, no una propuesta) y lo juzga como se juzga tu trabajo.

Así que la garantía viene de quien firma. La línea no comprueba el trabajo; hace tuyo el trabajo, y lo que lleva tu nombre lo haces bien, porque tu nombre es lo que la gente preguntará cuando falle. El certificado no añade un control. Quita una excusa.

La parte de quien recibe es confiar en la firma, y preguntar; la responsabilidad siempre ha consistido en preguntar a quien firmó. Por qué esto y no aquello; qué lo rompería. Quien leyó el trabajo y lo hizo suyo sabe responder sin la herramienta. Quien firmó sin leer descubre qué significaba la firma.

En la práctica

Contenido y documentos

Un artículo, una publicación, un informe. El Design son tus reglas para cada pieza: tono, estilo, lo que nunca publicas. Escríbelo una vez y dáselo primero al asistente. Brief y Build son la conversación. El Watch es leer el borrador y quedarte solo con lo que aceptas. El Sign es la línea, añadida a mano. Bajo una publicación, tal cual:

talaia.dev/certificate — John Doe

Al pie de un informe, la dirección una vez y un nombre por mano:

talaia.dev/certificate
John Doe, Director financiero, 2026-09-14
Jane Roe, CEO, 2026-09-16

Software

El software es el medio en el que el marco de trabajo encaja con gestos que ya haces, y donde las reglas son más estrictas: el instrumento no escribe en git. Ni add, ni commit, ni push, ni merge. Nada entra en la historia sin una decisión humana.

El Design son tres ficheros en .talaia/, en la raíz del repositorio (architecture.md, conventions.md, constraints.md), escritos por ti, leídos por el agente en cada turno, y commiteados y firmados como cualquier otro cambio. El agente escribe en ellos solo al dictado tuyo.

Las reglas para el agente van en el fichero de instrucciones que lee en cada turno. Todo agente de programación tiene uno, con un nombre u otro (AGENTS.md, CLAUDE.md, GEMINI.md); las reglas se ponen ahí una vez, y el agente trabaja dentro de ellas desde entonces.

talaia.dev/agentsmd

Este es AGENTS.md: el marco de trabajo escrito para el agente. Vive en una sola dirección, así que todas sus copias dicen lo mismo. Guárdalo en la raíz del repositorio; cada herramienta lo lee desde su propio sitio (Claude Code, Codex, Gemini, Cursor, Copilot). Cómo, para cada una: talaia.dev/how-to-agentsmd (en inglés).

Brief y Build son la conversación con el agente, bajo esas reglas. Watch y Sign son git:

  • El Watch es el diff y el stage. Lees el cambio en tu editor, fragmento a fragmento, y preparas (stage) lo que aceptas: preparar es el primer acto de aceptación.

  • El Sign es el commit. Escribes el mensaje con tus propias palabras (el agente nunca lo redacta; si no sabes escribir el mensaje, no puedes hacer el commit) con la dirección dentro, y -s escribe tu nombre como trailer:

    git commit -s -m "feat: export orders as CSV (#42)" -m "talaia.dev/certificate"
    feat: export orders as CSV (#42)
    
    talaia.dev/certificate
    
    Signed-off-by: John Doe <[email protected]>
  • La pull request es la siguiente mano. Quien revisa lee el cambio y pone su propia firma detrás de la tuya; la plantilla de pull request vuelve a pedir el certificado, delante del equipo, donde ya ocurre la revisión.

El agente termina cada trabajo acabado con el certificado y el comando para firmar. El mismo trailer, el mismo gesto, la misma comprobación que el DCO: si tu proyecto ya lo usa, una sola firma certifica los dos: talaia añade la comprensión encima del origen, nunca lo sustituye.

Una comprobación se ejecuta en cada pull request y falla cuando alguno de sus commits no lleva Signed-off-by:; hazla obligatoria y sin firma no hay merge.

talaia.dev/pr-check

Un fichero. Dónde ponerlo en GitHub, GitLab, Bitbucket o Gitea, y cómo hacerlo obligatorio, está en talaia.dev/how-to-pr-check (en inglés).

Usar talaia

Esta parte es solo para software: se aplica cuando el trabajo vive en un repositorio git.

Inicio rápido

Instala una vez, y luego dos comandos dentro de tu propio repositorio:

go install talaia.dev/cmd/talaia@latest   # una vez; Go 1.23+ es el único requisito

cd ~/tu-proyecto
talaia init                 # el fichero de instrucciones, los ficheros de diseño, la plantilla de pull request, la comprobación
talaia hooks claude         # opcional: prohíbe las escrituras en git en la configuración del propio agente (claude, gemini, git)
talaia audit --strict       # en cualquier momento: ¿están firmados los commits? (leído de git)

Escribe el diseño en .talaia/, haz commit de lo generado, abre tu herramienta de IA y trabaja como siempre. La CLI no ejecuta ninguna IA ni hace llamadas de red; crea ficheros, edita solo la lista de configuración que pertenece a hooks, y lee la historia de git. talaia help lista los comandos.

talaia init

Ejecútalo en la raíz de tu repositorio. Crea el arnés (ocho ficheros) y no toca nada más:

AGENTS.md                     Las reglas del marco para los agentes de IA
CLAUDE.md, GEMINI.md          Redirecciones a AGENTS.md (Claude Code, Gemini CLI)
.github/
├── PULL_REQUEST_TEMPLATE.md  Qué, por qué, cómo se ha probado + el certificado
└── workflows/talaia.yml      La comprobación de audit en cada pull request
.talaia/                      El diseño: lo escribes tú
├── architecture.md           Visión general, estructura, principios
├── conventions.md            Convenciones de código y de desarrollo
└── constraints.md            Límites duros y decisiones que atan
Las reglas (AGENTS.md) El fichero de talaia.dev/agentsmd, tal cual; tuyo para adaptarlo. CLAUDE.md y GEMINI.md son importaciones de una línea: no pongas reglas en ellos. Dónde lo lee cada otra herramienta: talaia.dev/how-to-agentsmd.
El diseño (.talaia/) Las verdades del sistema: arquitectura, convenciones, restricciones. Se crean con marcadores TODO para que los escribas tú, antes del primer Brief. El agente los lee en cada turno y nunca los cambia por su cuenta: se detiene y pregunta, y solo escribe en ellos a tu dictado.
La plantilla de pull request Aplica a cada pull request: qué ha cambiado, por qué, cómo se ha probado, y las dos cláusulas del certificado como casillas, marcadas delante del equipo.
La comprobación (.github/workflows/talaia.yml) El fichero de talaia.dev/pr-check, tal cual: talaia audit --strict sobre los commits de la pull request. Hazla obligatoria y sin firma no hay merge: talaia.dev/how-to-pr-check.

init es idempotente y nunca destructivo. Los ficheros existentes se quedan exactamente como están; solo se crean los que faltan.

talaia hooks

AGENTS.md le dice al agente que nunca ejecute un comando de git que cambie el estado. talaia hooks hace que el agente se niegue, aunque olvide la regla.

talaia hooks claude   # .claude/settings.json
talaia hooks gemini   # .gemini/settings.json

Añade a la configuración versionada del agente una regla de prohibición por cada escritura en git: add, am, apply, branch, checkout, cherry-pick, clean, commit, merge, mv, pull, push, rebase, reset, restore, revert, rm, stash, switch, tag. El git de solo lectura sigue abierto. Llega a todo el que clone; el resto del fichero se conserva, y ejecutarlo dos veces no cambia nada.

talaia hooks git      # .git/hooks/, solo este clon

Instala reference-transaction y pre-push, que rechazan commits, ramas, etiquetas y pushes cuando git se llama desde dentro de un agente, reconocido por CLAUDECODE, GEMINI_CLI, CODEX_SANDBOX, o TALAIA_AGENT=1 para cualquier otro. Funciona con cualquier agente, pero no cubre add, reset --hard ni clean. Vuelve a ejecutarlo tras cada clon nuevo; un hook existente nunca se sobrescribe.

Nada de esto es una barrera de seguridad: un agente puede llamar a git de otra manera. Lo que se sostiene frente a un rodeo deliberado es que el commit lleva el nombre de la persona.

talaia audit

La garantía es un subproducto de git, no un informe. talaia audit lee la historia (un solo git log, de solo lectura, sin los commits de merge) y dice si las firmas están: cuántos commits llevan Signed-off-by: y un id de historia, y cuáles no. Con --strict sale con estado 1 ante cualquier commit sin firmar. Un id de historia que falta o un commit demasiado grande solo se informan; eso es lo que ejecuta la comprobación de pull request. Acótalo con lo que le pasarías a git log: talaia audit main..feature, talaia audit --since=2026-08-01.

Footnotes

  1. Inspirado en la encíclica Magnifica Humanitas de León XIV (2026), donde la elección no es «sí» o «no» a la tecnología, sino construir Babel o reconstruir la muralla. ↩

  2. Ver Atalaya en Wikipedia. ↩

  3. Inspirado en el Manifiesto por el Desarrollo Ágil de Software. ↩

  4. Nos inspira también Humanismo Tecnológico Disidente (Jesús Granero, 2025): no rechazar la tecnología, pero no rendirle culto. ↩

  5. Inspirado en el Developer Certificate of Origin. ↩

  6. Pensado para apoyar la revisión humana y la responsabilidad editorial del artículo 50, apartado 4, del Reglamento de IA de la UE. ↩