speccrew 0.5.9 → 0.5.11

package/docs/GETTING-STARTED.es.md

@@ -14,7 +14,7 @@
   <a href="./GETTING-STARTED.ar.md">العربية</a>
 </p>
 
-Este documento le ayuda a comprender rápidamente cómo usar el equipo de Agentes de SpecCrew para completar el ciclo completo de desarrollo desde los requisitos hasta la entrega siguiendo procesos de ingeniería estándar.
+Este documento le ayuda a comprender rápidamente cómo usar el equipo de Agentes de SpecCrew para completar el desarrollo completo desde los requisitos hasta la entrega siguiendo procesos de ingeniería estándar.
 
 ---
 
@@ -54,7 +54,7 @@ IDEs soportados: `qoder`, `cursor`, `claude`, `codex`
 ### Referencia Rápida de Comandos CLI
 
 | Comando | Descripción |
-|---------|-------------|
+|------|------|
 | `speccrew list` | Listar todos los Agentes y Skills disponibles |
 | `speccrew doctor` | Verificar integridad de la instalación |
 | `speccrew update` | Actualizar configuración del proyecto a la última versión |
@@ -62,7 +62,82 @@ IDEs soportados: `qoder`, `cursor`, `claude`, `codex`
 
 ---
 
-## 2. Visión General del Flujo de Trabajo
+## 2. Inicio Rápido en 5 Minutos Después de la Instalación
+
+Después de ejecutar `speccrew init`, siga estos pasos para entrar rápidamente en estado de trabajo:
+
+### Paso 1: Elija Su IDE
+
+| IDE | Comando de Inicialización | Escenario de Aplicación |
+|-----|-----------|----------|
+| **Qoder** (Recomendado) | `speccrew init --ide qoder` | Orquestación completa de agentes, workers paralelos |
+| **Cursor** | `speccrew init --ide cursor` | Workflows basados en Composer |
+| **Claude Code** | `speccrew init --ide claude` | Desarrollo CLI-first |
+| **Codex** | `speccrew init --ide codex` | Integración ecosistema OpenAI |
+
+### Paso 2: Inicializar Base de Conocimientos (Recomendado)
+
+Para proyectos con código fuente existente, se recomienda inicializar primero la base de conocimientos para que los agentes comprendan su base de código:
+
+```
+@speccrew-team-leader inicializar base de conocimientos técnica
+```
+
+Luego:
+
+```
+@speccrew-team-leader inicializar base de conocimientos de negocio
+```
+
+### Paso 3: Comience Su Primera Tarea
+
+```
+@speccrew-product-manager Tengo un nuevo requisito: [describa su requisito funcional]
+```
+
+> **Consejo**: Si no está seguro de qué hacer, simplemente diga `@speccrew-team-leader ayúdame a comenzar` — el Team Leader detectará automáticamente el estado de su proyecto y lo guiará.
+
+---
+
+## 3. Árbol de Decisión Rápido
+
+¿No está seguro de qué hacer? Encuentre su escenario a continuación:
+
+- **Tengo un nuevo requisito funcional**
+  → `@speccrew-product-manager Tengo un nuevo requisito: [describa su requisito funcional]`
+
+- **Quiero escanear el conocimiento del proyecto existente**
+  → `@speccrew-team-leader inicializar base de conocimientos técnica`
+  → Luego: `@speccrew-team-leader inicializar base de conocimientos de negocio`
+
+- **Quiero continuar el trabajo anterior**
+  → `@speccrew-team-leader ¿cuál es el progreso actual?`
+
+- **Quiero verificar el estado de salud del sistema**
+  → Ejecutar en terminal: `speccrew doctor`
+
+- **No estoy seguro de qué hacer**
+  → `@speccrew-team-leader ayúdame a comenzar`
+  → El Team Leader detectará automáticamente el estado de su proyecto y lo guiará
+
+---
+
+## 4. Referencia Rápida de Agentes
+
+| Rol | Agente | Responsabilidades | Ejemplo de Comando |
+|------|-------|-----------------|-----------------|
+| Líder de Equipo | `@speccrew-team-leader` | Navegación del proyecto, inicialización de base de conocimientos, verificación de estado | "Ayúdame a comenzar" |
+| Gerente de Producto | `@speccrew-product-manager` | Análisis de requisitos, generación de PRD | "Tengo un nuevo requisito: ..." |
+| Diseñador de Funcionalidades | `@speccrew-feature-designer` | Análisis funcional, diseño de especificaciones, contratos API | "Iniciar diseño de funcionalidades para iteración X" |
+| Diseñador de Sistema | `@speccrew-system-designer` | Diseño de arquitectura, diseño detallado por plataforma | "Iniciar diseño de sistema para iteración X" |
+| Desarrollador de Sistema | `@speccrew-system-developer` | Coordinación de desarrollo, generación de código | "Iniciar desarrollo para iteración X" |
+| Gerente de Pruebas | `@speccrew-test-manager` | Planificación de pruebas, diseño de casos, ejecución | "Iniciar pruebas para iteración X" |
+
+> **Nota**: No necesita recordar todos los agentes. Simplemente hable con `@speccrew-team-leader` y él enrutará su solicitud al agente correcto.
+
+---
+
+## 5. Visión General del Flujo de Trabajo
 
 ### Diagrama de Flujo Completo
 
