docplane
DocPlane es un control plane para documentación de personas que construyen y ejecutan sistemas con agentes de IA. Permite gestionar páginas, tarjetas, capturas y observaciones en una base de datos PostgreSQL a través de una API versionada, publicada como sitio estático certificado.
Ficha actualizada 23 sept 2026, 8:01 · upstream 23 sept 2026, 7:48 · release sin release detectada
Qué es docplane
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
DocPlane es un control plane para documentación de personas que construyen y ejecutan sistemas con agentes de inteligencia artificial. Permite gestionar páginas, tarjetas, capturas y observaciones en una base de datos PostgreSQL a través de una API versionada, publicada como sitio estático certificado.
El sistema se basa en cuatro verbos: work (qué debe suceder), know (qué entendemos), model (estructura del sistema) y observe (lo que se observa). Todo el conocimiento reside en un solo autoridad — la base de datos PostgreSQL — con una API versionada como único fuente de verdad. Las ediciones son revisionables, los conflictos se reportan explícitamente y no hay múltiples fuentes de verdad.
Se distingue entre humanos (dashboard) e agentes (MCP server), pero ambos comparten el mismo contrato: editar un documento en la versión actual sin crear una nueva página vacía como fuente de verdad. La publicación requiere validación, no solo aprobación.
- Documentar y versionar la arquitectura de sistemas con IA
- Gestionar conocimiento técnico entre equipos humanos e agentes
- Crear runbooks y procedimientos operativos versionados
- Mantener un único autoridad sobre el estado del sistema
- Permitir que agentes accedan a documentación sin repositorios
- Auditoría de cambios con trazabilidad completa
- Un solo autoridad (PostgreSQL) como fuente única de verdad, eliminando múltiples fuentes contradictorias
- Ediciones revisionables en tiempo real con conflictos HTTP explícitos (409/412)
- API versionada que permite cambios sin romper la documentación publicada
- MCP server para acceso directo a agentes sin necesidad de repositorios
- Modelo basado en cuatro verbos: work, know, model, observe
- Cero decisiones al guardar una idea; la estructuración es un acto deliberado
- Requiere PostgreSQL como base de datos centralizada
- No soporta bases de datos distribuidas o no relacionales
- Depende de Docker Compose para despliegue, lo que limita escalabilidad horizontal
- El sistema es monolítico en la API y el control plane
- La publicación requiere validación manual antes del despliegue
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega con docker compose: docs-web (8080), docs-api (8010), dashboard (8051) y docs-mcp (8049). Usa PostgreSQL como base de datos. Para modo privado, establece DOCPLANE_ACCESS_PROFILE=private_fabric para que los agentes generen tokens con autenticación individual sin necesidad de un operador. Verifica la salud del servicio con curl al endpoint /healthz.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.