Skip to content

gpsaggese/helpers / .claude/skills/project.create_plan

project.create_plan

Verified

Write the end-to-end plan of a project from its design docs

FileKindSize
SKILL.mdskill md3.0 KB
---
description: Write the end-to-end plan of a project from its design docs
model: opus
---

# Goal

- Given the PRD and design docs, write `docs/04-plan.md`: what to build, in which
  order, as versions and PRs
- Do not implement code and do not create GitHub issues

## Input

- `<DESIGN>`: the design overview, e.g., `docs/02-design.architecture.md`
- `<DOCS_DIR>`: the `docs/` dir of the project, optional
  - If missing, use the dir of `<DESIGN>`

# Workflow

## Read the Inputs

- Read `<DESIGN>`, the other `02*-design.*.md` files, and `<DOCS_DIR>/01-prd.md`
- If `<DOCS_DIR>/04-plan.md` exists, extend it instead of replacing it

## Ask If the Design Is Unclear

- If the scope or the order of the work is not perfectly clear:
  - Do not write the plan
  - Ask the user for clarification
  - Wait for the answers

## Split Into Versions

- Split the work into versions. Each version must run and be demoable
- Order versions so that each needs only the versions before it
- Put components and their open questions in "Component Specs"

## Write the PR Entries

- Write the PR entries of the next version in detail
- Keep later versions as a few bullets
- Name PRs `PR_<component letter><number>`. Never reuse an id, per
  `.claude/skills/project.rules.md` section "Name the PRs"
- Mark each PR that needs a spec. It gets one later with
  `.claude/skills/auto_task.create_plan_for_feature/SKILL.md`
- Order PRs by dependency first, then by increasing complexity

## Write the Plan File

- Create `<DOCS_DIR>/04-plan.md`
- Follow `.claude/skills/project.rules.md` section "Plan File"
- Follow the template `.claude/templates/project_plan.template.md`
- Follow `.claude/skills/markdown.rules.md` and `.claude/skills/text.rules.md` when
  writing text
- Add the execution part only if the user says several people work in parallel
- If `<DOCS_DIR>/07-progress.md` does not exist, create it from
  `.claude/templates/project_progress.template.md`

## Update the Index

- Add a row for each new doc to `<DOCS_DIR>/README.md`, if the file exists

# Conventions

- Follow `.claude/skills/project.rules.md` for project docs
- Follow `.claude/skills/markdown.rules.md` and `.claude/skills/text.rules.md`
- Say in each file you create how it was generated, with this line right after the
  title:
  ```markdown
  - Generated by `.claude/skills/project.create_plan/SKILL.md`
  ```

# Constraints

- Do not implement any code
- Do not create GitHub issues. They are filed only for the next version, when the
  work starts
- Do not copy content from the PRD or the design docs. Point to it
- Do not commit any change

# Verification

- [ ] Every version is a deliverable that a person can run or demo
- [ ] Every PR has a stable id and a checkbox
- [ ] Every PRD requirement is covered by at least one PR
- [ ] Every requirement id in the plan is a link to its H3 in the PRD
- [ ] No PR appears before a PR it depends on
- [ ] Every open question is numbered
- [ ] The next version has detailed PR entries
- [ ] Each file you create says it was generated by
      `.claude/skills/project.create_plan/SKILL.md`
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall