#  Manual Completo de Usuario: Graft Manager para Windows
**Autor:** @XeBoLaX  
**Versión:** 1.2.0  

---

## 1. ¿Qué es esta aplicación?
**Graft Manager** es una aplicación diseñada para que cualquier persona, sin necesidad de saber programación avanzada, pueda preparar sus proyectos y carpetas de trabajo para que las **Inteligencias Artificiales** (como Claude Code, Cursor, Gemini, ChatGPT o Copilot) entiendan el código inmediatamente.

### ¿Qué beneficio obtienes?
*  **Respuestas un 60% más rápidas:** La IA no pierde tiempo explorando carpetas a ciegas.
*  **Ahorro de más del 40% de tokens:** No gasta presupuesto de IA leyendo archivos innecesarios.
*  **Respuestas más precisas y sin errores:** La IA tiene un mapa claro de cómo se conecta cada parte de tu proyecto.

---

## 2. Guía Rápida: Optimiza tu Proyecto en 3 Pasos

1. **Seleccionar tu Carpeta:**  
   En la parte superior, escribe la ruta de tu proyecto, pulsa el botón **Examinar...** para buscarla, o arrastra la carpeta directamente sobre la ventana.
2. **Elegir tu IA favorita:**  
   Ve a la pestaña **1. Integración con IAs** (`Alt+1`). Muévete por la lista y pulsa la **Barra Espaciadora** sobre la IA que utilices (por ejemplo Cursor, Gemini, Claude o Genérico). Luego pulsa el botón **Inicializar e Integrar**.
3. **Construir el Grafo:**  
   Ve a la pestaña **2. Construcción de Grafo** (`Alt+2`) y pulsa el botón **Construir Grafo de Contexto**.

---

## 3. ¿Qué hacer en tu IA? (Ahorro de Tokens)

Pulsa el botón **Copiar Prompt Ahorro Tokens** (`Ctrl+P`).  
Pega ese texto en el chat de tu IA antes de pedirle que programe o modifique algo. La IA seguirá las reglas del mapa y ahorrará miles de tokens.

---

## 4. Explicación de las Pestañas

* **Pestaña 1: Integración con IAs (`Alt+1`):**  
  Configura las instrucciones nativas para cada editor o asistente de IA.
* **Pestaña 2: Construcción de Grafo (`Alt+2`):**  
  Analiza el código y crea la carpeta `graft/` sin coste. También puedes comprobar si el código ha cambiado con *Comprobar Deriva*.
* **Pestaña 3: Consultas y Visualización (`Alt+3`):**  
  - *Ver Mapa:* Muestra un esquema condensado de tu proyecto.  
  - *Consultar (ask):* Escribe una duda o tarea (ej. 'dónde está el login') y te dice archivos y líneas exactos.  
  - *Lanzar Visualizador 3D:* Abre una página interactiva en tu navegador para ver la arquitectura en 3D.
* **Pestaña 4: Análisis y Firmas (`Alt+4`):**  
  - *Extraer Esqueleto:* Obtiene las firmas y clases de un archivo sin el cuerpo de código (ahorra 90% de texto).  
  - *Rastrear Llamadas:* Averigua quién llama a una función antes de modificarla.

---

## 5. Atajos de Teclado Principales

* **Ctrl+H:** Abre un tutorial detallado sobre el botón o campo que tengas enfocado en ese instante.
* **Alt+1, Alt+2, Alt+3, Alt+4:** Cambiar directamente entre las 4 pestañas de la aplicación.
* **F2:** Abrir este manual completo de usuario.
* **F1:** Información sobre la aplicación y autor (@XeBoLaX).
* **Ctrl+P:** Generar y copiar el Prompt de Ahorro de Tokens.
* **F5:** Comprobar estado de Node.js y Graft en el sistema.
* **Barra Espaciadora:** Marcar o desmarcar casillas en listas.
* **Escape:** Cerrar cualquier ventana o mensaje de diálogo.

