project-memory MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Canon de cuatro archivos: bugs.md, decision.md, key_facts.md, issues.md
Claude los lee antes de proponer cambios arquitectónicos.
Tres ámbitos de instalación: global (~/.claude/skills), proyecto (.claude/skills), espacio de trabajo
Instalable mediante skilz (pip) o copia simple
Sin base de datos: solo Markdown que puedes diferenciar y revisar

Demo en vivo

Cómo se ve en la práctica

project-memory-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "project-memory-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ],
      "_inferred": false
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "project-memory-skill",
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "SpillwaveSolutions_project-memory/project-memory"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "project-memory-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "SpillwaveSolutions_project-memory/project-memory"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add project-memory-skill -- pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: project-memory

Memoria de proyecto Bootstrap en una base de código existente

👤 Equipos cansados de volver a explicar el mismo contexto a su agente ⏱ ~15 min beginner

Cuándo usarlo: Has estado usando Claude Code en este repositorio, pero el contexto se restablece en cada sesión.

Requisitos previos

Python 3.10+ para el instalador de Skillz — pyenv o sistema Python

Flujo

Instalar en el alcance del proyecto

pip install skilz && skilz install SpillwaveSolutions_project-memory/project-memory --scope proyecto✓ Copiado

→ Aparece .claude/skills/project-memory/SKILL.md
Ejecute el comando de arranque

/project-memory: inicializa los cuatro archivos para este repositorio.✓ Copiado

→ docs/project_notes/ creado con los cuatro archivos canónicos
Decisiones de semillas.md con 2 o 3 opciones conocidas

Agregue ADR para nuestra elección de ORM, nuestra convención de manejo de errores y nuestro corredor de CI.✓ Copiado

→ Tres entradas ADR ordenadas

Resultado: Claude ahora tiene un cerebro persistente y revisable para este repositorio.

Errores comunes

Confirmando key_facts.md con secretos — La habilidad marca explícitamente key_facts.md como "no confidencial"; nunca coloque credenciales allí

Combinar con: memory-bank-mcp

Capture la causa raíz de un error para que nunca vuelva a aparecer

👤 Ingenieros de guardia apagando un incendio ⏱ ~5 min beginner

Cuándo usarlo: Acabas de arreglar algo complicado y quieres que la lección sea duradera.

Flujo

Pídele a Claude que lo grabe.

Agregue esto a bugs.md: el error fue Ninguno en billing.retry; causa raíz: caché de claves de idempotencia obsoletas; Prevención: TTL en el caché.✓ Copiado

→ Nueva entrada de bugs.md con causa raíz + prevención

Resultado: Un catálogo de errores que dará sus frutos la próxima vez que aparezca un síntoma similar.

Errores comunes

Escribir el síntoma en lugar de la causa — Fuerce la entrada para que tenga una sección "Causa raíz" y "Prevención", no solo "lo que arreglé"

Combinar con: github

Deje que Claude consulte decision.md antes de sugerir una refactorización

👤 Equipos que odian volver a litigar decisiones acordadas con su agente ⏱ ~10 min beginner

Cuándo usarlo: Su agente sigue proponiendo marcos/patrones a los que el equipo ya dijo que no.

Flujo

Asegúrese de que la decisión esté en Decisions.md

Registro: 'Usamos el patrón Repositorio, no Registro Activo. Justificación: <x>.'✓ Copiado

→ Borrar ADR en decisiones.md
Pregunta por la refactorización

Proponga una refactorización de src/billing/: respete nuestras decisiones.md.✓ Copiado

→ La propuesta hace referencia a la decisión del Repositorio y no sugiere Registro Activo

Resultado: Menos propuestas sin salida que sean rechazadas en la revisión.

Combinar con: git

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

project-memory-skill + memory-bank-mcp

Utilice project-memory para los cuatro archivos canónicos seleccionados, Memory-bank-mcp para una memoria de trabajo de formato libre en todos los proyectos.

Escriba ADR estructurados en Decisions.md; volcar notas de sesión sin procesar en el banco de memoria.✓ Copiado

project-memory-skill + github

Después de fusionar un PR, actualice Decisions.md y issues.md como parte de la descripción del PR

Abra el PR e incluya decisiones.md diff en la descripción.✓ Copiado

project-memory-skill + git

Revise las diferencias de memoria antes de comprometerse para mantenerlas honestas.

git diff docs/project_notes/ — leer antes de confirmar; arreglar cualquier cosa engañosa.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
/project-memory	subcommand: init\|add-bug\|add-decision\|add-fact\|log-issue	Arranque los archivos y registre nuevas entradas	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguna
Tokens por llamada: Depende de cuántos de los cuatro archivos cargue Claude; mantener las entradas cortas
Monetario: Gratis
Consejo: Prefiera entradas breves y fechadas a narrativas largas: Claude las escanea en cada sesión, por lo que el tamaño importa.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Explícitamente: key_facts.md es solo para configuraciones no confidenciales. Guarde los secretos en env o en una bóveda, no aquí.

Salida de datos: Archivos locales; no hay actividad de red desde la habilidad misma

Si envía docs/project_notes/ a un repositorio público, recuerde que Claude puede haber registrado detalles internos; revíselos antes de enviarlos.
No permita que los agentes agreguen automáticamente decisiones.md sin revisión; ahí es donde el contexto obsoleto o incorrecto corroe todo el sistema.

Resolución de problemas

Errores comunes y soluciones

Comando /project-memory no reconocido

Habilidad no instalada en el alcance esperado. Reinstale con Skillz y reinicie Claude.

Verificar: ls ~/.claude/skills/project-memory/ or .claude/skills/project-memory/

Claude ignora las decisiones.md

Asegúrese de que Decisiones.md tenga entradas claras de estilo ADR con encabezados "Decisión" y "Justificación"; Se pasan por alto viñetas vagas.

Verificar: head docs/project_notes/decisions.md

Los archivos siguen creciendo

Archivar trimestralmente: mueva las entradas antiguas a docs/project_notes/archive/ para que los archivos activos sigan siendo escaneables.

Verificar: wc -l docs/project_notes/*.md

Alternativas

project-memory vs otros

Alternativa	Cuándo usarla	Contrapartida
memory-bank-mcp	Quiere que la memoria entre proyectos sea accesible mediante herramientas, no archivos	Más flexibilidad, menos visible en las revisiones de relaciones públicas
codebase-memory	Quieres un gráfico de símbolos del código, no notas narrativas.	Diferentes capas de memoria
marm-systems	Quieres un marco de memoria más elaborado	Configuración más pesada

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills