make-plan

Create feature plans in Markdown with YAML frontmatter using Shape Up principles.

20|11|Updated Sep 8, 2020
One-click install
npx skills add https://github.com/tomcounsell/ai --skill make-plan-tomcounsell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-plan
Source: https://github.com/tomcounsell/ai/tree/main/.claude/skills/make-plan
Command: npx skills add https://github.com/tomcounsell/ai --skill make-plan-tomcounsell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan creation and scoping for features using Shape Up principles, providing a reproducible workflow to turn ideas into structured plans and track progress.

Core Features & Use Cases

  • Creates standardized feature plans in docs/plans/ with sections for problem, appetite, solution, risks, and boundaries.
  • Enforces a frontmatter schema (status and type) for tracking and integration with GitHub or Notion tasks.
  • Supports an end-to-end planning workflow from initial draft to readiness, with prerequisites, risks, and team orchestration.

Quick Start

Create a new plan by outlining your feature idea and saving it to docs/plans/{slug}.md to begin Shape Up planning.

Frequently Asked Questions about make-plan

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

FAQPage Schema
How do I create a feature plan using Shape Up methodology?

To create a feature plan using Shape Up, define your problem statement, appetite, solution, risks, and boundaries, then save the structured document to docs/plans/{slug}.md. This ensures a reproducible workflow for scoping work.

What is a Shape Up plan document and what sections should it contain?

A Shape Up plan document is a standardized markdown file that structures feature scoping. It must contain sections for the problem statement, appetite, solution, risks, and boundaries to effectively turn ideas into tracked plans.

Does feature planning with Shape Up work with Notion and GitHub task tracking?

Yes, feature planning with Shape Up integrates with Notion and GitHub task tracking. The plan document enforces a YAML frontmatter schema with mandatory fields like status and type to enable seamless progress tracking.

What is the best way to scope new features for project management?

The best way to scope new features for project management is applying Shape Up principles to define boundaries, risks, and appetite. This produces a standardized plan document with prerequisites and success criteria for team orchestration.

How do I track the status of a Shape Up feature plan from draft to readiness?

Track the status of a Shape Up feature plan by updating the mandatory status field in the document's YAML frontmatter. This supports an end-to-end planning workflow from initial draft through readiness and team orchestration.

What do I need to start writing Shape Up project plans?

To start writing Shape Up project plans, you need an initial feature idea or concept to scope. You will save this input as a markdown file at docs/plans/{slug}.md to begin the structured planning workflow.