trycore-spec-product-flow

Vertical agéntica de Trycore para producir, de forma consistente y de alta calidad, los artefactos de discovery / producto que cada proyecto de consultoría necesita:

PRD  →  User Story Map  →  Backlog  →  Historias de Usuario (con AC G/W/T)  →  Priorización  →  Flows (opcional, Mermaid por épica)

Todo se construye partiendo del prd.md hacia abajo, en Markdown versionado en git. El núcleo es agnóstico a herramientas externas — no requiere Jira, Linear, Confluence ni ninguna integración para operar.

Cómo se usa (rápido)

# 1) Instalar el CLI global (una vez por máquina)
npm install -g @trycore/spec-product-flow

# 2) Instalar la vertical en un proyecto cliente (idempotente; respeta .claude/ existente)
cd /ruta/al/proyecto-cliente
trycore-spec init

# 3) Abrir Claude Code y operar la vertical
/trycore:onboard            # parametriza el proyecto (1 vez)
/trycore:flujo              # PRD → Backlog priorizado, end-to-end
/trycore:revisar            # auditoría global on-demand

Comandos del CLI:

| Comando | Para qué | |---|---| | trycore-spec init [dir] | Instala (o actualiza) la vertical en el proyecto | | trycore-spec update [dir] | Refresca tras npm update -g @trycore/spec-product-flow | | trycore-spec status [dir] | Estado de instalación + documentos | | trycore-spec uninstall [dir] | Quita la vertical (preserva docs/) | | trycore-spec --version | Versión del paquete |

Slash commands /trycore:*

Cada paso del pipeline expone un slash command (estilo OpenSpec):

Operativos (high-level)

| Command | Propósito | |---|---| | /trycore:onboard | Parametriza un proyecto: nombre, dominio, stakeholders, framework de priorización | | /trycore:flujo | Ejecuta el pipeline completo PRD→Backlog con checkpoints | | /trycore:revisar | Audita todos los artefactos con los agentes revisores |

Por artefacto

| Command | Produce | |---|---| | /trycore:prd | Un PRD con los 12 componentes obligatorios | | /trycore:epicas | Descomposición del PRD en épicas trazadas a objetivos | | /trycore:mapa | User Story Map estilo Jeff Patton (backbone + ranking + releases) | | /trycore:historia | Una historia de usuario en formato "Como/Quiero/Para" | | /trycore:ac | Acceptance criteria en Given/When/Then (happy + error + edge) | | /trycore:invest | Validación INVEST sobre una historia | | /trycore:backlog | Backlog consolidado (tabla ordenada) | | /trycore:priorizar | Priorización con MoSCoW / RICE / Valor-Esfuerzo / Eisenhower | | /trycore:flows | Flujos de navegación en Mermaid, un archivo por épica (docs/06-flows/EP-*.md) |

Arquitectura

trycore-spec-product-flow/
├── METODOLOGIA.md          ← extracto ejecutable de la bibliografía (fuente de verdad)
├── GOVERNANCE.md           ← cadencia de auditoría del arnés cognitivo + roles
├── .claude-plugin/         ← manifesto plugin nativo (coexiste con la vía npm)
├── skills/                 ← 11 skills públicas + 1 interna (auditar-vertical)
├── agents/                 ← 8 agentes revisores (segunda opinión, contexto limpio)
├── commands/trycore/       ← slash commands /trycore:*
├── hooks/                  ← quality gates opt-in (PostToolUse/SessionStart/Stop, incluyendo reflect-session)
├── scripts/                ← install, uninstall, lint, check-agnostic, reflect-session
└── templates/              ← plantillas neutras (CLAUDE.md raíz + CLAUDE.md scoped por subdir de docs/, .claudeignore, artefactos)

Patrón: las skills guían la escritura, los agentes auditan en contexto limpio, los hooks automatizan los quality gates, y los CLAUDE.md scoped activan reglas locales solo cuando se edita en el subdirectorio correspondiente (progressive disclosure).

Documentación

| Doc | Para qué | |---|---| | docs/getting-started.md | Tu primer pipeline end-to-end en 10 minutos. Empieza aquí. | | docs/installation.md | Instalación detallada, flags, manejo de proyectos con .claude/ propio | | docs/concepts.md | Mapa mental: PRD, INVEST, G/W/T, taxonomía Agile, Story Mapping | | docs/commands.md | Referencia de los 11 slash commands /trycore:* | | docs/skills.md | Las 11 skills públicas (la skill interna auditar-vertical no se distribuye) | | docs/agents.md | Los 8 agentes revisores | | docs/hooks.md | Hooks opt-in (TRYCORE_AUTO_AUDIT, TRYCORE_REFLECT_SESSION) | | docs/workflows.md | Patrones de uso: greenfield, PRD vivo, refinamiento, triage, entrega | | docs/quality-gates.md | Cómo funciona la garantía de calidad | | docs/customization.md | Extender la vertical (skills/agentes/frameworks/plantillas) | | docs/customization/mcp-extensions.md | Conectar Jira/Linear/Confluence/Slack vía MCP (opt-in, agnóstico) | | docs/troubleshooting.md | Problemas comunes y resolución | | METODOLOGIA.md | Fuente de verdad metodológica (12 componentes PRD, INVEST detallado, frameworks de priorización con fórmulas) | | GOVERNANCE.md | Gobernanza del paquete (solo para mantainers): roles, cadencia de auditoría, poda |

Agnóstico al proyecto

Ninguna skill / agent / template menciona dominios de cliente. Toda parametrización viene de:

1. <proyecto>/CLAUDE.md (bloque marcado <!-- BEGIN trycore-vertical -->)
2. Auto-memory (tipo project) que /trycore:onboard puebla
3. Preguntas en runtime vía AskUserQuestion

Pre-commit: scripts/check-agnostic.sh valida contra scripts/denylist.txt.

Roadmap

• ✅ v0.1.0 — repo clonable con bash installer + 10 skills + 7 agentes + 11 slash commands.
• ✅ v0.2.0 — paquete npm público con CLI trycore-spec (init / update / status / uninstall). Modelo OpenSpec.
• ✅ v0.3.0 — artefacto flows (flujos de navegación en Mermaid, un archivo por épica) con su skill mapear-flujos-navegacion, agent flows-auditor y slash command /trycore:flows. Carpeta docs/06-flows/ integrada al pipeline como paso 7 opcional.
• ✅ v0.4.0 (actual) — capa cognitiva del arnés, aplicando la guía maestra del auditor externo: CLAUDE.md scoped por subdirectorio de docs/ (progressive disclosure), path-scoping de skills, .claudeignore versionado idempotente, stop hook reflexivo (TRYCORE_REFLECT_SESSION), plugin nativo (.claude-plugin/plugin.json coexistiendo con npm), GOVERNANCE.md con cadencia de auditoría, skill interna auditar-vertical para poda, y guía MCP opt-in para el consumidor.
• 🔜 v0.5.0 — soporte multi-IDE (auto-detecta Claude Code / Cursor / Codex CLI / Gemini CLI y genera la configuración adecuada).
• 🔜 v0.6.0 — SessionStart dinámico sensible a la fase activa del pipeline (carga contexto distinto si el proyecto está en fase de PRD vs en fase de backlog).

Ver CHANGELOG.md para el historial detallado.

Licencia

Uso interno de Trycore.