knowledge-ops

Operaciones de Conocimiento

Gestiona un sistema de conocimiento multicapa para ingerir, organizar, sincronizar y recuperar conocimiento en múltiples almacenes.

Prefiere el modelo de espacio de trabajo en vivo:

• el trabajo de código vive en los repos clonados reales
• el contexto de ejecución activo vive en GitHub, Linear y archivos de contexto de trabajo locales del repo
• las notas más amplias orientadas a humanos pueden vivir en una carpeta context/archive externa al repo
• la memoria duradera entre máquinas pertenece a la base de conocimiento, no a un espacio de trabajo de repo espejo

Cuándo Activar

• El usuario quiere guardar información en su base de conocimiento
• Ingerir documentos, conversaciones o datos en almacenamiento estructurado
• Sincronizar conocimiento entre sistemas (archivos locales, memoria MCP, Supabase, repos Git)
• Deduplicar u organizar conocimiento existente
• El usuario dice "guarda esto en la KB", "sincroniza conocimiento", "¿qué sé sobre X?", "ingiere esto", "actualiza la base de conocimiento"
• Cualquier tarea de gestión de conocimiento más allá de un simple recuerdo de memoria

Arquitectura de Conocimiento

Capa 1: Verdad de ejecución activa

• Fuentes: Issues de GitHub, PRs, discusiones, notas de versión, Issues/proyectos/docs de Linear
• Uso: para el estado operativo actual del trabajo
• Regla: si algo afecta a un plan de ingeniería activo, hoja de ruta, despliegue o versión, prefiere ponerlo aquí primero

Capa 2: Memoria de Claude Code (Acceso Rápido)

