agenticluke/knowledge-sync-plus

Operaciones de Conocimiento

Gestiona conocimiento a través de varios almacenes.

Asigna a cada hecho un hogar principal. Otros almacenes pueden contener una nota breve y un enlace a ese hogar.

Usa Esta Habilidad Cuando

Usa esta habilidad cuando el usuario quiera:

• Guardar hechos o notas en una base de conocimiento.
• Importar un archivo, chat o conjunto de datos.
• Sincronizar conocimiento entre almacenes.
• Encontrar o fusionar notas duplicadas.
• Buscar hechos conocidos sobre un tema.
• Actualizar una fuente de verdad compartida.
• Hacer más que una simple consulta de memoria.

Reglas Principales

• Mantén el trabajo de código en el repositorio clonado real.
• Coloca los planes activos y el estado del trabajo en GitHub, Linear o el repositorio.
• Coloca las notas largas fuera del repositorio de código cuando no pertenezcan al código.
• Coloca las notas a largo plazo y multiplataforma en la base de conocimiento.
• Busca antes de crear.
• No hagas dos copias principales del mismo hecho.
• No hagas llamadas externas a menos que el usuario lo solicite y la herramienta necesaria ya esté configurada.
• Nunca guardes claves, contraseñas, tokens, cookies ni datos de inicio de sesión privados.
• No hagas commit ni push a menos que el usuario lo solicite o ya haya aprobado ese paso.
• No reemplaces hechos más nuevos con notas más antiguas.

Capas de Almacenamiento

1. Fuente de Trabajo Activo

Ejemplos:

• Issues, pull requests, discusiones y notas de versión de GitHub
• Issues, proyectos y documentos de Linear
• Archivos en el repositorio de proyecto real

Úsalo para:

• Planes actuales
• Hojas de ruta
• Estado de versiones
• Estado de despliegue
• Trabajo de construcción y código

Si un hecho cambia el trabajo activo, actualiza esta capa primero.

2. Memoria de Claude Code

Ruta:

