Models matter. Context matters more.
π deepworkplan.com Β· π Security Β· π Changelog Β· π€ Contributing
The official DeepWorkPlan agent skill pack, maintained by Dailybot.
DeepWorkPlan turns any repository into a structured environment β context,
guardrails, and a durable plan β where any coding agent executes with precision
and finishes short- and long-horizon work. It makes the repo AI-first (an adapted
AGENTS.md, docs/, per-module docs, and .agents/ config), then drives
structured Deep Work Plans: a compact executable Lite plan for bounded
work, or a per-task Full plan for longer work; then execute, refine, resume,
and report with all plan output living in a gitignored
.dwp/ directory.
DeepWorkPlan is spec-driven development where the repository itself becomes the harness.
What it rests on
- You steer; the agents do the hours. You decide what done means and where the lines are. The plan carries your intent, so the work does not need correcting every twenty minutes.
- The plan is what the agent returns to. Long work fills any model's context and detail falls away. Atomic tasks, validation gates and resumable state give the agent something durable to come back to, lap after lap.
- Done is a contract, not a feeling. Every task names its acceptance criteria and the checks that must pass. An agent does not get to decide it finished β it passes, or the task stays open.
- The repository is the harness. Context, tools, guardrails and state live in your repo as plain files any agent can read. No lock-in, no external brain, and it survives a context reset or a change of agent mid-flight.
- Context is the scarcest resource. Instructions load progressively by trigger, validation is selected from what each task actually touched, and skills are decided task-locally β so the plan pays for itself instead of crowding out the work.
At a glance
- License: MIT
- Security policy: SECURITY.md
- Changes: CHANGELOG.md
- Format: Open Agent Skills standard
- Docs: https://deepworkplan.com
| Skill | What it does |
|---|---|
| deepworkplan-onboard | Make any repo AI-first. Reasons about the repo's stack and archetype (orchestrator hub vs individual repo), then generates an adapted AGENTS.md, docs/, per-module docs, .agents/, and the .claude β .agents / .cursor β .agents symlinks. Offers opt-in addons. |
| deepworkplan-create | Create a Deep Work Plan. Starts every request as an executable Lite plan, recommends Lite or Full from the work's risk and horizon, and promotes safely to Full only when needed. |
| deepworkplan-execute | Execute an existing plan task-by-task, run each task's validation, and log progress. |
| deepworkplan-refine | Modify the scope or tasks of an existing plan, or promote a Lite plan to Full task files. |
| deepworkplan-resume | Resume an interrupted plan from its recorded progress state. |
| deepworkplan-status | Report the status of a plan β completed tasks, what's left, and blockers β without executing. |
| deepworkplan-verify | Check the repository and its plans against the standard β read-only, pass/fail, exits 0/1. Confirms the harness is in place and that every plan's tasks, gates, evidence and final review actually hold, so "done" is auditable rather than asserted. |
| deepworkplan-author | Author or update reusable skills, agents, and commands in the current repo β reasons about the repo's .agents/ layout, follows the Open Agent Skills frontmatter contract, and keeps the .agents/docs/ catalog in sync. Backs the /skill-create and /agent-create aliases. |
A root deepworkplan meta-skill acts as a router β it describes all
capabilities and routes to the right sub-skill based on the developer's intent.
Each skill can be used independently or together; they share context detection
through a common shared/ directory. The AI Diff Reviewer local review ships
in the baseline (installed by onboard, run by every Final Review; its CI
Action stays optional), and opt-in addons such as devcontainer support can
layer more onto an onboarded repo.
The skills.sh CLI auto-detects your agent and installs the skill in the right place:
npx skills add DailybotHQ/deepworkplan-skillTo target a specific agent or list available skills first:
npx skills add DailybotHQ/deepworkplan-skill --list
npx skills add DailybotHQ/deepworkplan-skill -a claude-codeInstalling at project scope writes an entry to a workspace-root
skills-lock.json so the exact skill version is reproducible across your team
(see Reproducible installs below).
openclaw skills install deepworkplanOpenClaw loads the pack natively on every eligible session β no trigger setup required.
Pick the path for your agent, clone, then run setup.sh:
| Agent | Default path |
|---|---|
| Claude Code | ~/.claude/skills/deepworkplan/ |
| Cursor | ~/.cursor/skills/deepworkplan/ |
| OpenAI Codex | ~/.codex/skills/deepworkplan/ |
| Windsurf | ~/.codeium/windsurf/skills/deepworkplan/ |
| GitHub Copilot | ~/.copilot/skills/deepworkplan/ |
| Cline | ~/.cline/skills/deepworkplan/ |
| Gemini CLI | ~/.gemini/skills/deepworkplan/ |
| OpenCode | ~/.config/opencode/skills/deepworkplan/ |
| Antigravity | ~/.antigravity/skills/deepworkplan/ |
| OpenClaw | <workspace>/skills/deepworkplan/ or ~/.openclaw/skills/ |
git clone https://github.com/DailybotHQ/deepworkplan-skill.git ~/deepworkplan-skill
cd ~/deepworkplan-skill
./setup.sh # auto-detect installed agents
./setup.sh --host claude # or target one agent explicitlysetup.sh symlinks the deepworkplan pack plus each sub-skill
(deepworkplan-create, deepworkplan-execute, deepworkplan-refine,
deepworkplan-resume, deepworkplan-status, deepworkplan-onboard) into the
agent's skills directory so they're discoverable as independent slash commands.
/dwp-create accepts mode tokens at either edge of the request. trust (or
auto) skips the guided review; lite and full override the recommendation.
For example: /dwp-create trust fix the broken link, /dwp-create lite trust rename this setting, and /dwp-create redesign the auth flow full trust.
lite and full together are rejected. A direct-edit request remains direct;
the router only offers DWP when the developer asks to plan or organize work.
Once installed, describe what you want and the agent routes to the right sub-skill:
- "Make this repo AI-first" / "onboard this repo" β deepworkplan-onboard
- "Create a plan to ship feature X" β deepworkplan-create
- "Execute the plan" / "continue the plan" β deepworkplan-execute
- "What's left on the plan?" β deepworkplan-status
- "Create a skill / agent" / "evolve the kit" β deepworkplan-author (also
/skill-create,/agent-create)
Or invoke directly: /deepworkplan-create, /deepworkplan-onboard, etc.
All Deep Work Plan output lives in a gitignored .dwp/ directory at the repo
root:
.dwp/plans/PLAN_<slug>/β the plans (README + state + progress log, plus task files when the plan is Full)
There is no draft directory: create materializes an executable Lite plan
directly, and that plan is the reviewable artifact. .dwp/drafts/ and the
refined-draft commands were removed in DWP 2.4.0.
.dwp/ is resolved by skills/deepworkplan/shared/context.sh and overridable
via the DWP_DIR environment variable. It is meant to be gitignored β plan
artifacts are working state, not committed source. For orchestrator hubs, child
plans live at repositories/<repo>/.dwp/plans/PLAN_<child>/.
When you install at project scope (e.g. npx skills add run inside a
workspace), the skills.sh CLI writes the resolved skill source, path, and a
content hash to a skills-lock.json at your workspace root. Commit that file to
pin the exact version of DeepWorkPlan your team uses β re-running the installer
later restores the same revision. This skill repo does not ship a
skills-lock.json of its own; it is a consumer-side artifact that lives in
your workspace, not in the skill pack.
# npx
npx skills update DailybotHQ/deepworkplan-skill
# Git clone
cd <skill-path> && git pull && ./setup.sh
# OpenClaw
openclaw skills update deepworkplan# Remove the skill pack itself
rm -rf <skill-path>
# Remove sub-skill symlinks (Claude Code example)
rm -f ~/.claude/skills/deepworkplan \
~/.claude/skills/deepworkplan-create \
~/.claude/skills/deepworkplan-execute \
~/.claude/skills/deepworkplan-refine \
~/.claude/skills/deepworkplan-resume \
~/.claude/skills/deepworkplan-status \
~/.claude/skills/deepworkplan-onboard
# OpenClaw
openclaw skills remove deepworkplanThis README is for users. If you want to work on the skill itself, start with
CONTRIBUTING.md β the human-facing guide to local setup, the
auto-release flow, and the PR workflow. The canonical, terser rule list for AI
agents is AGENTS.md (and CLAUDE.md is a symlink to it): it covers
the ship boundary (only skills/deepworkplan/ ships), the SKILL.md frontmatter
contract, the automatic-versioning rule, the commit format, and the pre-commit
checklist. Deeper background lives under docs/ β DESIGN.md
(the why behind the layout), INSTALLATION.md,
OPENCLAW.md, and SUB_SKILL_GUIDE.md.
- DeepWorkPlan
- Dailybot
- Open Agent Skills standard (agentskills.io)
- skills.sh β cross-agent skills directory
π Powered by Dailybot
Dailybot is an AI-powered async communication platform that keeps people and agents visible β without adding more meetings or tools. It lives where your team already works (Slack, Teams, Google Chat, Discord, VS Code, and the CLI) and turns scattered signals into clear progress: async check-ins and standups, AI summaries that detect blockers and read team sentiment, workflow automation and approvals, team analytics, and recognition. As AI agents join the workflow, Dailybot surfaces their status and activity right alongside your team's β so long-running agents never go dark. Learn more.