Prompt file imported from agarrido2/sddqwik (.github/prompts/new-feature.prompt.md). Fill in {{featureName}}, {{FEATURE}}, {{SPEC_STATUS}} before use. Copyright stays with the author.

🚀 FEATURE KICKOFF — `{{featureName}}`

Name: new-feature
Author: agarrido2

Propósito

/new-feature es la puerta de entrada al ciclo de ejecución de una Spec ya aprobada.

No crea la Spec. No implementa código. No sustituye al Orchestrator. No salta gates SDD.

Su única responsabilidad es preparar una entrada segura para el flujo:

INDEX → Spec Approved → Plan técnico → Implementation Tasks → DBA si aplica → Builder → Auditor → Polisher → Memory

PRD y Blueprint no forman parte del flujo operativo principal ni son gates para /new-feature.

Si la feature no está lista para construcción, /new-feature debe detenerse y explicar el siguiente paso correcto.

Regla operativa crítica

Antes de invocar a @QwikOrchestrator, este prompt debe verificar:

existe docs/sessions/INDEX.md como primera fuente operativa;
existe docs/specs/{{featureName}}.md;
la Spec está en estado 🟢 Approved o Approved;
no hay dependencias bloqueantes declaradas en el INDEX;
existe o se puede crear docs/plans/{{featureName}}.md sin sobrescribir trabajo previo;
si no hay Plan técnico, el routing debe ir a @QwikArchitect;
si el Plan no tiene Implementation Tasks, el routing debe ir a @QwikArchitect;
si hay datos/RLS pendientes, el routing debe ir a @QwikDBA;
@QwikBuilder solo puede entrar con Spec Approved, Plan técnico, Implementation Tasks y DBA resuelto o N/A.

Si falla INDEX, Spec Approved o dependencias bloqueantes, detener el flujo. Si falta Plan técnico, faltan Implementation Tasks o DBA/RLS está pendiente, registrar el estado y enrutar al agente correcto.

Prohibiciones

Durante /new-feature, no hacer:

escribir código en src/;
modificar schema, migraciones o RLS;
crear una Spec nueva;
aprobar una Spec por cuenta propia;
leer todas las specs;
leer todos los plans;
cargar sesiones archivadas;
explorar masivamente el repositorio;
sobrescribir un Plan File existente sin revisar su estado.

Paso 0 — Normalizar entrada

Usar {{featureName}} como identificador canónico de la feature.

Si el nombre está vacío, es ambiguo o contiene espacios no intencionales, detener:

NEW-FEATURE GATE BLOQUEADO: falta un nombre de feature válido.
Usa: /new-feature [feature-name]

Paso 1 — Verificar INDEX operativo

docs/sessions/INDEX.md es la primera fuente de verdad operativa para routing, dependencias y carga selectiva.

FEATURE="{{featureName}}"
INDEX_FILE="docs/sessions/INDEX.md"

if [ ! -f "$INDEX_FILE" ]; then
  echo "NEW-FEATURE GATE BLOQUEADO: falta docs/sessions/INDEX.md"
  echo "Siguiente paso: ejecutar /setup para inicializar memoria operativa."
  exit 1
fi

echo "INDEX operativo: $INDEX_FILE"

Regla

No sustituir el INDEX leyendo specs y plans a ciegas. Si el INDEX falta, el siguiente paso correcto es /setup.

Paso 2 — Verificar Spec aprobada

Ejecutar una comprobación acotada sobre la Spec esperada. Este es el primer gate de construcción.

SPEC_FILE="docs/specs/{{FEATURE}}.md"

if [ ! -f "$SPEC_FILE" ]; then
  echo "NEW-FEATURE GATE BLOQUEADO: no existe $SPEC_FILE"
  echo "Siguiente paso: ejecutar /spec {{FEATURE}}"
  exit 1
fi

SPEC_STATUS=$(grep -E '^>?[[:space:]]*Estado:|^>?[[:space:]]*Status:' "$SPEC_FILE" | head -1 || true)

echo "Spec: $SPEC_FILE"
echo "Estado detectado: {{SPEC_STATUS}}"

if ! echo "$SPEC_STATUS" | grep -Eiq '(🟢[[:space:]]*)?Approved|Aprobada|Aprobado'; then
  echo "NEW-FEATURE GATE BLOQUEADO: la Spec existe pero no está Approved."
  echo "Siguiente paso: volver a @QwikSpeccer con /spec {{FEATURE}} o aprobar explícitamente la Spec antes de construir."
  exit 1
fi

Regla

No continuar si la Spec no está aprobada.

Una Spec en Draft, Review, Pending, Blocked o sin estado explícito no habilita construcción.

Paso 3 — Consultar contexto mínimo en INDEX

Consultar únicamente las entradas relevantes para {{featureName}}.

echo "Entradas relacionadas en INDEX:"
grep -Ei "(^\|[[:space:]]*{{FEATURE}}[[:space:]]*\|)|{{FEATURE}}" "$INDEX_FILE" || true

Revisar si la entrada o entradas relacionadas declaran:

dependencias en columna Depende de;
tablas DB que conviene reutilizar;
servicios o APIs en columna Expone;
estado previo WIP, BLOCKED, FAILED, DONE o PRODUCTION-READY.

Regla

No cargar artefactos adicionales todavía. El INDEX filtra; los artefactos amplían solo si el Orchestrator lo decide.

Paso 4 — Comprobar dependencias bloqueantes

Si el INDEX declara dependencias para esta feature, verificar que no aparecen como WIP, FAILED, BLOCKED o sin estado claro.

Esta comprobación puede requerir lectura humana del resultado del grep anterior. El prompt debe documentar el resultado en el Plan File.

Si hay dependencia bloqueante, detener:

NEW-FEATURE GATE BLOQUEADO: existen dependencias no completadas.
Completa primero los módulos bloqueantes indicados en docs/sessions/INDEX.md.

Si no hay dependencias bloqueantes, continuar.

Paso 5 — Crear o preservar Plan File

El Plan File es el artefacto de coordinación del ciclo. /new-feature puede crear un contenedor operativo inicial, pero no crea el Plan técnico ni las Implementation Tasks; eso corresponde a @QwikArchitect.

Ruta esperada:

docs/plans/{{featureName}}.md