@@ -89,11 +164,11 @@ flowchart LR
 
 ---
 
-## 3. Paso Cero: Inicialización de la Base de Conocimientos
+## 6. Paso Cero: Inicialización de la Base de Conocimientos
 
 Antes de comenzar el proceso formal de ingeniería, necesita inicializar la base de conocimientos del proyecto.
 
-### 3.1 Inicialización de la Base de Conocimientos Técnica
+### 6.1 Inicialización de la Base de Conocimientos Técnica
 
 **Ejemplo de Conversación**:
 ```
@@ -115,7 +190,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # Archivo de índice
 ```
 
-### 3.2 Inicialización de la Base de Conocimientos de Negocio
+### 6.2 Inicialización de la Base de Conocimientos de Negocio
 
 **Ejemplo de Conversación**:
 ```
@@ -124,9 +199,9 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 
 **Proceso de Cuatro Fases**:
 1. Inventario de Funcionalidades — Escanear código para identificar todas las funcionalidades
-2. Análisis de Funcionalidades — Analizar la lógica de negocio de cada funcionalidad
+2. Análisis de Funcionalidades — Analizar la lógica de negocio para cada funcionalidad
 3. Resumen por Módulo — Resumir funcionalidades por módulo
-4. Resumen del Sistema — Generar visión general del negocio a nivel de sistema
+4. Resumen del Sistema — Generar vista general de negocio a nivel de sistema
 
 **Entregable**:
 ```
@@ -139,24 +214,24 @@ speccrew-workspace/knowledges/bizs/
 
 ---
 
-## 4. Guía de Conversación Fase por Fase
+## 7. Guía de Conversación Fase por Fase
 
-### 4.1 Fase 1: Análisis de Requisitos (Product Manager)
+### 7.1 Fase 1: Análisis de Requisitos (Product Manager)
 
-**Cómo Comenzar**:
+**Cómo Iniciar**:
 ```
-@speccrew-product-manager tengo un nuevo requisito: [describa su requisito]
+@speccrew-product-manager Tengo un nuevo requisito: [describa su requisito]
 ```
 
 **Flujo de Trabajo del Agente**:
-1. Leer visión general del sistema para entender módulos existentes
-2. Analizar requisitos del usuario
+1. Leer la visión general del sistema para comprender los módulos existentes
+2. Analizar los requisitos del usuario
 3. Generar documento PRD estructurado
 
 **Entregable**:
 ```
 iterations/{número}-{tipo}-{nombre}/01.product-requirement/
-├── [feature-name]-prd.md           # Documento de Requisitos del Producto
+├── [feature-name]-prd.md           # Documento de Requisitos de Producto
 └── [feature-name]-bizs-modeling.md # Modelado de negocio (para requisitos complejos)
 ```
 
