Runs the Beat Expansion decision pass to assess whether a book's beats are stable enough for section expansion. Analyzes each beat's structure, recommends splits or braiding, and produces the beat-to-section coverage plan. Use when the user asks to stabilize beats, check beat readiness, or prepare for section expansion.
Run the beat stabilization analysis. This is the gate between beat work and serious section expansion.
Resolve which book to analyze; the resolved path replaces {book} for the rest of this skill.
$ARGUMENTS provides a book name matching a subdirectory of books/, use books/[name] as the book root.books/, use it. If multiple, ask the user which.Check prerequisites. Read {book}/docs/15_beats.md. If it doesn't exist, stop: "No beat file found for this book. Generate beats first with /generate-beats {book-name}."
Spawn the beat-analyzer agent. Use the Agent tool. Substitute the concrete book root for {book} in the prompt:
Prompt: "Analyze the beat file for structural stability. Book root: {book}. Read {book}/docs/15_beats.md, {book}/docs/story_concept.md (if exists), {book}/docs/characters.md (if exists), and {book}/docs/open_questions.md (if exists). Run the full Beat Expansion decision pass on each beat and return the stability assessment with beat-to-section coverage plan."
Wait for the agent to return.
Review the analysis. Present the agent's report to the user:
Ask for user decision. Based on the analysis:
If the agent recommends Stable: "The beat structure appears stable. Would you like to mark it as Stable and begin section expansion? Or review specific beats first?"
If the agent recommends Provisional (with blockers): "These issues need resolution before beats can be stabilized: [list blockers]. Would you like to address them now?"
If the agent recommends Exploratory: "The beat structure has significant unresolved elements. Recommend continuing discovery/convergence work before attempting stabilization."
If user approves Stable: Update the beat status header in {book}/docs/15_beats.md from its current status to Stable. Also update the beat-to-section mapping table if the agent produced one.
If user approves Locked: Update the beat status header to Locked. This means: beats will not change without explicit user instruction. Section expansion can proceed as authoritative.
/generate-beats for that)/expand-sections for that)This skill is purely analytical: it assesses the current state and recommends a status.