Cómo está hecha

← Pregunta a la vaca

Los asistentes de IA a veces se inventan cosas, y las dicen con mucha seguridad. Este está hecho para que no pueda inventarse mi experiencia. Te cuento cómo, en palabras sencillas.

Qué hace

Una vaca que solo sabe lo que he comprobado

Esta web tiene un asistente: una vaca de las Highlands a la que puedes preguntar por mi experiencia. No busca en internet. Solo puede leer una lista de datos sobre mí que he escrito y comprobado uno a uno, como un currículum con mi firma al lado de cada línea.

Siempre enseña de dónde lo ha sacado

Debajo de una respuesta puedes abrir sus fuentes: los datos exactos que ha usado y el día en que confirmé cada uno. Si intenta citar un dato que no ha consultado para esa respuesta, la web no lo acepta y no muestra ninguna fuente para él.

Hace un examen antes de cada cambio

Tengo una lista de preguntas, algunas con trampa, como "¿entonces era el jefe de ingeniería?" cuando fui el líder técnico. Cada vez que cambio cómo responde, la vaca hace el examen y otra IA corrige sus respuestas frase a frase. Hay unas pocas preguntas que siempre tiene que acertar: si falla una de ellas, no acepto el cambio.

Con límites, y con respeto

Cada visitante puede hacer 30 preguntas al día, y la web entera tiene un tope de gasto diario, para que los costes no se disparen. Para contar tus preguntas, la web no guarda tu dirección IP, solo un código hecho a partir de ella que cambia cada día. Las estadísticas de visitas no usan ni eso. Las preguntas se guardan de forma anónima durante 90 días para mejorar el asistente.

Un valle de verdad

El paisaje de arriba está en directo. La estación sigue el calendario, el sol está a la altura real que tiene ahora mismo sobre Glasgow, y el tiempo es el de Glasgow de la última media hora. Si allí llueve, aquí también.

Cómo la hice

El dibujo muestra el flujo: un plan se convierte en tareas pequeñas; cada tarea va a su propia sesión de programación; dos revisores de IA leen el cambio; un buzón despierta al supervisor, que lo revisa; y yo decido si entra.
  1. Hecha con ayuda de la IA, pero con reglas

    Hice esta web con la ayuda de Claude, una IA de la empresa Anthropic, y de Claude Code, su asistente para escribir código. Les di reglas por escrito: pueden proponer cambios, pero solo yo los acepto, y solo yo puedo aprobar una línea sobre mi experiencia.

  2. Primero, un plan

    Antes de escribir código, preparé el plan con Claude: fases (los datos, el asistente, su examen, el diseño…) y, en cada fase, tareas pequeñas, cada una escrita como una petición clara en GitHub, la web donde vive el código.

  3. Un asistente de programación por tarea

    Varias sesiones de Claude Code trabajan a la vez en mi ordenador, cada una en su propia tarea y en su propia copia del código, para que nunca se pisen.

  4. Dos revisores en cada cambio

    Antes de que un cambio me llegue, dos revisores de IA lo leen: uno comprueba que se cumplen las reglas del proyecto, y el otro que la documentación sigue diciendo la verdad.

  5. Un supervisor que ve el conjunto

    Unas conversaciones con Claude, en la app de Claude, supervisan el trabajo. Llevan notas de todo el proyecto, de sus decisiones y de cómo me gusta hacer las cosas, así que revisan cada plan y cada cambio con más contexto que la sesión que lo escribió.

  6. Buzones entre ellos

    Se comunican por buzones: peticiones especiales en GitHub que nunca se aceptan, donde una sesión de programación deja una nota corta, como "plan listo" o "cambio listo", que despierta a su supervisor.

  7. Decido yo

    No se construye nada hasta que su plan está aprobado, solo yo puedo confirmar un dato sobre mí, y solo yo acepto un cambio en la web.

Para desarrolladores

La parte técnica, con enlaces a los documentos del propio repositorio.

Cómo se responde una pregunta
  1. La pregunta llega al servidor, a POST /api/chat.
  2. Se comprueban los límites del día en Cloudflare D1, por visitante y para toda la web.
  3. Claude responde, con herramientas de solo lectura que devuelven solo claims confirmados.
  4. La comprobación de citas solo acepta una cita si una herramienta devolvió ese claim para esta respuesta.
  5. La respuesta llega por streaming con citas numeradas y sus fuentes.