context-first-cli 2.1.6 → 2.2.1

package/dist/templates/commands/es/products/collect.md

@@ -18,26 +18,63 @@ Eres un especialista en producto responsable de recopilar y documentar nuevas id
 
 ---
 
+## 📋 Configuración del Proyecto
+
+**⚠️ IMPORTANTE: ¡Siempre lee los archivos de configuración del proyecto ANTES de ejecutar este comando!**
+
+### Archivos Obligatorios
+
+1. **`context-manifest.json`** (raíz del orchestrator)
+   - Lista de repositorios del proyecto
+   - Roles de cada repositorio (metaspecs, application, etc.)
+   - URLs y dependencias entre repositorios
+
+2. **`ai.properties.md`** (raíz del orchestrator)
+   - Configuraciones del proyecto (`project_name`, `base_path`)
+   - Sistema de gestión de tareas (`task_management_system`)
+   - Credenciales y configuraciones específicas
+
+### Cómo Leer
+
+```bash
+# 1. Leer context-manifest.json
+cat context-manifest.json
+
+# 2. Leer ai.properties.md
+cat ai.properties.md
+```
+
+### Información Esencial
+
+Después de leer los archivos, tendrás:
+- ✅ Lista completa de repositorios del proyecto
+- ✅ Ubicación del repositorio de metaspecs
+- ✅ Base path para localizar repositorios
+- ✅ Sistema de gestión de tareas configurado
+- ✅ Configuraciones específicas del proyecto
+
+**🛑 ¡NO continúes sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
+
 ## Contexto del Proyecto
 
-Antes de comenzar, carga el contexto consultando:
+Antes de iniciar, carga el contexto consultando:
 
 1. **Localizar MetaSpecs automáticamente**:
-   - Lee `context-manifest.json` del orquestador
+   - Lee `context-manifest.json` del orchestrator
    - Encuentra el repositorio con `"role": "metaspecs"`
    - Lee `ai.properties.md` para obtener el `base_path`
    - El metaspecs está en: `{base_path}/{metaspecs-repo-id}/`
    - Lee los archivos `index.md` como referencia
 
 2. **Estructura del proyecto**:
-   - `context-manifest.json` - Lista de repositorios y sus funciones
+   - `context-manifest.json` - Lista de repositorios y sus roles
    - `README.md` de los repositorios involucrados
 
 ## Tu Objetivo
 
 Entender la solicitud del usuario y capturarla como issue en el gestor de tareas (vía MCP).
 
-**En esta fase, NO necesitas:**
+**En esta fase NO necesitas:**
 - ❌ Escribir especificación completa
 - ❌ Validar contra metaspecs (esto se hace en `/refine` o `/spec`)
 - ❌ Detallar implementación técnica
@@ -50,20 +87,20 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
 # [Título Claro y Descriptivo]
 
 ## Descripción
-[2-3 párrafos explicando qué es la funcionalidad/bug y por qué es importante]
+[2-3 párrafos explicando qué es la feature/bug y por qué es importante]
 
 ## Tipo
-- [ ] Nueva Funcionalidad
-- [ ] Mejora de Funcionalidad Existente
+- [ ] Nueva Feature
+- [ ] Mejora de Feature Existente
 - [ ] Bug
 - [ ] Deuda Técnica
 - [ ] Documentación
 
 ## Contexto Adicional
-[Información relevante: dónde ocurre el bug, inspiración para la funcionalidad, etc.]
+[Información relevante: dónde ocurre el bug, inspiración para la feature, etc.]
 
 ## Repositorios Afectados
-[Lista de los repositorios del proyecto que serán impactados]
+[Lista de repositorios del proyecto que serán impactados]
 
 ## Prioridad Sugerida
 - [ ] 🔴 Crítica
@@ -76,7 +113,7 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
 
 1. **Entendimiento Inicial**
    - Haz preguntas de aclaración si es necesario