Crear docs/plans/ si no existe.

PLAN_FILE="docs/plans/{{FEATURE}}.md"
mkdir -p docs/plans

Si el Plan File no existe

Crear un Plan File inicial mínimo:

if [ ! -f "$PLAN_FILE" ]; then
  cat > "$PLAN_FILE" <<EOF
# Plan: {{FEATURE}}

> Estado: 🟡 Planning
> Spec: docs/specs/{{FEATURE}}.md
> Fecha: $(date +%F)
> Agente inicial: /new-feature

## 1. Pre-flight Gate Report

| Gate | Estado | Evidencia | Acción |
|---|---|---|---|
| Spec existe | ✅ PASS | docs/specs/{{FEATURE}}.md | N/A |
| Spec Approved | ✅ PASS | {{SPEC_STATUS}} | N/A |
| INDEX existe | ✅ PASS | docs/sessions/INDEX.md | N/A |
| Dependencias | ⚠️ REVIEWED | Revisar entrada INDEX relacionada | Documentar en fase Architect |
| Plan File | ✅ CREATED | docs/plans/{{FEATURE}}.md | N/A |
| Plan técnico | ⏳ PENDING | Pendiente de @QwikArchitect | Enrutar a @QwikArchitect |
| Implementation Tasks | ⏳ PENDING | Pendiente de @QwikArchitect | Enrutar a @QwikArchitect |
| Datos/RLS | ⏳ REVIEW | Pendiente de clasificación | Enrutar a @QwikDBA si aplica |

## 2. Contexto mínimo inicial

- Spec: docs/specs/{{FEATURE}}.md
- INDEX: docs/sessions/INDEX.md
- Plan: docs/plans/{{FEATURE}}.md

## 3. Dependencias detectadas desde INDEX

Pendiente de completar por @QwikOrchestrator tras lectura selectiva del INDEX.

## 4. Riesgos iniciales

Pendiente de completar por @QwikArchitect.

## 5. Handoff Log

### $(date +%F) — /new-feature → @QwikOrchestrator
- Contexto: docs/specs/{{FEATURE}}.md, docs/sessions/INDEX.md, docs/plans/{{FEATURE}}.md
- Tarea: iniciar routing controlado para construcción de feature con Spec aprobada.
- Scope: preparar handoff hacia @QwikArchitect.
- No tocar: código de aplicación, schema, migraciones, RLS o UI antes del Plan técnico y las Implementation Tasks.
- Condición de salida: routing decision registrado y handoff a @QwikArchitect si procede.
- Riesgos conocidos: validar dependencias y datos/RLS desde INDEX y Spec.

## 6. Routing Decision

Pendiente de @QwikOrchestrator.

## 7. Technical Plan

Pendiente de @QwikArchitect.

## 8. DBA Notes

Pendiente si aplica.

## 9. Implementation Tasks

Pendiente de @QwikArchitect.

## 10. DBA Gate

Estado: N/A / READY_FOR_DBA / RESOLVED / BLOCKED

Pendiente de clasificación por @QwikArchitect o @QwikDBA.

## 11. Builder Delivery Summary

Pendiente de @QwikBuilder.

## 12. Audit Cycles

Pendiente de @QwikAuditor.

## 13. Polish Notes

Pendiente de @QwikPolisher.

## 14. Memory Notes

Pendiente de @QwikMemory.

## 15. Final Status

Pendiente.
EOF
  echo "CREADO $PLAN_FILE"
fi

Si el Plan File ya existe

No sobrescribirlo.

if [ -f "$PLAN_FILE" ]; then
  echo "Plan File existente: $PLAN_FILE"
  grep -E '^> Estado:|^> Status:' "$PLAN_FILE" | head -1 || true
fi

Si existe y está en estado ✅ Done, PRODUCTION-READY o cerrado, detener salvo instrucción explícita del usuario:

NEW-FEATURE GATE BLOQUEADO: ya existe un Plan File cerrado para esta feature.
Usa /bug-fix, /optimizer-code o una nueva Spec si necesitas cambiar comportamiento.

Si existe y está en Planning, WIP o similar, continuar como reentrada controlada. Añadir un nuevo handoff log, no borrar contenido anterior.

Paso 6 — Verificar Plan técnico, Implementation Tasks y DBA/RLS

Antes de invocar al Orchestrator, confirmar que el Plan File contiene las secciones mínimas para enrutar correctamente. Esta verificación no habilita Builder por sí sola; solo determina el siguiente handoff correcto.

missing_plan_sections=0

for section in "Pre-flight Gate Report" "Handoff Log" "Routing Decision" "Technical Plan" "Implementation Tasks" "DBA Gate" "Builder Delivery Summary" "Audit Cycles" "Polish Notes" "Memory Notes"; do
  if grep -q "$section" "$PLAN_FILE"; then
    echo "OK sección Plan: $section"
  else
    echo "FALTA sección Plan: $section"
    missing_plan_sections=$((missing_plan_sections + 1))
  fi
done

if [ "$missing_plan_sections" -gt 0 ]; then
  echo "NEW-FEATURE GATE ADVERTENCIA: el Plan File existe pero le faltan secciones operativas."
  echo "@QwikOrchestrator debe normalizarlo antes de handoff a @QwikArchitect."
fi

Routing según estado del Plan

Si no existe Plan técnico → @QwikArchitect.
Si el Plan técnico está vacío, pendiente o incompleto → @QwikArchitect.
Si no existen Implementation Tasks → @QwikArchitect.
Si las Implementation Tasks están vacías, pendientes o no son ejecutables → @QwikArchitect.
Si datos/RLS está en READY_FOR_DBA, pendiente DBA o BLOCKED → @QwikDBA.
Si datos/RLS es RESOLVED o N/A, y existen Spec Approved + Plan técnico + Implementation Tasks → @QwikBuilder.

@QwikBuilder solo puede entrar si todos estos gates están satisfechos:

Spec Approved
Plan técnico existe
Implementation Tasks existen
DBA/RLS resuelto o N/A

Paso 7 — Invocar a @QwikOrchestrator

Solo después de superar los gates anteriores, invocar a @QwikOrchestrator.

Mensaje de handoff:

@QwikOrchestrator

Inicia el ciclo de construcción para la feature `{{featureName}}`.