@@ -168,9 +243,9 @@ iterations/{número}-{tipo}-{nombre}/01.product-requirement/
 
 ---
 
-### 4.2 Fase 2: Diseño de Funcionalidades (Feature Designer)
+### 7.2 Fase 2: Diseño de Funcionalidades (Feature Designer)
 
-**Cómo Comenzar**:
+**Cómo Iniciar**:
 ```
 @speccrew-feature-designer iniciar diseño de funcionalidades
 ```
@@ -178,26 +253,26 @@ iterations/{número}-{tipo}-{nombre}/01.product-requirement/
 **Flujo de Trabajo del Agente**:
 1. Localizar automáticamente el documento PRD confirmado
 2. Cargar base de conocimientos de negocio
-3. Generar diseño de funcionalidades (incluyendo wireframes UI, flujos de interacción, definiciones de datos, contratos API)
-4. Para múltiples PRDs, usar Task Worker para diseño paralelo
+3. Generar diseño de funcionalidad (incluyendo wireframes UI, flujos de interacción, definiciones de datos, contratos API)
+4. Para múltiples PRD, usar Task Worker para diseño paralelo
 
 **Entregable**:
 ```
 iterations/{iter}/02.feature-design/
-└── [feature-name]-feature-spec.md  # Documento de diseño de funcionalidades
+└── [feature-name]-feature-spec.md  # Documento de diseño de funcionalidad
 ```
 
 **Lista de Verificación de Confirmación**:
 - [ ] ¿Están cubiertos todos los escenarios de usuario?
-- [ ] ¿Los flujos de interacción son claros?
+- [ ] ¿Los flujos de interacción están claros?
 - [ ] ¿Las definiciones de campos de datos están completas?
 - [ ] ¿El manejo de excepciones es completo?
 
 ---
 
-### 4.3 Fase 3: Diseño del Sistema (System Designer)
+### 7.3 Fase 3: Diseño del Sistema (System Designer)
 
-**Cómo Comenzar**:
+**Cómo Iniciar**:
 ```
 @speccrew-system-designer iniciar diseño del sistema
 ```
@@ -207,7 +282,7 @@ iterations/{iter}/02.feature-design/
 2. Cargar base de conocimientos técnica (stack tecnológico, arquitectura, especificaciones para cada plataforma)
 3. **Checkpoint A**: Evaluación de Framework — Analizar brechas técnicas, recomendar nuevos frameworks (si es necesario), esperar confirmación del usuario
 4. Generar DESIGN-OVERVIEW.md
-5. Usar Task Worker para despacho paralelo de diseño para cada plataforma (frontend/backend/móvil/escritorio)
+5. Usar Task Worker para distribuir paralelamente el diseño para cada plataforma (frontend/backend/móvil/desktop)
 6. **Checkpoint B**: Confirmación Conjunta — Mostrar resumen de todos los diseños de plataforma, esperar confirmación del usuario
 
 **Entregable**:
@@ -215,20 +290,20 @@ iterations/{iter}/02.feature-design/
 iterations/{iter}/03.system-design/
 ├── DESIGN-OVERVIEW.md              # Visión general del diseño
 ├── {platform-id}/
