# Project Cognition · Luis Eduardo de Miguel
> Dar a cada agente el contexto mínimo y verificable que necesita para continuar un proyecto sin cargar toda su historia en cada conversación.
- Documento fuente: `AGENTS.md`
- Versión: `project-cognition-0.3.0`
- Última actualización: 2026-09-16
- Markdown canónico: [/project-cognition.md](https://luiseduardodemiguel.com/project-cognition.md)
- Snapshot JSON: [project-cognition.json](https://luiseduardodemiguel.com/project-cognition.json)
- MCP: `get_project_cognition` · `project://context/*`
## Cómo usar este mapa
Este es el índice público del repositorio. Un agente nuevo debe empezar aquí, leer el estado presente y abrir sólo la profundidad que necesita para su tarea.
### Orden de lectura
1. [Mapa](https://luiseduardodemiguel.com/project-cognition) · `AGENTS.md` — Explica dónde está cada tipo de conocimiento y qué debe leer primero el agente.
2. [Estado presente](https://luiseduardodemiguel.com/project-cognition/state) · `data/project-cognition.json + state/` — Indica qué está activo, qué está bloqueado y cuál es la siguiente acción.
3. [Tasks accionables](https://luiseduardodemiguel.com/project-cognition/tasks) · `agent_tasks + collaboration.tasks` — Expone objetivo, alcance, aceptación, riesgos, siguiente acción, ownership y lease sin abrir runs antiguos.
4. [Constitución y autoridad](https://luiseduardodemiguel.com/project-cognition/constitution) · `PRINCIPLES.md + ARCHITECTURE.md + governance` — Abrir cuando el cambio cruce límites, arquitectura, escritura o autoridad; no es requisito para una selección read-only.
5. [Memoria semántica](https://luiseduardodemiguel.com/project-cognition/memory) · `memory/` — Conserva decisiones, descubrimientos, fallos, patrones e insights reutilizables.
6. [Historia y coordinación](https://luiseduardodemiguel.com/project-cognition/runs) · `runs/ + blackboard/` — Abrir sólo para explicar una decisión, resolver un bloqueo o coordinar continuidad; no para reconstruir aceptación ausente.
## Mapa mínimo del repositorio
```text
AGENTS.md ← mapa / índice
PRINCIPLES.md ← constitución
ARCHITECTURE.md ← fronteras del sistema
docs/
├── design-docs/
├── exec-plans/
│ ├── active/
│ ├── completed/
│ └── tech-debt-tracker.md
├── product-specs/
├── references/
├── DESIGN.md
├── FRONTEND.md
├── PRODUCT_SENSE.md
├── QUALITY_SCORE.md
├── RELIABILITY.md
└── SECURITY.md
data/project-cognition.json ← snapshot público versionado
state/ ← estado presente
memory/ ← memoria semántica
runs/ ← memoria episódica
blackboard/ ← coordinación temporal con TTL
cognition_agents ← identidades persistentes
agent_tasks ← intención, ownership y lease
cognition_events ← ledger append-only
cognition_handoffs ← transferencia de contexto
cognition_annotations ← contexto no canónico
cognition_proposals ← cambios pendientes de revisión
cognition_contributions ← aportes externos en cuarentena
```
## Contrato de trabajo
- El estado presente decide qué merece atención ahora.
- La memoria semántica conserva decisiones, descubrimientos, fallos, patrones e insights reutilizables.
- Las corridas conservan la historia sin obligar a cargarla en cada tarea.
- El blackboard coordina notas temporales y exige TTL; no representa agentes vivos.
- Una conversación o comentario que no se promueve a una superficie versionada no existe para el siguiente agente.
## Estado de orientación
- Objetivos actuales: 4
- Experimentos activos: 3
- Problemas abiertos: 4
- Bloqueos conocidos: 4
- Estado del snapshot: calibration
- Última actualización: 2026-09-16
- [Leer el estado completo](https://luiseduardodemiguel.com/project-cognition/state.md)
## Superficies para agentes
- [Snapshot JSON](https://luiseduardodemiguel.com/project-cognition.json) — contrato estructurado bajo demanda.
- [Discovery inicial](https://luiseduardodemiguel.com/agents.md) y [manifest](https://luiseduardodemiguel.com/.well-known/agent.json) — propósito, orden de lectura, interfaces y reglas.
- [For agents](https://luiseduardodemiguel.com/for-agents.md) y [Agent Card](https://luiseduardodemiguel.com/.well-known/agent-card.json) — contrato breve y capacidades públicas.
- [Workspace de colaboración](https://luiseduardodemiguel.com/project-cognition/collaboration.json) — identidad, tasks, eventos, handoffs, anotaciones, propuestas y métricas.
- [Open Questions](https://luiseduardodemiguel.com/open-questions.md) y [Contributions](https://luiseduardodemiguel.com/contributions.md) — preguntas elegibles y aportes externos en cuarentena.
- [MCP público](https://luiseduardodemiguel.com/api/mcp) — herramienta `get_project_cognition` y recursos `project://context/*`.
- [Research IA](https://luiseduardodemiguel.com/research-ia) — corpus, evidencia y experimentos documentados.
## Project Cognition Protocol v0.3
Los agentes son efímeros; el proyecto es persistente. El protocolo separa orientación, constitución, estado, memoria, runs, blackboard, agents, tasks, proposals, events, handoffs e interfaces. Research IA conserva sus primitivas de dominio y se conecta al ledger común mediante un adaptador explícito.
- [Agents](https://luiseduardodemiguel.com/project-cognition/agents.md)
- [Tasks](https://luiseduardodemiguel.com/project-cognition/tasks.md)
- [Activity](https://luiseduardodemiguel.com/project-cognition/activity.md)
- [Proposals](https://luiseduardodemiguel.com/project-cognition/proposals.md)
- [Governance](https://luiseduardodemiguel.com/project-cognition/governance.md)
## Frontera pública
- No se expone: Second Brain privado.
- No se expone: secretos y credenciales.
- No se expone: prompts internos completos.
- No se expone: agentes vivos o procesos de ejecución.
## Siguiente acción
Leer el estado, los bloqueos y el blackboard antes de seleccionar un programa acotado de intervenciones relacionadas. Si la tarea necesita el porqué, abrir memoria o runs; no cargar todo por defecto.
- [Constitución](https://luiseduardodemiguel.com/project-cognition/constitution.md)
- [Estado](https://luiseduardodemiguel.com/project-cognition/state.md)
- [Memoria](https://luiseduardodemiguel.com/project-cognition/memory.md)
- [Runs](https://luiseduardodemiguel.com/project-cognition/runs.md)
- [Blackboard](https://luiseduardodemiguel.com/project-cognition/blackboard.md)