@grec0/memory-bank-mcp 0.0.6 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 # Memory Bank MCP - Semantic Code Indexing
 
-Servidor MCP (Model Context Protocol) para indexación semántica de código. Permite a agentes de IA como Claude mantener un "memoria persistente" de bases de código completas mediante embeddings vectoriales y búsqueda semántica.
+Servidor MCP (Model Context Protocol) para indexación semántica de código. Permite a agentes de IA como Claude, Copilot, Cursor y otros mantener una "memoria persistente" de bases de código completas mediante embeddings vectoriales y búsqueda semántica.
 
 ## 🧠 ¿Qué es Memory Bank?
 
@@ -11,6 +11,7 @@ Servidor MCP (Model Context Protocol) para indexación semántica de código. Pe
 - **Almacena** vectores en LanceDB para búsquedas ultrarrápidas
 - **Busca** semánticamente: pregunta en lenguaje natural, obtén código relevante
 - **Actualiza** incrementalmente: solo reindexa archivos modificados
+- **Multi-proyecto**: consulta código de cualquier proyecto indexado desde cualquier workspace
 
 ### ¿Por qué lo necesitas?
 
@@ -25,6 +26,7 @@ Con Memory Bank, las IAs:
 - ✅ Entienden arquitectura y patrones
 - ✅ Responden con código real del proyecto
 - ✅ Generan código consistente con tu estilo
+- ✅ **Consultan múltiples proyectos** indexados simultáneamente
 
 ## 🚀 Características
 
@@ -36,6 +38,7 @@ Con Memory Bank, las IAs:
 - **🎯 Filtros Avanzados**: Por archivo, lenguaje, tipo de chunk
 - **📊 Estadísticas Detalladas**: Conoce el estado de tu índice en todo momento
 - **🔒 Privacidad**: Vector store local, respeta .gitignore y .memoryignore
+- **🔀 Multi-Proyecto**: Consulta cualquier proyecto indexado usando su `projectId`
 
 ### Project Knowledge Layer (Conocimiento Global) 🆕
 - **📄 Documentación Automática**: Genera 6 documentos markdown estructurados del proyecto
@@ -43,16 +46,6 @@ Con Memory Bank, las IAs:
 - **🔄 Actualización Inteligente**: Solo regenera documentos afectados por cambios
 - **📚 Contexto Global**: Complementa búsqueda precisa con visión de alto nivel
 
-Los documentos generados incluyen:
-| Documento | Propósito |
-|-----------|-----------|
-| `projectBrief.md` | Descripción general del proyecto |
-| `productContext.md` | Perspectiva de negocio y usuarios |
-| `systemPatterns.md` | Patrones de arquitectura y diseño |
-| `techContext.md` | Stack tecnológico y dependencias |
-| `activeContext.md` | Estado actual de desarrollo |
-| `progress.md` | Seguimiento de cambios |
-
 ## 📋 Requisitos
 
 - **Node.js** >= 18.0.0
@@ -75,7 +68,7 @@ Para desarrollo o contribución:
 
 ```bash
 # Clonar repositorio
-git clone https://github.com/grec0/memory-bank-mcp.git
+git clone https://github.com/gcorroto/memory-bank-mcp.git
 cd memory-bank-mcp
 
 # Instalar dependencias
@@ -88,33 +81,85 @@ npm run build
 npm run start
 ```
 
-## ⚙️ Configuración
+## ⚙️ Configuración Completa
 
 ### Variables de Entorno
 
-Crea un archivo `.env` en la raíz de tu workspace (o configúralas en tu cliente MCP):
+Memory Bank se configura mediante variables de entorno. Puedes configurarlas en tu cliente MCP o en un archivo `.env`:
 