• Ruta: ~/.claude/projects/*/memory/
• Formato: Archivos Markdown con frontmatter
• Tipos: preferencias de usuario, feedback, contexto de proyecto, referencia
• Uso: para contexto de acceso rápido que persiste entre conversaciones
• Cargado automáticamente al inicio de la sesión

Capa 3: Servidor de Memoria MCP (Grafo de Conocimiento Estructurado)

• Acceso: herramientas de memoria MCP (create_entities, create_relations, add_observations, search_nodes)
• Uso: Búsqueda semántica en todas las memorias almacenadas, mapeo de relaciones
• Persistencia entre sesiones con estructura de grafo consultable

Capa 4: Repo de base de conocimiento / almacén de documentos duraderos

• Uso: notas duraderas curadas, exportaciones de sesión, investigación sintetizada, memoria del operador, documentos extensos
• Regla: este es el almacén duradero preferido para contexto entre máquinas cuando el contenido no es código propiedad del repo

Capa 5: Almacén de Datos Externo (Supabase, PostgreSQL, etc.)

• Uso: Datos estructurados, almacenamiento de documentos grandes, búsqueda de texto completo
• Ideal para: Documentos demasiado grandes para archivos de memoria, datos que necesitan consultas SQL

Capa 6: Carpeta local de contexto/archivo

• Uso: notas orientadas a humanos, planes archivados, organización multimedia local, documentos temporales no relacionados con código
• Regla: escribible para almacenamiento de información, pero no es un espacio de trabajo de código espejo
• No usar para: cambios de código activos o verdad del repo que deba vivir en upstream

Flujo de Ingesta

Cuando se necesita capturar nuevo conocimiento:

1. Clasificar

¿Qué tipo de conocimiento es?

• Decisión de negocio -> archivo de memoria (tipo proyecto) + memoria MCP
• Estado activo de hoja de ruta / versión / implementación -> GitHub + Linear primero
• Preferencia personal -> archivo de memoria (tipo usuario/feedback)
• Información de referencia -> archivo de memoria (tipo referencia) + memoria MCP
• Documento grande -> almacén de datos externo + resumen en memoria
• Conversación/sesión -> repo de base de conocimiento + resumen breve en memoria

2. Deduplicar

Verifica si este conocimiento ya existe:

• Busca en archivos de memoria entradas existentes
• Consulta la memoria MCP con términos relevantes
• Comprueba si la información ya existe en GitHub o Linear antes de crear otra nota local
• No crees duplicados. En su lugar, actualiza las entradas existentes.

3. Almacenar

Escribe en la(s) capa(s) apropiada(s):

• Siempre actualiza la memoria de Claude Code para acceso rápido
• Usa la memoria MCP para búsqueda semántica y mapeo de relaciones
• Actualiza GitHub / Linear primero cuando la información cambia la verdad del proyecto en vivo
• Haz commit al repo de base de conocimiento para adiciones duraderas de formato largo

4. Indexar

Actualiza cualquier índice o archivo de resumen relevante.

Operaciones de Sincronización

Sincronización de Conversaciones

Sincroniza periódicamente el historial de conversaciones en la base de conocimiento:

• Fuentes: archivos de sesión de Claude, sesiones de Codex, otras sesiones de agente
• Destino: repo de base de conocimiento
• Genera un índice de sesión para navegación rápida
• Haz commit y push

Sincronización del Estado del Espacio de Trabajo

Refleja configuraciones y scripts importantes del espacio de trabajo en la base de conocimiento:

• Genera mapas de directorios
• Oculta config sensible antes de commitear
• Rastrea cambios a lo largo del tiempo
• No trates la base de conocimiento o la carpeta de archivo como el espacio de trabajo de código en vivo

Sincronización GitHub / Linear

Cuando la información afecta la ejecución activa:

• actualiza el Issue de GitHub, PR, discusión, notas de versión o hilo de hoja de ruta correspondiente
• adjunta documentos de soporte a Linear cuando el trabajo necesita contexto de planificación duradero
• solo refleja una nota local después si aún añade valor

Sincronización de Conocimiento entre Fuentes

Extrae conocimiento de múltiples fuentes a un solo lugar:

• Exportaciones de conversaciones de Claude/ChatGPT/Grok
• Marcadores del navegador
• Eventos de actividad de GitHub
• Escribe un resumen de estado, haz commit y push

Patrones de Memoria

# Corto plazo: contexto de sesión actual
Usa TodoWrite para seguimiento de tareas dentro de la sesión

# Medio plazo: archivos de memoria del proyecto
Escribe en ~/.claude/projects/*/memory/ para recuerdo entre sesiones

# Largo plazo: GitHub / Linear / KB
Pon la verdad de ejecución activa en GitHub + Linear
Pon el contexto sintetizado duradero en el repo de base de conocimiento

# Capa semántica: grafo de conocimiento MCP
Usa mcp__memory__create_entities para datos estructurados permanentes
Usa mcp__memory__create_relations para mapeo de relaciones
Usa mcp__memory__add_observations para nuevos hechos sobre entidades conocidas
Usa mcp__memory__search_nodes para encontrar conocimiento existente

Buenas Prácticas

• Mantén los archivos de memoria concisos. Archiva datos antiguos en lugar de dejar que los archivos crezcan sin límite.
• Usa frontmatter (YAML) para metadatos en todos los archivos de conocimiento.
• Deduplica antes de almacenar. Busca primero, luego crea o actualiza.
• Prefiere un único hogar canónico por conjunto de hechos. Evita copias paralelas del mismo plan en notas locales, archivos de repo y documentos de seguimiento.
• Oculta información sensible (API keys, contraseñas) antes de commitear a Git.
• Usa convenciones de nomenclatura consistentes para archivos de conocimiento (minúsculas-con-guiones).
• Etiqueta las entradas con temas/categorías para una recuperación más fácil.

Puerta de Calidad

Antes de completar cualquier operación de conocimiento:

• sin entradas duplicadas creadas
• datos sensibles ocultos de cualquier archivo rastreado por Git
• índices y resúmenes actualizados
• capa de almacenamiento apropiada elegida para el tipo de datos
• referencias cruzadas añadidas cuando sea relevante