Finalize Plan
Add action frontmatter and present the executable plan to user
4
IMPORTANT: You MUST add _action frontmatter to make the plan executable.
Convert each step into a todo item and add the frontmatter block at the top:
---
_action:
label: "Run Now"
prompt: "Execute this plan step by step. For each todo, complete the step described, then mentally mark it complete before moving to the next. Stop if you encounter a blocker and report it."
isComplete: false
name: [Plan title from the draft]
overview: [One-line summary of the goal]
todos:
- id: step-1
content: [Step 1 description from the draft]
status: pending
- id: step-2
content: [Step 2 description from the draft]
status: pending
[Continue for all steps...]
---Keep the full plan content below the frontmatter (Goal, Scope, Steps, Success Criteria).
Write the finalized plan to Plan Draft.
5
Present the plan to the user.
The plan file now has _action frontmatter, so Sauna will display it as a preview card
with a "Run Now" button.
In your message to the user:
- Briefly summarize what the plan will accomplish
- Highlight any decisions or assumptions they should review
- Note any "Needs user action" items they must handle
- Let them know they can edit the plan before clicking "Run Now"
Example message:
"Here's your plan to [goal]. It has [N] steps and should [outcome].
Review the scope section—I've marked [X] as out of scope. Let me know
if you'd like to adjust anything before running it."
You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple CONSECUTIVE read steps in a row, read them all at once (in parallel). Otherwise, do not read a file until you reach that step.
Add all steps to your todo list now and begin executing.
## Steps
1. [Read Plan Draft]: Read the file at `session/plan-draft.md` into context (The drafted plan to finalize)
2. [Read Plan Template]: Read the documentation in: `skills/sauna/[skill_id]/references/project.plan.template.md` (Full template with _action frontmatter format)
3. [Read External Actions Guide]: Read the documentation in: `skills/sauna/[skill_id]/references/sauna.actions.external.md` (CRITICAL: The _action pattern for external actions - read immediately before adding frontmatter)
4. IMPORTANT: You MUST add _action frontmatter to make the plan executable.
Convert each step into a todo item and add the frontmatter block at the top:
```yaml
---
_action:
label: "Run Now"
prompt: "Execute this plan step by step. For each todo, complete the step described, then mentally mark it complete before moving to the next. Stop if you encounter a blocker and report it."
isComplete: false
name: [Plan title from the draft]
overview: [One-line summary of the goal]
todos:
- id: step-1
content: [Step 1 description from the draft]
status: pending
- id: step-2
content: [Step 2 description from the draft]
status: pending
[Continue for all steps...]
---
```
Keep the full plan content below the frontmatter (Goal, Scope, Steps, Success Criteria).
Write the finalized plan to `session/plan-draft.md`.
5. Present the plan to the user.
The plan file now has _action frontmatter, so Sauna will display it as a preview card
with a "Run Now" button.
In your message to the user:
1. Briefly summarize what the plan will accomplish
2. Highlight any decisions or assumptions they should review
3. Note any "Needs user action" items they must handle
4. Let them know they can edit the plan before clicking "Run Now"
Example message:
"Here's your plan to [goal]. It has [N] steps and should [outcome].
Review the scope section—I've marked [X] as out of scope. Let me know
if you'd like to adjust anything before running it."