7. Resumen

La fábrica está montada. Esta página es la que se tiene abierta mientras se trabaja en la 2ª evaluación: el flujo en pasos, la chuleta de las skills y la lista de comprobación. El diagrama del flujo con quién hace cada cosa está en el tema 1.

El flujo, en pasos

Por cada issue (varios a la vez, cada uno en su worktree):

Crear el issue en GitHub y ponerlo en el tablero.
/git-flow iniciar N: rama, worktree y .env con sus puertos. cd al worktree y ./arrancar.sh.
Modo plan: decir qué se quiere, pedir que pregunte, revisar el plan. Sale planes/N-slug.md.
/clear y Ejecuta @planes/N-slug.md. Si el issue es un CRUD, en vez del plan: /kiro-spec-init, requirements, design -y, tasks -y e impl.
Los tests: /crear-test-unitarios para el dominio que haya cambiado, /crear-test-api para los endpoints nuevos y /crear-test-e2e planes/N-slug.md. Y /crear-test-arquitectura si hay reglas nuevas. Si el issue era un CRUD, a partir de su requirements.md.
Pasar los tests: mvn test, npm run test:api y npm run test:e2e. Probar en la URL del worktree; si ha cambiado el backend, ./arrancar.sh antes.
/revisar-calidad sobre el paquete del issue; corregir los graves.
/git-flow commit.
/git-flow finalizar: pasa /revisar; si no hay nada grave, fusiona en develop y GitHub cierra el issue. CI en develop; si sale en rojo, /revisar-ci.

Cuando hay algo que sacar:

/revisar-calidad sobre todo el backend; corregir los graves.
/git-flow publicar: develop → main, CI, despliegue en el servidor, smoke test. Si sale en rojo, /revisar-ci.

Scripts y comandos

Comando	Dónde	Qué hace
`./arrancar.sh`	raíz del worktree	Levanta la aplicación del worktree (reconstruyendo lo que ha cambiado) y dice su URL
`./parar.sh`	raíz del worktree	La para conservando los datos; con `-v` borra la base de datos
`./estado.sh`	raíz del worktree	Estado de sus contenedores
`./logs.sh`	raíz del worktree	Últimas líneas de log de sus contenedores

Los mismos cuatro operan la aplicación en el servidor, lanzados desde GitHub (tema 6).

Los tres comandos de tests

Comando	Dónde	Qué pasa
`mvn test`	`backend/`	Unitarios y ArchUnit. No necesita nada levantado
`npm run test:api`	`frontend/`	Resetea la base de datos y pasa los de API contra la aplicación del worktree. No forman parte del build
`npm run test:e2e`	`frontend/`	Lo mismo con los E2E

Chuleta de skills

Skill	Para qué
`/git-flow iniciar N`	Empezar un issue: rama, worktree y `.env` con puertos
`/git-flow commit`	Agrupar los cambios en commits con sentido, `type(#N):título`
`/git-flow actualizar`	Traer `develop` a la rama
`/git-flow finalizar`	Revisar, fusionar en `develop` con `Closes #N`, push, parar contenedores y borrar el worktree
`/git-flow publicar`	`develop` → `main`: despliega
`/crear-test-arquitectura`	Reglas en castellano → tests ArchUnit con descripción
`/crear-test-unitarios <clase>`	Un test JUnit por comportamiento del dominio, con Mockito
`/crear-test-api <Entidad>`	Un test Playwright por endpoint y por error previsto
`/crear-test-e2e <plan>`	Criterios de aceptación → tests Playwright pasando
`/revisar`	Diff contra el plan y las convenciones, grave / mejorable
`/revisar-calidad <ruta>`	Informe de calidad del código con las reglas de `calidad-codigo`; no toca nada
`/kiro-spec-init` … `/kiro-impl`	Un CRUD con cc-sdd, igual que el de referencia gracias al steering
`/revisar-ci`	Seguir el workflow y diagnosticar si falla
`convenciones-backend`, `convenciones-frontend`, `calidad-codigo`	No se invocan: el agente las carga al tocar código

Listo para la 2ª evaluación

Antes de empezar el proyecto, todo esto tiene que estar hecho y comprobado:

Tablero creado y un issue de prueba cerrado solo por el commit de finalizar.
Dos worktrees con la aplicación levantada a la vez, cada uno con sus datos.
Un CRUD hecho con el flujo de plan y un segundo con cc-sdd, iguales.
Steering de cc-sdd con backend.md y frontend.md condicionales, y las skills de convenciones apuntando a ellos.
convenciones-backend y convenciones-frontend escritas a partir del primer CRUD.
Tests ArchUnit con su descripción y unitarios pasando en mvn test.
Tests de API y E2E generados pasando en npm run test:api y npm run test:e2e.
/git-flow finalizar se para ante una revisión con algo grave.
CI en verde en develop.
Una publicación en main desplegada sola en http://<alumno>.proyectosdaw.cip.fpmislata.com.
AGENTS.md con: comandos, dónde corren los tests, git solo con /git-flow, planes/ es histórico.