speccrew 0.1.0 → 0.1.2

package/README.en.md

@@ -1,10 +1,34 @@
 # SpecCrew - AI-Driven Software Engineering Framework
 
 <p align="center">
-  <a href="./README.md">中文</a> |
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
   <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
   <a href="./README.ar.md">العربية</a> |
-  <a href="./README.es.md">Español</a>
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
 </p>
 
 > A virtual AI development team that enables rapid engineering implementation for any software project
@@ -93,7 +117,7 @@ graph LR
     B --> C[API Contract<br/>Interface Contract]
     C --> D[Design<br/>Detailed Design]
     D --> E[Dev<br/>Implementation]
-    E --> F[Test<br/>Testing]
+    E --> F[System Test<br/>Testing]
     F --> G[Archive<br/>Archiving]
     
     H[Knowledge<br/>Repository] -.-> A
@@ -113,7 +137,7 @@ graph LR
 | Solution | Planner | PRD | Technical Solution + API Contract | ✅ Required |
 | Design | Designer | Solution | Frontend/Backend Design Documents | ✅ Required |
 | Dev | Dev | Design | Code + Task Records | ✅ Required |
-| Test | Test | Dev Output + PRD Acceptance Criteria | Test Report | ✅ Required |
+| System Test | Test Manager | Dev Output + Feature Spec | Test Cases + Test Code + Test Report + Bug Report | ✅ Required |
 
 ---
 
@@ -134,100 +158,71 @@ graph LR
 
 ## Quick Start
 
-### 1. Install SpecCrew
-
-**Method 1: One-click Install Script (Recommended, Qoder IDE only)**
-
-```bash
-# macOS / Linux / WSL - Install from GitHub
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.sh | bash
-
-# macOS / Linux / WSL - Install from Gitee (China Mirror)
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.sh | bash
-```
+### Prerequisites
 
-```powershell
-# Windows - Install from GitHub
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.ps1").Content
+- Node.js >= 16.0.0
+- Supported IDEs: Qoder (default), Cursor, Claude Code
 
-# Windows - Install from Gitee (China Mirror)
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.ps1").Content
-```
-
-> **Note**: One-click installation script currently only supports Qoder IDE. For other IDEs (VS Code, Cursor, etc.), please use manual copy method below.
+> **Note**: The adapters for Cursor and Claude Code have not been tested in actual IDE environments (implemented at the code level and verified through E2E tests, but not yet tested in real Cursor/Claude Code).
 
-**Method 2: Manual Copy (Universal for all IDEs)**
+### 1. Install SpecCrew
 
 ```bash
-# Clone repository and copy to existing project
-git clone https://github.com/charlesmu99/speccrew.git
-# or: git clone https://gitee.com/amutek/speccrew.git
-
-# Copy to target project (adjust based on your IDE config directory)
-cp -r SpecCrew/.speccrew /path/to/your-project/
-cp -r SpecCrew/SpecCrew-workspace /path/to/your-project/
-
-# For Qoder IDE, also copy to .qoder/ directory
-cp -r SpecCrew/.speccrew/agents/* /path/to/your-project/.qoder/agents/
-cp -r SpecCrew/.speccrew/skills/* /path/to/your-project/.qoder/skills/
+npm install -g speccrew
 ```
 
 ### 2. Initialize Project
 
+Navigate to your project root directory and run the initialization command:
+
 ```bash
-# Run initialization Skill to automatically generate knowledge base and project structure
-# Executed automatically by speccrew-project-init Skill
-```
+cd /path/to/your-project
 
-### 3. Start Development Workflow
+# Default uses Qoder
+speccrew init
 
-```bash
-# 1. Create PRD
-# 2. Generate Solution
-# 3. Confirm API Contract
-# 4. Detailed Design
-# 5. Development Implementation
-# 6. Testing
+# Or specify IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
 ```
 
-### 4. Uninstall SpecCrew
+After initialization, the following will be generated in your project:
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent role definitions
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill workflows
+- `speccrew-workspace/` — Workspace (iteration directories, knowledge base, document templates)
+- `.speccrewrc` — SpecCrew configuration file
 
