ghwf3-plan_skill

Overview

This skill generates an implementation plan document (03_PLAN.md) from an existing specification and project context. It automates reading the kickoff and spec files, analyzing the repository and issue discussion, and producing a structured plan ready for commit. The skill also updates repository state, PR checklist, and workflow labels to advance the work item.

How this skill works

The skill loads active work context from state.json and reads 01_KICKOFF.md and 02_SPEC.md, then fetches the related issue body and comments using the GitHub CLI. It analyzes the codebase structure to determine impacted files, dependencies, and risks, and fills the 03_PLAN.md template with ordered implementation steps, file change details, dependencies, and risk assessment. Finally it commits and pushes the new plan, updates PR checklist and labels, and writes the updated workflow state.

When to use it

• After ghwf2-spec is completed and 02_SPEC.md exists
• When a concrete implementation roadmap is needed before coding
• To convert discussion and spec details into actionable steps and file changes
• When you want an auditable plan committed to the repo and workflow state advanced

Best practices

• Ensure 02_SPEC.md and 01_KICKOFF.md are accurate and up to date before running
• Review issue comments and resolve ambiguities in the spec prior to plan creation
• Keep the plan focused on minimal viable implementation steps with clear order
• List explicit file-level changes and dependencies to make reviews efficient
• Run the update or revise commands to iteratively refine the plan based on feedback

Example use cases

• Generate a first-pass implementation plan after spec sign-off to kick off development
• Update the plan interactively when new constraints or comments appear in the issue
• Revise the plan after stakeholder feedback to reflect scope or risk changes
• Produce a risk-assessed checklist for reviewers to validate before PR approval