By Sungmin-Cho
Orchestrates an evidence-driven development workflow across structured phases (brainstorm, research, plan, implement, test, integrate) with TDD enforcement, slice-based coding, automated verification gates, mutation testing, drift detection, and session receipt tracking. Manages worktrees for isolation and provides real-time quality sensors and code review.
Delegated implementation worker for deep-work's Implement phase. Receives a list of slice IDs to execute and runs the full TDD + Sensor + Slice Review protocol for each. Invoked by the deep-implement skill. <example> Context: solo implement — parent delegates all slices to one worker prompt: "cluster_ids=[SLICE-001,SLICE-002,SLICE-003]; sequential; tdd_mode=strict" </example> <example> Context: team implement with multiple subagents — each worker handles one cluster prompt: "cluster_ids=[SLICE-004]; tdd_mode=strict; evaluator_model=opus" </example>
Delegated research worker for deep-work's Research phase on existing codebases. Invoked by the deep-research skill (not by the user directly). Takes an area parameter and analyzes the corresponding codebase areas, writing findings to $WORK_DIR/research{-area}.md. <example> Context: parent skill runs Research in solo mode prompt (parent → agent): "area=full; work_dir=/.../deep-work; task=..." </example> <example> Context: parent skill runs Research in team mode, arch area prompt (parent → agent): "area=architecture; work_dir=...; task=..." </example>
Delegated research worker for deep-work's Research phase on NEW projects (project_type=zero-base). Takes an area parameter and researches technology choices, conventions, and data models — with explicit authority to search the web for up-to-date framework/library information. <example> Context: zero-base project, solo mode, full research prompt: "area=full; work_dir=/.../deep-work; task=Build a CLI for X" </example> <example> Context: zero-base, team mode parallel, tech-stack area prompt: "area=tech-stack; work_dir=...; task=..." </example>
Deep-work 세션 초기화 시 task description + workspace meta + capability를 분석하여 5개 ask 항목(team_mode, start_phase, tdd_mode, git, model_routing)에 대한 추천 값을 fenced JSON으로 반환합니다. <example> Context: 사용자가 "Refactor authentication module" task로 deep-work 호출 prompt: { "task_description": "Refactor authentication module", "workspace_meta": { "git_status": "clean", "recent_commits": [], "top_level_dirs": ["src", "tests"] }, "capability": { "git_worktree": true, "team_mode_available": true } } expected_output: ```json { "team_mode": { "value": "team", "reason": "리팩터 + 인증 = 다중 모듈 변경 예상" }, "start_phase": { "value": "research", "reason": "기존 코드 구조 파악 필요" }, "tdd_mode": { "value": "strict", "reason": "인증 모듈은 core 안정성 요구" }, "git": { "value": "worktree", "reason": "리팩터 범위 격리 필요" }, "model_routing": { "value": "default", "reason": "표준 흐름" } } ``` </example>
Use when the user wants to inspect deep-work's assumption health report — Wilson Score-based per-assumption confidence, verdict (justified / loosen / drop), model-aware split, and decay history. Triggers on `/deep-assumptions`, `/deep-status --assumptions`, "assumption health", "rule justification", "loosen enforcement", "어썸션 헬스", "규칙 정당화", "가정 검증". Reads session evidence to decide whether deep-work's hook denylist + receipt validation rules are still justified. Sub-page of the deep-status hub.
This skill should be used at Phase 0 of a deep-work session to explore the problem space before implementation — defining goals, success criteria, boundaries, and comparing 2-3 candidate approaches. Triggered when the /deep-work orchestrator enters brainstorm phase, when /deep-brainstorm is invoked directly, or via cross-platform Skill({ skill: "deep-work:deep-brainstorm", args: "..." }) to ideate on a task without writing code yet. Skippable via --skip-brainstorm.
Use when the user wants to scan and clean up stale deep-work git worktrees (`dw/*` branches) plus fork worktrees. Triggers on `/deep-cleanup`, "clean worktrees", "stale worktree", "worktree 정리", "fork 정리", "deep-work 정리". Scans `git worktree list`, classifies stale/active, offers per-worktree or batch deletion via AskUserQuestion, handles dirty trees with extra confirmation, and prunes `.claude/deep-work-sessions.json` registry for idle fork sessions.
Use when the user enters debug sub-mode during deep-work Phase 3 (Implement) to investigate root causes before applying fixes. Triggers on `/deep-debug`, "systematic debug", "root cause investigation", "디버그 모드", "근본 원인 분석", `verification_cmd` 실패 시 자동 진입, or "fix this" once iron-rule blocks guessing. Four phases: Investigate → Analyze → Hypothesize → Implement. Iron rule: NO fixes without root cause investigation first. Escalates to user after 3 invalidated hypotheses.
Use when the user finishes a deep-work session — merging, opening a PR, keeping the branch as-is, or discarding. Triggers on `/deep-finish`, "finish session", "wrap up session", "세션 마무리", "세션 종료", "PR 만들어줘", or orchestrator auto-call after Phase 5 (Integrate) completes. Emits an M3-envelope-wrapped `session-receipt.json` (and optionally a cross-plugin `handoff.json`). Supports `--skip-integrate` (Phase 5 bypass), `--handoff-to=<plugin>` / `--no-handoff` (post-finish handoff control).
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Uses power tools
Uses Bash, Write, or Edit tools
Uses power tools
Uses Bash, Write, or Edit tools
English | 한국어
An Evidence-Driven Development Protocol for Claude Code and Codex. A single command drives a full Brainstorm → Research → Plan → Implement → Test → Integrate workflow with TDD enforcement, receipt-based evidence collection, and a hard separation between planning and coding.
deep-work fights the common failure modes of AI coding on complex tasks: introducing new patterns that ignore the existing architecture, reimplementing utilities that already exist, jumping into code before understanding the codebase, adding unrequested "improvements" that cause bugs, and marking work done without verification.
deep-work is the core harness engine of the claude-deep-suite, implementing the Harness Engineering framework (Böckeler/Fowler, 2026). Across the Guide/Sensor × Computational/Inferential matrix it provides:
It emits receipts and health reports that deep-review and deep-dashboard consume.
Via the claude-deep-suite marketplace (recommended):
/plugin marketplace add Sungmin-Cho/claude-deep-suite
/plugin install deep-work@claude-deep-suite
Standalone, from this repository:
/plugin marketplace add Sungmin-Cho/claude-deep-work
/plugin install deep-work@Sungmin-Cho-claude-deep-work
deep-work runs in both the Claude Code and Codex plugin runtimes — each reads its native manifest, and skill callers use the same skill-native invocation model.
Windows: hook scripts require
bashin PATH (Git for Windows or WSL).
The entire workflow runs from one skill invocation; plan approval is the only required interaction.
# Run the full auto-flow: Brainstorm → Research → Plan → [approve] → Implement → Test → Integrate → Report
$deep-work:deep-work "Implement JWT-based user authentication"
# Unified status — flags route to the same implementations as the standalone skills
$deep-work:deep-status # current progress
$deep-work:deep-status --report # session report
$deep-work:deep-status --receipts # receipt dashboard
$deep-work:deep-status --history # cross-session trends
$deep-work:deep-status --assumptions # assumption health
$deep-work:deep-status --all # everything at once
$deep-work:deep-status --compare # compare two sessions
In Claude Code the same surfaces are also available as slash commands (e.g. typing the command name); in Codex and other hosts use the $deep-work:<verb> skill form.
deep-work v6.9.0 wires Phase 1 recall and Phase 5 harvest recommendation into the new deep-memory plugin as a read-only, opt-in consumer. See the CHANGELOG for full release history.
deep-work exposes 24 command-equivalent skills. The most-used are:
| Skill | Description |
|---|---|
$deep-work:deep-work <task> | Auto-flow orchestration — runs the entire pipeline; plan approval is the only required interaction |
$deep-work:deep-research | Phase 1 (Research) — deep codebase analysis |
$deep-work:deep-plan | Phase 2 (Plan) — slice-based implementation planning |
$deep-work:deep-implement | Phase 3 (Implement) — TDD-enforced slice execution |
$deep-work:deep-test | Phase 4 (Test) — receipt + spec + quality gates; auto-runs drift-check, SOLID review, insight |
$deep-work:deep-integrate | Phase 5 (Integrate) — cross-plugin next-step recommendation loop |
$deep-work:deep-status | Unified view (--report / --receipts / --history / --assumptions / --all / --compare) |
$deep-work:deep-finish | Close a session — merge, PR, keep, or discard the worktree |
$deep-work:deep-debug | Systematic debugging: investigate → analyze → hypothesize → fix |
npx claudepluginhub sungmin-cho/claude-deep-suite --plugin deep-workAutonomous Experimentation Protocol — goal-driven experiment loops that systematically improve any project through measured code modifications
LLM-managed markdown wiki for persistent knowledge accumulation — based on Karpathy's LLM Wiki philosophy. 5 skill-based entry surfaces (cross-platform: Claude Code slash + Codex/Copilot CLI/Gemini CLI/SDK via Skill()).
Independent Evaluator for AI coding agents — cross-model code review with Codex integration
Document gardening agent — validates freshness and auto-repairs CLAUDE.md, AGENTS.md, and project docs
Corca Workflow Framework — consolidated hooks and skill orchestration for structured development sessions
Verification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.
Virtual development team: TDD, debugging, code review, backlog management, and proven workflow patterns
Framework for AI-powered multi-step workflows with quality gates
AI-powered development workflow automation - Phase-based planning, implementation orchestration, preflight code quality checks with security scanning, ship-it workflow, and development principles generator for CLAUDE.md
Claude harness - A harness for solo developers (Vibecoders) to handle full-cycle contract development.