-│   ├── INDEX.md                    # Índice de diseño de plataforma
-│   └── {module}-design.md          # Diseño de módulo a nivel de pseudocódigo
+│   ├── INDEX.md                    # Índice de diseño por plataforma
+│   └── {module}-design.md          # Diseño de módulo nivel pseudocódigo
 ```
 
 **Lista de Verificación de Confirmación**:
-- [ ] ¿El pseudocódigo usa sintaxis de framework real?
-- [ ] ¿Los contratos API multiplataforma son consistentes?
+- [ ] ¿El pseudocódigo usa la sintaxis real del framework?
+- [ ] ¿Los contratos API cross-plataforma son consistentes?
 - [ ] ¿La estrategia de manejo de errores es unificada?
 
 ---
 
-### 4.4 Fase 4: Implementación de Desarrollo (System Developer)
+### 7.4 Fase 4: Desarrollo (System Developer)
 
-**Cómo Comenzar**:
+**Cómo Iniciar**:
 ```
 @speccrew-system-developer iniciar desarrollo
 ```
@@ -236,14 +311,14 @@ iterations/{iter}/03.system-design/
 **Flujo de Trabajo del Agente**:
 1. Leer documentos de diseño del sistema
 2. Cargar conocimientos técnicos para cada plataforma
-3. **Checkpoint A**: Pre-verificación de Ambiente — Verificar versiones de runtime, dependencias, disponibilidad de servicios; esperar resolución del usuario si falla
-4. Usar Task Worker para despacho paralelo de desarrollo para cada plataforma
-5. Verificación de integración: Alineación de contratos API, consistencia de datos
-6. Generar informe de entrega
+3. **Checkpoint A**: Pre-verificación de Entorno — Verificar versiones runtime, dependencias, disponibilidad de servicios; esperar resolución del usuario si falla
+4. Usar Task Worker para distribuir paralelamente el desarrollo para cada plataforma
+5. Verificación de integración: alineación de contratos API, consistencia de datos
+6. Producir informe de entrega
 
 **Entregable**:
 ```
-# Código fuente escrito en el directorio de código fuente real del proyecto
+# El código fuente se escribe en el directorio fuente real del proyecto
 iterations/{iter}/04.development/
 ├── {platform-id}/
 │   └── tasks/                      # Registros de tareas de desarrollo
@@ -251,26 +326,26 @@ iterations/{iter}/04.development/
 ```
 
 **Lista de Verificación de Confirmación**:
-- [ ] ¿Está listo el ambiente?
-- [ ] ¿Los problemas de integración están dentro del rango aceptable?
+- [ ] ¿El entorno está listo?
+- [ ] ¿Los problemas de integración están en un rango aceptable?
 - [ ] ¿El código cumple con las especificaciones de desarrollo?
 
 ---
 
-### 4.5 Fase 5: Pruebas del Sistema (Test Manager)
+### 7.5 Fase 5: Pruebas del Sistema (Test Manager)
 
-**Cómo Comenzar**:
+**Cómo Iniciar**:
 ```
 @speccrew-test-manager iniciar pruebas
 ```
 
-**Proceso de Pruebas de Tres Fases**:
+**Proceso de Pruebas en Tres Fases**:
 
 | Fase | Descripción | Checkpoint |
-|------|-------------|------------|
+|-------|-------------|------------|
 | Diseño de Casos de Prueba | Generar casos de prueba basados en PRD y Feature Spec | A: Mostrar estadísticas de cobertura de casos y matriz de trazabilidad, esperar confirmación del usuario de cobertura suficiente |
 | Generación de Código de Prueba | Generar código de prueba ejecutable | B: Mostrar archivos de prueba generados y mapeo de casos, esperar confirmación del usuario |
-| Ejecución de Pruebas e Informe de Bugs | Ejecutar pruebas automáticamente y generar informes | Ninguno (ejecución automática) |
+| Ejecución de Pruebas e Informe de Bugs | Ejecutar automáticamente pruebas y generar informes | Ninguno (ejecución automática) |
 
 **Entregable**:
 ```
@@ -280,21 +355,21 @@ iterations/{iter}/05.system-test/
 ├── code/
 │   └── {platform-id}/              # Plan de código de prueba
 ├── reports/
-│   └── test-report-{date}.md       # Informe de pruebas
+│   └── test-report-{date}.md       # Informe de prueba
 └── bugs/