Contexto mínimo permitido:
- Spec aprobada: docs/specs/{{featureName}}.md
- INDEX operativo: docs/sessions/INDEX.md
- Plan File: docs/plans/{{featureName}}.md

Tarea:
1. Leer primero docs/sessions/INDEX.md.
2. Leer la Spec aprobada.
3. Leer el Plan File creado o existente.
4. Confirmar si hay dependencias, datos/RLS o servicios relacionados en INDEX.
5. Registrar Routing Decision en el Plan File.
6. Enrutar hacia @QwikArchitect si el Plan técnico aún no existe.
7. Enrutar hacia @QwikArchitect si faltan Implementation Tasks ejecutables.
8. Enrutar hacia @QwikDBA si datos/RLS está pendiente, READY_FOR_DBA o BLOCKED.
9. Enrutar hacia @QwikBuilder solo si existe Spec Approved, Plan técnico, Implementation Tasks y DBA/RLS resuelto o N/A.

Restricciones:
- No escribir código.
- No modificar schema.
- No leer specs o plans no relacionados salvo dependencia confirmada en INDEX.
- No saltar a Builder.
- No ampliar scope funcional fuera de la Spec aprobada.

Builder gate obligatorio:

```text
Spec Approved + Plan técnico + Implementation Tasks + DBA/RLS resuelto o N/A

Flujo esperado: @QwikArchitect → @QwikDBA si aplica → @QwikBuilder → @QwikAuditor → @QwikPolisher → @QwikMemory


---

## Salida esperada

```text
NEW-FEATURE PREFLIGHT — {{featureName}}

INDEX: PASS / FAIL
Spec: PASS / FAIL
Spec status: Approved / no aprobado / no encontrado
Dependencias: OK / BLOQUEADAS / REVIEW REQUIRED
Plan File: CREATED / EXISTS / BLOCKED
Plan sections: OK / NEEDS NORMALIZATION
Plan técnico: EXISTS / MISSING / PENDING
Implementation Tasks: EXISTS / MISSING / PENDING
DBA/RLS: N/A / RESOLVED / READY_FOR_DBA / BLOCKED
Builder gate: READY / BLOCKED
Estado: READY FOR ORCHESTRATOR / READY FOR ARCHITECT / READY FOR DBA / READY FOR BUILDER / BLOCKED

Siguiente paso:
- @QwikOrchestrator
- @QwikArchitect
- @QwikDBA
- @QwikBuilder
- /spec {{featureName}}
- /setup
- resolver dependencias bloqueantes

Regla final

/new-feature no significa “programa esto”.

/new-feature significa:

Esta feature ya tiene Spec aprobada.
Prepara una entrada segura al ciclo de construcción.

Si el sistema no puede demostrar eso, debe detenerse.