~/.claude/projects/*/memory/

Usa archivos Markdown cortos con frontmatter YAML.

Úsalo para:

• Decisiones del usuario
• Comentarios del usuario
• Hechos pequeños del proyecto
• Notas de referencia cortas
• Hechos necesarios en chats posteriores

No asumas que esta ruta existe o se puede cambiar. Verifica primero.

3. Memoria MCP

Herramientas comunes:

• create_entities
• create_relations
• add_observations
• search_nodes

Úsalo para:

• Personas, equipos, herramientas y proyectos nombrados
• Vínculos entre esos elementos
• Hechos que deberían ser fáciles de buscar después

Usa los nombres exactos de las herramientas del servidor MCP actual. Si no hay ningún servidor de memoria configurado, omite esta capa y dilo.

4. Repositorio de Base de Conocimiento

Úsalo para:

• Notas a largo plazo
• Exportaciones de sesiones
• Investigación conjunta
• Runbooks
• Documentos largos

Este es el almacén multiplataforma principal para contenido que no es código de proyecto.

5. Almacén de Datos

Ejemplos:

• Supabase
• PostgreSQL

Úsalo para:

• Grandes conjuntos de filas
• Grandes conjuntos de documentos
• Búsqueda de texto completo
• Datos que necesitan SQL

Mantén solo un resumen corto y un ID de registro en la memoria.

6. Notas y Archivo Local

Úsalo para:

• Notas para que las lean personas
• Planes antiguos
• Listas de medios locales
• Archivos no relacionados con código a corto plazo

No lo uses como un segundo repositorio de código ni como el hogar principal de planes activos.

Elige el Hogar Principal

Usa esta guía:

Tipo de conocimiento	Hogar principal	Copia opcional
Plan actual, versión o estado de código	GitHub, Linear o repositorio del proyecto	Nota corta en memoria
Decisión de negocio	Memoria del proyecto o base de conocimiento	Memoria MCP
Decisión o comentario del usuario	Memoria de Claude Code	Memoria MCP
Hecho de referencia pequeño	Memoria de Claude Code	Memoria MCP
Gran conjunto de documentos	Almacén de datos o base de conocimiento	Resumen corto en memoria
Exportación de chat o sesión	Repositorio de base de conocimiento	Resumen corto en memoria
Nota local a corto plazo	Archivo local	Ninguna

Si dos opciones encajan, elige el almacén que posee el trabajo. Agrega un enlace desde el otro almacén en lugar de copiar el texto completo.

Pasos de Importación

1. Leer y Clasificar

Encuentra:

• La fuente
• El tema
• La fecha
• El propietario
• Si los hechos están actualizados
• Si el texto contiene secretos
• El mejor hogar principal

No importes texto que no puedas leer o en el que no confíes. Marca los hechos inciertos como inciertos.

2. Buscar una Coincidencia

Antes de escribir:

• Busca en archivos de memoria.
• Busca en la memoria MCP cuando esté configurada.
• Busca en la base de conocimiento.
• Verifica en GitHub o Linear cuando puedan poseer el hecho.
• Verifica el almacén de datos de destino cuando se use.

Coincide por tema, nombres, fechas, IDs y enlaces de fuente.

3. Manejar Copias y Conflictos

Si el mismo hecho existe:

• Actualiza el registro principal.
• Agrega nuevos enlaces de fuente o fechas.
• Conserva el historial útil.
• Elimina o marca copias obsoletas solo cuando sea seguro.

Si dos fuentes están en desacuerdo:

• No adivines.
• Conserva ambas afirmaciones con sus fechas y fuentes.
• Prefiere la fuente más reciente solo cuando posea claramente el hecho.
• Pregunta al usuario cuando la elección cambie el trabajo o elimine datos.

4. Guardar

Escribe solo en almacenes que estén dentro del alcance y listos para usar.

• Actualiza la fuente de trabajo activo primero cuando el trabajo activo cambie.
• Mantén la memoria de Claude Code corta.
• Usa la memoria MCP para hechos y vínculos.
• Coloca texto largo en la base de conocimiento.
• Coloca conjuntos grandes en un almacén de datos.
• Agrega una fuente, fecha y propietario cuando se conozcan.

Si falta un almacén o es de solo lectura, no guardes nada allí. Informa lo que no se pudo hacer.

5. Actualizar Índices

Actualiza cualquier lista de temas, lista de sesiones o archivo de resumen utilizado para encontrar el nuevo elemento.

Usa nombres de archivo en minúsculas con kebab-case, por ejemplo:

release-plan-2026-05.md

6. Verificar el Resultado

Vuelve a leer cada registro modificado. Asegúrate de que los enlaces, fechas y nombres sean correctos.

Trabajo de Sincronización

Sincronizar Chats

Para exportaciones de Claude, Codex u otros chats:

1. Elimina secretos y datos de inicio de sesión privados.
2. Conserva el nombre de la fuente y la fecha.
3. Guarda la exportación completa en la base de conocimiento.
4. Agrega un resumen corto en la memoria.
5. Actualiza el índice de sesiones.
6. Haz commit y push solo con la aprobación del usuario.

Sincronizar Estado del Espacio de Trabajo

Para archivos y configuraciones clave:

1. Haz un mapa de carpetas.
2. Copia solo hechos útiles y sin secretos.
3. Elimina claves, tokens, contraseñas, cookies y rutas privadas.
4. Anota la fuente y la fecha.
5. Rastrea los cambios a lo largo del tiempo.

No copies una carpeta de código activo completa en un archivo.

Sincronizar GitHub o Linear

Cuando un hecho cambie el trabajo activo:

1. Encuentra el elemento que posee el trabajo.
2. Actualiza ese elemento primero.
3. Agrega documentos de respaldo cuando sea necesario.
4. Agrega una nota local solo si aporta valor adicional.
5. Vincula la nota al elemento principal.

Sincronizar Múltiples Fuentes

Para chats, marcadores, eventos de GitHub u otras fuentes:

1. Agrupa elementos por tema.
2. Elimina copias exactas y casi exactas.
3. Conserva los enlaces de fuente y las fechas.
4. Escribe una nota de estado clara.
5. Guárdala en el hogar principal.
6. Haz commit y push solo con la aprobación del usuario.

Patrón de Memoria

A corto plazo:
Usa la lista de tareas actual para el trabajo en este chat.

A medio plazo:
Usa archivos cortos en ~/.claude/projects/*/memory/.