-    └── BUG-{id}-{title}.md         # Informes de bugs (un archivo por bug)
+    └── BUG-{id}-{title}.md         # Informes de bug (un archivo por bug)
 ```
 
 **Lista de Verificación de Confirmación**:
-- [ ] ¿La cobertura de casos es completa?
+- [ ] ¿La cobertura de casos está completa?
 - [ ] ¿El código de prueba es ejecutable?
 - [ ] ¿La evaluación de severidad de bugs es precisa?
 
 ---
 
-### 4.6 Fase 6: Archivo
+### 7.6 Fase 6: Archivado
 
-Las iteraciones se archivan automáticamente al completarse:
+Las iteraciones se archivan automáticamente después de completarse:
 
 ```
 speccrew-workspace/iteration-archives/
@@ -308,11 +383,11 @@ speccrew-workspace/iteration-archives/
 
 ---
 
-## 5. Visión General de la Base de Conocimientos
+## 8. Visión General de la Base de Conocimientos
 
-### 5.1 Base de Conocimientos de Negocio (bizs)
+### 8.1 Base de Conocimientos de Negocio (bizs)
 
-**Propósito**: Almacenar descripciones de funciones de negocio del proyecto, divisiones de módulos, características API
+**Propósito**: Almacenar descripciones de funcionalidades de negocio del proyecto, divisiones de módulos, características API
 
 **Estructura de Directorios**:
 ```
@@ -325,9 +400,9 @@ knowledges/bizs/
 
 **Escenarios de Uso**: Product Manager, Feature Designer
 
-### 5.2 Base de Conocimientos Técnica (techs)
+### 8.2 Base de Conocimientos Técnica (techs)
 
-**Propósito**: Almacenar stack tecnológico del proyecto, convenciones de arquitectura, especificaciones de desarrollo, especificaciones de pruebas
+**Propósito**: Almacenar stack tecnológico del proyecto, convenciones de arquitectura, especificaciones de desarrollo, especificaciones de prueba
 
 **Estructura de Directorios**:
 ```
@@ -343,21 +418,21 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Gestión del Progreso del Workflow
+## 9. Gestión de Progreso del Flujo de Trabajo
 
-El equipo virtual de SpecCrew sigue un estricto mecanismo de validación por etapas donde cada fase debe ser confirmada por el usuario antes de proceder a la siguiente. También soporta ejecución reanudable — al reiniciar después de una interrupción, continúa automáticamente desde donde se detuvo.
+El equipo virtual SpecCrew sigue un mecanismo estricto de paso de fases donde cada fase debe ser confirmada por el usuario antes de pasar a la siguiente. También soporta ejecución reanudable — cuando se reinicia después de una interrupción, continúa automáticamente desde donde se detuvo.
 
-### 6.1 Archivos de Progreso de Tres Niveles
+### 9.1 Tres Capas de Archivos de Progreso
 
-El workflow mantiene automáticamente tres tipos de archivos de progreso JSON, ubicados en el directorio de iteración:
+El flujo de trabajo mantiene automáticamente tres tipos de archivos JSON de progreso, ubicados en el directorio de iteración:
 
 | Archivo | Ubicación | Propósito |
-|---------|-----------|----------|
+|------|----------|---------|
 | `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Registra el estado de cada etapa del pipeline |
 | `.checkpoints.json` | Bajo cada directorio de fase | Registra el estado de confirmación de checkpoints del usuario |
-| `DISPATCH-PROGRESS.json` | Bajo cada directorio de fase | Registra el progreso elemento por elemento para tareas paralelas (multiplataforma/multimódulo) |
+| `DISPATCH-PROGRESS.json` | Bajo cada directorio de fase | Registra el progreso item por item para tareas paralelas (multi-plataforma/multi-módulo) |
 
-### 6.2 Flujo de Estado de las Etapas
+### 9.2 Flujo de Estado de Fase
 
 Cada fase sigue este flujo de estado:
 
@@ -366,27 +441,27 @@ pending → in_progress → completed → confirmed
 ```
 
 - **pending**: Aún no iniciado