# 🚀 FEATURE KICKOFF — `{{featureName}}` ## Propósito `/new-feature` es la puerta de entrada al ciclo de ejecución de una Spec ya aprobada. No crea la Spec. No implementa código. No sustituye al Orchestrator. No salta gates SDD. Su única responsabilidad es preparar una entrada segura para el flujo: ```text INDEX → Spec Approved → Plan técnico → Implementation Tasks → DBA si aplica → Builder → Auditor → Polisher → Memory ``` PRD y Blueprint no forman parte del flujo operativo principal ni son gates para `/new-feature`. Si la feature no está lista para construcción, `/new-feature` debe detenerse y explicar el siguiente paso correcto. --- ## Regla operativa crítica Antes de invocar a `@QwikOrchestrator`, este prompt debe verificar: 1. existe `docs/sessions/INDEX.md` como primera fuente operativa; 2. existe `docs/specs/{{featureName}}.md`; 3. la Spec está en estado `🟢 Approved` o `Approved`; 4. no hay dependencias bloqueantes declaradas en el INDEX; 5. existe o se puede crear `docs/plans/{{featureName}}.md` sin sobrescribir trabajo previo; 6. si no hay Plan técnico, el routing debe ir a `@QwikArchitect`; 7. si el Plan no tiene `Implementation Tasks`, el routing debe ir a `@QwikArchitect`; 8. si hay datos/RLS pendientes, el routing debe ir a `@QwikDBA`; 9. `@QwikBuilder` solo puede entrar con Spec Approved, Plan técnico, Implementation Tasks y DBA resuelto o N/A. Si falla INDEX, Spec Approved o dependencias bloqueantes, detener el flujo. Si falta Plan técnico, faltan Implementation Tasks o DBA/RLS está pendiente, registrar el estado y enrutar al agente correcto. --- ## Prohibiciones Durante `/new-feature`, no hacer: - escribir código en `src/`; - modificar schema, migraciones o RLS; - crear una Spec nueva; - aprobar una Spec por cuenta propia; - leer todas las specs; - leer todos los plans; - cargar sesiones archivadas; - explorar masivamente el repositorio; - sobrescribir un Plan File existente sin revisar su estado. --- ## Paso 0 — Normalizar entrada Usar `{{featureName}}` como identificador canónico de la feature. Si el nombre está vacío, es ambiguo o contiene espacios no intencionales, detener: ```text NEW-FEATURE GATE BLOQUEADO: falta un nombre de feature válido. Usa: /new-feature [feature-name] ``` --- ## Paso 1 — Verificar INDEX operativo `docs/sessions/INDEX.md` es la primera fuente de verdad operativa para routing, dependencias y carga selectiva. ```bash FEATURE="{{featureName}}" INDEX_FILE="docs/sessions/INDEX.md" if [ ! -f "$INDEX_FILE" ]; then echo "NEW-FEATURE GATE BLOQUEADO: falta docs/sessions/INDEX.md" echo "Siguiente paso: ejecutar /setup para inicializar memoria operativa." exit 1 fi echo "INDEX operativo: $INDEX_FILE" ``` ### Regla No sustituir el INDEX leyendo specs y plans a ciegas. Si el INDEX falta, el siguiente paso correcto es `/setup`. --- ## Paso 2 — Verificar Spec aprobada Ejecutar una comprobación acotada sobre la Spec esperada. Este es el primer gate de construcción. ```bash SPEC_FILE="docs/specs/{{FEATURE}}.md" if [ ! -f "$SPEC_FILE" ]; then echo "NEW-FEATURE GATE BLOQUEADO: no existe $SPEC_FILE" echo "Siguiente paso: ejecutar /spec {{FEATURE}}" exit 1 fi SPEC_STATUS=$(grep -E '^>?[[:space:]]*Estado:|^>?[[:space:]]*Status:' "$SPEC_FILE" | head -1 || true) echo "Spec: $SPEC_FILE" echo "Estado detectado: {{SPEC_STATUS}}" if ! echo "$SPEC_STATUS" | grep -Eiq '(🟢[[:space:]]*)?Approved|Aprobada|Aprobado'; then echo "NEW-FEATURE GATE BLOQUEADO: la Spec existe pero no está Approved." echo "Siguiente paso: volver a @QwikSpeccer con /spec {{FEATURE}} o aprobar explícitamente la Spec antes de construir." exit 1 fi ``` ### Regla No continuar si la Spec no está aprobada. Una Spec en `Draft`, `Review`, `Pending`, `Blocked` o sin estado explícito no habilita construcción. --- ## Paso 3 — Consultar contexto mínimo en INDEX Consultar únicamente las entradas relevantes para `{{featureName}}`. ```bash echo "Entradas relacionadas en INDEX:" grep -Ei "(^\|[[:space:]]*{{FEATURE}}[[:space:]]*\|)|{{FEATURE}}" "$INDEX_FILE" || true ``` Revisar si la entrada o entradas relacionadas declaran: - dependencias en columna `Depende de`; - tablas DB que conviene reutilizar; - servicios o APIs en columna `Expone`; - estado previo `WIP`, `BLOCKED`, `FAILED`, `DONE` o `PRODUCTION-READY`. ### Regla No cargar artefactos adicionales todavía. El INDEX filtra; los artefactos amplían solo si el Orchestrator lo decide. --- ## Paso 4 — Comprobar dependencias bloqueantes Si el INDEX declara dependencias para esta feature, verificar que no aparecen como `WIP`, `FAILED`, `BLOCKED` o sin estado claro. Esta comprobación puede requerir lectura humana del resultado del grep anterior. El prompt debe documentar el resultado en el Plan File. Si hay dependencia bloqueante, detener: ```text NEW-FEATURE GATE BLOQUEADO: existen dependencias no completadas. Completa primero los módulos bloqueantes indicados en docs/sessions/INDEX.md. ``` Si no hay dependencias bloqueantes, continuar. --- ## Paso 5 — Crear o preservar Plan File El Plan File es el artefacto de coordinación del ciclo. `/new-feature` puede crear un contenedor operativo inicial, pero no crea el Plan técnico ni las Implementation Tasks; eso corresponde a `@QwikArchitect`. Ruta esperada: ```text docs/plans/{{featureName}}.md ``` Crear `docs/plans/` si no existe. ```bash PLAN_FILE="docs/plans/{{FEATURE}}.md" mkdir -p docs/plans ``` ### Si el Plan File no existe Crear un Plan File inicial mínimo: ```bash if [ ! -f "$PLAN_FILE" ]; then cat > "$PLAN_FILE" <<EOF # Plan: {{FEATURE}} > Estado: 🟡 Planning > Spec: docs/specs/{{FEATURE}}.md > Fecha: $(date +%F) > Agente inicial: /new-feature ## 1. Pre-flight Gate Report | Gate | Estado | Evidencia | Acción | |---|---|---|---| | Spec existe | ✅ PASS | docs/specs/{{FEATURE}}.md | N/A | | Spec Approved | ✅ PASS | {{SPEC_STATUS}} | N/A | | INDEX existe | ✅ PASS | docs/sessions/INDEX.md | N/A | | Dependencias | ⚠️ REVIEWED | Revisar entrada INDEX relacionada | Documentar en fase Architect | | Plan File | ✅ CREATED | docs/plans/{{FEATURE}}.md | N/A | | Plan técnico | ⏳ PENDING | Pendiente de @QwikArchitect | Enrutar a @QwikArchitect | | Implementation Tasks | ⏳ PENDING | Pendiente de @QwikArchitect | Enrutar a @QwikArchitect | | Datos/RLS | ⏳ REVIEW | Pendiente de clasificación | Enrutar a @QwikDBA si aplica | ## 2. Contexto mínimo inicial - Spec: docs/specs/{{FEATURE}}.md - INDEX: docs/sessions/INDEX.md - Plan: docs/plans/{{FEATURE}}.md ## 3. Dependencias detectadas desde INDEX Pendiente de completar por @QwikOrchestrator tras lectura selectiva del INDEX. ## 4. Riesgos iniciales Pendiente de completar por @QwikArchitect. ## 5. Handoff Log ### $(date +%F) — /new-feature → @QwikOrchestrator - Contexto: docs/specs/{{FEATURE}}.md, docs/sessions/INDEX.md, docs/plans/{{FEATURE}}.md - Tarea: iniciar routing controlado para construcción de feature con Spec aprobada. - Scope: preparar handoff hacia @QwikArchitect. - No tocar: código de aplicación, schema, migraciones, RLS o UI antes del Plan técnico y las Implementation Tasks. - Condición de salida: routing decision registrado y handoff a @QwikArchitect si procede. - Riesgos conocidos: validar dependencias y datos/RLS desde INDEX y Spec. ## 6. Routing Decision Pendiente de @QwikOrchestrator. ## 7. Technical Plan Pendiente de @QwikArchitect. ## 8. DBA Notes Pendiente si aplica. ## 9. Implementation Tasks Pendiente de @QwikArchitect. ## 10. DBA Gate Estado: N/A / READY_FOR_DBA / RESOLVED / BLOCKED Pendiente de clasificación por @QwikArchitect o @QwikDBA. ## 11. Builder Delivery Summary Pendiente de @QwikBuilder. ## 12. Audit Cycles Pendiente de @QwikAuditor. ## 13. Polish Notes Pendiente de @QwikPolisher. ## 14. Memory Notes Pendiente de @QwikMemory. ## 15. Final Status Pendiente. EOF echo "CREADO $PLAN_FILE" fi ``` ### Si el Plan File ya existe No sobrescribirlo. ```bash if [ -f "$PLAN_FILE" ]; then echo "Plan File existente: $PLAN_FILE" grep -E '^> Estado:|^> Status:' "$PLAN_FILE" | head -1 || true fi ``` Si existe y está en estado `✅ Done`, `PRODUCTION-READY` o cerrado, detener salvo instrucción explícita del usuario: ```text NEW-FEATURE GATE BLOQUEADO: ya existe un Plan File cerrado para esta feature. Usa /bug-fix, /optimizer-code o una nueva Spec si necesitas cambiar comportamiento. ``` Si existe y está en `Planning`, `WIP` o similar, continuar como reentrada controlada. Añadir un nuevo handoff log, no borrar contenido anterior. --- ## Paso 6 — Verificar Plan técnico, Implementation Tasks y DBA/RLS Antes de invocar al Orchestrator, confirmar que el Plan File contiene las secciones mínimas para enrutar correctamente. Esta verificación no habilita Builder por sí sola; solo determina el siguiente handoff correcto. ```bash missing_plan_sections=0 for section in "Pre-flight Gate Report" "Handoff Log" "Routing Decision" "Technical Plan" "Implementation Tasks" "DBA Gate" "Builder Delivery Summary" "Audit Cycles" "Polish Notes" "Memory Notes"; do if grep -q "$section" "$PLAN_FILE"; then echo "OK sección Plan: $section" else echo "FALTA sección Plan: $section" missing_plan_sections=$((missing_plan_sections + 1)) fi done if [ "$missing_plan_sections" -gt 0 ]; then echo "NEW-FEATURE GATE ADVERTENCIA: el Plan File existe pero le faltan secciones operativas." echo "@QwikOrchestrator debe normalizarlo antes de handoff a @QwikArchitect." fi ``` ### Routing según estado del Plan ```text Si no existe Plan técnico → @QwikArchitect. Si el Plan técnico está vacío, pendiente o incompleto → @QwikArchitect. Si no existen Implementation Tasks → @QwikArchitect. Si las Implementation Tasks están vacías, pendientes o no son ejecutables → @QwikArchitect. Si datos/RLS está en READY_FOR_DBA, pendiente DBA o BLOCKED → @QwikDBA. Si datos/RLS es RESOLVED o N/A, y existen Spec Approved + Plan técnico + Implementation Tasks → @QwikBuilder. ``` `@QwikBuilder` solo puede entrar si todos estos gates están satisfechos: ```text Spec Approved Plan técnico existe Implementation Tasks existen DBA/RLS resuelto o N/A ``` --- ## Paso 7 — Invocar a @QwikOrchestrator Solo después de superar los gates anteriores, invocar a `@QwikOrchestrator`. Mensaje de handoff: ```text @QwikOrchestrator Inicia el ciclo de construcción para la feature `{{featureName}}`. Contexto mínimo permitido: - Spec aprobada: docs/specs/{{featureName}}.md - INDEX operativo: docs/sessions/INDEX.md - Plan File: docs/plans/{{featureName}}.md Tarea: 1. Leer primero docs/sessions/INDEX.md. 2. Leer la Spec aprobada. 3. Leer el Plan File creado o existente. 4. Confirmar si hay dependencias, datos/RLS o servicios relacionados en INDEX. 5. Registrar Routing Decision en el Plan File. 6. Enrutar hacia @QwikArchitect si el Plan técnico aún no existe. 7. Enrutar hacia @QwikArchitect si faltan Implementation Tasks ejecutables. 8. Enrutar hacia @QwikDBA si datos/RLS está pendiente, READY_FOR_DBA o BLOCKED. 9. Enrutar hacia @QwikBuilder solo si existe Spec Approved, Plan técnico, Implementation Tasks y DBA/RLS resuelto o N/A. Restricciones: - No escribir código. - No modificar schema. - No leer specs o plans no relacionados salvo dependencia confirmada en INDEX. - No saltar a Builder. - No ampliar scope funcional fuera de la Spec aprobada. Builder gate obligatorio: ```text Spec Approved + Plan técnico + Implementation Tasks + DBA/RLS resuelto o N/A ``` Flujo esperado: @QwikArchitect → @QwikDBA si aplica → @QwikBuilder → @QwikAuditor → @QwikPolisher → @QwikMemory ``` --- ## Salida esperada ```text NEW-FEATURE PREFLIGHT — {{featureName}} INDEX: PASS / FAIL Spec: PASS / FAIL Spec status: Approved / no aprobado / no encontrado Dependencias: OK / BLOQUEADAS / REVIEW REQUIRED Plan File: CREATED / EXISTS / BLOCKED Plan sections: OK / NEEDS NORMALIZATION Plan técnico: EXISTS / MISSING / PENDING Implementation Tasks: EXISTS / MISSING / PENDING DBA/RLS: N/A / RESOLVED / READY_FOR_DBA / BLOCKED Builder gate: READY / BLOCKED Estado: READY FOR ORCHESTRATOR / READY FOR ARCHITECT / READY FOR DBA / READY FOR BUILDER / BLOCKED Siguiente paso: - @QwikOrchestrator - @QwikArchitect - @QwikDBA - @QwikBuilder - /spec {{featureName}} - /setup - resolver dependencias bloqueantes ``` --- ## Regla final `/new-feature` no significa “programa esto”. `/new-feature` significa: ```text Esta feature ya tiene Spec aprobada. Prepara una entrada segura al ciclo de construcción. ``` Si el sistema no puede demostrar eso, debe detenerse.

