A Claude Code plugin for requirements-first development. Separates project requirements, feature planning, and implementation into distinct phases — so Claude asks the right questions before writing any code.
Questions are presented as interactive multiple-choice selections — no walls of text to read and respond to.
Claude is eager to help. Sometimes too eager. Given a vague prompt like "build me an API," it will pick a framework, invent a schema, guess at auth, and hand you 200 lines of code built on assumptions you never agreed to.
thorough fixes this with three commands:
| Command | Purpose |
|---|---|
/thorough:sketch |
Create a full project requirements document |
/thorough:plan |
Plan a specific feature for implementation |
/thorough:code |
TDD implementation of a planned feature |
Creates a comprehensive requirements document (REQUIREMENTS.md) tailored to your specific project. Unlike fixed templates, it:
- Analyzes your request to determine what kind of software you're building (web app, CLI, API, library, etc.)
- Generates project-specific categories — a web app gets Pages & Navigation; a CLI gets Commands & Flags; an API gets Endpoints & Auth. No irrelevant sections.
- Asks targeted questions through interactive multiple-choice, in priority rounds
- Checks feasibility before committing to the spec
- Writes a structured requirements document with user stories, data model, scope boundaries, and acceptance tests
Plans a specific feature or user story from the requirements document:
- Reads
REQUIREMENTS.mdand extracts everything relevant to the feature - Clarifies feature-specific details that the requirements doc left open
- Explores the codebase for patterns, conventions, and related implementations
- Produces an implementation plan with file list, build order, test plan, and edge cases
Implements the planned feature using strict Test-Driven Development:
- Breaks the plan into implementable units ordered by dependency
- For each unit: write failing tests → run → write minimal code → run → refactor
- Verifies against acceptance criteria from the plan
- Stops and asks if anything becomes unclear mid-implementation
- Claude Code CLI installed and working
/plugin marketplace add yasinishyn/claude-thorough
/plugin install thorough@yasinishyn-claude-thorough
/reload-plugins
git clone https://github.com/yasinishyn/claude-thorough.git /tmp/thorough
mkdir -p ~/.claude/skills/sketch ~/.claude/skills/plan ~/.claude/skills/code
cp /tmp/thorough/skills/sketch/SKILL.md ~/.claude/skills/sketch/SKILL.md
cp /tmp/thorough/skills/plan/SKILL.md ~/.claude/skills/plan/SKILL.md
cp /tmp/thorough/skills/code/SKILL.md ~/.claude/skills/code/SKILL.mdWith this method skills are invoked as /sketch, /plan, /code (no namespace prefix).
git clone https://github.com/yasinishyn/claude-thorough.git /tmp/thorough
mkdir -p .claude/skills/sketch .claude/skills/plan .claude/skills/code
cp /tmp/thorough/skills/sketch/SKILL.md .claude/skills/sketch/SKILL.md
cp /tmp/thorough/skills/plan/SKILL.md .claude/skills/plan/SKILL.md
cp /tmp/thorough/skills/code/SKILL.md .claude/skills/code/SKILL.md
git add .claude/skills/
git commit -m "Add thorough skills"Start a new Claude Code session and run:
/thorough:sketch build me a website
If installed correctly, Claude will analyze your request and present interactive questions instead of writing code.
# Step 1: Define the project
/thorough:sketch build me a website where I can add RSS feeds and it generates a newsletter
# (Answer interactive questions across multiple rounds)
# (Review REQUIREMENTS.md — edit if needed)
# Step 2: Plan a feature
/thorough:plan add RSS feed management
# (Review the implementation plan)
# Step 3: Implement
/thorough:code
# Step 4: Plan the next feature
/thorough:plan generate newsletter from articles
# ...and so on
/thorough:sketch -f parse this CSV and dump it to JSON
Skips all phases, states assumptions upfront, and writes the document immediately.
These phrases also activate /thorough:sketch:
- "be thorough"
- "think it through"
- "don't assume"
- "plan this out"
- "interrogate the requirements"
claude-thorough/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace manifest for distribution
├── skills/
│ ├── sketch/
│ │ └── SKILL.md # Project requirements document creation
│ ├── plan/
│ │ └── SKILL.md # Feature planning
│ ├── code/
│ │ └── SKILL.md # TDD implementation
│ └── ask/
│ └── SKILL.md # Internal: interactive questioning tool
├── README.md
└── LICENSE
MIT