-```bash
-# REQUERIDO: Tu API key de OpenAI
-OPENAI_API_KEY=sk-your-api-key-here
+#### Variables Requeridas
+
+| Variable | Descripción |
+|----------|-------------|
+| `OPENAI_API_KEY` | **REQUERIDO**. Tu API key de OpenAI |
+
+#### Variables de Indexación
+
+| Variable | Default | Descripción |
+|----------|---------|-------------|
+| `MEMORYBANK_STORAGE_PATH` | `.memorybank` | Directorio donde se almacena el índice vectorial |
+| `MEMORYBANK_WORKSPACE_ROOT` | `process.cwd()` | Raíz del workspace (se auto-detecta normalmente) |
+| `MEMORYBANK_EMBEDDING_MODEL` | `text-embedding-3-small` | Modelo de embeddings de OpenAI |
+| `MEMORYBANK_EMBEDDING_DIMENSIONS` | `1536` | Dimensiones del vector (1536 o 512) |
+| `MEMORYBANK_MAX_TOKENS` | `7500` | Tokens máximos por chunk (límite: 8192) |
+| `MEMORYBANK_CHUNK_OVERLAP_TOKENS` | `200` | Solapamiento entre chunks para mantener contexto |
+
+#### Variables del Project Knowledge Layer
+
+| Variable | Default | Descripción |
+|----------|---------|-------------|
+| `MEMORYBANK_REASONING_MODEL` | `gpt-5-mini` | Modelo para generar documentación (soporta reasoning) |
+| `MEMORYBANK_REASONING_EFFORT` | `medium` | Nivel de razonamiento: `low`, `medium`, `high` |
+| `MEMORYBANK_AUTO_UPDATE_DOCS` | `false` | Auto-regenerar docs cuando se indexa código |
+
+### Configuración en Cursor IDE
 
-# OPCIONAL: Configuración de indexación
-MEMORYBANK_STORAGE_PATH=.memorybank              # Dónde almacenar el índice
-MEMORYBANK_EMBEDDING_MODEL=text-embedding-3-small # Modelo de OpenAI
-MEMORYBANK_EMBEDDING_DIMENSIONS=1536             # Dimensiones (1536 o 512)
-MEMORYBANK_MAX_TOKENS=7500                       # Tokens máx por chunk (límite: 8192)
-MEMORYBANK_CHUNK_OVERLAP_TOKENS=200              # Overlap en tokens entre chunks
-MEMORYBANK_WORKSPACE_ROOT=/path/to/project       # Raíz del workspace
+Edita tu archivo de configuración de MCP:
 
-# OPCIONAL: Project Knowledge Layer (documentación con IA)
-MEMORYBANK_REASONING_MODEL=gpt-5-mini            # Modelo de razonamiento
-MEMORYBANK_REASONING_EFFORT=medium               # low/medium/high
-MEMORYBANK_AUTO_UPDATE_DOCS=false                # Auto-actualizar docs al indexar
+**Windows**: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+
+#### Configuración Mínima
+
+```json
+{
+  "mcpServers": {
+    "memory-bank-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@grec0/memory-bank-mcp@latest"],
+      "env": {
+        "OPENAI_API_KEY": "sk-your-api-key-here"
+      }
+    }
+  }
+}
 ```
 
-### Configuración en Claude Desktop
+#### Configuración Completa (Recomendada)
+
+```json
+{
+  "mcpServers": {
+    "memory-bank-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@grec0/memory-bank-mcp@latest"],
+      "env": {
+        "OPENAI_API_KEY": "sk-your-api-key-here",
+        "MEMORYBANK_REASONING_MODEL": "gpt-5-mini",
+        "MEMORYBANK_REASONING_EFFORT": "medium",
+        "MEMORYBANK_AUTO_UPDATE_DOCS": "false",
+        "MEMORYBANK_MAX_TOKENS": "7500",
+        "MEMORYBANK_CHUNK_OVERLAP_TOKENS": "200",
+        "MEMORYBANK_EMBEDDING_MODEL": "text-embedding-3-small",
+        "MEMORYBANK_EMBEDDING_DIMENSIONS": "1536"
+      }
+    }
+  }
+}
+```
 
-Edita tu archivo de configuración de Claude Desktop:
+### Configuración en Claude Desktop
 
 **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
 **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
@@ -127,7 +172,9 @@ Edita tu archivo de configuración de Claude Desktop:
       "command": "npx",
       "args": ["@grec0/memory-bank-mcp@latest"],
       "env": {
-        "OPENAI_API_KEY": "sk-your-api-key-here"
+        "OPENAI_API_KEY": "sk-your-api-key-here",
+        "MEMORYBANK_REASONING_MODEL": "gpt-5-mini",
+        "MEMORYBANK_REASONING_EFFORT": "medium"
       }
     }
   }
@@ -151,6 +198,151 @@ Edita tu archivo de configuración de Claude Desktop:
 }
 ```
 
