planner-refine-wps

planner-refine-wps

L1 session that refines a combined_wps.json (a PlanDocument with all work packages in WPElaborated form) by spawning one L0 subagent per phase in parallel (batched to 6). Unlike the per-WP elaboration pass, this skill spawns one L0 per phase (not per WP). Each L0 reviews ALL WPs in its assigned phase against the full WP set, detecting cross-phase API mismatches, duplicate deliverables, missing dependencies, and scope overlap. The L1 collects structured suggestions, resolves conflicts, and writes refined_wps.json.

When to Use

• Launched by the L2 planner recipe after the parallel WP elaboration merge step
• Accepts combined_wps.json, refined_plan.json, and refined_assignments.json
• Produces refined_wps.json as input for downstream planner steps (e.g. reconcile_deps)

Arguments

• $1 — Absolute path to combined_wps.json (PlanDocument with work_packages: list[WPElaborated])
• $2 — Absolute path to refined_plan.json (PlanDocument with phases as PhaseElaborated)
• $3 — Absolute path to refined_assignments.json (PlanDocument with assignments as AssignmentElaborated)
• $4 — Absolute path to the run-scoped planner directory (e.g., {{AUTOSKILLIT_TEMP}}/planner/run-YYYYMMDD-HHMMSS). Output is written to $4/refined_wps.json.

Critical Constraints

NEVER:

• Write any file outside $4/
• Directly modify combined_wps.json ($1) — always write a new refined_wps.json
• Allow an L0 subagent to write files directly (L0s return structured text only)
• Emit refined_wps_path before writing refined_wps.json
• Skip emitting refined_wps_path even if all L0s fail (write unchanged WPs, still emit)
• Spawn more than 6 L0s in a single parallel batch
• Spawn one L0 per WP — L0s operate per PHASE
• Read {{AUTOSKILLIT_TEMP}} artifacts not passed as positional arguments
• Run subagents in the background (run_in_background: true is prohibited)

ALWAYS:

• Spawn one L0 per phase (NOT per WP) — each L0 reviews ALL WPs in its phase against the full WP set
• Validate each L0 response for phase_id, wp_changes (array), cross_phase_deps (array), deliverable_conflicts (array), api_mismatches (array)
• Log WARNING to stdout for any L0 response that fails validation (skip that phase)
• Log CRITICAL to stdout for any L0 subagent that fails entirely (proceed with N-1 suggestions)
• When two WPs claim the same deliverable file, assign ownership to the WP with the numerically earlier ID using natural sort (e.g., P1-A1-WP1 beats P2-A1-WP1)
• Emit: refined_wps_path = <absolute path to refined_wps.json>