builder-resume

Load the current plan and validate its directory to resume work.

1|Updated Aug 6, 2022
One-click install
npx skills add https://github.com/wormholecowboy/.dotfiles --skill builder-resume
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: builder-resume
Source: https://github.com/wormholecowboy/.dotfiles/tree/main/claude-config/skills/builder-resume
Command: npx skills add https://github.com/wormholecowboy/.dotfiles --skill builder-resume

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you resume the current plan and reload context, enabling a seamless transition into a fresh session without losing progress.

Core Features & Use Cases

  • Context restoration: loads the active plan from the current-plan pointer and reads plan artifacts (state.yaml, main.md, impl/.md, reviews/.md) to restore status and context.
  • Status presentation: displays task statuses, escalations, and blockers to guide next actions.
  • Planning mode activation: automatically transitions the environment into planning mode ready for builder commands.

Quick Start

Use the /builder-resume command to resume the current plan and load context for a fresh session.

Frequently Asked Questions about builder-resume

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume a plan and reload context in a fresh Claude session?

To resume a plan and reload context in a fresh Claude session, use the /builder-resume command. It loads the active plan from the .current-plan pointer, reads plan artifacts, and activates planning mode.

What plan artifacts are read to restore task status and progress?

Plan artifacts read to restore task status include state.yaml, main.md, impl/*.md, and reviews/*.md. These files are loaded from the validated plan directory to summarize progress and display task statuses.

How does planning mode handle escalations and blockers when resuming a session?

Planning mode handles escalations and blockers by reading state.yaml and review artifacts to highlight pending issues. It displays these blockers alongside task statuses to guide your next actions.

Do I need an existing plan directory to use the context restoration command?

Yes, you need an existing plan directory to use the context restoration command. The skill validates the corresponding plan directory and loads the current plan from .claude/skills/builder/.current-plan.

Can I restore task status from YAML state files when starting a new session?

Yes, you can restore task status from YAML state files when starting a new session. The skill reads state.yaml to summarize progress and validate the active plan before activating builder commands.

Why does my plan resume fail to load context in a new session?

A plan resume fails to load context if the .current-plan pointer is missing or the corresponding plan directory cannot be validated. Ensure state.yaml and main.md exist in the correct path.