-- **in_progress**: Actualmente en ejecución
-- **completed**: Ejecución del Agent completada, esperando confirmación del usuario
-- **confirmed**: Confirmado por el usuario a través del checkpoint final, la siguiente fase puede iniciar
+- **in_progress**: En ejecución
+- **completed**: Ejecución del agente completada, esperando confirmación del usuario
+- **confirmed**: Usuario confirmado a través del checkpoint final, la siguiente fase puede comenzar
 
-### 6.3 Ejecución Reanudable
+### 9.3 Ejecución Reanudable
 
-Al reiniciar un Agent para una fase:
+Al reiniciar un Agente para una fase:
 
-1. **Verificación automática ascendente**: Verifica si la fase anterior está confirmada, bloquea y notifica si no lo está
-2. **Recuperación de checkpoints**: Lee `.checkpoints.json`, omite los checkpoints superados, continúa desde el último punto de interrupción
-3. **Recuperación de tareas paralelas**: Lee `DISPATCH-PROGRESS.json`, solo reejecuta tareas con estado `pending` o `failed`, omite tareas `completed`
+1. **Verificación automática upstream**: Verifica si la fase anterior está confirmada, bloquea y notifica si no
+2. **Recuperación de Checkpoint**: Lee `.checkpoints.json`, salta checkpoints pasados, continúa desde el último punto de interrupción
+3. **Recuperación de Tareas Paralelas**: Lee `DISPATCH-PROGRESS.json`, solo re-ejecuta tareas con estado `pending` o `failed`, salta tareas `completed`
 
-### 6.4 Ver el Progreso Actual
+### 9.4 Ver Progreso Actual
 
-Ver el estado panorámico del pipeline a través del Agent Team Leader:
+Ver el estado panorámico del pipeline a través del Agente Team Leader:
 
 ```
-@speccrew-team-leader ver progreso de iteración actual
+@speccrew-team-leader ver progreso actual de la iteración
 ```
 
-El Team Leader leerá los archivos de progreso y mostrará un resumen de estado similar a:
+El Team Leader leerá los archivos de progreso y mostrará una visión general del estado similar a:
 
 ```
 Pipeline Status: i001-user-management
@@ -397,27 +472,27 @@ Pipeline Status: i001-user-management
   05 System Test:    ⏳ Pending
 ```
 
-### 6.5 Compatibilidad hacia atrás
+### 9.5 Compatibilidad Hacia Atrás
 
-El mecanismo de archivos de progreso es completamente retrocompatible — si los archivos de progreso no existen (por ejemplo, en proyectos heredados o nuevas iteraciones), todos los Agents se ejecutarán normalmente según la lógica original.
+El mecanismo de archivos de progreso es completamente compatible hacia atrás — si los archivos de progreso no existen (por ej. en proyectos legacy o nuevas iteraciones), todos los Agentes se ejecutarán normalmente según la lógica original.
 
 ---
 
-## 7. Preguntas Frecuentes (FAQ)
+## 10. Preguntas Frecuentes (FAQ)
 
 ### P1: ¿Qué hacer si el Agente no funciona como se espera?
 
-1. Ejecute `speccrew doctor` para verificar la integridad de la instalación
-2. Confirme que la base de conocimientos ha sido inicializada
-3. Confirme que el entregable de la fase anterior existe en el directorio de iteración actual
+1. Ejecutar `speccrew doctor` para verificar integridad de la instalación
+2. Confirmar que la base de conocimientos ha sido inicializada
+3. Confirmar que el entregable de la fase anterior existe en el directorio de iteración actual
 
-### P2: ¿Cómo omitir una fase?
+### P2: ¿Cómo saltar una fase?
 
-**No recomendado** — El resultado de cada fase es la entrada para la siguiente fase.
+**No recomendado** — La salida de cada fase es la entrada de la siguiente fase.
 