{ "prompt": "# 🚀 FEATURE KICKOFF — `{{featureName}}`\n\n## Propósito\n\n`/new-feature` es la puerta de entrada al ciclo de ejecución de una Spec ya aprobada.\n\nNo crea la Spec.\nNo implementa código.\nNo sustituye al Orchestrator.\nNo salta gates SDD.\n\nSu única responsabilidad es preparar una entrada segura para el flujo:\n\n```text\nINDEX → Spec Approved → Plan técnico → Implementation Tasks → DBA si aplica → Builder → Auditor → Polisher → Memory\n```\n\nPRD y Blueprint no forman parte del flujo operativo principal ni son gates para `/new-feature`.\n\nSi la feature no está lista para construcción, `/new-feature` debe detenerse y explicar el siguiente paso correcto.\n\n---\n\n## Regla operativa crítica\n\nAntes de invocar a `@QwikOrchestrator`, este prompt debe verificar:\n\n1. existe `docs/sessions/INDEX.md` como primera fuente operativa;\n2. existe `docs/specs/{{featureName}}.md`;\n3. la Spec está en estado `🟢 Approved` o `Approved`;\n4. no hay dependencias bloqueantes declaradas en el INDEX;\n5. existe o se puede crear `docs/plans/{{featureName}}.md` sin sobrescribir trabajo previo;\n6. si no hay Plan técnico, el routing debe ir a `@QwikArchitect`;\n7. si el Plan no tiene `Implementation Tasks`, el routing debe ir a `@QwikArchitect`;\n8. si hay datos/RLS pendientes, el routing debe ir a `@QwikDBA`;\n9. `@QwikBuilder` solo puede entrar con Spec Approved, Plan técnico, Implementation Tasks y DBA resuelto o N/A.\n\nSi falla INDEX, Spec Approved o dependencias bloqueantes, detener el flujo. Si falta Plan técnico, faltan Implementation Tasks o DBA/RLS está pendiente, registrar el estado y enrutar al agente correcto.\n\n---\n\n## Prohibiciones\n\nDurante `/new-feature`, no hacer:\n\n- escribir código en `src/`;\n- modificar schema, migraciones o RLS;\n- crear una Spec nueva;\n- aprobar una Spec por cuenta propia;\n- leer todas las specs;\n- leer todos los plans;\n- cargar sesiones archivadas;\n- explorar masivamente el repositorio;\n- sobrescribir un Plan File existente sin revisar su estado.\n\n---\n\n## Paso 0 — Normalizar entrada\n\nUsar `{{featureName}}` como identificador canónico de la feature.\n\nSi el nombre está vacío, es ambiguo o contiene espacios no intencionales, detener:\n\n```text\nNEW-FEATURE GATE BLOQUEADO: falta un nombre de feature válido.\nUsa: /new-feature [feature-name]\n```\n\n---\n\n## Paso 1 — Verificar INDEX operativo\n\n`docs/sessions/INDEX.md` es la primera fuente de verdad operativa para routing, dependencias y carga selectiva.\n\n```bash\nFEATURE=\"{{featureName}}\"\nINDEX_FILE=\"docs/sessions/INDEX.md\"\n\nif [ ! -f \"$INDEX_FILE\" ]; then\n echo \"NEW-FEATURE GATE BLOQUEADO: falta docs/sessions/INDEX.md\"\n echo \"Siguiente paso: ejecutar /setup para inicializar memoria operativa.\"\n exit 1\nfi\n\necho \"INDEX operativo: $INDEX_FILE\"\n```\n\n### Regla\n\nNo sustituir el INDEX leyendo specs y plans a ciegas.\nSi el INDEX falta, el siguiente paso correcto es `/setup`.\n\n---\n\n## Paso 2 — Verificar Spec aprobada\n\nEjecutar una comprobación acotada sobre la Spec esperada. Este es el primer gate de construcción.\n\n```bash\nSPEC_FILE=\"docs/specs/{{FEATURE}}.md\"\n\nif [ ! -f \"$SPEC_FILE\" ]; then\n echo \"NEW-FEATURE GATE BLOQUEADO: no existe $SPEC_FILE\"\n echo \"Siguiente paso: ejecutar /spec {{FEATURE}}\"\n exit 1\nfi\n\nSPEC_STATUS=$(grep -E '^>?[[:space:]]*Estado:|^>?[[:space:]]*Status:' \"$SPEC_FILE\" | head -1 || true)\n\necho \"Spec: $SPEC_FILE\"\necho \"Estado detectado: {{SPEC_STATUS}}\"\n\nif ! echo \"$SPEC_STATUS\" | grep -Eiq '(🟢[[:space:]]*)?Approved|Aprobada|Aprobado'; then\n echo \"NEW-FEATURE GATE BLOQUEADO: la Spec existe pero no está Approved.\"\n echo \"Siguiente paso: volver a @QwikSpeccer con /spec {{FEATURE}} o aprobar explícitamente la Spec antes de construir.\"\n exit 1\nfi\n```\n\n### Regla\n\nNo continuar si la Spec no está aprobada.\n\nUna Spec en `Draft`, `Review`, `Pending`, `Blocked` o sin estado explícito no habilita construcción.\n\n---\n\n## Paso 3 — Consultar contexto mínimo en INDEX\n\nConsultar únicamente las entradas relevantes para `{{featureName}}`.\n\n```bash\necho \"Entradas relacionadas en INDEX:\"\ngrep -Ei \"(^\\|[[:space:]]*{{FEATURE}}[[:space:]]*\\|)|{{FEATURE}}\" \"$INDEX_FILE\" || true\n```\n\nRevisar si la entrada o entradas relacionadas declaran:\n\n- dependencias en columna `Depende de`;\n- tablas DB que conviene reutilizar;\n- servicios o APIs en columna `Expone`;\n- estado previo `WIP`, `BLOCKED`, `FAILED`, `DONE` o `PRODUCTION-READY`.\n\n### Regla\n\nNo cargar artefactos adicionales todavía.\nEl INDEX filtra; los artefactos amplían solo si el Orchestrator lo decide.\n\n---\n\n## Paso 4 — Comprobar dependencias bloqueantes\n\nSi el INDEX declara dependencias para esta feature, verificar que no aparecen como `WIP`, `FAILED`, `BLOCKED` o sin estado claro.\n\nEsta comprobación puede requerir lectura humana del resultado del grep anterior.\nEl prompt debe documentar el resultado en el Plan File.\n\nSi hay dependencia bloqueante, detener:\n\n```text\nNEW-FEATURE GATE BLOQUEADO: existen dependencias no completadas.\nCompleta primero los módulos bloqueantes indicados en docs/sessions/INDEX.md.\n```\n\nSi no hay dependencias bloqueantes, continuar.\n\n---\n\n## Paso 5 — Crear o preservar Plan File\n\nEl Plan File es el artefacto de coordinación del ciclo. `/new-feature` puede crear un contenedor operativo inicial, pero no crea el Plan técnico ni las Implementation Tasks; eso corresponde a `@QwikArchitect`.\n\nRuta esperada:\n\n```text\ndocs/plans/{{featureName}}.md\n```\n\nCrear `docs/plans/` si no existe.\n\n```bash\nPLAN_FILE=\"docs/plans/{{FEATURE}}.md\"\nmkdir -p docs/plans\n```\n\n### Si el Plan File no existe\n\nCrear un Plan File inicial mínimo:\n\n```bash\nif [ ! -f \"$PLAN_FILE\" ]; then\n cat > \"$PLAN_FILE\" <<EOF\n# Plan: {{FEATURE}}\n\n> Estado: 🟡 Planning\n> Spec: docs/specs/{{FEATURE}}.md\n> Fecha: $(date +%F)\n> Agente inicial: /new-feature\n\n## 1. Pre-flight Gate Report\n\n| Gate | Estado | Evidencia | Acción |\n|---|---|---|---|\n| Spec existe | ✅ PASS | docs/specs/{{FEATURE}}.md | N/A |\n| Spec Approved | ✅ PASS | {{SPEC_STATUS}} | N/A |\n| INDEX existe | ✅ PASS | docs/sessions/INDEX.md | N/A |\n| Dependencias | ⚠️ REVIEWED | Revisar entrada INDEX relacionada | Documentar en fase Architect |\n| Plan File | ✅ CREATED | docs/plans/{{FEATURE}}.md | N/A |\n| Plan técnico | ⏳ PENDING | Pendiente de @QwikArchitect | Enrutar a @QwikArchitect |\n| Implementation Tasks | ⏳ PENDING | Pendiente de @QwikArchitect | Enrutar a @QwikArchitect |\n| Datos/RLS | ⏳ REVIEW | Pendiente de clasificación | Enrutar a @QwikDBA si aplica |\n\n## 2. Contexto mínimo inicial\n\n- Spec: docs/specs/{{FEATURE}}.md\n- INDEX: docs/sessions/INDEX.md\n- Plan: docs/plans/{{FEATURE}}.md\n\n## 3. Dependencias detectadas desde INDEX\n\nPendiente de completar por @QwikOrchestrator tras lectura selectiva del INDEX.\n\n## 4. Riesgos iniciales\n\nPendiente de completar por @QwikArchitect.\n\n## 5. Handoff Log\n\n### $(date +%F) — /new-feature → @QwikOrchestrator\n- Contexto: docs/specs/{{FEATURE}}.md, docs/sessions/INDEX.md, docs/plans/{{FEATURE}}.md\n- Tarea: iniciar routing controlado para construcción de feature con Spec aprobada.\n- Scope: preparar handoff hacia @QwikArchitect.\n- No tocar: código de aplicación, schema, migraciones, RLS o UI antes del Plan técnico y las Implementation Tasks.\n- Condición de salida: routing decision registrado y handoff a @QwikArchitect si procede.\n- Riesgos conocidos: validar dependencias y datos/RLS desde INDEX y Spec.\n\n## 6. Routing Decision\n\nPendiente de @QwikOrchestrator.\n\n## 7. Technical Plan\n\nPendiente de @QwikArchitect.\n\n## 8. DBA Notes\n\nPendiente si aplica.\n\n## 9. Implementation Tasks\n\nPendiente de @QwikArchitect.\n\n## 10. DBA Gate\n\nEstado: N/A / READY_FOR_DBA / RESOLVED / BLOCKED\n\nPendiente de clasificación por @QwikArchitect o @QwikDBA.\n\n## 11. Builder Delivery Summary\n\nPendiente de @QwikBuilder.\n\n## 12. Audit Cycles\n\nPendiente de @QwikAuditor.\n\n## 13. Polish Notes\n\nPendiente de @QwikPolisher.\n\n## 14. Memory Notes\n\nPendiente de @QwikMemory.\n\n## 15. Final Status\n\nPendiente.\nEOF\n echo \"CREADO $PLAN_FILE\"\nfi\n```\n\n### Si el Plan File ya existe\n\nNo sobrescribirlo.\n\n```bash\nif [ -f \"$PLAN_FILE\" ]; then\n echo \"Plan File existente: $PLAN_FILE\"\n grep -E '^> Estado:|^> Status:' \"$PLAN_FILE\" | head -1 || true\nfi\n```\n\nSi existe y está en estado `✅ Done`, `PRODUCTION-READY` o cerrado, detener salvo instrucción explícita del usuario:\n\n```text\nNEW-FEATURE GATE BLOQUEADO: ya existe un Plan File cerrado para esta feature.\nUsa /bug-fix, /optimizer-code o una nueva Spec si necesitas cambiar comportamiento.\n```\n\nSi existe y está en `Planning`, `WIP` o similar, continuar como reentrada controlada.\nAñadir un nuevo handoff log, no borrar contenido anterior.\n\n---\n\n## Paso 6 — Verificar Plan técnico, Implementation Tasks y DBA/RLS\n\nAntes de invocar al Orchestrator, confirmar que el Plan File contiene las secciones mínimas para enrutar correctamente. Esta verificación no habilita Builder por sí sola; solo determina el siguiente handoff correcto.\n\n```bash\nmissing_plan_sections=0\n\nfor section in \"Pre-flight Gate Report\" \"Handoff Log\" \"Routing Decision\" \"Technical Plan\" \"Implementation Tasks\" \"DBA Gate\" \"Builder Delivery Summary\" \"Audit Cycles\" \"Polish Notes\" \"Memory Notes\"; do\n if grep -q \"$section\" \"$PLAN_FILE\"; then\n echo \"OK sección Plan: $section\"\n else\n echo \"FALTA sección Plan: $section\"\n missing_plan_sections=$((missing_plan_sections + 1))\n fi\ndone\n\nif [ \"$missing_plan_sections\" -gt 0 ]; then\n echo \"NEW-FEATURE GATE ADVERTENCIA: el Plan File existe pero le faltan secciones operativas.\"\n echo \"@QwikOrchestrator debe normalizarlo antes de handoff a @QwikArchitect.\"\nfi\n```\n\n### Routing según estado del Plan\n\n```text\nSi no existe Plan técnico → @QwikArchitect.\nSi el Plan técnico está vacío, pendiente o incompleto → @QwikArchitect.\nSi no existen Implementation Tasks → @QwikArchitect.\nSi las Implementation Tasks están vacías, pendientes o no son ejecutables → @QwikArchitect.\nSi datos/RLS está en READY_FOR_DBA, pendiente DBA o BLOCKED → @QwikDBA.\nSi datos/RLS es RESOLVED o N/A, y existen Spec Approved + Plan técnico + Implementation Tasks → @QwikBuilder.\n```\n\n`@QwikBuilder` solo puede entrar si todos estos gates están satisfechos:\n\n```text\nSpec Approved\nPlan técnico existe\nImplementation Tasks existen\nDBA/RLS resuelto o N/A\n```\n\n---\n\n## Paso 7 — Invocar a @QwikOrchestrator\n\nSolo después de superar los gates anteriores, invocar a `@QwikOrchestrator`.\n\nMensaje de handoff:\n\n```text\n@QwikOrchestrator\n\nInicia el ciclo de construcción para la feature `{{featureName}}`.\n\nContexto mínimo permitido:\n- Spec aprobada: docs/specs/{{featureName}}.md\n- INDEX operativo: docs/sessions/INDEX.md\n- Plan File: docs/plans/{{featureName}}.md\n\nTarea:\n1. Leer primero docs/sessions/INDEX.md.\n2. Leer la Spec aprobada.\n3. Leer el Plan File creado o existente.\n4. Confirmar si hay dependencias, datos/RLS o servicios relacionados en INDEX.\n5. Registrar Routing Decision en el Plan File.\n6. Enrutar hacia @QwikArchitect si el Plan técnico aún no existe.\n7. Enrutar hacia @QwikArchitect si faltan Implementation Tasks ejecutables.\n8. Enrutar hacia @QwikDBA si datos/RLS está pendiente, READY_FOR_DBA o BLOCKED.\n9. Enrutar hacia @QwikBuilder solo si existe Spec Approved, Plan técnico, Implementation Tasks y DBA/RLS resuelto o N/A.\n\nRestricciones:\n- No escribir código.\n- No modificar schema.\n- No leer specs o plans no relacionados salvo dependencia confirmada en INDEX.\n- No saltar a Builder.\n- No ampliar scope funcional fuera de la Spec aprobada.\n\nBuilder gate obligatorio:\n\n```text\nSpec Approved + Plan técnico + Implementation Tasks + DBA/RLS resuelto o N/A\n```\n\nFlujo esperado:\n@QwikArchitect → @QwikDBA si aplica → @QwikBuilder → @QwikAuditor → @QwikPolisher → @QwikMemory\n```\n\n---\n\n## Salida esperada\n\n```text\nNEW-FEATURE PREFLIGHT — {{featureName}}\n\nINDEX: PASS / FAIL\nSpec: PASS / FAIL\nSpec status: Approved / no aprobado / no encontrado\nDependencias: OK / BLOQUEADAS / REVIEW REQUIRED\nPlan File: CREATED / EXISTS / BLOCKED\nPlan sections: OK / NEEDS NORMALIZATION\nPlan técnico: EXISTS / MISSING / PENDING\nImplementation Tasks: EXISTS / MISSING / PENDING\nDBA/RLS: N/A / RESOLVED / READY_FOR_DBA / BLOCKED\nBuilder gate: READY / BLOCKED\nEstado: READY FOR ORCHESTRATOR / READY FOR ARCHITECT / READY FOR DBA / READY FOR BUILDER / BLOCKED\n\nSiguiente paso:\n- @QwikOrchestrator\n- @QwikArchitect\n- @QwikDBA\n- @QwikBuilder\n- /spec {{featureName}}\n- /setup\n- resolver dependencias bloqueantes\n```\n\n---\n\n## Regla final\n\n`/new-feature` no significa “programa esto”.\n\n`/new-feature` significa:\n\n```text\nEsta feature ya tiene Spec aprobada.\nPrepara una entrada segura al ciclo de construcción.\n```\n\nSi el sistema no puede demostrar eso, debe detenerse.", "variables": [ "featureName", "FEATURE", "SPEC_STATUS" ], "notes": "Inicia el ciclo de ejecución de una Spec ya aprobada. Verifica INDEX, Spec Approved, estado del Plan técnico, Implementation Tasks y DBA/RLS antes de enrutar hacia @QwikOrchestrator, @QwikArchitect, @QwikDBA o @QwikBuilder. Si cualquier gate falla, detiene el flujo y recomienda el siguiente paso correcto sin escribir código. Tools: edit, execute/runInTerminal, read. Arguments: example: /new-feature voice-agent-configuration.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/agarrido2/sddqwik", "path": ".github/prompts/new-feature.prompt.md", "ref": "65fb0cabe065f912259061419c296de8207613b5", "url": "https://github.com/agarrido2/sddqwik/blob/65fb0cabe065f912259061419c296de8207613b5/.github/prompts/new-feature.prompt.md", "key": "agarrido2/sddqwik/.github/prompts/new-feature.prompt.md" } } }

