home / skills / shotaiuchi / dotclaude / ghwf3-plan

ghwf3-plan skill

safe

This skill generates a complete implementation plan from specifications, creating a 03_PLAN.md with steps, file changes, dependencies, and risk assessment.

npx playbooks add skill shotaiuchi/dotclaude --skill ghwf3-plan

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.3 KB

---
name: ghwf3-plan
description: 実装計画ドキュメントを作成
argument-hint: "[update | revise]"
context: fork
agent: general-purpose
---

**Always respond in Japanese. Write all workflow documents (*.md) in Japanese.**

# /ghwf3-plan

仕様書から実装計画を作成する。

## Usage

```
/ghwf3-plan           # 新規作成
/ghwf3-plan update    # 対話形式で更新
/ghwf3-plan revise    # フィードバックに基づいて更新
```

## Prerequisites

- `ghwf2-spec` 完了済み
- `02_SPEC.md` が存在

## Processing

### 1. Load Context

- Read `state.json` for active work
- Read `01_KICKOFF.md`, `02_SPEC.md`
- Fetch Issue with comments:
  ```bash
  gh issue view <issue> --json body,comments
  ```
- Analyze codebase structure

### 2. Create 03_PLAN.md

- Template: `~/.claude/templates/03_PLAN.md`
- Sections:
  - Implementation Steps (ordered)
  - File Changes
  - Dependencies
  - Risk Assessment

### 3. Commit & Push

**Execute immediately without confirmation:**

```bash
git add docs/wf/<work-id>/03_PLAN.md
git commit -m "docs(wf): create plan <work-id>"
git push
```

### 4. Update PR & Labels

- PR チェックリスト更新
- `ghwf:step-3` ラベル追加

### 5. Update State

```json
{
  "current": "ghwf3-plan",
  "next": "ghwf4-review",
  "last_execution": "<ISO8601>"
}
```

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

FAQ

Will the skill make commits automatically?

Yes. The skill stages, commits, and pushes 03_PLAN.md immediately using a predefined commit message.

What files does it read to build the plan?

It reads state.json, 01_KICKOFF.md, 02_SPEC.md and fetches the related GitHub issue body and comments, then inspects the repository structure.

How does it update workflow state?

It writes the new current/next step and last_execution timestamp into state.json and adds the ghwf:step-3 label and PR checklist updates.