-**Method 1: One-Click Uninstall Script (Recommended, Qoder IDE only)**
+To update Agents and Skills for a specific IDE later:
 
 ```bash
-# macOS / Linux / WSL - Uninstall from GitHub
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.sh | bash
-
-# macOS / Linux / WSL - Uninstall from Gitee (China Mirror)
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.sh | bash
+speccrew update --ide cursor
+speccrew update --ide claude
 ```
 
-```powershell
-# Windows - Uninstall from GitHub
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.ps1").Content
-
-# Windows - Uninstall from Gitee (China Mirror)
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.ps1").Content
-```
+### 3. Start Development Workflow
 
-> **Note**: One-click uninstall script currently only supports Qoder IDE.
+Follow the standard engineering workflow step by step:
 
-**Method 2: Manual Uninstall (Universal for all IDEs)**
+1. **PRD**: Product Manager Agent analyzes requirements and generates product requirements document
+2. **Feature Design**: Feature Designer Agent generates feature design document + API contract
+3. **System Design**: System Designer Agent generates system design documents by platform (frontend/backend/mobile/desktop)
+4. **Dev**: System Developer Agent implements development by platform in parallel
+5. **System Test**: Test Manager Agent coordinates three-phase testing (case design → code generation → execution report)
+6. **Archive**: Archive iteration
 
-```bash
-# Remove speccrew-workspace directory
-rm -rf speccrew-workspace/
+> Each phase's deliverables require human confirmation before proceeding to the next phase.
 
-# Remove SpecCrew-prefixed files in .speccrew/ (preserve custom content)
-rm -rf .speccrew/agents/SpecCrew-*.md
-rm -rf .speccrew/skills/SpecCrew-*/
+### 4. Other CLI Commands
 
-# For Qoder IDE, also clean up .qoder/ directory
-rm -rf .qoder/agents/SpecCrew-*.md
-rm -rf .qoder/skills/SpecCrew-*/
+```bash
+speccrew list       # List installed agents and skills
+speccrew doctor     # Diagnose environment and installation status
+speccrew update     # Update agents and skills to latest version
+speccrew uninstall  # Uninstall SpecCrew (--all also removes workspace)
 ```
 
-> **Note**: Uninstallation will preserve source files and custom content in `.speccrew/`. To completely remove IDE configurations, manually delete the corresponding IDE config directory (e.g., `.qoder/`).
+📖 **Detailed Guide**: After installation, check the [Getting Started Guide](docs/GETTING-STARTED.en.md) for the complete workflow and agent conversation guide.
 
 ---
 
@@ -235,40 +230,51 @@ rm -rf .qoder/skills/SpecCrew-*/
 
 ```
 your-project/
-├── .speccrew/                       # SpecCrew source files (version controllable)
-├── .qoder/                          # Qoder IDE configuration (runtime)
-│   ├── agents/                      # 6 role Agents
-│   └── skills/                      # 16 Skills
+├── .qoder/                          # IDE configuration directory (Qoder example)
+│   ├── agents/                      # 7 role Agents
+│   │   ├── speccrew-team-leader.md       # Team Leader: Global scheduling and iteration management
+│   │   ├── speccrew-product-manager.md   # Product Manager: Requirements analysis and PRD
+│   │   ├── speccrew-feature-designer.md  # Feature Designer: Feature Design + API Contract
+│   │   ├── speccrew-system-designer.md   # System Designer: System design by platform
+│   │   ├── speccrew-system-developer.md  # System Developer: Parallel development by platform
+│   │   ├── speccrew-test-manager.md      # Test Manager: Three-phase testing coordination
+│   │   └── speccrew-task-worker.md       # Task Worker: Parallel subtask execution
+│   └── skills/                      # 38 Skills (grouped by function)
+│       ├── speccrew-pm-*/                # Product Management (requirements analysis, evaluation)
+│       ├── speccrew-fd-*/                # Feature Design (Feature Design, API Contract)
+│       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)
+│       ├── speccrew-dev-*/               # Development (frontend/backend/mobile/desktop)
+│       ├── speccrew-test-*/              # Testing (case design/code generation/execution report)
+│       ├── speccrew-knowledge-bizs-*/    # Business Knowledge (API analysis/UI analysis/module classification, etc.)
+│       ├── speccrew-knowledge-techs-*/   # Technical Knowledge (tech stack generation/conventions/index, etc.)
+│       ├── speccrew-knowledge-graph-*/   # Knowledge Graph (read/write/query)
+│       └── speccrew-*/                   # Utilities (diagnostics/timestamps/workflow, etc.)
 │
 └── speccrew-workspace/              # Workspace (generated during initialization)
     ├── docs/                        # Management documents
