--- name: project-story-mapping description: >- Orquesta una sesión de User Story Mapping (Jeff Patton) para el proyecto activo en SDDF: prepara el contexto desde los documentos del proyecto y delega la sesión completa al agente project-story-mapper, produciendo story-map.md con backbone, walking skeleton y release slices. Usar cuando se quiere organizar requisitos en incrementos entregables, definir el MVP, visualizar el journey del usuario o planificar releases. Invocar también cuando el usuario mencione "story mapping", "user story map", "backbone", "walking skeleton", "release slices", "project-story-mapping" o equivalentes. triggers: - project-story-mapping - /project-story-mapping - story mapping - user story map - backbone - walking skeleton - release slices --- # Skill: `/project-story-mapping` **Cuándo usar este skill:** Usar cuando el usuario quiere organizar requisitos en incrementos entregables, definir el alcance del MVP desde un conjunto grande de requisitos, visualizar el journey del usuario a través de las funcionalidades, planificar releases con valor claro, dividir épicas en historias entregables, o comunicar la visión del producto a stakeholders. Invocar también cuando el usuario mencione "story mapping", "user story map", "backbone", "walking skeleton", "release slices", "project-story-mapping" o equivalentes. ## Objetivo Orquesta una sesión de User Story Mapping (técnica de Jeff Patton) para el proyecto activo en SDDF: prepara el contexto desde los documentos del proyecto y delega la sesión completa al agente `project-story-mapper`, produciendo `$SPECS_BASE/specs/projects/$PROJ_DIR/story-map.md`. Se ubica entre la fase de discovery y la planificación del proyecto: ``` project-begin → project-discovery → [project-story-mapping] → project-planning ``` **Qué hace este skill:** - Resuelve el proyecto activo y lee los documentos disponibles (`project-intent.md`, `project.md`) - Delega la sesión interactiva completa al agente `project-story-mapper` con el contexto preparado - Añade el frontmatter YAML al documento generado por el agente **Qué NO hace este skill:** - No conduce el story mapping directamente — esa responsabilidad es del agente `project-story-mapper` - No modifica el contenido narrativo del `story-map.md` generado (solo añade frontmatter) ## Entrada - `$SPECS_BASE/specs/projects/$PROJ_DIR/project-intent.md` — contexto del proyecto (opcional) - `$SPECS_BASE/specs/projects/$PROJ_DIR/project.md` — especificación de requisitos (opcional) - Si no hay documentos disponibles, el agente `project-story-mapper` recopila el contexto interactivamente ## Parámetros - Ninguno — el skill opera de forma completamente interactiva mediante el agente `project-story-mapper` ## Precondiciones - El entorno debe superar el preflight (`skill-preflight`) sin errores - No hay precondición de estado: el skill puede ejecutarse con o sin documentos previos del proyecto ## Dependencias - Skills: [`skill-preflight`] - Agentes: [`project-story-mapper`] ## Modos de ejecución - **Manual** (`/project-story-mapping`): siempre interactivo — el agente `project-story-mapper` conduce la sesión con el usuario. - **Invocado desde `project-planning`**: el skill recibe contexto de los documentos del proyecto y lo pasa al agente automáticamente. ## Restricciones / Reglas - **Solo frontmatter:** el skill no modifica el contenido del `story-map.md` generado; solo prepende el bloque de frontmatter YAML. - **Contexto opcional:** si no se encuentran documentos del proyecto, el agente recopila el contexto interactivamente — la ausencia de documentos no es un error bloqueante. - **Frontmatter derivado dinámicamente:** `title` se extrae del primer `#` heading del documento; `date` es la fecha actual; `substatus` por defecto es `IN-PROGRESS`. - NO modifique ningún archivo existente en el código fuente (estamos en etapa de planeación y especificación, no de implementación) - NO genere código; estas especificando, no implementando los artefactos técnicos - **Encoding**: All generated `.md` files MUST be saved as **UTF-8 without BOM**. Do not use Latin-1, CP-1252, or any other encoding. If you see characters like `ó` or `📖`, that indicates an encoding error — fix it. ## Flujo de ejecución ### Paso 0 — Verificar entorno (`skill-preflight`) Invocar `skill-preflight` antes de cualquier operación con archivos. El preflight verifica `SDDF_ROOT`, resuelve `SPECS_BASE` (fallback: `docs`) y confirma los subdirectorios de specs estándar. Si retorna `✗ Entorno inválido`, detener la ejecución. Usar `$SPECS_BASE` (resuelto por `skill-preflight`) para todas las rutas en los pasos siguientes. ### Paso 0b — Resolver directorio del proyecto activo (`PROJ_DIR`) 1. Listar todos los subdirectorios de `$SPECS_BASE/specs/projects/`. 2. Para cada subdirectorio, leer `project-intent.md` y verificar si `substatus` es `DONE`. 3. Si se encuentra exactamente uno con `substatus: DONE` → usar ese directorio como `$PROJ_DIR`. 4. Si se encuentran varios → mostrar la lista y pedir al usuario que elija antes de continuar. 5. Si no se encuentra ninguno → proceder sin contexto de proyecto (el agente recopilará la información interactivamente). La ruta completa del proyecto activo es: `$SPECS_BASE/specs/projects/$PROJ_DIR/` ### Paso 1 — Leer documentos del proyecto Antes de invocar al agente, lee los siguientes archivos si existen: 1. `$SPECS_BASE/specs/projects/$PROJ_DIR/project-intent.md` 2. `$SPECS_BASE/specs/projects/$PROJ_DIR/project.md` Si existen, extrae y resume: - Nombre del proyecto - Problema que resuelve - Usuarios/personas identificadas - Funcionalidades clave Este resumen será el contexto inicial que se pasará al agente. ### Paso 2 — Invocar al agente project-story-mapper Delega la sesión completa al agente `project-story-mapper` con el siguiente briefing: > Inicia una sesión de User Story Mapping para el proyecto [nombre del proyecto si se conoce]. > [Si hay documentos disponibles]: He leído los documentos del proyecto. El contexto es: [resumen]. > [Si no hay documentos]: No hay documentos de proyecto disponibles aún; recopila el contexto interactivamente. > Produce el documento completo en `$SPECS_BASE/specs/projects/$PROJ_DIR/story-map.md`. El agente conduce toda la sesión de forma interactiva con el usuario y escribe el documento de salida. ### Paso 3 — Añadir frontmatter al documento generado Una vez que el agente `project-story-mapper` haya escrito `$SPECS_BASE/specs/projects/$PROJ_DIR/story-map.md`, antepón o completa si existe el siguiente bloque YAML al inicio del archivo (antes de cualquier otro contenido): ```yaml --- type: spec slug: title: "[primer # heading del documento generado]" date: [YYYY-MM-DD] status: BACKLOG substatus: IN‑PROGRESS parent: null related: - --- [[nombre-del-directorio-del-proyecto-project o slug de project-plan relacionado (si existe)]] ``` Reglas de derivación: - `title`: extrae el primer `#` heading del documento - `date`: fecha actual en formato YYYY-MM-DD - `substatus`: `IN‑PROGRESS` por defecto; `DONE` si el documento está completado ## Salida - `$SPECS_BASE/specs/projects/$PROJ_DIR/story-map.md` — mapa de historias con backbone, walking skeleton y release slices, generado por `project-story-mapper` con frontmatter YAML añadido.