-   - Identifica: ¿Es funcionalidad nueva? ¿Mejora? ¿Bug?
+   - Identifica: ¿Es feature nueva? ¿Mejora? ¿Bug?
    - Identifica qué repositorios serán afectados
 
 2. **Borrador de la Issue**
@@ -92,11 +129,11 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
    
    **Si la implementación parece grande** (> 5 días de esfuerzo estimado):
    - 🚨 **Sugiere dividir en múltiples issues más pequeñas**
-   - Explica la razón de la división (ej: "Esta funcionalidad involucra 3 áreas distintas: autenticación, procesamiento y notificación")
+   - Explica la razón de la división (ej: "Esta feature involucra 3 áreas distintas: autenticación, procesamiento y notificación")
    - Propón una división **lógica** (por funcionalidad, por repositorio, por capa, etc.)
    - Ejemplo de división:
      ```
-     Issue Original: "Sistema completo de pagos"
+     Issue Original: "Sistema de pagos completo"
      
      División Sugerida:
      - FIN-101: Integración con gateway de pago (backend)
@@ -120,7 +157,7 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
    **PRIORIDAD 1: Usar MCP (Model Context Protocol)**
    
    Verifica si hay MCP configurado para el gestor de tareas:
-   - Lee `ai.properties.md` del orquestador para identificar el `task_management_system`
+   - Lee `ai.properties.md` del orchestrator para identificar el `task_management_system`
    - Si `task_management_system=jira`: Usa MCP de Jira para crear la issue
    - Si `task_management_system=linear`: Usa MCP de Linear para crear la issue
    - Si `task_management_system=github`: Usa MCP de GitHub para crear la issue
@@ -138,16 +175,16 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
    - Crea archivo en `./.sessions/<ISSUE-ID>/collect.md`
    - Usa formato de ID manual: `LOCAL-001`, `LOCAL-002`, etc.
    - Incluye fecha, tipo y contenido completo
-   - Informa al usuario: "⚠️ Issue guardada localmente en .sessions/ (gestor de tareas no disponible)"
+   - Informa al usuario: "⚠️ Issue guardada localmente en .sessions/ (task manager no disponible)"
 
 ## Preguntas de Aclaración
 
-**Para Funcionalidades**:
+**Para Features**:
 - ¿Qué problema resuelve?
 - ¿Quién se beneficia?
 - ¿Es funcionalidad visible o infraestructura?
-- ¿Tiene relación con alguna funcionalidad existente?
-- ¿Qué repositorios necesitan ser modificados?
+- ¿Tiene relación con alguna feature existente?
+- ¿Qué repositorios necesitan modificarse?
 
 **Para Bugs**:
 - ¿Dónde ocurre el bug? (repositorio, componente, flujo)
@@ -172,7 +209,7 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
 
 ## 🎯 Próximo Paso
 
-Tras la aprobación y guardado de la issue:
+Después de la aprobación y guardado de la issue:
 
 ```bash
 /refine [ISSUE-ID]

package/dist/templates/commands/es/products/refine.md

@@ -1,6 +1,6 @@
 # Refinamiento de Requisitos
 
-Eres un especialista en producto encargado de ayudar a refinar requisitos para el proyecto.
+Usted es un especialista en producto encargado de ayudar a refinar requisitos para el proyecto.
 
 ## ⚠️ IMPORTANTE: Este Comando NO Implementa Código
 
@@ -8,7 +8,7 @@ Eres un especialista en producto encargado de ayudar a refinar requisitos para e
 - ✅ Validar requisitos contra metaspecs
 - ✅ Crear especificación refinada
 - ✅ Guardar documentación en `.sessions/`
-- ✅ Actualizar issue en el task manager
+- ✅ Actualizar issue en el gestor de tareas
 - ❌ **NO implementar código**
 - ❌ **NO hacer ediciones en archivos de código**
 - ❌ **NO ejecutar pruebas o deploy**
