One-click install
npx skills add https://github.com/bonjohen/claude-local --skill phase-bonjohen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase
Source: https://github.com/bonjohen/claude-local/tree/main/bundle/skills/phase
Command: npx skills add https://github.com/bonjohen/claude-local --skill phase-bonjohen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill executes the next unfinished item in a CLAUDE “Stage 4” phase loop, updating the authoritative plan file as it starts and completes each row.

Core Features & Use Cases

  • Plan-driven execution: Finds the current phase and selects the next appropriate row (resuming Started or taking the topmost Open row), while skipping Blocked rows and reporting blockers.
  • Accurate status + timestamps: Marks the chosen row as Started with a PST timestamp, then verifies the changes, and finally marks it Completed with a fresh PST timestamp.
  • Phase completion workflow: When all rows in the phase are complete, writes a Phase Summary block and stages a commit without pushing.

Quick Start

Ask the phase skill to execute the next available row in the most recently modified docs/*_plan.md.

Frequently Asked Questions about phase

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

FAQPage Schema
How do I automate plan execution and track row status in a markdown file?

Plan execution automation reads a markdown plan file, selects the next unfinished row, updates its status with PST timestamps, performs the scoped work, and verifies results before marking it complete. It resumes started rows or takes the topmost open row while skipping blocked items.

How does state management work for resumable phase loops across sessions?

Resumable phase loops persist state by writing Started and Completed transitions with timestamps directly to the plan file immediately after each change. This allows workflows to resume the first incomplete phase seamlessly across different sessions without losing progress.

Can I target a specific plan file for workflow automation instead of the default?

Yes, workflow automation optionally targets a specified plan file for execution. By default it targets the most recently modified docs/*_plan.md file, but you can direct it to execute the next available row in any explicitly provided plan file path.

What happens when all rows in a phase loop are completed?

When all rows in a phase are completed, the workflow writes a Phase Summary block to the plan file and stages exactly one git commit without pushing. This ensures incremental file edits are captured safely in version control for each finished phase.

How do I handle blocked items when executing an iterative development workflow?

Iterative development workflows automatically skip rows marked as Blocked during plan execution and report the blockers to the user. The system selects the next available Open or Started row, ensuring blocked items do not halt the overall phase loop progress.

Do I need to manually stage git commits during phase loop execution?

No, manual git commit staging is unnecessary during phase loop execution. The workflow automatically stages exactly one commit per fully completed phase without pushing, capturing the incremental file edits and phase summary safely in local version control.