+    │   ├── configs/                 # Configuration files (platform mapping, tech stack mapping, etc.)
     │   ├── rules/                   # Rule configurations
     │   └── solutions/               # Solution documents
-    │       └── agent-knowledge-map.md
     │
     ├── iterations/                  # Iteration projects (dynamically generated)
-    │   └── {number}-{type}-{name}/  # e.g., 001-feature-order
+    │   └── {number}-{type}-{name}/
     │       ├── 00.docs/             # Original requirements
     │       ├── 01.product-requirement/ # Product requirements
     │       ├── 02.feature-design/   # Feature design
     │       ├── 03.system-design/    # System design
     │       ├── 04.development/      # Development phase
-    │       ├── 05.test/             # Testing phase
+    │       ├── 05.system-test/      # System testing
     │       └── 06.delivery/         # Delivery phase
     │
     ├── iteration-archives/          # Iteration archives
-    │   └── {number}-{type}-{name}-{date}/
     │
     └── knowledges/                  # Knowledge base
-        ├── base/                    # Base metadata
+        ├── base/                    # Base/metadata
         │   ├── diagnosis-reports/   # Diagnosis reports
         │   ├── sync-state/          # Sync state
         │   └── tech-debts/          # Technical debts
-        │
         ├── bizs/                    # Business knowledge
-        │   └── {platform-type}/
-        │       └── {module-name}/
-        │
+        │   └── {platform-type}/{module-name}/
         └── techs/                   # Technical knowledge
             └── {platform-id}/
 ```
@@ -305,6 +311,7 @@ your-project/
 ## More Information
 
 - **Agent Knowledge Map**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
 - **GitHub**: https://github.com/charlesmu99/speccrew
 - **Gitee**: https://gitee.com/amutek/speccrew
 - **Qoder IDE**: https://qoder.com/

package/README.es.md

@@ -1,10 +1,34 @@
 # SpecCrew - Framework de Ingeniería de Software Impulsado por IA
 
 <p align="center">
-  <a href="./README.md">中文</a> |
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
   <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
   <a href="./README.ar.md">العربية</a> |
-  <a href="./README.es.md">Español</a>
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
 </p>
 
 > Un equipo de desarrollo virtual de IA que permite la implementación de ingeniería rápida para cualquier proyecto de software
@@ -93,7 +117,7 @@ graph LR
     B --> C[API Contract<br/>Contrato de Interfaz]
     C --> D[Design<br/>Diseño Detallado]
     D --> E[Dev<br/>Implementación]
-    E --> F[Test<br/>Pruebas]
+    E --> F[System Test<br/>Pruebas del Sistema]
     F --> G[Archive<br/>Archivado]
     
     H[Knowledge<br/>Repositorio] -.-> A
@@ -113,7 +137,7 @@ graph LR
 | Solution | Planner | PRD | Solución Técnica + Contrato API | ✅ Requerido |
 | Design | Designer | Solution | Documentos de Diseño Frontend/Backend | ✅ Requerido |
 | Dev | Dev | Design | Código + Registros de Tareas | ✅ Requerido |
-| Test | Test | Salida Dev + Criterios de Aceptación PRD | Reporte de Pruebas | ✅ Requerido |
+| System Test | Test Manager | Salida Dev + Feature Spec | Casos de Prueba + Código de Prueba + Reporte de Pruebas + Reporte de Bugs | ✅ Requerido |
 
 ---
 
@@ -134,100 +158,71 @@ graph LR
 
 ## Inicio Rápido
 
-### 1. Instalar SpecCrew
-
-**Método 1: Script de Instalación con Un Clic (Recomendado, solo Qoder IDE)**
-
-```bash
-# macOS / Linux / WSL - Instalar desde GitHub
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.sh | bash
-
-# macOS / Linux / WSL - Instalar desde Gitee (Espejo de China)
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.sh | bash
-```
+### Requisitos Previos
 
-```powershell
-# Windows - Instalar desde GitHub
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/install-qoder.ps1").Content
+- Node.js >= 16.0.0
+- IDEs compatibles: Qoder (predeterminado), Cursor, Claude Code
 