@@ -17,76 +17,114 @@ Eres un especialista en producto encargado de ayudar a refinar requisitos para e
 
 ---
 
+## 📋 Configuración del Proyecto
+
+**⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
+
+### Archivos Obligatorios
+
+1. **`context-manifest.json`** (raíz del orchestrator)
+   - Lista de repositorios del proyecto
+   - Roles de cada repositorio (metaspecs, application, etc.)
+   - URLs y dependencias entre repositorios
+
+2. **`ai.properties.md`** (raíz del orchestrator)
+   - Configuraciones del proyecto (`project_name`, `base_path`)
+   - Sistema de gestión de tareas (`task_management_system`)
+   - Credenciales y configuraciones específicas
+
+### Cómo Leer
+
+```bash
+# 1. Leer context-manifest.json
+cat context-manifest.json
+
+# 2. Leer ai.properties.md
+cat ai.properties.md
+```
+
+### Información Esencial
+
+Después de leer los archivos, usted tendrá:
+- ✅ Lista completa de repositorios del proyecto
+- ✅ Ubicación del repositorio de metaspecs
+- ✅ Base path para localizar repositorios
+- ✅ Sistema de gestión de tareas configurado
+- ✅ Configuraciones específicas del proyecto
+
+**🛑 NO continúe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
+
+
 ## Objetivo
 
-Transformar un requisito inicial en especificación refinada y validada, lista para convertirse en PRD completo.
+Transformar un requisito inicial en especificación refinada y validada, lista para convertirse en un PRD completo.
 
 ## Proceso
 
 ### 1. Fase de Aclaración
 
-Lee el requisito inicial y haz preguntas para alcanzar claridad total sobre:
+Lea el requisito inicial y haga preguntas para alcanzar claridad total sobre:
 - **Objetivo**: ¿Por qué construir esto?
 - **Valor de Negocio**: ¿Qué métrica/persona impacta?
 - **Alcance**: ¿Qué incluye y qué NO incluye?
-- **Interacciones**: ¿Qué features/componentes existentes se ven afectados?
+- **Interacciones**: ¿Qué funcionalidades/componentes existentes se ven afectados?
 
-Continúa haciendo preguntas hasta tener entendimiento completo.
+Continúe haciendo preguntas hasta tener entendimiento completo.
 
 ### 2. Validación Contra Metaspecs
 
-**IMPORTANTE**: Primero lee `ai.properties.md` para obtener el `base_path`. Los índices YA deben estar en contexto (corriste `/warm-up`). Consulta los índices y lee SÓLO los documentos relevantes para validar el requisito.
+**IMPORTANTE**: Primero lea `ai.properties.md` para obtener el `base_path`. Los índices YA deben estar en contexto (usted ejecutó `/warm-up`). Consulte los índices y lea SÓLO los documentos relevantes para validar el requisito.
 
 **Proceso de Validación**:
 
-1. **Consulta los índices cargados** por `/warm-up`:
-   - Lee `context-manifest.json` para encontrar el repositorio con `role: "metaspecs"`
-   - Obtén el `id` de ese repositorio (ej: "my-project-metaspecs")
-   - Lee `ai.properties.md` para obtener el `base_path`
+1. **Consulte los índices cargados** por `/warm-up`:
+   - Lea `context-manifest.json` para encontrar el repositorio con `role: "metaspecs"`
+   - Obtenga el `id` de ese repositorio (ej: "my-project-metaspecs")
+   - Lea `ai.properties.md` para obtener el `base_path`
    - El repositorio de metaspecs está en: `{base_path}/{metaspecs-id}/`
-   - Consulta `{base_path}/{metaspecs-id}/index.md` - Visión general del proyecto
-   - Consulta índices específicos (ej: `specs/business/index.md`, `specs/technical/index.md`)
+   - Consulte `{base_path}/{metaspecs-id}/index.md` - Visión general del proyecto
+   - Consulte índices específicos (ej: `specs/business/index.md`, `specs/technical/index.md`)
 
