Release notes from deepwork

0.14.0

2026-04-20T20:16:35Z

Added

New PLUG-REQ-001.15: Hook Script CLI Invocation requirement in doc/specs/deepwork/cli_plugins/PLUG-REQ-001-claude-code-plugin.md

Changed

claude_plugin_hook_deepwork_invocation review rule now requires plugin hook scripts to invoke the CLI via uvx deepwork instead of merely providing a uvx deepwork fallback (PLUG-REQ-001.15)
Plugin hook scripts (post_commit_reminder.sh, deepschema_write.sh, post_compact.sh) now invoke the deepwork CLI exclusively via uvx deepwork ..., matching the MCP server launch in plugins/claude/.mcp.json
Flake shellHook no longer runs uv tool install -e — the editable user-level deepwork install is redundant now that plugin hooks go through uvx

Fixed

Plugin hooks no longer fail when the end user has a stale user-level deepwork install (e.g., uv tool install deepwork pinned to an older release) that wins PATH lookup but lacks the hook module being requested. The 0.13.9 fallback still used PATH first; this release bypasses PATH entirely so hooks resolve to the same uvx cache that the MCP server populated

Removed

0.13.9

2026-04-16T22:16:08Z

Added

New claude_plugin_hook_deepwork_invocation review rule in plugins/claude/.deepreview that flags plugin hook scripts which call bare deepwork without a uvx deepwork fallback

Changed

Fixed

Plugin hook scripts (post_commit_reminder.sh, deepschema_write.sh, post_compact.sh) now fall back to uvx deepwork when the bare deepwork binary is not on PATH. End-user installs launch the MCP server via uvx deepwork serve, so deepwork is not available as a command — previously these hooks failed with exit 127 on every Bash tool use, and Claude Code reported them as failed PostToolUse hooks (regression introduced in PR #361)

Removed

0.14.0a1

2026-04-15T23:02:09Z

Pre-release 0.14.0a1 from branch main.

To use this pre-release, subscribe to the pre-release plugin channel:

claude plugin marketplace add Unsupervisedcom/deepwork#pre-release
claude plugin install deepwork@deepwork-plugins

0.13.8

2026-04-15T22:49:31Z

Added

Changed

Renamed default reviewer agent from reviewer to deepwork:reviewer (plugin-namespaced) in review instructions output
/review skill now checks for deepwork:reviewer agent availability before proceeding and directs users to /reload-plugins if missing

Fixed

Removed

0.13.7

2026-04-14T16:58:58Z

Added

Changed

Fixed

Removed

0.13.6

2026-04-14T15:40:41Z

Added

Changed

Deprecated the steps/ folder pattern for job definitions — step instructions are now inlined in job.yml; moved supplemental reference files from steps/ to job root directories
Repair workflow now instructs agents to git rm step instruction files after inlining
Moved specs/ to doc/specs/ and consolidated docs/ into doc/ to reduce root directory clutter

Removed

coverage_report.md (stale snapshot)
job_refactor.md (superseded planning notes)
CLAUDE_PLUGINS_README.md (redundant with README.md)

Fixed

Removed

0.13.5

2026-04-12T23:37:15Z

Added

Changed

Fixed

Removed

0.13.4

2026-04-12T17:47:23Z

Added

Changed

Post-commit review reminder hook now short-circuits when all applicable (non-catch-all) review rules for the committed files are already marked as passed, emitting "No re-review needed" instead of nagging
Renamed all "Task tool" references to "Agent tool" across codebase to match Claude Code's current tool naming
Review formatter now emits description, subagent_type, and prompt fields (dropped name field) to match Agent tool signature
Hook wrapper tool mappings updated: Task/task → Agent/agent

Fixed

Review instruction files now include a ## Project Root directive stating the absolute project root so reviewer subagents read files from the correct working tree — fixes spurious findings in git-worktree setups where the subagent's cwd differed from the worktree the commits actually lived in (REVIEW-REQ-005.1.9)

Removed

Removed automatic DeepPlan workflow injection from startup_context.sh hook (no longer forces plan mode into DeepPlan)
Deprecated JOBS-REQ-014.5.1 (startup hook DeepPlan trigger) and REVIEW-REQ-006.3.3a (name field in review output)

0.13.3

2026-04-10T02:46:23Z

Added

/record skill: "watch and learn" approach to creating DeepWork workflows — users do their work normally, then /deepwork learn turns it into a repeatable job
/new_user skill: guided onboarding that introduces DeepWork, offers review rule setup for code projects, and offers to record a first workflow
/deepwork learn now routes to the new_job workflow when invoked after /deepwork:record
Requirements specs PLUG-REQ-002 (record skill) and PLUG-REQ-003 (new user skill)
Anonymous DeepSchemas for both new skills

Changed

README install commands consolidated into a single &&-joined command ending with /deepwork:new_user
deepwork setup now opens https://www.deepwork.md/success in the default browser after completing configuration

Fixed

Removed

0.13.2

2026-04-09T02:29:18Z

Added

deepwork setup CLI command that auto-configures Claude Code settings (marketplace, plugin, MCP permissions, auto-update) (#343)
deepwork setup also grants project-root-relative Read/Write/Edit permissions for /.deepwork/**/* so the plugin can operate on .deepwork/ in every project without per-prompt approval
Integration tests for quality gate review caching (JOBS-REQ-004.5.7)
Requirements traceability coverage now at 100% (#346)
- Added section-level REQ ID annotations to 32 existing test files for traceability
- Wrote 218 new tests across 5 files for learning-agents requirements (LA-REQ-001, 003, 004, 005, 006, 010, 011)
- Added 6 anonymous DeepSchemas for judgment-based learning-agents skill requirements (LA-REQ-002, 007, 008, 009, 012)
- Added new PLUG-REQ-001.12 tests for session/agent identity injection hooks
- New req-ids-in-comments requirement in the standard DeepSchema definition: requirement IDs must be placed in YAML comments, not requirement body text

Changed

JOBS-REQ-004.5.7 strengthened to explicit MUST requirement for skipping already-passed reviews

Fixed

DeepSchema PostToolUse hook (deepschema_write) no longer reports File is not valid JSON for YAML files whose name has no extension (e.g. .deepreview). The hook now parses target files and the referenced JSON Schema as YAML, which is a superset of JSON, so both formats are accepted regardless of file extension. DW-REQ-011.7.3 updated to match. (Mirrors the fix shipped in #338 for the workflow quality gate.)
review: blocks declared on type: string step outputs are now actually executed. Previously they were silently dropped because the review pipeline only matched against file paths, leaving authors with misconfigured-but-silent quality gates. String output reviews now produce synthetic ReviewTask objects with the string value carried on a new ReviewTask.inline_content field and rendered into the instruction file as a "Content to Review" section. New requirements: JOBS-REQ-004.8, REVIEW-REQ-005.1.8, REVIEW-REQ-009.1.7. (#350)