deep-work-workflow

Orchestrate multi-phase software development workflows with TDD enforcement and git worktree support.

10|1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Sungmin-Cho/claude-deep-work --skill deep-work-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-work-workflow
Source: https://github.com/Sungmin-Cho/claude-deep-work/tree/main/skills/deep-work-workflow
Command: npx skills add https://github.com/Sungmin-Cho/claude-deep-work --skill deep-work-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces a structured, evidence-driven development flow to prevent premature coding, architectural drift, duplicate implementations, and unverified changes when working on complex multi-file tasks.

Core Features & Use Cases

  • Phase-based orchestration: Brainstorm → Research → Plan → Implement → Test with hard phase gates that block file writes until plan approval.
  • TDD & sensors: Enforces TDD state machine (RED→GREEN), runs linters/typechecks, mutation testing, and collects receipts for every slice.
  • Worktree & session management: Git worktree forks, session state files, phase review gates, cross-model reviews, and automatic reporting.
  • Use Case: Ideal for adding a new feature that touches many modules or performing an architectural refactor where research, a reviewed plan, and strict verification are required before code changes.

Quick Start

Run /deep-work followed by a concise task description to start the Brainstorm → Research → Plan → Implement → Test flow and approve the plan to begin automated implementation.

Frequently Asked Questions about deep-work-workflow

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

FAQPage Schema
How do I enforce a TDD workflow for complex multi-file refactoring?

To enforce a TDD workflow for multi-file refactoring, this Skill orchestrates a structured phase sequence from Brainstorm to Test, blocking file writes until a plan is approved and enforcing strict RED to GREEN state transitions for every code slice.

What is an evidence-driven development workflow and when do I need it?

An evidence-driven development workflow requires verified receipts and passing sensors before advancing phases. You need it for complex multi-file engineering tasks to prevent architectural drift, duplicate implementations, and unverified code changes.

How do I prevent premature coding when adding a new feature across many modules?

You can prevent premature coding across modules by applying hard phase gates that block file writes until the Research and Plan phases are complete, ensuring structured brainstorming and plan approval occur first.

Can I use git worktrees to isolate feature development during a strict phase-gated workflow?

Yes, you can use git worktrees to isolate feature development. This Skill supports git worktree forks and session state files to manage isolated contexts alongside phase review gates and cross-model reviews.

What's the best way to verify code quality and prevent unverified changes in large tasks?

The best way to verify code quality in large tasks is to run mutation testing, linters, and typechecks while collecting receipts for every implemented slice, ensuring no unverified changes advance past the Test phase.

When should I not use a strict phase-gated TDD workflow?

You should not use a strict phase-gated TDD workflow for simple, single-file edits or rapid prototyping where the overhead of brainstorm, research, plan, and test phases outweighs the need for strict architectural verification.