-2. **Identifica documentos relevantes** para este requisito específico:
+2. **Identifique documentos relevantes** para este requisito específico:
    - En `specs/business/`: ¿Qué documentos de negocio son relevantes?
    - En `specs/technical/`: ¿Qué documentos técnicos son relevantes?
 
-3. **Lee SÓLO los documentos relevantes** identificados (¡no leas todo!)
+3. **Lea SÓLO los documentos relevantes** identificados (¡no lea todo!)
 
-4. **Valida el requisito** contra las metaspecs leídas:
+4. **Valide el requisito** contra las metaspecs leídas:
    - ✅ Alineación con estrategia y visión de producto
    - ✅ Atiende necesidades de las personas correctas
    - ✅ Compatible con stack tecnológico aprobado
-   - ✅ Respeta decisiones arquitecturales (ADRs)
+   - ✅ Respeta decisiones arquitectónicas (ADRs)
    - ✅ Sigue reglas de negocio existentes
-   - ⚠️ Identifica conflictos o violaciones
+   - ⚠️ Identifique conflictos o violaciones
 
-**Si identificas violaciones**: 🛑 **DETENTE** y pide aclaración al usuario antes de continuar (Principio Jidoka).
+**Si identifica violaciones**: 🛑 **PARE** y pida aclaración al usuario antes de continuar (Principio Jidoka).
 
 ### 3. Fase de Resumen y Aprobación
 
-Una vez que hayas recopilado información suficiente y validado contra metaspecs, presenta un resumen estructurado con:
+Una vez que haya recopilado información suficiente y validado contra metaspecs, presente un resumen estructurado con:
 - **Feature**: Nombre de la funcionalidad
 - **Objetivo**: Por qué construir (1-2 frases)
-- **Valor de Negocio**: Métrica, persona, fase del roadmap (consulta metaspecs)
+- **Valor de Negocio**: Métrica, persona, fase del roadmap (consulte metaspecs)
 - **Alcance**: Qué INCLUYE y qué NO INCLUYE
-- **Componentes Afectados**: Lista basada en la arquitectura actual (consulta metaspecs técnicas)
+- **Componentes Afectados**: Lista basada en la arquitectura actual (consulte metaspecs técnicas)
 - **Validación contra Metaspecs**: ✅ Aprobado / ⚠️ Atención necesaria
 - **Estimación de Esfuerzo**: Pequeño (< 1 día) / Medio (1-3 días) / Grande (3-5 días) / Muy Grande (> 5 días)
 
 **Evaluación de Complejidad y Sugerencia de División**:
 
 **Si la implementación parece grande** (> 5 días de esfuerzo estimado):
