Kioku se distribuye como un proyecto .NET público con artefactos de release, paquete NuGet y documentación operativa. La versión 3.1.2 es la versión estable etiquetada del servidor; el desarrollo continúa hacia publicaciones posteriores.
CASO DE ESTUDIO · INGENIERÍA BACKEND
Kioku
Un servidor MCP local-first en .NET 10 que conserva decisiones, especificaciones, planes, errores y handoffs de sesión como registros persistentes en Markdown y YAML dentro de un vault de Obsidian.
v3.1.2 Código público Activo
SISTEMA ACTUAL
Versión estable 3.1.2 con desarrollo activo en curso
PROBLEMA
El contexto de un agente debe sobrevivir a la sesión que lo creó
Los agentes de programación pueden tomar buenas decisiones y aun así perder el razonamiento cuando termina un proceso, terminal o conversación. El historial del proveedor no es un registro persistente del proyecto y un handoff no debería obligar al siguiente agente a reconstruir la intención desde chats anteriores.
Kioku usa el vault como memoria persistente del proyecto: especificaciones, planes de implementación, decisiones, errores, conocimiento y handoffs de sesión siguen siendo legibles en Markdown y YAML incluso cuando el servidor MCP o la interfaz de Obsidian no están ejecutándose.
SISTEMA
Límite MCP local-first
Límite de ejecución de Kioku Los clientes MCP se conectan a un servidor Kioku en .NET 10 mediante stdio local o Streamable HTTP autenticado. El servidor lee directamente el vault de Obsidian; la recuperación semántica y la integración con Obsidian son opcionales.
DECISIONES DE INGENIERÍA
Almacenamiento legible y límites del protocolo explícitos
DECISIÓN 01
MARKDOWN ES EL FORMATO PERSISTENTE
El vault continúa siendo comprensible y editable sin Kioku. La capa MCP coordina flujos de trabajo, pero no se convierte en el único lugar desde el que puede recuperarse el conocimiento del proyecto.
DECISIÓN 02
NÚCLEO HEADLESS, UI OPCIONAL
Notas, búsqueda, proyectos, sesiones, indexación y coordinación trabajan directamente sobre el vault. Obsidian y su plugin complementario son opcionales para operaciones específicas de interfaz e integración.
DECISIÓN 03
EL ACCESO REMOTO NECESITA UN LÍMITE DE CONFIANZA EXPLÍCITO
stdio local continúa como opción por defecto. Streamable HTTP escucha en loopback por
defecto y exponerlo fuera de la máquina requiere autenticación salvo que se habilite
explícitamente una excepción insegura.
FLUJO
La intención de diseño se convierte en un artefacto recuperable
Flujo de ingeniería persistente Kioku separa el requerimiento, el plan de implementación y el handoff de ejecución para que un agente nuevo pueda recuperar tanto la intención como el estado actual.
ESTADO DE RELEASE
Una versión estable y una línea de desarrollo activa
VERSIÓN ESTABLE
3.1.2 · PAQUETE · CONTRATOS · DOCUMENTACIÓN OPERATIVA
La release 3.1.2 publica artefactos del servidor y enlaza el paquete NuGet
kioku-mcp-server. El proyecto también mantiene referencias MCP generadas,
documentación del flujo de ingeniería, configuración, seguridad y pruebas automatizadas.
DESARROLLO ACTIVO
EL TRABAJO CONTINÚA MÁS ALLÁ DE 3.1.2
El desarrollo activo puede incorporar cambios posteriores a la versión estable 3.1.2. El comportamiento específico de una release permanece asociado a su versión etiquetada hasta que el trabajo posterior se promueve a una nueva publicación.
APRENDIZAJES
Qué cambió este proyecto en mi forma de construir
APRENDIZAJE 01
PERSISTENCIA ANTES QUE HISTORIAL DEL PROVEEDOR
Los registros de proyecto legibles por personas sobreviven mejor los límites de sesión y proceso que depender del historial conversacional de un único proveedor de IA.
APRENDIZAJE 02
SPEC → PLAN → SESIÓN ES UN LÍMITE ÚTIL
Separar requerimientos, intención de implementación y estado de ejecución hace más probable que un agente nuevo continúe el trabajo correcto, no solo el texto anterior.
APRENDIZAJE 03
LOCAL-FIRST NO ELIMINA EL TRABAJO DE SEGURIDAD
Cuando un protocolo local se vuelve accesible remotamente, autenticación, política de orígenes, confianza en proxies y límites del vault se convierten en decisiones de ingeniería de primer nivel.