+---
+
+## 📄 Sistema de Documentación del Proyecto (Project Knowledge Layer)
+
+Memory Bank incluye un sistema inteligente de documentación que genera y mantiene conocimiento estructurado sobre tu proyecto usando IA con capacidades de razonamiento.
+
+### ¿Cómo Funciona?
+
+1. **Análisis del Código**: El sistema analiza el código indexado usando búsqueda semántica
+2. **Generación con IA**: Usa modelos con razonamiento (gpt-5-mini) para generar documentación estructurada
+3. **Actualización Incremental**: Solo regenera documentos afectados cuando hay cambios significativos
+4. **Almacenamiento Persistente**: Los documentos se guardan en `.memorybank/projects/{projectId}/docs/`
+
+### Documentos Generados
+
+El sistema genera **6 documentos markdown** que proporcionan diferentes perspectivas del proyecto:
+
+| Documento | Propósito | Contenido |
+|-----------|-----------|-----------|
+| `projectBrief.md` | **Descripción General** | Qué es el proyecto, su propósito principal, funcionalidades clave |
+| `productContext.md` | **Perspectiva de Negocio** | Por qué existe, problemas que resuelve, usuarios objetivo, UX |
+| `systemPatterns.md` | **Arquitectura y Patrones** | Estructura del código, patrones de diseño, decisiones técnicas |
+| `techContext.md` | **Stack Tecnológico** | Tecnologías, dependencias, configuraciones, integraciones |
+| `activeContext.md` | **Estado Actual** | En qué se está trabajando, cambios recientes, próximos pasos |
+| `progress.md` | **Seguimiento** | Historial de cambios, qué funciona, qué falta, problemas conocidos |
+
+### Herramientas de Documentación
+
+#### `memorybank_generate_project_docs`
+
+Genera o regenera la documentación del proyecto.
+
+```json
+{
+  "projectId": "my-project",
+  "force": false
+}
+```
+
+- `projectId` **(REQUERIDO)**: ID del proyecto
+- `force` (opcional): `true` para regenerar todo, `false` para actualizar incrementalmente
+
+#### `memorybank_get_project_docs`
+
+Lee la documentación generada.
+
+```json
+// Obtener resumen de todos los documentos
+{
+  "projectId": "my-project",
+  "document": "summary"
+}
+
+// Obtener documento específico
+{
+  "projectId": "my-project",
+  "document": "systemPatterns"
+}
+
+// Obtener todos los documentos completos
+{
+  "projectId": "my-project",
+  "document": "all",
+  "format": "full"
+}
+```
+
+### Flujo de Trabajo con Documentación
+
+```
+1. Indexar código
+   memorybank_index_code({ projectId: "my-project" })
+
+2. Generar documentación
+   memorybank_generate_project_docs({ projectId: "my-project" })
+
+3. Consultar documentación al inicio de cada sesión
+   memorybank_get_project_docs({ projectId: "my-project", document: "activeContext" })
+
+4. Buscar código específico
+   memorybank_search({ projectId: "my-project", query: "..." })
+```
+
+### Auto-Actualización de Documentación
+
+Si configuras `MEMORYBANK_AUTO_UPDATE_DOCS=true`, los documentos se regenerarán automáticamente después de cada indexación. Esto es útil para mantener la documentación siempre actualizada pero consume más tokens de API.
+
+---
+
+## 🔀 Multi-Proyecto: Consultas Entre Proyectos
+
+Una característica poderosa de Memory Bank es la capacidad de **consultar cualquier proyecto indexado desde cualquier workspace**.
+
+### ¿Cómo Funciona?
+
+Todos los proyectos indexados se almacenan en un vector store compartido, identificados por su `projectId`. Esto significa que:
+
+1. **Puedes trabajar en el Proyecto A** y consultar código del Proyecto B
+2. **Los agentes pueden aprender** de proyectos similares ya indexados
+3. **Reutiliza patrones** de otros proyectos de tu organización
+
+### Ejemplo de Uso
+
+```
+# Estás trabajando en "frontend-app" pero necesitas ver cómo se hizo algo en "backend-api"
+
+Usuario: ¿Cómo se implementó la autenticación en el proyecto backend-api?
+
+Agente: [ejecuta memorybank_search({ 
+  projectId: "backend-api",  // Otro proyecto
+  query: "autenticación JWT middleware"
+})]
+
+Encontré la implementación en backend-api:
+- El middleware de auth está en src/middleware/auth.ts
+- Usa JWT con refresh tokens
+- La validación se hace con jsonwebtoken...
+```
+
+### Requisitos para Multi-Proyecto
+
+1. **El proyecto debe estar indexado** previamente con su `projectId`
+2. **Usa el projectId correcto** al hacer consultas
+3. **La documentación es independiente** por proyecto
+
+### Ejemplo Real: Dos Proyectos Relacionados
+
+```json
+// Proyecto 1: a2a_gateway (ya indexado)
+memorybank_search({
+  "projectId": "a2a_gateway",
+  "query": "cómo se registran los agentes"
+})
+
+// Proyecto 2: GREC0AI (workspace actual)
+memorybank_search({
+  "projectId": "GREC0AI", 
+  "query": "implementación de AgentEntity"
+})
+
+// Puedes consultar ambos en la misma sesión!
+```
+
+---
+
 ## 📚 Herramientas Disponibles
 
 > **⚠️ IMPORTANTE**: Todas las herramientas requieren `projectId` obligatorio. Este ID debe coincidir con el definido en tu archivo `AGENTS.md`.
