project-plan · git:20260712.7e3d1bb · 2026-07-12 · sha256 f28c0264de470b6a

project-plan git:20260712.7e3d1bbA

Immutable. This exact content never changes and is served at /api/v1/blob/f28c0264de470b6a.

---
name: project-plan
argument-hint: "[project or product name]"
description: Create a project delivery plan covering scope, milestones, timeline, work breakdown, resourcing, stakeholder roles (RACI), dependencies, and a project-level risk register. Use at the start of any project to define who is building what, in what order, by when - before any code is written.
intent: >-
  Produce the top-level delivery plan that every other document in this suite hangs off of. A technical specification defines what the system must do; an architecture document defines how it is structured; this document defines who does the work, in what sequence, against what timeline, and what could derail it. Projects rarely fail from lack of technical skill - they fail from unclear ownership, undiscovered dependencies, and unscoped risk. This is a project-management artifact, not an engineering one: it applies Work Breakdown Structure (WBS) decomposition, milestone-based planning, and a RACI matrix to remove ambiguity about ownership before it causes delay.
type: workflow
theme: engineering-docs
best_for:
  - "Kicking off any new project or major initiative before implementation planning begins"
  - "Establishing milestones and a delivery timeline that stakeholders outside engineering can track"
  - "Clarifying who owns what when multiple people or teams are involved"
  - "Surfacing schedule, resource, and scope risks before they become delays"
scenarios:
  - "Create a project plan for building a new customer support ticketing platform from scratch"
  - "We're a team of 4 - write a project plan with milestones and a RACI matrix for our mobile app rewrite"
  - "Plan the delivery timeline and dependencies for migrating our monolith to a new framework"
estimated_time: "1-2 hours"
license: MIT
compatibility: Designed for Gemini (Antigravity), Claude Code, Cursor/Windsurf, Kimi Code, Codex/Copilot
---

## Purpose

Produce a project plan that defines scope, milestones, timeline, ownership, dependencies, and risk at the delivery level - the document that answers "what are we building, in what order, who owns each part, and by when" for anyone tracking the project, not just the engineers building it.

**This is not a technical design document.** It does not specify how any single component works - it specifies the shape and sequence of the overall effort so that individual technical-blueprint and implementation-plan documents have a timeline and ownership structure to slot into.

## Input

**Works best with:** The name of the project and a description of its overall goal and scope.
**Also valuable:** Team size and roles, hard deadlines or launch dates, budget constraints, known dependencies on other teams or vendors, prior similar projects and how long they took.

**Example invocation:** `Create a project plan for building a subscription-billing SaaS product from scratch. Team of 3 engineers, 1 designer, 1 PM. Target: usable beta in 3 months. No hard external deadline but investors expect a demo by month 4.`

## Key Concepts

### Work Breakdown Structure (WBS)
Decompose the project into progressively smaller deliverables until each leaf item is small enough to estimate confidently (typically 1 day - 2 weeks of work). A WBS is a tree, not a flat list: Project → Phases → Workstreams → Deliverables → Tasks.

### Milestone-Based Planning
Milestones are dated, binary (done/not-done) checkpoints tied to a deliverable a stakeholder can actually see or use - not "50% done with backend." Every milestone needs an explicit Definition of Done.

### RACI Matrix
For every major deliverable, assign:
- **Responsible** - does the work
- **Accountable** - owns the outcome; exactly one person per deliverable
- **Consulted** - provides input before decisions
- **Informed** - notified after decisions

Ambiguous ownership (two people "Accountable," or nobody) is the single most common cause of stalled work - resolve it explicitly.

### Dependency and Critical Path Mapping
Identify which deliverables block others. The critical path is the longest chain of dependent tasks - it determines the earliest possible finish date regardless of how much parallel work happens elsewhere. Compressing the timeline requires shortening the critical path specifically, not adding effort anywhere.

### Project-Level Risk Register
Distinct from a security threat model or technical risk - this covers schedule risk (key person unavailable, estimate wrong), resource risk (budget cut, hiring delay), scope risk (requirements change mid-flight), and external risk (vendor delay, dependency on another team).

## Application

### Phase 1: Socratic Clarification & Brainstorming (Mandatory Interview)
Before writing any project plan, you MUST interrogate the user's initial input, identify gaps, and ask **3-5 targeted clarifying questions** to dig deeper. Do NOT generate the template yet.
Ask questions to resolve:
1. **Scope boundary**: What must exist at launch versus what can wait for a later phase?
2. **Team and constraints**: Who is actually available to do the work, and what is their capacity (full-time, part-time, shared across projects)?
3. **Hard dates**: Are there any externally fixed dates (investor demo, contractual deadline, event) versus soft target dates?
4. **Known dependencies**: Does this project depend on another team, a vendor, a not-yet-built piece of infrastructure, or a decision still pending elsewhere?
*Wait for the user's response to these questions before drafting the final project plan.*

### Phase 2: Scope and WBS (30-45 min)
Define what is in and out of scope, then decompose into a Work Breakdown Structure down to estimable deliverables.

### Phase 3: Milestones and Timeline (30 min)
Group deliverables into dated milestones with explicit Definition of Done. Sequence them against team capacity.

### Phase 4: RACI and Ownership (20 min)
Assign Responsible/Accountable/Consulted/Informed for every major deliverable. Flag any deliverable with unclear or dual ownership.

### Phase 5: Dependency and Critical Path Mapping (20 min)
Map which deliverables block others. Identify the critical path and the milestones most exposed to delay.

### Phase 6: Risk Register (20 min)
Identify schedule, resource, scope, and external risks with likelihood, impact, and a mitigation or contingency for each.