Claude Project Planner
An AI-powered project planning toolkit that combines deep research with comprehensive software architecture design. Generate complete project specifications, architecture documents, sprint plans, building blocks, cost analyses, and implementation roadmaps—all backed by real-time research and verified data.
Project Planner breaks down complex software projects into Claude Code-buildable components, enabling incremental delivery with clear specifications and acceptance criteria.
Key Features
📋 Project Planning
- Building Blocks - Decompose projects into discrete, buildable components
- Sprint Planning - User stories with INVEST criteria and capacity management
- Architecture Design - C4 model diagrams, ADRs, technology research
- Implementation Roadmaps - Milestones, dependencies, critical path
💰 Cost & Risk Analysis
- Service Cost Estimation - AWS, GCP, Azure pricing with ROI projections
- Risk Assessment - Risk registers with scoring and mitigation strategies
- Feasibility Analysis - Technical, resource, and market viability
🔍 Research-Backed
- Technology Research - Stack comparisons with real benchmarks
- Competitive Analysis - Market positioning and differentiation
- AI-Powered Diagrams - C4, sequence, ERD, deployment diagrams via Nano Banana Pro
📣 Go-to-Market (New in v1.0.6)
- Marketing Campaign Planning - Social media strategy and content calendars
- Platform Playbooks - LinkedIn, X/Twitter, Instagram, TikTok strategies
- Influencer Strategy - Tier framework and outreach templates
Quick Start
Prerequisites
- Python 3.10-3.12
ANTHROPIC_API_KEY(required)OPENROUTER_API_KEY(optional, for research-lookup and diagrams)
Installation
Option 1: Claude Code Plugin (Recommended) ⭐
# Add the plugin marketplace
/plugin marketplace add https://github.com/flight505/claude-project-planner
# Install the plugin
/plugin install claude-project-planner
# Restart Claude Code when prompted
Option 2: Install from PyPI
pip install project-planner
Option 3: Install from source
git clone https://github.com/flight505/claude-project-planner.git
cd claude-project-planner
uv sync
Configure API Keys
# .env file (recommended)
echo "ANTHROPIC_API_KEY=your_key" > .env
echo "OPENROUTER_API_KEY=your_openrouter_key" >> .env
# or export in your shell
export ANTHROPIC_API_KEY='your_key'
Usage
Commands
After installing the plugin, use these commands:
| Command | Description |
|---|---|
/full-plan | Complete project planning - runs all 6 phases (market research, architecture, feasibility, sprints, marketing, review) |
/tech-plan | Technical planning only - architecture, costs, risks, sprints (no marketing) |
/project-planner:setup | Configuration wizard - detect/configure API keys |
Plugin Usage (Recommended)
After installing the plugin, simply ask Claude:
# Full project planning (or use /full-plan)
> Plan a B2B SaaS inventory management system with multi-tenant architecture,
PostgreSQL database, React frontend, and deployment on AWS.
# Architecture research
> Research the best technology stack for a real-time collaboration app.
Compare WebSockets vs SSE vs polling for our use case.
# Building blocks specification
> Break down an e-commerce platform into buildable components.
Include user authentication, product catalog, cart, checkout, and admin dashboard.
# Sprint planning
> Create a sprint plan for the authentication service.
Include user registration, login, OAuth, and password reset features.
# Cost analysis
> Estimate monthly infrastructure costs for a SaaS app with 10,000 users.
Consider compute, database, storage, and third-party services.
# Risk assessment
> Identify technical and business risks for migrating from monolith to microservices.
Include mitigation strategies and contingency plans.
# Marketing campaign (NEW)
> Create a product launch campaign for our developer tool.
Include content calendar, platform strategies, and influencer outreach.
CLI Usage
# If installed via pip
project-planner
# If installed from source with uv
uv run project-planner
Python API
import asyncio
from project_planner import generate_project