A largo plazo:
Usa GitHub o Linear para el trabajo activo.
Usa la base de conocimiento para notas largas.

Hechos vinculados:
Usa la memoria MCP para elementos, hechos y vínculos.

Formulario de Archivo de Conocimiento

---
title: Plan de versión
type: project
topics:
  - release
  - mobile-app
source: https://example.com/item/123
updated: 2026-05-12
status: current
---

# Plan de Versión

Los hechos cortos van aquí.

## Enlaces

- Elemento de trabajo principal: URL o ruta de archivo

Usa solo campos que ayuden. Usa una fecha ISO en formato YYYY-MM-DD. Establece status en current, stale, archived o unclear.

Ejemplo Concreto

Solicitud del usuario:

Guarda esto: El lanzamiento de la aplicación móvil se movió del 1 de junio al 15 de junio. El issue 42 de GitHub es el propietario del plan de lanzamiento.

Pasos:

1. Busca el plan de lanzamiento en GitHub, memoria, memoria MCP y base de conocimiento.
2. Abre el issue 42 y verifica que sea el elemento de trabajo principal.
3. Si está permitido, actualiza el issue 42 al 15 de junio.
4. Actualiza la nota de memoria antigua en lugar de crear una nueva.
5. Agrega un hecho MCP que indique que la fecha de lanzamiento es el 15 de junio y vincúlalo al issue 42.
6. Marca cualquier nota del 1 de junio como obsoleta. Consérvala solo si la fecha antigua es un historial útil.
7. Vuelve a leer la fecha y los enlaces guardados.
8. Informa cada almacén modificado y cualquier almacén omitido.

No actualices GitHub si el usuario solo solicitó una revisión o búsqueda.

Casos Extremos

• Si la fuente no tiene fecha, di que la fecha es desconocida.
• Si el propietario no está claro, pregunta antes de cambiar un plan activo.
• Si un archivo es demasiado grande, guárdalo en la base de conocimiento o en el almacén de datos y conserva una nota corta en memoria.
• Si dos elementos comparten un nombre, usa IDs, enlaces, propietarios y fechas para distinguirlos.
• Si el contenido puede ser privado, guarda la menor cantidad necesaria.
• Si se encuentra un secreto, déjalo fuera. No lo copies ni lo imprimas.
• Si una escritura falla parcialmente, no afirmes que la sincronización está completa. Enumera lo que funcionó y lo que falló.
• Si un guardado eliminaría un historial útil, archívalo o pregunta primero.
• Si no hay un hogar principal seguro, pregunta al usuario dónde debería ir.
• Si el mismo hecho debe aparecer en dos almacenes, conserva el texto completo en un almacén. Coloca una nota breve y un enlace en el otro.

Verificación Final

Antes de terminar, confirma:

• No se creó ningún duplicado nuevo.
• Cada hecho tiene un hogar principal.
• Los hechos antiguos se actualizaron o marcaron como obsoletos.
• No se guardó ni imprimió ningún secreto.
• Las fechas, nombres, IDs y enlaces son correctos.
• Los índices y resúmenes están actualizados.
• Se agregaron enlaces cruzados cuando fue útil.
• Todos los registros modificados se volvieron a leer.
• No se realizó ningún commit, push ni escritura externa sin aprobación.
• Se informó al usuario qué cambió, qué se omitió y por qué.