@@ -205,11 +397,6 @@ Lee contenido de un archivo.
 - `startLine` (opcional): Línea inicial
 - `endLine` (opcional): Línea final
 
-**Ejemplo:**
-```
-memorybank_read_file({ path: "src/auth/service.ts", startLine: 50, endLine: 100 })
-```
-
 ### `memorybank_write_file`
 
 Escribe un archivo y lo reindexa automáticamente.
@@ -220,132 +407,61 @@ Escribe un archivo y lo reindexa automáticamente.
 - `content` (requerido): Contenido del archivo
 - `autoReindex` (opcional): Auto-reindexar (default: true)
 
-**Ejemplo:**
-```json
-{
-  "projectId": "my-project",
-  "path": "src/utils/validator.ts",
-  "content": "export function validateEmail(email: string) { ... }"
-}
-```
-
 ### `memorybank_get_stats`
 
 Obtiene estadísticas del Memory Bank.
 
-**Ejemplo:**
-```
-memorybank_get_stats({})
-```
-
 ### `memorybank_analyze_coverage`
 
 Analiza la cobertura de indexación del proyecto.
 
 **Parámetros:**
 - `projectId` **(REQUERIDO)**: Identificador del proyecto a analizar
-- `path` (opcional): Ruta específica a analizar
+- `path` **(REQUERIDO)**: Ruta absoluta del workspace a analizar
 
 **Ejemplo:**
 ```json
 {
-  "projectId": "my-project"
+  "projectId": "my-project",
+  "path": "C:/workspaces/my-project"
 }
 ```
 
-### `memorybank_generate_project_docs` 🆕
+### `memorybank_generate_project_docs`
 
-Genera documentación estructurada del proyecto usando IA con razonamiento (gpt-5-mini).
+Genera documentación estructurada del proyecto usando IA con razonamiento.
 
 **Parámetros:**
 - `projectId` **(REQUERIDO)**: Identificador del proyecto
 - `force` (opcional): Forzar regeneración (default: false)
 
-**Ejemplo:**
-```json
-{
-  "projectId": "my-project",
-  "force": true
-}
-```
-
-Genera 6 documentos markdown:
-- `projectBrief.md`: Descripción general
-- `productContext.md`: Perspectiva de negocio
-- `systemPatterns.md`: Patrones de arquitectura
-- `techContext.md`: Stack tecnológico
-- `activeContext.md`: Estado actual
-- `progress.md`: Seguimiento
-
-### `memorybank_get_project_docs` 🆕
+### `memorybank_get_project_docs`
 
 Lee la documentación del proyecto generada por IA.
 
 **Parámetros:**
 - `projectId` **(REQUERIDO)**: Identificador del proyecto
-- `document` (opcional): Documento específico o "all"/"summary" (default: "summary")
-- `format` (opcional): "full" o "summary" (default: "full")
-
-**Ejemplo:**
-```json
-// Obtener resumen de todos los docs
-{
-  "projectId": "my-project",
-  "document": "summary"
-}
+- `document` (opcional): `"summary"`, `"all"`, o nombre específico (`projectBrief`, `systemPatterns`, etc.)
+- `format` (opcional): `"full"` o `"summary"` (default: "full")
 
-// Obtener documento específico
-{
-  "projectId": "my-project",
-  "document": "systemPatterns"
-}
-```
+---
 
 ## 📋 Plantillas de Instrucciones para Agentes
 
