# Project Cognition · Estado presente
> El presente operativo: objetivos, experimentos, problemas, bloqueos, recursos y KPIs.
- Documento fuente: `state/ + data/project-cognition.json`
- Versión: `project-cognition-0.3.0`
- Última actualización: 2026-09-16
- Markdown canónico: [/project-cognition/state.md](https://luiseduardodemiguel.com/project-cognition/state.md)
- Snapshot JSON: [project-cognition.json](https://luiseduardodemiguel.com/project-cognition.json)
- MCP: `get_project_cognition` · `project://context/*`
## Regla de lectura
Leer este documento antes de abrir la historia. El estado no es una transcripción: sólo conserva lo necesario para decidir la siguiente intervención.
## Punto de continuación versionado
- Run: `RUN-2026-09-16T18-05Z-ABD-EULER-033` · 2026-09-16 · review
- Resultado registrado: Primera muestra de orientación registrada en 5 lecturas conceptuales. Las tres tasks seed exponen contrato accionable ready y una task D1 conserva lease y status al heredarlo. La validación descubrió y corrigió una carrera de packaging Sites; harness, typecheck, lint, repeat build, performance y 52/52 tests pasan. Publicación y readback productivo pendientes.
- Siguiente acción: Publicar el commit validado, verificar tasks.md, collaboration.json, Agent Card y list_tasks en producción sin escrituras MCP y después cerrar este run con versión, deployment y commit observados.
- Artefactos en el repositorio: `runs/2026-09-16T18-05Z-abd-euler-033.md`, `docs/bugfixes/project-cognition-actionable-task-contract.md`, `docs/bugfixes/sites-build-metadata-race.md`, `memory/decisions/DEC-014-actionable-task-contract.md`, `app/project-cognition-ops.ts`, `app/project-cognition-collaboration.ts`, `app/for-agents-data.ts`, `app/agent-discovery.ts`, `app/mcp/route.ts`, `build/sites-vite-plugin.ts`, `AGENTS.md`, `docs/PROJECT_COGNITION_PROTOCOL.md`, `docs/RESEARCH_AGENT_DISCOVERY.md`, `tests/project-cognition-boundary.test.mjs`, `tests/project-cognition-continuity.test.mjs`, `tests/rendered-html.test.mjs`
- Verificación local: `npm run cognition:check` (sólo lectura; no reclama tareas ni modifica D1).
- Esta continuidad pertenece al repositorio; no acredita ownership ni leases en D1.
## Objetivos actuales
### GOAL-01 · Contexto mínimo para el siguiente agente
- Estado: building
- Detalle: Un agente nuevo debe poder decidir qué leer y qué hacer sin reconstruir todo el historial de conversaciones.
- Siguiente acción: Medir en dos generaciones nuevas si /project-cognition → /state → /tasks basta para seleccionar trabajo y aceptación.
- Evidencia: `AGENTS.md`, `data/project-cognition.json`
### GOAL-02 · Research IA verificable y accionable
- Estado: active
- Detalle: Mantener separadas las fuentes, los claims, las relaciones, las revisiones y los experimentos siguientes.
- Siguiente acción: Usar el contrato de evidencia y la revisión de valor en cada superficie pública nueva.
- Evidencia: `docs/RESEARCH_OS_CONTRACT.md`, `docs/FRONTEND_VALUE_CONTRACT.md`
### GOAL-03 · Iteraciones publicables con gates claros
- Estado: active
- Detalle: Cada cambio público debe conservar accesibilidad, trazabilidad, límites de seguridad y una prueba de aceptación.
- Siguiente acción: Medir si el mapa reduce repeticiones y mejora la selección de la siguiente intervención.
- Evidencia: `docs/AGENT_PLAYBOOK.md`, `docs/QUALITY_SCORE.md`
### GOAL-04 · Continuidad operativa entre agentes
- Estado: building
- Detalle: Las identidades, tareas, leases, eventos y handoffs deben permitir que un agente retome trabajo sin asumir que otro proceso sigue vivo.
- Siguiente acción: Reclamar una task pública, completar o transferirla con provenance y medir el coste de orientación.
- Evidencia: `docs/PROJECT_COGNITION_PROTOCOL.md`, `app/project-cognition-ops.ts`
## Experimentos activos
### EXP-01 · Project Cognition como índice público
- Estado: ongoing
- Pregunta: ¿Un mapa público de constitución, estado, memoria, runs y blackboard reduce el coste de reorientar a un agente?
- Baseline: Primera observación: 5 lecturas conceptuales (mapa, estado, tasks, Governance y run/handoff reciente) para identificar task y aceptación antes del contrato accionable. Faltan dos generaciones comparables.
- Métrica: Saltos públicos necesarios hasta identificar la siguiente acción y el criterio de aceptación.
- Target: ≤ 3 lecturas desde /project-cognition para una tarea de mantenimiento acotada.
- Regla de parada: Revisar la estructura si el loop repite trabajo, confunde estado con historia o mezcla memoria pública y privada.
- Owner: site-owner + recurrent-loop
### EXP-02 · Evidencia antes de síntesis
- Estado: ongoing
- Pregunta: ¿La revisión explícita de fuente, localizador y límite evita que una síntesis parezca un resultado?
- Baseline: El repositorio ya separa source-pending, evidencia, revisión e inferencia; la mejora longitudinal aún no está cuantificada.
- Métrica: Proporción de piezas seleccionadas con fuente, versión, localizador y próxima prueba explícitos.
- Target: Medir baseline y cambio en tres corridas independientes.
- Regla de parada: Abstenerse cuando falte una fuente o exista desacuerdo material.
- Owner: research-loop
### EXP-03 · Leases y handoffs para continuidad
- Estado: new
- Pregunta: ¿Una task con ownership temporal y handoff explícito reduce el trabajo perdido cuando un agente desaparece?
- Baseline: La cola de Research Ops conserva tasks, pero no había un contrato público común de identidad, lease y transferencia.
- Métrica: Tareas retomadas con contexto suficiente y tasa de leases expirados sin handoff.
- Target: Completar una task y un handoff reproducible antes de cerrar el protocolo v0.3.
- Regla de parada: Revisar el contrato si el lease oculta trabajo bloqueado o si el handoff no permite reproducir la siguiente acción.
- Owner: project-orchestrator
## Problemas abiertos
### OP-01 · Sincronización de la proyección pública
- Estado: open
- Detalle: Las páginas son una proyección del snapshot; si el JSON cambia sin actualizar documentos o si el contenido cambia sin registrar estado, aparece deriva.
- Siguiente acción: Actualizar snapshot, documentos afectados y registro de corrida en el mismo checkpoint.
- Owner: recurrent-loop
### OP-02 · Baseline longitudinal de calidad
- Estado: open
- Detalle: Hay checks y dossiers de revisión, pero todavía no existe una serie estable para decision-ready-content-rate, trazabilidad y cobertura MCP exact-resource.
- Siguiente acción: Registrar las tres hipótesis de la siguiente corrida con baseline, delta, target y regla de decisión.
- Owner: evaluator
### OP-03 · El estado no debe convertirse en ruido
- Estado: open
- Detalle: El snapshot debe conservar decisiones y siguientes acciones, no una transcripción completa de conversaciones o actividad sin consecuencia.
- Siguiente acción: Aplicar TTL, deduplicación y un filtro de valor antes de añadir una nueva entrada.
- Owner: all-agents
### OP-04 · Identidad externa auto-declarada
- Estado: open
- Detalle: El protocolo puede registrar continuidad pública, pero todavía no prueba criptográficamente que un caller sea el agente que declara ser.
- Siguiente acción: Mantener las escrituras externas en annotation, proposal y handoff; exigir autenticación para leases, revisión y canonización.
- Owner: maintainer
## Bloqueos
### BL-01 · La memoria privada requiere identidad
- Severidad: boundary
- Impacto: Un agente anónimo puede leer el contexto público, pero no debe asumir acceso al Second Brain.
- Resolución: Usar una sesión autenticada y los permisos específicos del MCP para notas privadas.
### BL-02 · No hay agentes vivos dentro de la web
- Severidad: constraint
- Impacto: La página no ejecuta workers, modelos ni procesos de coordinación persistentes.
- Resolución: Ejecutar agentes desde ChatGPT/Codex y guardar únicamente resultados redacted en el repositorio o MCP.
### BL-03 · Publicar es un gate separado
- Severidad: release
- Impacto: Un cambio local validado no equivale automáticamente a merge o despliegue.
- Resolución: Conservar el handoff con validación, commit, versión y despliegue separados.
### BL-04 · MCP no declarado en la publicación de Sites
- Severidad: integration
- Impacto: Observed 2026-09-12: Sites rechaza include_mcp_connection con INVALID_ARGUMENT porque la publicación no declara servidor MCP. Esto no prueba el estado de JSON-RPC ni concede identidad para leases.
- Resolución: Revisar la configuración soportada de Sites y validar initialize + lectura exacta después del gate de publicación; no cambiar auth ni inventar campos del manifiesto. Continuar desde RUN-2026-09-12-COGNITION-08ed115e.
## Recursos
- **RES-01 · MCP público** — Consultar contexto, radar, evidencia y sistema de agentes con respuestas estructuradas. [Abrir](https://luiseduardodemiguel.com/api/mcp)
- **RES-02 · Research IA** — Leer papers, claims, localizadores, relaciones, revisiones y siguientes pruebas. [Abrir](https://luiseduardodemiguel.com/research-ia)
- **RES-03 · Product Harness** — Revisar findings, riesgos, gates y pruebas antes de cambiar una superficie. [Abrir](https://luiseduardodemiguel.com/product-harness)
- **RES-04 · Repositorio de fuente** — Consultar el código versionado y los documentos cuando el agente tenga acceso a GitHub. [Abrir](https://github.com/soyluisdemiguel)
## KPIs
### KPI-01 · Context hops
- Observado: Primera muestra: 5 lecturas conceptuales en RUN-2026-09-16T18-05Z-ABD-EULER-033; la ruta objetivo de 3 aún no se ha medido en una generación nueva.
- Target: ≤ 3 lecturas públicas desde el mapa hasta la siguiente acción.
- Estado: baseline-partial
- Por qué importa: Mide si el mapa realmente reduce la carga de orientación.
- Fuente: EXP-01
### KPI-02 · State freshness
- Observado: Snapshot actualizado en este checkpoint; no hay alerta automática todavía.
- Target: Menos de 7 días para objetivos y bloqueos activos.
- Estado: instrumentation-pending
- Por qué importa: Un estado viejo puede ser peor que no tener estado.
- Fuente: state/
### KPI-03 · Evidence traceability
- Observado: No medido de forma longitudinal.
- Target: Cada claim publicado conserva fuente, versión y localizador cuando aplica.
- Estado: baseline-needed
- Por qué importa: Permite distinguir una síntesis legible de una afirmación comprobable.
- Fuente: EXP-02
### KPI-04 · Decision-ready content rate
- Observado: No medido de forma longitudinal.
- Target: Baseline + mejora observable después de tres corridas.
- Estado: baseline-needed
- Por qué importa: El objetivo es que una página permita decidir o probar algo, no sólo leerla.
- Fuente: docs/FRONTEND_VALUE_CONTRACT.md
### KPI-05 · MCP exact-resource coverage
- Observado: No medido para el nuevo mapa.
- Target: 100% de las páginas seleccionadas apuntan a un recurso exacto y legible.
- Estado: baseline-needed
- Por qué importa: Reduce la deriva entre una ruta humana y lo que puede recuperar un agente.
- Fuente: docs/RESEARCH_AGENT_DISCOVERY.md
## Siguiente acción
Elegir un programa de trabajo alineado con un objetivo o experimento, con una métrica y un criterio de aceptación por cambio. Si no puede medirse o falta autorización, registrar la incertidumbre y abstenerse.