| name | registrar-bloqueo |
| description | Registra en docs/gestion/registro-de-bloqueos.md que una tarea no puede avanzar porque falta un insumo que produce otro rol, y avisa en el chat con el formato acordado. Úsala en cuanto detectes que una compuerta de la secuencia de trabajo está cerrada, y también al cerrar un bloqueo o al abrir una compuerta. |
Registrar un bloqueo
Se registra antes de intentar rodearlo. Un bloqueo que se rodea inventando el insumo faltante
—tipos escritos a mano, un DTO "provisional", un mock que nadie retira— no se ve hasta la
integración, y para entonces cuesta un sprint.
Contexto de por qué existe la secuencia y qué compuerta habilita a quién:
docs/equipo/secuencia-de-trabajo.md §2 y §5.
Cuándo usar esto
- Vas a empezar una tarea y el insumo que necesita no existe todavía en
develop
- La compuerta de la que dependes está 🔴 o 🟡 en
docs/gestion/registro-de-bloqueos.md §1
- El titular de la compuerta autoriza un desbloqueo temporal (se registra igual, en §4)
- Se abre una compuerta o se resuelve un bloqueo (actualizar, no borrar)
No para: una tarea que simplemente no has empezado, una duda de diseño (eso es un ADR), ni un
defecto en algo que sí existe (eso es registrar-bug).
Paso 1 — Verificar, no suponer
Corre el comando de verificación de la compuerta que aparece en la tabla §1 del registro y guarda
su salida real. Sin verificación no hay bloqueo: hay una suposición.
Este proyecto ya perdió trabajo por afirmar sin comprobar (MEMORY.md, corrección del 2026-08-06).
La misma disciplina aplica aquí: no se declara bloqueado ni desbloqueado a nadie de memoria.
Paso 2 — Escribir la entrada
Toma el siguiente BL-NNN del comentario al final de docs/gestion/registro-de-bloqueos.md y
copia la plantilla a la sección 2. Bloqueos abiertos. Los campos no son decorativos:
- Insumo que falta — el artefacto y su ruta esperada, no "el backend".
- Verificación — comando + salida. Literal.
- Trabajo alterno tomado — qué sí se puede hacer sin cruzar la compuerta. Un bloqueo casi nunca
detiene el 100% del rol; detiene una tarea.
Paso 3 — Avisar en el chat — obligatorio
Registrar sin avisar no sirve: nadie lee un archivo que no sabe que cambió. Usa este formato exacto:
🚧 BLOQUEO — no puedo avanzar
Rol · tarea: D4 · componente MapaSectores (RF-004)
Depende de: compuerta C2 — contrato OpenAPI (titular D3)
Verificación: `git show develop:backend/openapi.yaml` → fatal: path no existe (2026-08-07)
Registrado: docs/gestion/registro-de-bloqueos.md → BL-003
Sí puedo avanzar en: tokens de DESIGN.md, layout sin datos, pruebas de accesibilidad estáticas
Necesito de ti: que D3 publique el contrato, o un desbloqueo temporal por escrito
Se avisa aunque el bloqueo ya esté registrado por otra persona. El registro es memoria del
proyecto; el aviso es lo que desatasca a un humano hoy.
Paso 4 — Al cerrar
- Verifica de nuevo con el comando. La compuerta se abre con evidencia, no con un "ya quedó".
- Marca 🟢 en la tabla §1 con la fecha, mueve el bloqueo a la tabla §3 con los días detenido.
- Avisa en el chat:
✅ DESBLOQUEO — C2 abierta
Verificación: `git show develop:backend/openapi.yaml | head -5` → openapi: 3.1.0 …
Cierra: BL-003 (4 días detenido)
D4 puede retomar MapaSectores.
- Si hubo un desbloqueo temporal asociado, comprueba que su issue de reconciliación se cerró. Si
caducó y sigue vigente, regístralo como bug S2 con
registrar-bug.
Reglas de escritura
- Nombra la compuerta y a su titular. "Estoy esperando el backend" no es accionable.
- Un bloqueo es del trabajo, no de la persona. Se escribe qué falta, no quién falló.
- Nunca cierres un bloqueo sin la salida del comando. Es la única diferencia entre un registro
y una impresión.
Efecto en la Sala de control
La sección "Quién está detenido, y por qué" de la Sala de control se arma con los campos de §2:
Rol bloqueado, Insumo que falta, Titular que lo resuelve y Tarea detenida. Escríbelos
con ese nombre exacto y en negrita — si cambias el rótulo, el bloqueo aparece incompleto en el
tablero que miran los cinco. Al cerrarlo, mueve la fila a §3: la cuenta de bloqueos abiertos sale de
cuántos bloques quedan en §2 sin marca de cerrado.
