/crucible-continue

Resume your Crucible project from wherever you left off.

CRITICAL: How to Present Options

When presenting choices to the user, you MUST use the AskUserQuestion tool.

WRONG - Never do this:

Would you like to:
A) Continue planning
B) Review premise
C) Start fresh
D) Something else

RIGHT - Always do this:

Use the AskUserQuestion tool with this format:

{
  "questions": [
    {
      "header": "Continue",
      "question": "How would you like to proceed?",
      "options": [
        {"label": "Continue planning", "description": "Resume from current position"},
        {"label": "Review premise", "description": "Check the premise before continuing"},
        {"label": "Start fresh", "description": "Begin planning with a new premise"},
        {"label": "Something else", "description": "Do something different"}
      ],
      "multiSelect": false
    }
  ]
}

Execution Steps

1. Read state files to determine current phase
2. Display project status as plain text (title, phase, progress)
3. Use AskUserQuestion tool to present options (NOT plain text A/B/C/D)
4. Invoke the appropriate skill based on user selection

State Files to Check

• .crucible/state/planning-state.json - Planning progress
• .crucible/state/outline-state.json - Outlining progress
• .crucible/state/draft-state.json - Writing progress
• .crucible/state/edit-state.json - Editing progress

CRITICAL: Planning Completion Check

Planning has TWO phases that must BOTH be complete:

1. Phase 2 (Q&A): All 9 documents marked complete in progress.documents_complete
2. Phase 3 (Compilation): Actual planning files generated by compile_documents.py

To verify planning is truly complete, check for actual files:

# Check if planning documents were generated
ls <project_path>/planning/crucible-thesis.md

If Q&A is done (9/9 docs) but crucible-thesis.md does NOT exist:

• Planning is NOT complete - Phase 3 was never run
• Report: "Q&A complete but planning documents not generated"
• Offer to run compilation:

  python <plugin_path>/skills/crucible-planner/scripts/compile_documents.py "<project_path>"
  

Only report "Planning COMPLETE" if:

• progress.documents_complete contains all 9 documents AND
• planning/crucible-thesis.md exists

Phase-Specific Options

Planning Phase

Use AskUserQuestion with these options:

• Continue planning (resume from current document/question)
• Review premise (check premise before continuing)
• Start fresh (begin with new premise)
• Something else

Resuming Planning with Saved Answers

When resuming a planning session, load and display the saved answers so the user knows their progress was preserved.

Step 1: Load State Read the planning state file to get saved answers and progress (check new location first, then legacy):

# New location (preferred)
cat <project_path>/.crucible/state/planning-state.json

# Legacy location (fallback)
cat <project_path>/state.json

Step 2: Display Progress Show the user what has been answered:

Resuming your planning session...

**Progress:** Document [X] of 9, Question [Y]
**Questions Answered:** [N] of ~75

**Previously saved answers:**
- Burden: [saved value]
- Fire: [saved value]
- Core Bond: [saved value]
...

Step 3: Reference Previous Answers When continuing questions, reference the saved answers to maintain coherence:

• "Based on your previous answer that the burden is [saved value]..."
• "Building on the fire type you chose ([saved value])..."

Step 4: Resume at Correct Position Use the progress.current_document and progress.current_question to start from exactly where the user left off.

Example Resume Message:

Resuming planning session for "[Project Title]"

Progress: Document 3 (Fire Strand) - Question 4 of 7
Total answered: 23 of ~75 questions

Your story so far:
- Burden: Physical object of power (an ancient artifact)
- Fire: Magical ability that corrupts with use
- Core Bond: Sworn friendship (battle-brother)
- [...]

Continuing with Fire Strand questions...

This ensures users see their work was saved and can pick up exactly where they stopped.

Outlining Phase

Use AskUserQuestion with these options:

• Continue outlining (resume from current chapter)
• Review previous (check previous chapter first)
• See full status (view outline progress)
• Something else

Writing Phase

Use AskUserQuestion with these options:

• Continue writing (resume from current scene)
• Review previous (check previous scene first)
• See full status (view writing progress)
• Something else

Editing Phase

Use AskUserQuestion with these options:

• Continue editing (resume from current chapter)
• Review changes (see what has been edited)
• See full status (view editing progress)
• Something else

Prerequisites

Requires an existing Crucible project with state files.