tapania-5d-skills

5D Spec-Driven Development Skills

A comprehensive suite of Claude Code skills that implement the 5D Spec-Driven Development methodology—a structured approach to building software that prevents wasted effort by ensuring understanding before commitment at every level.

What Are Claude Code Skills?

Skills are extensions that teach Claude how to complete specific tasks in a repeatable, structured way. They consist of SKILL.md files containing instructions and workflows that Claude follows when invoked via /skill-name commands.

The 5D Framework

The methodology is built on five dimensions of thinking:

Dimension	Description
Width	Multiple domains (technical, business, user, ops, design)
Depth	Thinking levels (reactive → dogmatic → integrative → creative)
Height	Skill dependencies (what capabilities enable other capabilities)
Quadrants	Four perspectives (Individual/Collective × Inner/Outer)
Time	Evolution ("transcend and include" from current state)

Skills Overview

Main Orchestrator

Skill	Command	Description
5d-sdd	/5d-sdd	The complete methodology. Orchestrates the full workflow across all 10 phases from orientation to reflection. Use when starting a new project or feature that needs careful planning.

Foundational Thinking

Skill	Command	Description
5d-thinking	/5d-thinking	Strategic multi-dimensional thinking framework for analysis and problem-solving. Apply 5D thinking to analyze problems, generate insights, and avoid cognitive blind spots.

The 10 Development Phases

UNDERSTAND          DESIGN              BUILD               LEARN
───────────────     ───────────────     ───────────────     ───────────
0. ORIENT           2. PLAN             6. TASKS            9. REFLECT
1. SPAR             3. REFINE           7. BUILD
                    4. SPEC             8. VERIFY
                    5. GAP ANALYSIS

#	Phase	Command	What Happens	Output
0	Orient	/5d-orient	Map domains, surface assumptions, identify stakeholders	Orientation Summary
1	Spar	/5d-spar	Challenge thinking through structured dialogue, find blind spots	SPAR Summary
2	Plan	/5d-plan	Crystallize into concrete plan with assumptions made explicit	PLAN.md
3	Refine	/5d-refine	Stress-test plan through adversarial review and edge cases	Refinement Summary
4	Spec	/5d-spec	Formalize technical specification with architecture decisions	SPEC.md
5	Gap Analysis	/5d-gap-analysis	Identify all required changes across all quadrants	Gap Analysis
6	Tasks	/5d-tasks	Sequence gaps into executable, right-sized tasks	Task List
7	Build	/5d-build	Implement with spec fidelity and quality awareness	Working code
8	Verify	/5d-verify	Multi-layer verification (technical, spec, plan, epistemic)	Verification Report
9	Reflect	/5d-reflect	Extract learning, identify process improvements	Retrospective

Installation

Option 1: Plugin Marketplace (Recommended)

Install directly from the Claude Code plugin marketplace:

# Step 1: Add the marketplace
/plugin marketplace add tapania/5d-skills

# Step 2: Install the plugin
/plugin install 5d-skills@tapania-5d-skills

Or use the interactive plugin manager:

# Opens interactive UI to browse and install
/plugin

Then navigate to the Marketplaces tab, add tapania/5d-skills, and install from the Discover tab.

Requirements: Claude Code version 1.0.33 or later (claude --version to check)

Option 2: Project-Level

Copy the skills/ directory to your project's .claude/ folder:

git clone https://github.com/tapania/5d-skills.git
cp -r 5d-skills/skills/ your-project/.claude/skills/

Option 3: Personal (All Projects)

Copy to your personal Claude Code skills directory:

git clone https://github.com/tapania/5d-skills.git
cp -r 5d-skills/skills/* ~/.claude/skills/

Usage

Full Workflow

For new features or projects, run phases sequentially:

/5d-orient → /5d-spar → /5d-plan → /5d-refine → /5d-spec → /5d-gap-analysis → /5d-tasks → /5d-build → /5d-verify → /5d-reflect

Each phase has exit criteria. Don't proceed until criteria are met.

Partial Workflows

Use individual phases when appropriate: