Stack, Ciclo de Desarrollo, Infraestructura y Gobernanza (Streams E–H)
Los Streams E a H cubren el ecosistema de desarrollo más amplio — decisiones de stack, generación de agentes, tooling, integración Git, orquestación multi-agente y gobernanza.
Stream E — Stack y Agentes
suggest_stack
Sugiere un stack tecnológico basado en los requisitos del proyecto.
Cuándo usarlo: Al inicio del proyecto cuando el equipo está eligiendo entre tecnologías competidoras, o al validar una elección de stack contra las restricciones del proyecto.
Prompt: "Suggest a stack for a real-time collaborative document editor for project proj_abc123"check_versions
Verifica versiones de dependencias en busca de actualizaciones, deprecaciones y problemas de seguridad.
Qué verifica:
- Versiones actuales vs. últimas estables
- CVEs conocidos y avisos de seguridad
- Paquetes deprecados
- Advertencias de breaking changes para saltos de versiones major
Prompt: "Check dependency versions for project proj_abc123"generate_skill
Genera un archivo de skill de agente para una plataforma de agente de IA específica.
Plataformas soportadas: Claude Code (skills de CLAUDE.md), Cursor (fragmentos de .cursorrules), Windsurf, instrucciones de Copilot, definiciones de agentes personalizados.
Prompt: "Generate a Claude Code skill for the authentication workflow in project proj_abc123"detect_agent
Detecta la plataforma de agente de IA en uso en la ruta del proyecto.
Cuándo usarlo: Cuando necesitas generar artefactos específicos del agente (archivos de reglas, skills, archivos de memoria) y quieres que SpecForge auto-seleccione el formato correcto.
Prompt: "Detect what AI agent is configured at /Users/me/my-app"generate_sub_agent
Genera una definición de sub-agente para orquestación multi-agente.
Qué produce: Una definición de agente estructurada con capacidades, propiedad de recursos, protocolo de handoff y contrato de comunicación — lista para usar con orchestrate_agents.
Prompt: "Generate a sub-agent for the database migration task in spec SPEC-011 for project proj_abc123"generate_rules
Genera archivos de reglas de agente — .cursorrules, CLAUDE.md, instrucciones de Copilot, reglas de Windsurf — a partir de la Constitución del proyecto y los patrones detectados.
Prompt: "Generate a CLAUDE.md for project proj_abc123"
Prompt: "Generate .cursorrules for project proj_abc123"Stream F — Ciclo de Desarrollo
suggest_tooling
Evalúa y sugiere tooling del ciclo de desarrollo en todo el stack.
Cobertura:
- CI/CD (GitHub Actions, GitLab CI, CircleCI, etc.)
- Testing (unitario, integración, E2E, visual regression)
- Monitoreo y observabilidad (OpenTelemetry, Datadog, Grafana)
- Tooling AI-native (observabilidad LLM, caché semántico, gestión de prompts, guardrails)
- Tooling de performance frontend (Lighthouse CI, visual regression, librerías de componentes)
Prompt: "Suggest tooling for project proj_abc123"generate_tests
Genera un plan de tests y stubs de archivos de test a partir de los criterios de aceptación de una spec.
Qué produce:
- Plan de tests con nombres de casos mapeados a criterios de aceptación
- Stubs de archivos de test en el framework de testing del proyecto (vitest, pytest, go test, JUnit, etc.)
- Targets de cobertura por criterio
- Estrategia de mocking para dependencias externas
Prompt: "Generate tests for spec SPEC-003 in project proj_abc123"generate_docs
Genera documentación a partir de specs y código — docs de API, secciones de README, resúmenes de arquitectura.
Prompt: "Generate API documentation for spec SPEC-007 in project proj_abc123"
Prompt: "Generate a README section for the authentication module from spec SPEC-001"integrate_pm
Integra con herramientas de gestión de proyectos — crea issues, épicas o tareas a partir de specs.
Soportado: Jira, Linear, GitHub Issues, GitLab Issues, Trello, Notion.
Prompt: "Create a GitHub issue for spec SPEC-004 in project proj_abc123"
Prompt: "Create a Linear task for spec SPEC-009 in project proj_abc123"Stream G — Infraestructura
manage_context
Guarda, carga y gestiona notas de contexto persistentes entre sesiones.
Cuándo usarlo: Cuando necesitas preservar decisiones arquitectónicas importantes, restricciones externas o acuerdos del equipo que no están capturados en specs.
Prompt: "Save context: we decided to use Postgres 16 with pgvector for all AI features in project proj_abc123"
Prompt: "What context have we saved for project proj_abc123?"manage_git
Integración Git — crea ramas, genera descripciones de PR, changelogs y hooks vinculados a specs.
Prompt: "Create a branch for spec SPEC-005 in project proj_abc123"
Prompt: "Generate a PR description for spec SPEC-005 in project proj_abc123"
Prompt: "Generate a changelog from specs SPEC-001 through SPEC-010 for project proj_abc123"orchestrate
Orquestación multi-agente — registra agentes, bloquea recursos, distribuye tareas y coordina ejecución paralela.
Prompt: "Register an agent for spec SPEC-011 and lock the auth module in project proj_abc123"consult_docs
Consulta documentación de frameworks para un tema específico — obtiene y resume docs relevantes sin salir de tu conversación.
Prompt: "Consult React docs about concurrent rendering for project proj_abc123"
Prompt: "What does the FastAPI docs say about dependency injection?"discover_mcps
Descubre los servidores MCP configurados en el entorno actual.
Prompt: "What MCP servers are available in my environment?"suggest_mcps
Sugiere servidores MCP que beneficiarían al proyecto basándose en su stack y patrones detectados.
Prompt: "Suggest MCP servers for project proj_abc123"migrate_tech
Guía la migración del stack tecnológico — analiza el codebase fuente, mapea equivalencias, genera el plan de migración, valida la paridad funcional y planea la migración de BD.
Cuándo usarlo: Al mover de un framework a otro (Express → Fastify, Django → FastAPI, Create React App → Vite), al actualizar una dependencia major, o al migrar bases de datos.
Prompt: "Plan a migration from Express to Fastify for project proj_abc123"
Prompt: "Migrate from class-based to functional React components in project proj_abc123"orchestrate_agents
Declara capacidades de agentes, enruta tareas al mejor agente, genera contextos de handoff estructurados y detecta conflictos de propiedad de archivos antes de la ejecución paralela.
Prompt: "Orchestrate agents for specs SPEC-012, SPEC-013, SPEC-014 in project proj_abc123"validate_workflow
Valida convenciones del workflow del desarrollador — selección de modelo de IA, cumplimiento de Git Flow, convenciones de herramientas MCP, o auditoría completa del workflow.
Prompt: "Validate my workflow for project proj_abc123"
Prompt: "Check Git Flow compliance for project proj_abc123"log_decision
Registra, lista, busca o reemplaza decisiones arquitectónicas y de proceso para un proyecto.
Cuándo usarlo: Alternativa ligera a los ADRs completos para decisiones de proceso, elecciones de herramientas o acuerdos del equipo.
Prompt: "Log decision: we will use pnpm as the package manager for all new projects"
Prompt: "List all decisions for project proj_abc123"facilitate
Punto de entrada para usuarios no familiarizados con SpecForge — los guía a través del workflow SDD de forma interactiva.
Cuándo usarlo: Al incorporar a un nuevo miembro del equipo o cuando alguien usa SpecForge por primera vez.
Prompt: "Facilitate a SpecForge session for my project at /Users/me/my-app"request_context
Genera un prompt que le pide al usuario documentación de referencia (README, PRD, docs de arquitectura) para enriquecer la base de conocimiento del proyecto.
Prompt: "Request context for project proj_abc123"contribute_context
Persiste conocimiento estructurado extraído de documentos proporcionados por el usuario en la base de conocimiento del proyecto.
Prompt: "Contribute the attached PRD document to project proj_abc123"Stream H — Gobernanza y Salud del Stack
data_governance
Detecta PII en specs, genera políticas de retención, redacta avisos de privacidad y audita cumplimiento GDPR/CCPA/LGPD.
Cuándo usarlo: Antes de cualquier spec que maneje datos de usuario — flujos de registro, gestión de perfiles, analytics o exportación de datos.
Prompt: "Run a data governance check on spec SPEC-006 for project proj_abc123"
Prompt: "Generate a GDPR compliance audit for project proj_abc123"audit_stack
Audita todas las dependencias del proyecto — las clasifica como up_to_date, outdated, vulnerable o unmaintained. Genera un StackHealthScore (0–100).
Cuándo usarlo: Periódicamente (mensualmente o antes de cada release) para mantener el grafo de dependencias saludable.
Prompt: "Audit the stack for project proj_abc123"plan_upgrade
Genera un plan de migración para actualizar un paquete específico — breaking changes, esfuerzo estimado y procedimiento de rollback.
Prompt: "Plan the upgrade from React 18 to React 19 for project proj_abc123"
Prompt: "Plan upgrading Zod from v3 to v4 in project proj_abc123"detect_deprecations
Escanea los archivos fuente del proyecto en busca de patrones de API deprecados (sin red requerida) y retorna un reporte de deprecaciones con estimación de deuda técnica.
Cuándo usarlo: Antes de una actualización de versión major, o como parte de una revisión trimestral de deuda técnica.
Prompt: "Detect deprecated APIs in project proj_abc123"check_config_health
Analiza archivos de configuración del proyecto para detectar errores, campos faltantes y violaciones de buenas prácticas en todos los ecosistemas.
Cuándo usarlo: Después del setup del proyecto, durante onboarding, o cuando los builds fallan por razones de configuración.
Prompt: "Check config health for project proj_abc123"