-Si debe omitir, prepare manualmente el documento de entrada de la fase correspondiente y asegúrese de que siga las especificaciones de formato.
+Si debe saltar, prepare manualmente el documento de entrada de la fase correspondiente y asegúrese de que cumpla con las especificaciones de formato.
 
-### P3: ¿Cómo manejar múltiples requisitos en paralelo?
+### P3: ¿Cómo manejar múltiples requisitos paralelos?
 
 Cree directorios de iteración independientes para cada requisito:
 ```
@@ -431,26 +506,26 @@ Cada iteración está completamente aislada y no afecta a las demás.
 
 ### P4: ¿Cómo actualizar la versión de SpecCrew?
 
-La actualización se realiza en dos pasos:
+La actualización requiere dos pasos:
 
 ```bash
 # Paso 1: Actualizar la herramienta CLI global
 npm install -g speccrew@latest
 
-# Paso 2: Sincronizar Agents y Skills en el directorio del proyecto
+# Paso 2: Sincronizar Agents y Skills en su directorio de proyecto
 cd /path/to/your-project
 speccrew update
 ```
 
-- `npm install -g speccrew@latest`: Actualiza la herramienta CLI en sí (la nueva versión puede contener nuevas definiciones de Agent/Skill, correcciones de errores, etc.)
-- `speccrew update`: Sincroniza los archivos de definición de Agent y Skill en el proyecto a la última versión
-- `speccrew update --ide cursor`: Actualiza solo la configuración del IDE especificado
+- `npm install -g speccrew@latest`: Actualiza la herramienta CLI en sí (las nuevas versiones pueden incluir nuevas definiciones de Agent/Skill, correcciones de bugs, etc.)
+- `speccrew update`: Sincroniza los archivos de definición de Agent y Skill de su proyecto a la última versión
+- `speccrew update --ide cursor`: Actualiza la configuración para un IDE específico únicamente
 
-> **Nota**: Ambos pasos deben ejecutarse. Ejecutar solo `speccrew update` no actualizará la herramienta CLI en sí; ejecutar solo `npm install` no actualizará los archivos en el proyecto.
+> **Nota**: Ambos pasos son necesarios. Ejecutar solo `speccrew update` no actualizará la herramienta CLI en sí; ejecutar solo `npm install` no actualizará los archivos del proyecto.
 
-### P5: ¿`speccrew update` muestra nueva versión disponible pero `npm install -g speccrew@latest` sigue instalando la versión anterior?
+### P5: `speccrew update` indica que hay una nueva versión disponible pero `npm install -g speccrew@latest` sigue instalando la versión antigua?
 
-Esto suele ser causado por la caché de npm. Solución:
+Esto generalmente es causado por el caché de npm. Solución:
 
 ```bash
 # Limpiar caché de npm y reinstalar
@@ -468,25 +543,25 @@ npm install -g speccrew@0.5.6
 
 ### P6: ¿Cómo ver iteraciones históricas?
 
-Después de archivar, consulte en `speccrew-workspace/iteration-archives/`, organizado en formato `{número}-{tipo}-{nombre}-{fecha}/`.
+Después del archivado, ver en `speccrew-workspace/iteration-archives/`, organizado por formato `{número}-{tipo}-{nombre}-{fecha}/`.
 
 ### P7: ¿La base de conocimientos necesita actualizaciones regulares?
 
-Se requiere reinicialización en las siguientes situaciones:
-- Cambios importantes en la estructura del proyecto
+Se requiere re-inicialización en las siguientes situaciones:
+- Cambios mayores en la estructura del proyecto
 - Actualización o reemplazo del stack tecnológico
 - Adición/eliminación de módulos de negocio
 
 ---
 
-## 8. Referencia Rápida
+## 11. Referencia Rápida
 
 ### Referencia Rápida de Inicio de Agentes
 
 | Fase | Agente | Conversación de Inicio |
