Does this skill write code immediately?

No, the Deep Work skill follows a 'thinking before typing' philosophy. It requires you to review and approve a research report and an implementation plan before any code is modified.

How do I provide feedback on a proposed plan?

You can add inline notes directly to the `.claude/plan.md` file. Claude will then read these annotations, update the plan accordingly, and clean up the notes in an iterative cycle.

Where are the research and planning files stored?

All artifacts, including research.md and plan.md, are stored in a dedicated `.claude/` directory to keep your project root clean while maintaining persistent context.

What is the Deep Work skill for Claude Code?

It is a specialized capability that guides Claude through a structured workflow—Research, Plan, Annotate, and Implement—to ensure high-quality output for complex coding tasks.

What happens during the implementation phase?

Once you approve the plan, Claude generates a granular todo list and executes each task sequentially, updating the status in the plan file and running linting or type checks to ensure quality.

Deep Work Workflow

Name: Deep Work Workflow
Author: petekp

bypetekp

•

生産性とワークフロー

Enforces a disciplined, multi-phase development process that separates research and planning from code execution for complex technical tasks.

Deep Work is a specialized workflow skill for Claude Code designed to handle non-trivial features, refactors, and bug investigations through a structured, artifact-driven approach. It prevents premature coding by mandating a rigorous cycle of deep codebase analysis, persistent markdown documentation, and interactive plan refinement. By generating research and planning documents in the .claude directory, this skill ensures that every major change is intentional, architecturally sound, and fully reviewed by the developer before implementation begins.

主な機能

01Artifact-driven workflow using persistent research and planning documents

02Granular task tracking with real-time status updates during the implementation phase

03Interactive annotation cycle for collaborative refinement of implementation plans

04Deep codebase analysis to identify patterns, data flows, and integration points

05Enforced review checkpoints that require user approval before code execution

061 GitHub stars

ユースケース

01Executing large-scale refactors while maintaining architectural consistency

02Architecting and implementing complex new features with deep system integration

03Conducting thorough investigations into subtle or hard-to-reproduce bugs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add petekp/agent-skills deep-work

For use in Claude.ai and ChatGPT