project-planning

Generate PVS, ADR, Tech Spec, and Roadmap documents from a project concept.

2|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/williaby/image-preprocessing-detector --skill project-planning-williaby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-planning
Source: https://github.com/williaby/image-preprocessing-detector/tree/main/.claude/skills/project-planning
Command: npx skills add https://github.com/williaby/image-preprocessing-detector --skill project-planning-williaby

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, uv, mcp__zen__consensus, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Starting a new project or feature often lacks structured planning, leading to architectural drift, inconsistent decisions, and unclear roadmaps. This skill automates the generation of essential planning documents, providing a solid foundation for AI-assisted development.

Core Features & Use Cases

  • Comprehensive Document Generation: Creates Project Vision & Scope (PVS), Architecture Decision Records (ADRs), Technical Specifications, and Development Roadmaps.
  • Consensus-Driven Review: Integrates with multi-model AI for expert review and feedback on generated plans, ensuring quality and alignment.
  • Context Coherence: Ensures planning documents are consistent, cross-referenced, and prevent architectural drift throughout the development lifecycle.
  • Use Case: You have a new project idea for a personal finance CLI tool. This skill can generate all initial planning documents, including a phased roadmap, key architectural decisions (like database choice), and a detailed technical specification, ensuring a solid foundation before coding begins.

Quick Start

Generate project planning documents for a new CLI tool to manage personal finances.

Frequently Asked Questions about project-planning

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

FAQPage Schema
How do I generate project planning documents from a concept?

Project planning documents—PVS, ADRs, technical specs, and roadmaps—transform a concept into structured outputs. This skill generates all four in one pass, cross-referenced and ready for consensus review, eliminating manual planning overhead at project kickoff.

What should I document before starting development?

Architecture Decision Records (ADRs) and technical specifications establish decision rationale and implementation detail before code begins. They prevent architectural drift, align teams on trade-offs, and provide reference points for AI-assisted development workflows.

Can I generate a roadmap and technical specification together?

Yes. This skill produces phased development roadmaps alongside detailed technical specifications in a single workflow, ensuring roadmap milestones align with spec requirements and architectural decisions are documented at each phase.

How do I ensure planning documents stay coherent across phases?

Cross-referenced documents with versioned ADRs, required headings, and validation steps maintain consistency across phases. Consensus-driven review via multi-model feedback catches misalignment early and keeps documents aligned throughout the project lifecycle.

What's included in a project vision and scope document?

Project Vision & Scope (PVS) defines goals, constraints, and stakeholder expectations with an executive TL;DR. It serves as the anchor for all downstream planning outputs—roadmaps, specs, and architectural decisions—ensuring alignment from kickoff onward.

Do I need Python and uv to run project planning?

Yes. Python 3 and uv are required dependencies. The skill also integrates consensus-driven review via mcp__zen__consensus for multi-model feedback on generated planning documents.