-# Windows - Instalar desde Gitee (Espejo de China)
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/install-qoder.ps1").Content
-```
-
-> **Nota**: El script de instalación con un clic actualmente solo soporta Qoder IDE. Para otros IDEs (VS Code, Cursor, etc.), use el método de copia manual a continuación.
+> **Nota**: Los adaptadores para Cursor y Claude Code aún no han sido probados en entornos IDE reales (implementados a nivel de código y verificados mediante pruebas E2E, pero aún no probados en Cursor/Claude Code real).
 
-**Método 2: Copia Manual (Universal para todos los IDEs)**
+### 1. Instalar SpecCrew
 
 ```bash
-# Clonar repositorio y copiar a proyecto existente
-git clone https://github.com/charlesmu99/SpecCrew.git
-# o: git clone https://gitee.com/amutek/SpecCrew.git
-
-# Copiar al proyecto destino (ajustar según el directorio de configuración de su IDE)
-cp -r SpecCrew/.speccrew /path/to/your-project/
-cp -r SpecCrew/SpecCrew-workspace /path/to/your-project/
-
-# Para Qoder IDE, también copiar al directorio .qoder/
-cp -r SpecCrew/.speccrew/agents/* /path/to/your-project/.qoder/agents/
-cp -r SpecCrew/.speccrew/skills/* /path/to/your-project/.qoder/skills/
+npm install -g speccrew
 ```
 
 ### 2. Inicializar Proyecto
 
+Navegue al directorio raíz de su proyecto y ejecute el comando de inicialización:
+
 ```bash
-# Ejecutar Skill de inicialización para generar automáticamente base de conocimiento y estructura del proyecto
-# Ejecutado automáticamente por el Skill SpecCrew-project-init
-```
+cd /ruta/a/su-proyecto
 
-### 3. Iniciar Flujo de Trabajo de Desarrollo
+# Predeterminado usa Qoder
+speccrew init
 
-```bash
-# 1. Crear PRD
-# 2. Generar Solution
-# 3. Confirmar Contrato API
-# 4. Diseño Detallado
-# 5. Implementación de Desarrollo
-# 6. Pruebas
+# O especificar IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
 ```
 
-### 4. Desinstalar SpecCrew
+Después de la inicialización, se generarán en su proyecto:
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definiciones de roles Agent
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 flujos de trabajo Skill
+- `speccrew-workspace/` — Espacio de trabajo (directorios de iteración, base de conocimientos, plantillas de documentos)
+- `.speccrewrc` — Archivo de configuración de SpecCrew
 
-**Método 1: Script de Desinstalación con Un Clic (Recomendado, solo Qoder IDE)**
+Para actualizar Agents y Skills para un IDE específico más tarde:
 
 ```bash
-# macOS / Linux / WSL - Desinstalar desde GitHub
-curl -fsSL https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.sh | bash
-
-# macOS / Linux / WSL - Desinstalar desde Gitee (Espejo de China)
-curl -fsSL https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.sh | bash
+speccrew update --ide cursor
+speccrew update --ide claude
 ```
 
-```powershell
-# Windows - Desinstalar desde GitHub
-Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/charlesmu99/SpecCrew/main/scripts/uninstall-qoder.ps1").Content
-
-# Windows - Desinstalar desde Gitee (Espejo de China)
-Invoke-Expression (Invoke-WebRequest -Uri "https://gitee.com/amutek/speccrew/raw/main/scripts/uninstall-qoder.ps1").Content
-```
+### 3. Iniciar Flujo de Trabajo de Desarrollo
 
-> **Nota**: El script de desinstalación con un clic actualmente solo soporta Qoder IDE.
+Siga el flujo de trabajo de ingeniería estándar paso a paso:
 
-**Método 2: Desinstalación Manual (Universal para todos los IDEs)**
+1. **PRD**: El Agent Product Manager analiza los requisitos y genera el documento de requisitos del producto
+2. **Feature Design**: El Agent Feature Designer genera el documento de diseño de funcionalidades + contrato API
+3. **System Design**: El Agent System Designer genera documentos de diseño del sistema por plataforma (frontend/backend/móvil/escritorio)
+4. **Dev**: El Agent System Developer implementa el desarrollo por plataforma en paralelo
+5. **System Test**: El Agent Test Manager coordina las pruebas de tres fases (diseño de casos → generación de código → reporte de ejecución)
+6. **Archive**: Archivar iteración
 
-```bash
-# Eliminar directorio SpecCrew-workspace
-rm -rf SpecCrew-workspace/
+> Los entregables de cada fase requieren confirmación humana antes de proceder a la siguiente fase.
 
-# Eliminar archivos con prefijo SpecCrew- en .speccrew/ (preservar contenido personalizado)
-rm -rf .speccrew/agents/SpecCrew-*.md
-rm -rf .speccrew/skills/SpecCrew-*/
+### 4. Otros Comandos CLI
 