-- 🚨 **Sugiere dividir en múltiples issues menores**
-- Explica el racional de la división (ej: "Esta feature involucra 3 áreas distintas que pueden implementarse independientemente")
-- Propón una división **lógica** basada en:
+- 🚨 **Sugiera dividir en múltiples issues más pequeñas**
+- Explique el razonamiento de la división (ej: "Esta feature involucra 3 áreas distintas que pueden implementarse independientemente")
+- Proponga una división **lógica** basada en:
   - Funcionalidades independientes
   - Repositorios diferentes
   - Capas de la aplicación (backend, frontend, infra)
   - Fases de implementación (MVP, mejoras, optimizaciones)
 - Ejemplo de división:
   ```
-  Issue Original: "Sistema de notificaciones multi-canal"
+  Issue Original: "Sistema de notificaciones multicanal"
   
   División Sugerida:
   - FIN-201: Infraestructura de colas y workers (backend)
@@ -97,59 +135,59 @@ Una vez que hayas recopilado información suficiente y validado contra metaspecs
 - **Importante**: La decisión final es del usuario - puede aceptar la división o mantener como issue única
 
 **Si el usuario acepta la división**:
-- Documenta cada issue por separado
-- Añade referencias cruzadas entre las issues relacionadas
-- Sugiere orden de implementación si hay dependencias
+- Documente cada issue por separado
+- Añada referencias cruzadas entre las issues relacionadas
+- Sugiera orden de implementación si hay dependencias
 - Cada issue dividida debe pasar por el mismo proceso de refinamiento
 
-Pide aprobación del usuario e incorpora feedback si es necesario.
+Solicite aprobación del usuario e incorpore feedback si es necesario.
 
-**Consejo**: Puedes buscar en el código base o internet antes de finalizar, si es necesario.
+**Consejo**: Puede investigar en el código base o internet antes de finalizar, si es necesario.
 
 ### 4. Guardado de los Requisitos Refinados
 
-Una vez que el usuario apruebe, guarda los requisitos:
+Una vez que el usuario apruebe, guarde los requisitos:
 
-**IMPORTANTE**: Siempre crea backup local Y actualiza el task manager (si está configurado).
+**IMPORTANTE**: Siempre cree backup local Y actualice el gestor de tareas (si está configurado).
 
 **Proceso de Guardado**:
 
 1. **SIEMPRE crear backup local primero**:
-   - Crea archivo completo en `./.sessions/<ISSUE-ID>/refined.md` (ej: `./.sessions/FIN-5/refined.md`)
+   - Cree archivo completo en `./.sessions/<ISSUE-ID>/refined.md` (ej: `./.sessions/FIN-5/refined.md`)
    - Donde `<ISSUE-ID>` es el ID de la issue (ej: FIN-5, FIN-123)
-   - Incluye TODOS los detalles del refinamiento (backup completo)
-
-2. **Si el task manager está configurado** (lee `ai.properties.md` para identificar `task_management_system`):
-   - Identifica la herramienta MCP del task manager
-   - **Actualiza el BODY (description) de la issue** con versión CONCISA de los requisitos refinados
-     - Para Jira: Usa MCP de Jira con campo `description`
-     - Para Linear: Usa MCP de Linear con campo `description`
-     - Para GitHub: Usa MCP de GitHub con campo `body`
-     - Para Azure Boards: Usa MCP de Azure Boards con campo `description`
-     - Incluye todo el contenido refinado en el campo description/body de la issue
-     - Si el contenido es muy extenso y hay error de API, considera crear versión resumida
-   - **SIEMPRE sobrescribe** el body existente (no agregar al final)
+   - Incluya TODOS los detalles del refinamiento (backup completo)
+
+2. **Si el gestor de tareas está configurado** (lea `ai.properties.md` para identificar `task_management_system`):
+   - Identifique la herramienta MCP del gestor de tareas
+   - **Actualice el BODY (descripción) de la issue** con versión CONCISA de los requisitos refinados
+     - Para Jira: Use MCP de Jira con campo `description`
+     - Para Linear: Use MCP de Linear con campo `description`
+     - Para GitHub: Use MCP de GitHub con campo `body`
+     - Para Azure Boards: Use MCP de Azure Boards con campo `description`
+     - Incluya todo el contenido refinado en el campo description/body de la issue
+     - Si el contenido es muy extenso y hay error de API, considere crear versión resumida
+   - **SIEMPRE sobrescriba** el body existente (no añadir al final)
 
 **Observación**:
 - El backup local SIEMPRE está guardado y completo
-- Si hay error de API, verifica manualmente si la issue fue actualizada en el task manager
+- Si hay error de API, verifique manualmente si la issue fue actualizada en el gestor de tareas
 
-**Template de Salida**:
+**Plantilla de Salida**:
 
-**IMPORTANTE**: El template estándar para requisitos refinados puede estar documentado en el repositorio de metaspecs. Consulta `{base_path}/{metaspecs-id}/specs/refined/` o similar.
+**IMPORTANTE**: La plantilla estándar para requisitos refinados puede estar documentada en el repositorio de metaspecs. Consulte `{base_path}/{metaspecs-id}/specs/refined/` o similar.
 
-**Template COMPLETO** (para backup local `.sessions/<ISSUE-ID>/refined.md`):
+**Plantilla COMPLETA** (para backup local `.sessions/<ISSUE-ID>/refined.md`):
 - **Metadatos**: Issue, ID, Task Manager, Proyecto, Fecha, Sprint, Prioridad
 - **🎯 POR QUÉ**: Razones, valor de negocio, métrica, persona, alineamiento estratégico
 - **📦 QUÉ**: Funcionalidades detalladas, componentes afectados, integraciones, alcance negativo completo
-- **🔧 CÓMO**: Stack, patrones de código, estructura de archivos, dependencias, orden de implementación, failure modes, consideraciones de performance/costo/UX
+- **🔧 CÓMO**: Stack, patrones de código, estructura de archivos, dependencias, orden de implementación, modos de fallo, consideraciones de performance/costo/UX
 - **✅ Validación contra Metaspecs**: Documentos consultados (business y technical), ADRs verificados, resultado de la validación
 - **📊 Métricas de Éxito**: Técnicas, producto/UX, criterios de aceptación
 - **🔄 Impacto en el Producto**: Alineamiento con objetivos, habilitadores, riesgos mitigados
 - **⚠️ Limitaciones Conocidas**: Limitaciones del MVP
-- **📝 Checklist de Implementación**: Tareas por área (backend, frontend, tests, seguridad, etc.)
+- **📝 Checklist de Implementación**: Tareas por área (backend, frontend, pruebas, seguridad, etc.)
 
-**Template para Task Manager**:
+**Plantilla para Gestor de Tareas**:
 ```markdown
 # [Nombre Feature] - Requisitos Refinados
 