new-feature

About

🚀 FEATURE KICKOFF — `{{featureName}}`

Propósito

Regla operativa crítica

Prohibiciones

Paso 0 — Normalizar entrada

Paso 1 — Verificar INDEX operativo

Regla

Paso 2 — Verificar Spec aprobada

Regla

Paso 3 — Consultar contexto mínimo en INDEX

Regla

Paso 4 — Comprobar dependencias bloqueantes

Paso 5 — Crear o preservar Plan File

Si el Plan File no existe

Si el Plan File ya existe

Paso 6 — Verificar Plan técnico, Implementation Tasks y DBA/RLS

Routing según estado del Plan

Paso 7 — Invocar a @QwikOrchestrator

Regla final

Use it

Manifest

Reviews

About

🚀 FEATURE KICKOFF — {{featureName}}

Propósito

Regla operativa crítica

Prohibiciones

Paso 0 — Normalizar entrada

Paso 1 — Verificar INDEX operativo

Regla

Paso 2 — Verificar Spec aprobada

Regla

Paso 3 — Consultar contexto mínimo en INDEX

Regla

Paso 4 — Comprobar dependencias bloqueantes

Paso 5 — Crear o preservar Plan File

Si el Plan File no existe

Si el Plan File ya existe

Paso 6 — Verificar Plan técnico, Implementation Tasks y DBA/RLS

Routing según estado del Plan

Paso 7 — Invocar a @QwikOrchestrator

Regla final

Use it

Manifest

Reviews

🚀 FEATURE KICKOFF — `{{featureName}}`