-# Para Qoder IDE, también limpiar el directorio .qoder/
-rm -rf .qoder/agents/SpecCrew-*.md
-rm -rf .qoder/skills/SpecCrew-*/
+```bash
+speccrew list       # Listar agents y skills instalados
+speccrew doctor     # Diagnosticar entorno y estado de instalación
+speccrew update     # Actualizar agents y skills a la última versión
+speccrew uninstall  # Desinstalar SpecCrew (--all también elimina el workspace)
 ```
 
-> **Nota**: La desinstalación preservará los archivos fuente y contenido personalizado en `.speccrew/`. Para eliminar completamente las configuraciones del IDE, elimina manualmente el directorio de configuración correspondiente (ej., `.qoder/`).
+📖 **Guía Detallada**: Después de la instalación, consulta la [Guía de Inicio Rápido](docs/GETTING-STARTED.es.md) para el flujo de trabajo completo y la guía de conversación con agentes.
 
 ---
 
@@ -235,40 +230,51 @@ rm -rf .qoder/skills/SpecCrew-*/
 
 ```
 your-project/
-├── .speccrew/                       # Archivos fuente SpecCrew (controlables por versión)
-├── .qoder/                          # Configuración Qoder IDE (tiempo de ejecución)
-│   ├── agents/                      # 6 Agentes de rol
-│   └── skills/                      # 16 Skills
+├── .qoder/                          # Directorio de configuración IDE (ejemplo Qoder)
+│   ├── agents/                      # 7 Agents de roles
+│   │   ├── speccrew-team-leader.md       # Líder de Equipo: Programación global y gestión de iteraciones
+│   │   ├── speccrew-product-manager.md   # Product Manager: Análisis de requisitos y PRD
+│   │   ├── speccrew-feature-designer.md  # Feature Designer: Feature Design + Contrato API
+│   │   ├── speccrew-system-designer.md   # System Designer: Diseño de sistema por plataforma
+│   │   ├── speccrew-system-developer.md  # System Developer: Desarrollo paralelo por plataforma
+│   │   ├── speccrew-test-manager.md      # Test Manager: Coordinación de pruebas de tres fases
+│   │   └── speccrew-task-worker.md       # Task Worker: Ejecución paralela de subtareas
+│   └── skills/                      # 38 Skills (agrupados por función)
+│       ├── speccrew-pm-*/                # Gestión de Producto (análisis de requisitos, evaluación)
+│       ├── speccrew-fd-*/                # Feature Design (Feature Design, Contrato API)
+│       ├── speccrew-sd-*/                # System Design (frontend/backend/móvil/escritorio)
+│       ├── speccrew-dev-*/               # Desarrollo (frontend/backend/móvil/escritorio)
+│       ├── speccrew-test-*/              # Pruebas (diseño de casos/generación de código/reporte de ejecución)
+│       ├── speccrew-knowledge-bizs-*/    # Conocimiento de Negocio (análisis API/análisis UI/clasificación de módulos, etc.)
+│       ├── speccrew-knowledge-techs-*/   # Conocimiento Técnico (generación de stack/convenciones/índice, etc.)
+│       ├── speccrew-knowledge-graph-*/   # Grafo de Conocimiento (leer/escribir/consultar)
+│       └── speccrew-*/                   # Utilidades (diagnósticos/marcas de tiempo/flujo de trabajo, etc.)
 │
-└── SpecCrew-workspace/              # Espacio de trabajo (generado durante inicialización)
+└── speccrew-workspace/              # Espacio de trabajo (generado durante inicialización)
     ├── docs/                        # Documentos administrativos
+    │   ├── configs/                 # Archivos de configuración (mapeo de plataforma, mapeo de stack técnico, etc.)
     │   ├── rules/                   # Configuraciones de reglas
     │   └── solutions/               # Documentos de soluciones
-    │       └── agent-knowledge-map.md
     │
     ├── iterations/                  # Proyectos de iteración (generados dinámicamente)
-    │   └── {número}-{tipo}-{nombre}/ # ej., 001-feature-order
+    │   └── {número}-{tipo}-{nombre}/
     │       ├── 00.docs/             # Requisitos originales
     │       ├── 01.product-requirement/ # Requisitos del producto
     │       ├── 02.feature-design/   # Diseño de características
     │       ├── 03.system-design/    # Diseño del sistema
     │       ├── 04.development/      # Fase de desarrollo
-    │       ├── 05.test/             # Fase de pruebas
+    │       ├── 05.system-test/      # Pruebas del sistema
     │       └── 06.delivery/         # Fase de entrega
     │
     ├── iteration-archives/          # Archivos de iteración
-    │   └── {número}-{tipo}-{nombre}-{fecha}/
     │
     └── knowledges/                  # Base de conocimiento
-        ├── base/                    # Metadatos base
+        ├── base/                    # Base/metadatos
         │   ├── diagnosis-reports/   # Informes de diagnóstico
         │   ├── sync-state/          # Estado de sincronización
         │   └── tech-debts/          # Deudas técnicas
-        │
         ├── bizs/                    # Conocimiento de negocio
-        │   └── {tipo-de-plataforma}/
-        │       └── {nombre-del-módulo}/
-        │
+        │   └── {tipo-de-plataforma}/{nombre-del-módulo}/
         └── techs/                   # Conocimiento técnico
             └── {id-de-plataforma}/
 ```
@@ -304,9 +310,10 @@ your-project/
 
 ## Más Información
 
-- **Mapa de Conocimiento del Agente**: [SpecCrew-workspace/docs/agent-knowledge-map.md](./SpecCrew-workspace/docs/agent-knowledge-map.md)
-- **GitHub**: https://github.com/charlesmu99/SpecCrew
-- **Gitee**: https://gitee.com/amutek/SpecCrew
+- **Mapa de Conocimiento del Agente**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
+- **GitHub**: https://github.com/charlesmu99/speccrew
+- **Gitee**: https://gitee.com/amutek/speccrew
 - **Qoder IDE**: https://qoder.com/
 
 ---