@@ -160,7 +198,7 @@ Una vez que el usuario apruebe, guarda los requisitos:
 
 ## Alcance
 
-### Funcionalidades Principales
+### Principales Funcionalidades
 - Funcionalidad 1: [resumen]
 - Funcionalidad 2: [resumen]
 - Validaciones/Guards: [resumen]
@@ -170,10 +208,10 @@ Una vez que el usuario apruebe, guarda los requisitos:
 - Componente 2: [tipo de cambio]
 
 ### Seguridad
-✅ [ítem 1] ✅ [ítem 2] ✅ [ítem 3]
+✅ [item 1] ✅ [item 2] ✅ [item 3]
 
 ## Alcance Negativo
-❌ [ítem 1] ❌ [ítem 2] ❌ [ítem 3]
+❌ [item 1] ❌ [item 2] ❌ [item 3]
 
 ## Stack
 [Tech stack resumida por área]
@@ -181,14 +219,14 @@ Una vez que el usuario apruebe, guarda los requisitos:
 ## Estructura
 [Árbol de archivos RESUMIDO - módulos principales solamente]
 
-## Failure Modes (Evitar)
+## Modos de Fallo (Evitar)
 🔴 [crítico 1] 🔴 [crítico 2]
 🟡 [medio 1] 🟡 [medio 2]
 
 ## Criterios de Aceptación
-- [ ] [ítem 1]
-- [ ] [ítem 2]
-- [ ] [ítem 3]
+- [ ] [item 1]
+- [ ] [item 2]
+- [ ] [item 3]
 
 ## Validación
 **ADRs**: [lista]
