deep-project

/deep-project, a Claude Code plugin

Blog posts:

• The Deep Trilogy - How the three plugins work together
• What I Learned - Technical lessons from plugin development

/deep-project transforms vague, high-level project requirements into well-scoped planning units through AI-assisted interview and decomposition. It ensures you've thought through every major component of the software you want to build and properly scoped them for thorough planning through /deep-plan.

This plugin is the first step in the deep planning pipeline. After decomposition, each unit can be fed to /deep-plan for comprehensive planning with research, external LLM review, and a TDD approach.

I built this after the first time I wanted to put a vague, broadly scoped software project through /deep-plan. I realized that at a certain level of broadness, for e.g., "Build me an app that does x y and z", that the optimal use of /deep-plan would be to split that vague idea into its distinct, major components and /deep-plan each of them. /deep-project is the plugin that allows you to give it very broad, vague ideas and have it tease out context and form the components that should each be /deep-planned.

TL;DR

/plugin marketplace add piercelamb/deep-project
/plugin install deep-project
/plugin enable deep-project
/deep-project @planning/requirements.md

Table of Contents

• Overview
• The Deep Trilogy
• Why deep-project?
• When to Use
• Quick Start
• How It Works
• Installation
• Usage
• Workflow Steps
• Output Files
• Requirements
• Best Practices
• Troubleshooting
• Testing
• Project Structure
• Contributing

Overview

deep-project orchestrates a decomposition workflow that breaks large projects into manageable pieces before detailed planning:

Interview → Split Analysis → Dependency Mapping → Directory Creation → Spec Generation

The plugin guides you through:

• Interview Phase: Structured Q&A to understand your mental model of the project
• Split Analysis: Determine if the project benefits from multiple planning units
• Dependency Discovery: Map relationships between splits
• Spec Generation: Create focused spec files for each unit

By the end, you have a planning directory with a project manifest and numbered split directories, each containing a spec file ready for /deep-plan.

The Deep Trilogy

This plugin is part of a three-plugin pipeline for turning ideas into production code:

/deep-project (decompose) → /deep-plan (plan) → /deep-implement (build)