Write Plan

This is the planning half of a two-skill workflow that separates design from execution. It walks through context loading, clarification questions, and outputs a timestamped folder under docs/.plans with a SUMMARY.md and numbered phase files. Each phase gets complexity ratings, task checklists, and verification commands. The goal is a plan so self-contained that execute-plan can pick it up in a fresh session, even after /clear. It's opinionated about granularity (2-10 minute tasks), includes research folders when needed, and enforces a "no coding during planning" rule. Best for refactors, migrations, or anything risky enough that you want a reviewer or your future self to understand the strategy before touching production files.

skills.sh installs: 423
GitHub stars: 48
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add buiducnhat/agent-skills --skill write-plan --agent claude-code

Installs into .claude/skills of the current project.

Files

Write Plan

Overview

Produce a complete, self-contained implementation plan that can be executed by execute-plan with minimal ambiguity, even after /clear or by another agent.

This skill is for planning only:

Do not implement code
Do not modify production files (except plan artifacts)

Workflow

Step 1: Contextualize

Load only the project context relevant to the requested change:

If docs/SUMMARY.md exists, read it first.
Load only task-relevant detail docs.
Prioritize Code Standard docs for implementation conventions.
If docs conflict with code or user intent, use the available input/question tool before broad changes.

Then inspect only the code areas relevant to the requested change.

Capture:

User-visible purpose and expected outcome
Existing patterns to follow
Constraints and dependencies
Files, modules, commands, and docs that orient the executor
Risks, assumptions, and unknowns

Step 2: Initialize Plan Artifacts

Create: docs/.plans/YYMMDD-HHmm-<plan-slug>/
Create:
- SUMMARY.md
- one phase file per implementation phase with naming convention phase-XX-<name>.md
Add research/ only if needed.