@@ -202,7 +240,7 @@ Una vez que el usuario apruebe, guarda los requisitos:
 📄 **Documento completo**: `.sessions/<ISSUE-ID>/refined.md`
 ```
 
-**Audiencia**: Desarrollador IA con capacidades similares a las tuyas. Sé conciso pero completo.
+**Audiencia**: Desarrollador IA con capacidades similares a las suyas. Sea conciso pero completo.
 
 ---
 
@@ -216,7 +254,7 @@ Una vez que el usuario apruebe, guarda los requisitos:
 
 ## 🎯 Próximo Paso
 
-**Tras la aprobación del usuario y guardado de los requisitos refinados**, el flujo natural es:
+**Tras la aprobación del usuario y el guardado de los requisitos refinados**, el flujo natural es:
 
 ```bash
 /spec [ISSUE-ID]

package/dist/templates/commands/es/products/spec.md

@@ -1,15 +1,15 @@
 # Creación de Especificación (PRD)
 
-Este comando crea la especificación completa (Product Requirements Document) de la feature.
+Este comando crea la especificación completa (Product Requirements Document) de la funcionalidad.
 
 ## ⚠️ IMPORTANTE: Este Comando NO Implementa Código
 
 **Este comando es SÓLO para documentación de requisitos:**
 - ✅ Crear PRD (Product Requirements Document)
-- ✅ Actualizar issue en el task manager vía MCP
-- ✅ **LEER** archivos de los repositorios principales (read-only)
+- ✅ Actualizar issue en el gestor de tareas vía MCP
+- ✅ **LEER** archivos de los repositorios principales (solo lectura)
 - ❌ **NO implementar código**
-- ❌ **NO hacer edits en archivos de código**
+- ❌ **NO hacer ediciones en archivos de código**
 - ❌ **NO hacer checkout de branches en los repositorios principales**
 - ❌ **NO hacer commits**
 
@@ -17,19 +17,56 @@ Este comando crea la especificación completa (Product Requirements Document) de
 
 ---
 
-## 📋 Requisitos Previos
+## 📋 Configuración del Proyecto
+
+**⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
+
+### Archivos Obligatorios
+
+1. **`context-manifest.json`** (raíz del orquestador)
+   - Lista de repositorios del proyecto
+   - Roles de cada repositorio (metaspecs, application, etc.)
+   - URLs y dependencias entre repositorios
+
+2. **`ai.properties.md`** (raíz del orquestador)
+   - Configuraciones del proyecto (`project_name`, `base_path`)
+   - Sistema de gestión de tareas (`task_management_system`)
+   - Credenciales y configuraciones específicas
+
+### Cómo Leer
+
+```bash
+# 1. Leer context-manifest.json
+cat context-manifest.json
+
+# 2. Leer ai.properties.md
+cat ai.properties.md
+```
+
+### Información Esencial
+
+Después de leer los archivos, tendrás:
+- ✅ Lista completa de repositorios del proyecto
+- ✅ Ubicación del repositorio de metaspecs
+- ✅ Base path para localizar repositorios
+- ✅ Sistema de gestión de tareas configurado
+- ✅ Configuraciones específicas del proyecto
+
+**🛑 NO continúe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
+
+## 📋 Pre-requisitos
 
 - Issue refinada vía `/refine`
-- Aprobación para continuar con la feature
+- Aprobación para continuar con la funcionalidad
 
 ## 📚 Cargar MetaSpecs
 
 **Localizar MetaSpecs automáticamente**:
-1. Lea `context-manifest.json` del orchestrator
+1. Lea `context-manifest.json` del orquestador
 2. Encuentre el repositorio con `"role": "metaspecs"`
 3. Lea `ai.properties.md` para obtener el `base_path`
 4. El metaspecs está en: `{base_path}/{metaspecs-repo-id}/`
-5. Lea los archivos `index.md` relevantes para garantizar conformidad con:
+5. Lea los archivos `index.md` relevantes para asegurar conformidad con:
    - Arquitectura del sistema
    - Patrones de diseño
    - Restricciones técnicas