-|------|--------|------------------------|
+|-------|-------|-------------------|
 | Inicialización | Team Leader | `@speccrew-team-leader inicializar base de conocimientos técnica` |
-| Análisis de Requisitos | Product Manager | `@speccrew-product-manager tengo un nuevo requisito: [descripción]` |
+| Análisis de Requisitos | Product Manager | `@speccrew-product-manager Tengo un nuevo requisito: [descripción]` |
 | Diseño de Funcionalidades | Feature Designer | `@speccrew-feature-designer iniciar diseño de funcionalidades` |
 | Diseño del Sistema | System Designer | `@speccrew-system-designer iniciar diseño del sistema` |
 | Desarrollo | System Developer | `@speccrew-system-developer iniciar desarrollo` |
@@ -494,29 +569,29 @@ Se requiere reinicialización en las siguientes situaciones:
 
 ### Lista de Verificación de Checkpoints
 
-| Fase | Número de Checkpoints | Elementos Clave de Verificación |
-|------|----------------------|--------------------------------|
-| Análisis de Requisitos | 1 | Precisión de requisitos, completitud de reglas de negocio, mensurabilidad de criterios de aceptación |
+| Fase | Número de Checkpoints | Elementos de Verificación Clave |
+|-------|----------------------|-----------------|
+| Análisis de Requisitos | 1 | Precisión de requisitos, completitud de reglas de negocio, medibilidad de criterios de aceptación |
 | Diseño de Funcionalidades | 1 | Cobertura de escenarios, claridad de interacción, completitud de datos, manejo de excepciones |
-| Diseño del Sistema | 2 | A: Evaluación de framework; B: Sintaxis de pseudocódigo, consistencia multiplataforma, manejo de errores |
-| Desarrollo | 1 | A: Preparación del ambiente, problemas de integración, especificaciones de código |
+| Diseño del Sistema | 2 | A: Evaluación de framework; B: Sintaxis de pseudocódigo, consistencia cross-plataforma, manejo de errores |
+| Desarrollo | 1 | A: Preparación del entorno, problemas de integración, especificaciones de código |
 | Pruebas del Sistema | 2 | A: Cobertura de casos; B: Ejecutabilidad del código de prueba |
 
 ### Referencia Rápida de Rutas de Entregables
 
 | Fase | Directorio de Salida | Formato de Archivo |
-|------|---------------------|-------------------|
+|-------|-----------------|-------------|
 | Análisis de Requisitos | `iterations/{iter}/01.product-requirement/` | `[name]-prd.md`, `[name]-bizs-modeling.md` |
 | Diseño de Funcionalidades | `iterations/{iter}/02.feature-design/` | `[name]-feature-spec.md` |
 | Diseño del Sistema | `iterations/{iter}/03.system-design/` | `DESIGN-OVERVIEW.md`, `{platform}/INDEX.md`, `{platform}/{module}-design.md` |
 | Desarrollo | `iterations/{iter}/04.development/` | Código fuente + `delivery-report.md` |
 | Pruebas del Sistema | `iterations/{iter}/05.system-test/` | `cases/`, `code/`, `reports/`, `bugs/` |
-| Archivo | `iteration-archives/{iter}-{fecha}/` | Copia completa de la iteración |
+| Archivado | `iteration-archives/{iter}-{date}/` | Copia completa de la iteración |
 
 ---
 
 ## Próximos Pasos
 
 1. Ejecute `speccrew init --ide qoder` para inicializar su proyecto
-2. Ejecute el Paso Cero: Inicialización de la Base de Conocimientos
-3. Avance a través de cada fase siguiendo el flujo de trabajo, ¡disfrutando de la experiencia de desarrollo impulsada por especificaciones!
+2. Ejecute Paso Cero: Inicialización de la Base de Conocimientos
+3. ¡Progrese fase por fase según el flujo de trabajo, disfrute la experiencia de desarrollo impulsado por especificaciones!