@trycore/spec-build-harness 0.7.1 → 0.8.0

package/skills/building-a-slice/references/dor.md

@@ -16,6 +16,8 @@ la épica; lo de abajo aplica a la épica y a **cada HU** que cubre (`hus[]`). L
 - [ ] **Fuente de diseño identificada (slices con UI)**: la fuente visual de verdad del slice
   (el `DESIGN_SOURCE` del dominio) está declarada y confirmada (`design_source.confirmed`), y este
   slice apunta a la(s) pantalla(s) equivalente(s). No se construye UI fuera de la fuente declarada.
+- [ ] **Clasificación `layer`**: `foundational` (auth/datos/design-system/arquitectura base) | `business`. Se escribe en `active_slice.layer`. Gatea el front paralelo (foundational nunca en paralelo).
+- [ ] **`files_scope`**: globs de los archivos que la épica tocará (p.ej. `src/reports/**`). Fuente de la disjunción inter-épica. Se escribe en `active_slice.files_scope`.
 
 **Si todo ✓** → `dor-dod-gatekeeper` abre `active_slice` en `build-state.json` con `epica`, `hus[]`,
 `phase: dor`, `gates.dor: true` y el resto en `false` —incluido **`wiring_verified: false`**—

package/skills/managing-parallel-front/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: managing-parallel-front
+description: Use when building multiple NON-foundational, file-disjoint epics in parallel via git worktrees. Coordinates the parallel_front in build-state.json (selection, worktrees, deterministic merge order with re-smoke). Never parallelizes foundational epics or overlapping file scopes.
+---
+
+# Gestionar el front paralelo inter-épica (outer-loop)
+
+**Invariante:** el paralelismo es outer-loop. Cada worktree es un checkout aislado con su
+**propio** `build-state.json` y su `active_slice` singular (el inner loop no cambia).
+
+## Precondiciones (compuertas)
+- `scaffold.confirmed == true`.
+- **G1 Fundacionales primero:** ninguna épica `layer=foundational` abierta. Si aparece una,
+  poner `parallel_front.status="draining"` (terminar en curso, no admitir nuevas) antes de abrirla.
+
+## Procedimiento
+1. **Reunir candidatas** no fundacionales listas (DoR pasado), cada una con `layer` y `files_scope`.
+2. **Seleccionar el conjunto disjunto** (G2):
+   `echo "$CANDS" | python3 .claude/scripts/lib/front-plan.py`
+   → `selected` van al front; `serialized` esperan (construir secuencial después);
+   `excluded_foundational` nunca en paralelo.
+3. **Abrir un worktree por épica seleccionada:**
+   `git worktree add ".wt/<epica>" -b feature/<slug>` (rama por `1 épica = 1 rama = 1 PR`).
+   Registrar el miembro en `parallel_front.members[]` (`merge_status:"pending"`).
+4. **Construir cada worktree** con la skill `building-a-slice` (inner loop normal, en su cwd).
+   Cada uno mantiene su `journey_smoke` verde localmente.
+5. **Coordinar merge (G3)** en `merge_order` (determinista: por orden de épica):
+   - Merge del PR; tras cada merge, **re-smoke del journey completo** en el árbol principal.
+   - Conflicto → `merge_status:"conflict"`, serializar la perdedora (rebase + re-correr sus gates).
+   - Éxito → `merge_status:"merged"`; `git worktree remove`.
+6. **Cerrar el front** cuando todos `merged`: `parallel_front=null`.
+
+## Reglas duras
+- Nunca escritores paralelos sobre el mismo árbol (por eso worktrees).
+- Nunca paralelizar dentro de una épica (preserva la "regla del esqueleto que camina").
+- Un solape de `files_scope` no detectado que cause conflicto de merge → el re-smoke (G3) lo caza.

package/state/build-state.schema.json

@@ -31,6 +31,10 @@
       "type": "array",
       "description": "Release Gates (outer loop). Una entrada por línea de release del Story Map auditada en bloque.",
       "items": { "$ref": "#/$defs/release" }
+    },
+    "parallel_front": {
+      "description": "Coordinación outer-loop de worktrees inter-épica (C). null = modo secuencial normal.",
+      "oneOf": [ { "type": "null" }, { "$ref": "#/$defs/parallel_front" } ]
     }
   },
   "$defs": {
@@ -75,6 +79,7 @@
         },
         "openspec_change": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
         "branch": { "type": "string", "pattern": "^(feature|fix|chore)/[a-z0-9._-]+$" },
+        "branch_drift": { "type": "string", "description": "Rama git real cuando difiere de branch (lo escribe el reconciliador)." },
         "phase": {
           "type": "string",
           "enum": ["dor", "change", "red", "green", "refactor", "smoke", "api", "data", "dod", "pr", "archived"]
@@ -151,6 +156,19 @@
               "journey_smoke": { "type": "boolean", "description": "El backbone-hasta-este-sub-slice camina end-to-end." }
             }
           }
+        },
+        "layer": { "type": "string", "enum": ["foundational", "business"], "default": "business", "description": "Clasificación (taxonomía existente del arnés): foundational (auth/datos/design-system/arquitectura base) nunca va en paralelo; business = épica de negocio (paralelizable si es disjunta). Gatea el front paralelo (C)." },
+        "files_scope": { "type": "array", "items": { "type": "string" }, "description": "Globs de archivos que la épica toca. Fuente de la disjunción inter-épica (G2)." },
+        "session_continuity": {
+          "type": "object", "additionalProperties": false,
+          "description": "Handoff de sesión (A): permite resume sin pérdida tras presión de contexto.",
+          "properties": {
+            "last_session": { "type": ["string", "null"] },
+            "stopped_at": { "type": ["string", "null"], "description": "p.ej. 'context exhaustion at 24% (ISO)'." },
+            "resume_hint": { "type": ["string", "null"], "description": "Siguiente acción concisa." },
+            "critical_recorded": { "type": "boolean", "description": "Guard once-per-session del auto-handoff." },
+            "auto_continue": { "type": "boolean", "description": "true cuando context.auto_checkpoint disparó continuación automática (§4.4)." }
+          }
         }
       }
     },
@@ -184,6 +202,38 @@
         "created_at": { "type": "string", "format": "date-time" },
         "updated_by": { "type": "string" }
       }
+    },
+    "parallel_front": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "opened_at", "updated_by", "members", "merge_order"],
+      "properties": {
+        "status": { "type": "string", "enum": ["active", "draining"] },
+        "opened_at": { "type": "string", "format": "date-time" },
+        "updated_by": { "type": "string" },
+        "members": {
+          "type": "array",
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["epica", "worktree", "files_scope", "merge_status"],
+            "properties": {
+              "epica": { "type": "string", "pattern": "^EP-[0-9]{3}$" },
+              "worktree": {
+                "type": "object", "additionalProperties": false,
+                "required": ["path", "branch", "created_at"],
+                "properties": {
+                  "path": { "type": "string" },
+                  "branch": { "type": "string", "pattern": "^(feature|fix|chore)/[a-z0-9._-]+$" },
+                  "created_at": { "type": "string", "format": "date-time" }
+                }
+              },
+              "files_scope": { "type": "array", "items": { "type": "string" } },
+              "journey_smoke": { "type": "boolean" },
+              "merge_status": { "type": "string", "enum": ["pending", "merged", "conflict"] }
+            }
+          }
+        },
+        "merge_order": { "type": "array", "items": { "type": "string", "pattern": "^EP-[0-9]{3}$" } }
+      }
     }
   }
 }