-Memory Bank incluye plantillas de instrucciones en dos formatos:
-- **AGENTS.md** - Estándar [agents.md](https://agents.md/) (compatible con múltiples agentes)
-- **VSCode/Copilot** - Formato `.github/copilot-instructions.md` para VS Code
-
-### Instalación - Formato AGENTS.md
-
-Copia la plantilla que prefieras a la raíz de tu proyecto:
-
-```bash
-# Elegir una plantilla
-cp node_modules/@grec0/memory-bank-mcp/templates/AGENTS.basic.md ./AGENTS.md
-
-# Editar los placeholders
-# Reemplaza {{PROJECT_ID}} con tu ID de proyecto
-# Reemplaza {{WORKSPACE_PATH}} con la ruta del workspace
-```
-
-### Instalación - Formato VS Code
+Memory Bank incluye plantillas de instrucciones en dos formatos para configurar el comportamiento del agente:
 
-Para VS Code con GitHub Copilot, usa el formato `copilot-instructions.md`:
+- **AGENTS.md** - Estándar [agents.md](https://agents.md/) (compatible con Claude, Cursor, múltiples agentes)
+- **VSCode/Copilot** - Formato `.github/copilot-instructions.md` para GitHub Copilot en VS Code
 
-```bash
-# Crear carpeta .github si no existe
-mkdir -p .github
+### Modos Disponibles
 
-# Elegir una plantilla
-cp node_modules/@grec0/memory-bank-mcp/templates/vscode/copilot-instructions.basic.md ./.github/copilot-instructions.md
+| Modo | Archivo | Uso Ideal |
+|------|---------|-----------|
+| **Basic** | `AGENTS.basic.md` | Control total, indexación manual |
+| **Auto-Index** | `AGENTS.auto-index.md` | Desarrollo activo, sincronización automática |
+| **Sandboxed** | `AGENTS.sandboxed.md` | Entornos sin acceso directo a archivos |
 
-# Habilitar en VS Code settings.json:
-# "github.copilot.chat.codeGeneration.useInstructionFiles": true
-```
-
-También puedes usar el archivo `.instructions.md` con aplicación condicional:
-
-```bash
-# Crear carpeta de instrucciones
-mkdir -p .github/instructions
-
-# Copiar instrucciones base
-cp node_modules/@grec0/memory-bank-mcp/templates/vscode/memory-bank.instructions.md ./.github/instructions/
-```
-
-### 1. Basic Mode (`AGENTS.basic.md`)
+### 1. Basic Mode
 
 **Para proyectos donde quieres control total.**
 
@@ -356,7 +472,7 @@ cp node_modules/@grec0/memory-bank-mcp/templates/vscode/memory-bank.instructions
 
 **Ideal para**: Proyectos críticos, revisión de código, onboarding.
 
-### 2. Auto-Index Mode (`AGENTS.auto-index.md`)
+### 2. Auto-Index Mode
 
 **Para desarrollo activo con sincronización automática.**
 
@@ -367,7 +483,7 @@ cp node_modules/@grec0/memory-bank-mcp/templates/vscode/memory-bank.instructions
 
 **Ideal para**: Desarrollo activo, iteración rápida, equipos.
 
-### 3. Sandboxed Mode (`AGENTS.sandboxed.md`)
+### 3. Sandboxed Mode
 
 **Para entornos sin acceso directo al sistema de archivos.**
 
@@ -378,14 +494,81 @@ cp node_modules/@grec0/memory-bank-mcp/templates/vscode/memory-bank.instructions
 
 **Ideal para**: Entornos restringidos, desarrollo remoto, seguridad.
 
-### Ejemplo de `AGENTS.md` Configurado
+### Plantillas Disponibles
+
+Todas las plantillas están disponibles en el repositorio de GitHub:
+
+#### Formato AGENTS.md (Cursor, Claude, Multi-agente)
+
+| Modo | URL |
+|------|-----|
+| **Basic** | [AGENTS.basic.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/AGENTS.basic.md) |
+| **Auto-Index** | [AGENTS.auto-index.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/AGENTS.auto-index.md) |
+| **Sandboxed** | [AGENTS.sandboxed.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/AGENTS.sandboxed.md) |
+
+**Instalación:**
+
+```bash
+# Descargar plantilla (elige una)
+curl -o AGENTS.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/AGENTS.basic.md
+# O
+curl -o AGENTS.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/AGENTS.auto-index.md
+# O
+curl -o AGENTS.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/AGENTS.sandboxed.md
+
+# Editar los placeholders:
+# - Reemplaza {{PROJECT_ID}} con tu ID de proyecto único
+# - Reemplaza {{WORKSPACE_PATH}} con la ruta absoluta del workspace
+```
+
+#### Formato VS Code / GitHub Copilot
+
+| Modo | URL |
+|------|-----|
+| **Basic** | [copilot-instructions.basic.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/copilot-instructions.basic.md) |
+| **Auto-Index** | [copilot-instructions.auto-index.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/copilot-instructions.auto-index.md) |
+| **Sandboxed** | [copilot-instructions.sandboxed.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/copilot-instructions.sandboxed.md) |
+| **Instructions** | [memory-bank.instructions.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/memory-bank.instructions.md) |
+
+**Instalación:**
+
+```bash
+# Crear carpeta .github si no existe
+mkdir -p .github
+
+# Descargar plantilla (elige una)
+curl -o .github/copilot-instructions.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/vscode/copilot-instructions.basic.md
+# O
+curl -o .github/copilot-instructions.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/vscode/copilot-instructions.auto-index.md
+# O
+curl -o .github/copilot-instructions.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/vscode/copilot-instructions.sandboxed.md
+
+# Habilitar en VS Code settings.json:
+# "github.copilot.chat.codeGeneration.useInstructionFiles": true
+```
+
+#### Instrucciones con Aplicación Condicional (VS Code)
+
+Para usar el archivo `.instructions.md` que aplica solo a ciertos archivos:
+
+```bash
+# Crear carpeta de instrucciones
+mkdir -p .github/instructions
+
+# Descargar instrucciones base
+curl -o .github/instructions/memory-bank.instructions.md https://raw.githubusercontent.com/gcorroto/memory-bank-mcp/main/templates/vscode/memory-bank.instructions.md
+```
+
+Este archivo incluye `applyTo: "**/*"` que aplica a todos los archivos, pero puedes modificarlo.
+
+### Ejemplo de AGENTS.md Configurado
 
 ```markdown
 # AGENTS.md
 
 ## Project Configuration
 - **Project ID**: `my-awesome-app`
-- **Workspace**: `/home/user/projects/my-awesome-app`
+- **Workspace**: `C:/workspaces/my-awesome-app`
 
 ## Memory Bank Instructions
 
@@ -395,8 +578,14 @@ Before any action, call `memorybank_search` with projectId="my-awesome-app"
 ### Auto-Indexing Policy
 AFTER every file modification:
 memorybank_index_code({ projectId: "my-awesome-app", path: "<modified_file>" })
+
+### Session Start
+At the beginning of each session, get context:
+memorybank_get_project_docs({ projectId: "my-awesome-app", document: "activeContext" })
 ```
 
+---
+
 ## 🎯 Casos de Uso
 
 ### 1. Primera Indexación
@@ -427,21 +616,40 @@ Claude: [ejecuta memorybank_search({ projectId: "my-app", query: "autenticación
         La validación se hace en el middleware src/middleware/auth.ts.
 ```
 
-### 3. Modificación de Código
+### 3. Consulta Entre Proyectos
+
+```
+Usuario: Estoy trabajando en "frontend-v2" pero quiero ver cómo se hizo la 
+         paginación en el proyecto "admin-dashboard"
+
+Claude: [ejecuta memorybank_search({ 
+          projectId: "admin-dashboard", 
+          query: "paginación tabla listado" 
+        })]
+        
+        En admin-dashboard, la paginación se implementó así...
+        [Muestra código del otro proyecto]
+        
+        ¿Quieres que implemente algo similar en frontend-v2?
+```
+
+### 4. Generación de Documentación
 
 ```
-Usuario: Añade validación de email al formulario de registro
-Claude: [busca formulario de registro con projectId]
-        [busca validadores existentes con projectId]
-        [lee archivo actual]
-        [genera código respetando estilo del proyecto]
-        [escribe archivo con memorybank_write_file({ projectId: "my-app", ... })]
+Usuario: Genera documentación del proyecto para nuevos desarrolladores
+Claude: [ejecuta memorybank_generate_project_docs({ projectId: "my-app" })]
+        
+        He generado 6 documentos de conocimiento del proyecto:
+        - projectBrief.md: Descripción general
+        - systemPatterns.md: Arquitectura y patrones
+        - techContext.md: Stack tecnológico
+        ...
         
-        He añadido la validación de email en src/forms/RegisterForm.tsx línea 45.
-        Usa el validador existente de emailValidator.ts para mantener consistencia.
-        El archivo ha sido reindexado automáticamente.
+        Puedes consultarlos en cualquier momento con memorybank_get_project_docs
 ```
 
+---
+
 ## 🔧 Archivos de Configuración
 
 ### `.memoryignore`
@@ -474,26 +682,27 @@ build/
 *.mp4
 ```
 
-**Copia el ejemplo**:
-```bash
-cp .memoryignore.example .memoryignore
-```
-
 ### Respeto de `.gitignore`
 
 Memory Bank **respeta automáticamente** los patrones de `.gitignore` en tu proyecto, además de los de `.memoryignore`.
 
+---
+
 ## 💰 Costos de OpenAI
 
 Memory Bank usa `text-embedding-3-small` que es muy económico:
 
-- **Precio**: ~$0.00002 por 1K tokens
+- **Precio embeddings**: ~$0.00002 por 1K tokens
 - **Ejemplo**: 10,000 archivos × 1,000 tokens promedio = **~$0.20**
 - **Cache**: Los embeddings se cachean, solo se regeneran si el código cambia
 - **Incremental**: Solo se reindexan archivos modificados
 
 **Búsquedas son extremadamente baratas** (solo 1 embedding por query).
 
+**Documentación con IA** usa modelos de razonamiento que son más costosos pero se ejecutan solo cuando se solicita explícitamente.
+
+---
+
 ## 🧪 Testing
 
 ```bash
@@ -504,6 +713,8 @@ npm test
 npm test -- --coverage
 ```
 
+---
+
 ## 🔐 Seguridad y Privacidad
 
 - ✅ **Vector store local**: LanceDB corre en tu máquina
@@ -519,18 +730,13 @@ npm test -- --coverage
 3. **API keys en variables de entorno**, nunca en código
 4. **Revisa que `.env` esté en .gitignore**
 
+---
+
 ## 🐛 Solución de Problemas
 
 ### Error: "OPENAI_API_KEY is required"
 
-**Solución**: Configura tu API key en las variables de entorno.
-
-```bash
-# En .env
-OPENAI_API_KEY=sk-your-key-here
-
-# O en la configuración de Claude Desktop (ver arriba)
-```
+**Solución**: Configura tu API key en las variables de entorno del MCP.
 
 ### Error: "No files found to index"
 
@@ -539,27 +745,17 @@ OPENAI_API_KEY=sk-your-key-here
 2. Todos los archivos están en .gitignore/.memoryignore
 3. No hay archivos de código reconocidos
 
-**Solución**: Verifica que haya archivos .ts, .js, .py, etc. en el directorio.
-
 ### Búsquedas retornan resultados irrelevantes
 
 **Soluciones**:
 1. **Aumenta `minScore`**: Usa 0.8 o 0.9 para resultados más precisos
 2. **Usa filtros**: `filterByFile` o `filterByLanguage`
 3. **Reformula la query**: Sé más específico y descriptivo
-4. **Reindexa**: Puede que el índice esté desactualizado
-
-```
-memorybank_index_code({ forceReindex: true })
-```
+4. **Reindexa**: `memorybank_index_code({ forceReindex: true })`
 
-### Rate limit de OpenAI
-
-El sistema maneja automáticamente rate limits con exponential backoff, pero si tienes proyectos muy grandes:
+### Error: "projectId is required"
 
-1. **Indexa en partes**: Indexa directorios individuales
-2. **Aumenta límites**: Usa una API key con tier más alto
-3. **Reduce batch size**: Ajusta en código (default: 100)
+**Solución**: Todas las herramientas requieren `projectId`. Define el `projectId` en tu archivo `AGENTS.md` para que el agente lo use consistentemente.
 
 ### Índice desactualizado
 
@@ -576,18 +772,24 @@ Si `pendingFiles` muestra archivos pendientes:
 }
 ```
 
-### Error: "projectId is required"
+---
 
-**Solución**: Todas las herramientas requieren `projectId`. Asegúrate de incluirlo en cada llamada:
+## 📖 Documentación Adicional
 
-```json
-{
-  "projectId": "my-project",
-  "query": "..."
-}
-```
+### Plantillas de Instrucciones
+
+**Formato AGENTS.md** (estándar multi-agente):
+- [AGENTS.basic.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/AGENTS.basic.md) - Modo básico (indexación manual)
+- [AGENTS.auto-index.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/AGENTS.auto-index.md) - Modo auto-indexación
+- [AGENTS.sandboxed.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/AGENTS.sandboxed.md) - Modo sin acceso directo a archivos
+
+**Formato VS Code / Copilot**:
+- [copilot-instructions.basic.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/copilot-instructions.basic.md) - Modo básico
+- [copilot-instructions.auto-index.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/copilot-instructions.auto-index.md) - Modo auto-indexación
+- [copilot-instructions.sandboxed.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/copilot-instructions.sandboxed.md) - Modo sandboxed
+- [memory-bank.instructions.md](https://github.com/gcorroto/memory-bank-mcp/blob/main/templates/vscode/memory-bank.instructions.md) - Instrucciones condicionales
 
-Tip: Define el `projectId` en tu archivo `AGENTS.md` para que el agente lo use consistentemente.
+---
 
 ## 🤝 Contribución
 
@@ -599,20 +801,7 @@ Tip: Define el `projectId` en tu archivo `AGENTS.md` para que el agente lo use c
 4. Push al branch (`git push origin feature/AmazingFeature`)
 5. Abre un Pull Request
 
-## 📖 Documentación Adicional
-
-- [templates/](templates/): Plantillas de instrucciones para agentes
-  - **Formato AGENTS.md** (estándar multi-agente):
-    - `AGENTS.basic.md`: Modo básico (indexación manual)
-    - `AGENTS.auto-index.md`: Modo auto-indexación
-    - `AGENTS.sandboxed.md`: Modo sin acceso directo a archivos
-  - **Formato VS Code** (`templates/vscode/`):
-    - `copilot-instructions.basic.md`: Modo básico para Copilot
-    - `copilot-instructions.auto-index.md`: Modo auto-indexación para Copilot
-    - `copilot-instructions.sandboxed.md`: Modo sandboxed para Copilot
-    - `memory-bank.instructions.md`: Instrucciones con aplicación condicional
-- [wiki/Developer-Guide.md](wiki/Developer-Guide.md): Guía para desarrolladores
-- [wiki/API-Reference.md](wiki/API-Reference.md): Referencia completa de API
+---
 
 ## 🎓 Inspiración
 
@@ -620,23 +809,24 @@ Este proyecto está inspirado en el sistema de Memory Bank de Cursor IDE, tal co
 
 - [Advanced Cursor: Use the Memory Bank](https://medium.com/codetodeploy/advanced-cursor-use-the-memory-bank-to-eliminate-hallucination-affd3fbeefa3)
 - [How Cursor Indexes Codebases Fast](https://read.engineerscodex.com/p/how-cursor-indexes-codebases-fast)
-- [Cursor Security](https://simonwillison.net/2025/May/11/cursor-security/)
+
+---
 
 ## 📜 Licencia
 
 Este proyecto está licenciado bajo la Licencia MIT - ver el archivo [LICENSE](LICENSE) para detalles.
 
+---
+
 ## 🆘 Soporte
 
-- **Issues**: [GitHub Issues](https://github.com/grec0/memory-bank-mcp/issues)
-- **Documentación**: [Wiki del Proyecto](https://github.com/grec0/memory-bank-mcp/wiki)
+- **Issues**: [GitHub Issues](https://github.com/gcorroto/memory-bank-mcp/issues)
+- **Documentación**: [Wiki del Proyecto](https://github.com/gcorroto/memory-bank-mcp/wiki)
 - **OpenAI API**: [Documentación Oficial](https://platform.openai.com/docs)
 - **LanceDB**: [Documentación](https://lancedb.github.io/lancedb/)
 
-## ⭐ Star History
-
-Si este proyecto te resulta útil, ¡considera darle una estrella! ⭐
-
 ---
 
+⭐ Si este proyecto te resulta útil, ¡considera darle una estrella!
+
 **Hecho con ❤️ para la comunidad de AI coding assistants**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grec0/memory-bank-mcp",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "MCP server for semantic code indexing with Memory Bank - AI-powered codebase understanding",
   "license": "MIT",
   "author": "@grec0",