check-designs

name	check-designs
description	Retroactive compliance check for Stitch designs. Scans all UCs with screens and reports which have Stitch HTML designs and which don't. Use when the user says "check designs", "design compliance", "verify designs", "stitch status", or wants to audit design-to-code traceability.
context	fork
agent	Explore

/check-designs

Escanea todos los UCs con pantallas y reporta el estado de los diseños Stitch.

Uso

/check-designs [board_id | project_id | local]

Origenes:

• board_id → Escanear UCs del board Trello
• project_id → Escanear work items de Plane
• local → Escanear planes locales en doc/plans/
• Sin argumento → Detectar automaticamente (Trello config → Plane config → local)

---

Paso 1: Recopilar UCs con pantallas

Si Trello:

1. Obtener board_id de .claude/settings.local.json
2. Listar todas las US: list_us(board_id)
3. Para cada US: list_uc(board_id, us_id)
4. Para cada UC: get_uc(board_id, uc_id) → extraer campo screens
5. Filtrar solo UCs con screens no vacio

Si Plane:

1. Obtener project_id de configuracion
2. Listar work items tipo UC (con label "UC")
3. Extraer campo screens de la descripcion
4. Filtrar solo UCs con screens

Si local:

1. Listar doc/plans/*_plan.md
2. Parsear cada plan → extraer secciones con pantallas/screens
3. Extraer feature name de cada plan

---

Paso 2: Verificar diseños existentes

Para cada UC/feature con pantallas:

# Verificar existencia de HTMLs
FEATURE=$(echo "${uc_name}" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
DESIGN_DIR="doc/design/${FEATURE}"

if [ -d "$DESIGN_DIR" ]; then
  HTML_COUNT=$(find "$DESIGN_DIR" -name "*.html" | wc -l)
else
  HTML_COUNT=0
fi

---

Paso 3: Verificar trazabilidad en codigo

Para cada feature con diseños:

# Buscar paginas bajo presentation/pages/ para esta feature
PAGES=$(find lib/presentation/features/${FEATURE}/pages/ -name "*.dart" 2>/dev/null)
# O para React:
PAGES=$(find src/pages/${FEATURE}/ -name "*.tsx" 2>/dev/null)

for page in $PAGES; do
  if head -5 "$page" | grep -q "Generated from: doc/design/"; then
    TRACED="YES"
  else
    TRACED="NO"
  fi
done

---

Paso 4: Verificar campo stitch_designs en planes

for plan in doc/plans/*_plan.md; do
  STITCH_STATUS=$(grep -oP 'stitch_designs:\s*\K\w+' "$plan" 2>/dev/null || echo "NOT_SET")
done

---

Output

## Design Compliance Report

**Fecha**: [timestamp]
**Origen**: [Trello board / Plane project / local plans]

### Resumen

| Metrica | Valor |
|---------|-------|
| Total UCs con pantallas | [N] |
| UCs con diseños completos | [N] |
| UCs con diseños parciales | [N] |
| UCs sin diseños | [N] |
| Paginas con trazabilidad | [N]/[total] |
| Paginas sin trazabilidad | [N] |

### Detalle por UC

| UC | Pantallas esperadas | HTMLs encontrados | Trazabilidad | Status |
|----|--------------------|--------------------|--------------|--------|
| UC-001 | login, register | 2/2 | 2/2 | COMPLIANT |
| UC-002 | dashboard | 0/1 | 0/0 | MISSING |
| UC-003 | settings | 1/1 | 0/1 | PARTIAL (no traceability) |
| UC-004 | (sin pantallas) | N/A | N/A | SKIP |

### Status Legend

- **COMPLIANT**: Diseños existen + paginas tienen comentario de trazabilidad
- **MISSING**: No hay diseños HTML para las pantallas del UC
- **PARTIAL**: Diseños existen pero falta trazabilidad en el codigo
- **PENDING**: Plan tiene `stitch_designs: PENDING` — bloqueara /implement
- **SKIP**: UC no tiene pantallas definidas

### Compliance Metrics

| Metrica | Valor |
|---------|-------|
| Compliance Rate | [N]% |
| Enforcement Level | L0 / L1 / L2 |
| Baseline anterior | [N]% (si existe) |
| Variacion | +[N]% / -[N]% / sin cambios |

### Acciones requeridas

{Si hay UCs MISSING o PARTIAL:}
1. Ejecutar `/plan UC-XXX` para generar diseños faltantes
2. O crear diseños manualmente en `doc/design/{feature}/`
3. Paginas sin trazabilidad: anadir `// Generated from: doc/design/{feature}/{screen}.html`

{Si todo COMPLIANT:}
Todos los UCs con pantallas tienen diseños Stitch y trazabilidad completa.

### Retrofit Roadmap (si compliance < 80%)

Prioridad de retrofit basada en frecuencia de modificacion:

| Prioridad | Feature | Motivo | Esfuerzo |
|-----------|---------|--------|----------|
| Alta | {features tocadas en ultimos 5 commits} | Se modifican frecuentemente | /plan feature:X |
| Media | {features con PRs recientes} | Cambios recientes | /plan feature:X |
| Baja | {features estables sin cambios recientes} | Raramente modificadas | Puede esperar |

Para cada feature prioritaria:
1. `git log --oneline -5 -- lib/presentation/features/{feature}/` → frecuencia
2. `/plan feature:{feature}` → genera diseños Stitch retroactivos
3. Anadir traceability comment a paginas existentes
4. Re-medir con `/check-designs` → compliance deberia subir

---

Paso 5: Actualizar Baseline (opcional)

Si el usuario lo solicita o si es la primera vez:

.quality/scripts/design-baseline.sh . --update

Esto actualiza el campo designCompliance en el baseline del proyecto. El ratchet garantiza que el compliance rate nunca baje.

---

Checklist

• Origen detectado (Trello/Plane/local)
• UCs con pantallas recopilados
• Existencia de HTMLs verificada por feature
• Trazabilidad en codigo verificada (comentario // Generated from:)
• Campo stitch_designs de planes verificado
• Tabla de compliance generada
• Compliance rate calculado y nivel determinado (L0/L1/L2)
• Retrofit roadmap generado (si compliance < 80%)
• Baseline actualizado (si solicitado)

---

SpecBox Engine v5.19.0 — Design Compliance Check