@@ -44,13 +81,13 @@ Crear un PRD completo que servirá como fuente única de verdad para la implemen
 ### 1. Visión General
 
 ```markdown
-# [Título de la Feature]
+# [Título de la Funcionalidad]
 
 ## Contexto
 [¿Por qué estamos construyendo esto? ¿Qué problema resuelve?]
 
 ## Objetivo
-[¿Qué queremos lograr con esta feature?]
+[¿Qué queremos lograr con esta funcionalidad?]
 
 ## Métricas de Éxito
 - [Métrica 1]: [Cómo medir]
@@ -142,12 +179,12 @@ Crear un PRD completo que servirá como fuente única de verdad para la implemen
 ## Criterios de Aceptación
 
 ### Funcional
-- [ ] [Criterio específico y testable]
-- [ ] [Criterio específico y testable]
+- [ ] [Criterio específico y comprobable]
+- [ ] [Criterio específico y comprobable]
 
 ### Técnico
-- [ ] Tests unitarios con cobertura >= X%
-- [ ] Tests de integración implementados
+- [ ] Pruebas unitarias con cobertura >= X%
+- [ ] Pruebas de integración implementadas
 - [ ] Performance dentro de los requisitos
 - [ ] Documentación actualizada
 
@@ -207,15 +244,15 @@ Justificación: [Por qué quedan para después]
 ```markdown
 ## Plan de Pruebas
 
-### Tests Unitarios
-- [Área 1 a testear]
-- [Área 2 a testear]
+### Pruebas Unitarias
+- [Área 1 a probar]
+- [Área 2 a probar]
 
-### Tests de Integración
+### Pruebas de Integración
 - [Escenario 1]
 - [Escenario 2]
 
-### Tests Manuales
+### Pruebas Manuales
 - [Escenario 1]
 - [Escenario 2]
 ```
@@ -224,18 +261,18 @@ Justificación: [Por qué quedan para después]
 
 **PRIORIDAD 1: Usar MCP (Model Context Protocol)**
 
-- Lea `ai.properties.md` del orchestrator para identificar el `task_management_system`
+- Lea `ai.properties.md` del orquestador para identificar el `task_management_system`
 - Use el MCP apropiado para actualizar la issue con el PRD:
   - Añada el PRD completo como comentario en la issue
-  - O adjunte como archivo (si el task manager lo soporta)
-  - Actualice status/labels (ej: "spec-ready", "ready-for-dev")
+  - O adjunte como archivo (si el gestor de tareas lo soporta)
+  - Actualice estado/etiquetas (ej: "spec-ready", "ready-for-dev")
 - Informe al usuario: "✅ PRD añadido a la issue [ID]"
 
 **FALLBACK: Crear archivo .md sólo si MCP falla**
 
 Si MCP no está disponible o falla:
 - Guarde en `./.sessions/<ISSUE-ID>/prd.md`
-- Informe al usuario: "⚠️ PRD guardado localmente en .sessions/ (task manager no disponible)"
+- Informe al usuario: "⚠️ PRD guardado localmente en .sessions/ (gestor de tareas no disponible)"
 
 ## 🔍 Revisión y Aprobación
 
@@ -243,7 +280,7 @@ Antes de finalizar:
 1. Revise el PRD con stakeholders
 2. Valide contra metaspecs (si están disponibles)
 3. Obtenga aprobación para iniciar implementación
-4. **Vía MCP**: Actualice la issue en el task manager con status "Listo para Desarrollo"
+4. **Vía MCP**: Actualice la issue en el gestor de tareas con estado "Listo para Desarrollo"
 5. **Fallback**: Documente la aprobación en `./.sessions/<ISSUE-ID>/prd.md`
 
 ---
@@ -258,10 +295,10 @@ Antes de finalizar:
 
 ## 🎯 Próximo Paso
 
-Tras la aprobación del PRD:
+Después de la aprobación del PRD:
 
 ```bash
 /start
 ```
 
-Este comando iniciará el desarrollo de la feature.
+Este comando iniciará el desarrollo de la funcionalidad.