deepwork 0.4.0__py3-none-any.whl → 0.5.1__py3-none-any.whl

deepwork/core/adapters.py

@@ -469,7 +469,11 @@ class ClaudeAdapter(AgentAdapter):
             "Write(./.deepwork/**)",
             # All deepwork CLI commands
             "Bash(deepwork:*)",
+            # Job scripts that need to be executable
+            "Bash(./.deepwork/jobs/deepwork_jobs/make_new_job.sh:*)",
         ]
+        # NOTE: When modifying required_permissions, update the test assertion in
+        # tests/unit/test_adapters.py::TestClaudeAdapter::test_sync_permissions_idempotent
 
         # Load settings once, add all permissions, then save once
         settings = self._load_settings(project_path)

deepwork/templates/claude/AGENTS.md

@@ -0,0 +1,38 @@
+# Claude Templates - Agent Notes
+
+Notes for AI agents working on Claude Code jinja templates.
+
+## Prompt-Based Stop Hooks - NOT WORKING
+
+**IMPORTANT: Prompt-based stop hooks (`type: prompt` for Stop/SubagentStop events) do not currently work properly in Claude Code.**
+
+Reference: https://github.com/anthropics/claude-code/issues/20221
+
+### What This Means
+
+- Do NOT use `type: prompt` hooks for Stop or SubagentStop events in templates
+- The quality validation loop pattern that relies on prompt hooks will not function as expected
+- Instead, instruct agents to use a sub-agent (e.g., Haiku) to review their work against quality criteria
+
+### Workaround
+
+Instead of prompt-based stop hooks, templates should include explicit instructions in the command content directing the agent to:
+
+1. Have a sub-agent using Haiku review the work against the specified quality criteria
+2. Fix any valid issues raised by the sub-agent
+3. Have the sub-agent review again until all valid feedback is handled
+
+### Future Reversal
+
+If prompt-based stop hooks are fixed in Claude Code (check the issue above for updates), this guidance should be reversed and prompt hooks can be re-enabled in templates.
+
+## Historical Context (Prompt Hooks - When They Work)
+
+The following guidance applies IF prompt hooks start working again:
+
+When writing prompt-based hooks (e.g., Stop hooks with `type: prompt`):
+
+- **Do NOT include instructions on how to return responses** (e.g., "respond with JSON", "return `{"ok": true}`"). Claude Code's internal instructions already specify the expected response format for prompt hooks.
+- Adding redundant response format instructions can cause conflicts or confusion with the built-in behavior. i.e. the hook will not block the agent from stopping.
+
+Reference: https://github.com/anthropics/claude-code/issues/11786

deepwork/templates/claude/skill-job-step.md.jinja

@@ -40,72 +40,51 @@ Template Variables:
 ---
 name: {{ job_name }}.{{ step_id }}
 description: "{{ step_description }}"
-{% if not exposed %}
+{%- if not exposed %}
 user-invocable: false
-{% endif %}
-{% if quality_criteria or hooks %}
+{%- endif %}{#- if not exposed #}
+{#-
+  NOTE: Prompt-based stop hooks do not currently work in Claude Code.
+  See: https://github.com/anthropics/claude-code/issues/20221
+  Only command/script hooks are generated here. Prompt hooks are filtered out.
+  Quality validation is handled via sub-agent review in the instructions section.
+#}
+{%- if hooks -%}
+{%- set has_command_hooks = namespace(value=false) -%}
+{%- for event_name, event_hooks in hooks.items() -%}
+{%- for hook in event_hooks -%}
+{%- if hook.type == "script" -%}
+{%- set has_command_hooks.value = true -%}
+{%- endif -%}{#- if hook.type == "script" #}
+{%- endfor -%}{#- for hook in event_hooks #}
+{%- endfor -%}{#- for event_name, event_hooks in hooks.items() #}
+{%- if has_command_hooks.value %}
 hooks:
-{% if quality_criteria %}
-{% for event_name in ["Stop", "SubagentStop"] %}
-  {{ event_name }}:
-    - hooks:
-        - type: prompt
-          prompt: |
-            You must evaluate whether Claude has met all the below quality criteria for the request.
-
-            ## Quality Criteria
-
-{% for criterion in quality_criteria %}
-            {{ loop.index }}. {{ criterion }}
-{% endfor %}
-
-            ## Instructions
-
-            Review the conversation and determine if ALL quality criteria above have been satisfied.
-            Look for evidence that each criterion has been addressed.
-
-            If the agent has included `<promise>✓ Quality Criteria Met</promise>` in their response OR
-            all criteria appear to be met, respond with: {"ok": true}
-
-            If criteria are NOT met AND the promise tag is missing, respond with:
-            {"ok": false, "reason": "**AGENT: TAKE ACTION** - [which criteria failed and why]"}
-{% endfor %}
-{% endif %}
-{% for event_name, event_hooks in hooks.items() %}
-{% if not (event_name == "Stop" and quality_criteria) and not (event_name == "SubagentStop" and "Stop" in hooks) %}
-{# For Stop events, generate both Stop and SubagentStop blocks #}
-{% if event_name == "Stop" %}
-{% for stop_event in ["Stop", "SubagentStop"] %}
+{%- for event_name, event_hooks in hooks.items() %}
+{%- set script_hooks = event_hooks | selectattr("type", "equalto", "script") | list %}
+{%- if script_hooks -%}
+{#- For Stop events, generate both Stop and SubagentStop blocks #}
+{%- if event_name == "Stop" %}
+{%- for stop_event in ["Stop", "SubagentStop"] %}
   {{ stop_event }}:
     - hooks:
-{% for hook in event_hooks %}
-{% if hook.type == "script" %}
+{%- for hook in script_hooks %}
         - type: command
           command: ".deepwork/jobs/{{ job_name }}/{{ hook.path }}"
-{% else %}
-        - type: prompt
-          prompt: |
-            {{ hook.content | indent(12) }}
-{% endif %}
-{% endfor %}
-{% endfor %}
-{% else %}
+{%- endfor %}{#- for hook in script_hooks #}
+{%- endfor %}{#- for stop_event in ["Stop", "SubagentStop"] #}
+{%- elif event_name != "SubagentStop" or "Stop" not in hooks %}
   {{ event_name }}:
     - hooks:
-{% for hook in event_hooks %}
-{% if hook.type == "script" %}
+{%- for hook in script_hooks %}
         - type: command
           command: ".deepwork/jobs/{{ job_name }}/{{ hook.path }}"
-{% else %}
-        - type: prompt
-          prompt: |
-            {{ hook.content | indent(12) }}
-{% endif %}
-{% endfor %}
-{% endif %}
-{% endif %}
-{% endfor %}
-{% endif %}
+{%- endfor %}{#- for hook in script_hooks #}
+{%- endif %}{#- if event_name == "Stop" #}
+{%- endif %}{#- if script_hooks #}
+{%- endfor %}{#- for event_name, event_hooks in hooks.items() #}
+{%- endif %}{#- if has_command_hooks.value #}
+{%- endif %}{#- if hooks #}
 ---
 
 # {{ job_name }}.{{ step_id }}
@@ -114,7 +93,7 @@ hooks:
 **Standalone skill** - can be run anytime
 {% else %}
 **Step {{ step_number }}/{{ total_steps }}** in **{{ job_name }}** workflow
-{% endif %}
+{% endif %}{#- if is_standalone #}
 
 > {{ job_summary }}
 
@@ -124,8 +103,8 @@ hooks:
 Before proceeding, confirm these steps are complete:
 {% for dep in dependencies %}
 - `/{{ job_name }}.{{ dep }}`
-{% endfor %}
-{% endif %}
+{% endfor %}{#- for dep in dependencies #}
+{% endif %}{#- if dependencies #}
 
 ## Instructions
 
@@ -137,7 +116,7 @@ Before proceeding, confirm these steps are complete:
 ### Job Context
 
 {{ job_description }}
-{% endif %}
+{% endif %}{#- if job_description #}
 
 {% if user_inputs or file_inputs %}
 ## Required Inputs
@@ -146,16 +125,16 @@ Before proceeding, confirm these steps are complete:
 **User Parameters** - Gather from user before starting:
 {% for input in user_inputs %}
 - **{{ input.name }}**: {{ input.description }}
-{% endfor %}
-{% endif %}
+{% endfor %}{#- for input in user_inputs #}
+{% endif %}{#- if user_inputs #}
 
 {% if file_inputs %}
 **Files from Previous Steps** - Read these first:
 {% for input in file_inputs %}
 - `{{ input.file }}` (from `{{ input.from_step }}`)
-{% endfor %}
-{% endif %}
-{% endif %}
+{% endfor %}{#- for input in file_inputs #}
+{% endif %}{#- if file_inputs #}
+{% endif %}{#- if user_inputs or file_inputs #}
 
 ## Work Branch
 
@@ -177,13 +156,13 @@ Use branch format: `deepwork/{{ job_name }}-[instance]-YYYYMMDD`
   **Definition**: `{{ output.doc_spec.path }}`
 {% if output.doc_spec.target_audience %}
   **Target Audience**: {{ output.doc_spec.target_audience }}
-{% endif %}
+{% endif %}{#- if output.doc_spec.target_audience #}
 {% if output.doc_spec.quality_criteria %}
   **Quality Criteria**:
 {% for criterion in output.doc_spec.quality_criteria %}
   {{ loop.index }}. **{{ criterion.name }}**: {{ criterion.description }}
-{% endfor %}
-{% endif %}
+{% endfor %}{#- for criterion in output.doc_spec.quality_criteria #}
+{% endif %}{#- if output.doc_spec.quality_criteria #}
 {% if output.doc_spec.example_document %}
 
   <details>
@@ -194,12 +173,12 @@ Use branch format: `deepwork/{{ job_name }}-[instance]-YYYYMMDD`
   ```
 
   </details>
-{% endif %}
-{% endif %}
-{% endfor %}
+{% endif %}{#- if output.doc_spec.example_document #}
+{% endif %}{#- if output.has_doc_spec and output.doc_spec #}
+{% endfor %}{#- for output in outputs #}
 {% else %}
 No specific file outputs required.
-{% endif %}
+{% endif %}{#- if outputs #}
 
 ## Guardrails
 
@@ -208,27 +187,32 @@ No specific file outputs required.
 - Do NOT proceed without required inputs; ask the user if any are missing
 - Do NOT modify files outside the scope of this step's defined outputs
 
-{% if quality_criteria or stop_hooks %}
+{% if quality_criteria %}
 ## Quality Validation
 
-Stop hooks will automatically validate your work. The loop continues until all criteria pass.
+**Before completing this step, you MUST have your work reviewed against the quality criteria below.**
+
+Use a sub-agent (Haiku model) to review your work against these criteria:
 
-{% if quality_criteria %}
 **Criteria (all must be satisfied)**:
-{% for criterion in quality_criteria %}
+{% for criterion in quality_criteria -%}
 {{ loop.index }}. {{ criterion }}
-{% endfor %}
-{% endif %}
-
-{% for hook in stop_hooks %}
-{% if hook.type == "script" %}
+{% endfor %}{#- for criterion in quality_criteria #}
+**Review Process**:
+1. Once you believe your work is complete, spawn a sub-agent using Haiku to review your work against the quality criteria above
+2. The sub-agent should examine your outputs and verify each criterion is met
+3. If the sub-agent identifies valid issues, fix them
+4. Have the sub-agent review again until all valid feedback has been addressed
+5. Only mark the step complete when the sub-agent confirms all criteria are satisfied
+
+{% endif %}{#- if quality_criteria #}
+{% if stop_hooks -%}
+{% for hook in stop_hooks -%}
+{% if hook.type == "script" -%}
 **Validation script**: `.deepwork/jobs/{{ job_name }}/{{ hook.path }}` (runs automatically)
-{% endif %}
-{% endfor %}
-
-**To complete**: Include `<promise>✓ Quality Criteria Met</promise>` in your final response only after verifying ALL criteria are satisfied.
-
-{% endif %}
+{% endif -%}{#- if hook.type == "script" #}
+{% endfor %}{#- for hook in stop_hooks #}
+{% endif %}{#- if stop_hooks #}
 ## On Completion
 
 {% if is_standalone %}
@@ -243,8 +227,8 @@ This standalone skill can be re-run anytime.
 3. **Continue workflow**: Use Skill tool to invoke `/{{ job_name }}.{{ next_step }}`
 {% else %}
 3. **Workflow complete**: All steps finished. Consider creating a PR to merge the work branch.
-{% endif %}
-{% endif %}
+{% endif %}{#- if next_step #}
+{% endif %}{#- if is_standalone #}
 
 ---
 

{deepwork-0.4.0.dist-info → deepwork-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepwork
-Version: 0.4.0
+Version: 0.5.1
 Summary: Framework for enabling AI agents to perform complex, multi-step work tasks
 Project-URL: Homepage, https://github.com/deepwork/deepwork
 Project-URL: Documentation, https://github.com/deepwork/deepwork#readme

{deepwork-0.4.0.dist-info → deepwork-0.5.1.dist-info}/RECORD

@@ -6,7 +6,7 @@ deepwork/cli/main.py,sha256=ohWspMA5yVjOPZDiFWt7yT4aH4o8MiOJfU67fuDkklM,616
 deepwork/cli/rules.py,sha256=hLv751CwAAHK1LaggBhfPbTVpPRUBbEON73ldYWijo8,760
 deepwork/cli/sync.py,sha256=BH3kuheDZMfRQOem0D09RzJJYDp0egbAW6Huu_YBS9M,7554
 deepwork/core/__init__.py,sha256=1g869QuwsYzNjQONneng2OMc6HKt-tlBCaxJbMMfoho,36
-deepwork/core/adapters.py,sha256=Hm-t_PFtTTa5AIc3sdZAgq7Dyds4btwFlR6hAXLub5A,21533
+deepwork/core/adapters.py,sha256=kQ6VcXrB4AcQBwMFhw0808h-3LWNbUV6mPTMvkzQwq8,21829
 deepwork/core/command_executor.py,sha256=O3LBdwT0Jshgw6l7I9va0tJbjIYO_wSnC6COz1RynrU,5373
 deepwork/core/detector.py,sha256=PThpFLH-ZVL8UqjVdGSnGA0mFbhc6_rp6V3_Yzw97kI,2466
 deepwork/core/doc_spec_parser.py,sha256=DF1B3Ku9XHxTjRN12b1DatkwTa0HlwpPbeJCL4teobU,5739
@@ -55,8 +55,9 @@ deepwork/standard_jobs/deepwork_rules/rules/skill-md-validation.md,sha256=H-o8X9
 deepwork/standard_jobs/deepwork_rules/rules/source-test-pairing.md.example,sha256=Uwg0l85nB69yY8MWwF46EUwx3UJ3qIHXb2ywxp_VNW0,320
 deepwork/standard_jobs/deepwork_rules/steps/define.md,sha256=TP3j90bh0zsGQniAo2GkX9xbLtB_XkaA4IudcbAZ0YY,8349
 deepwork/templates/__init__.py,sha256=APvjx_u7eRUerw9yA_fJ1ZqCzYA-FWUCV9HCz0RgjOc,50
+deepwork/templates/claude/AGENTS.md,sha256=7ickAhY8fNWhNCXPMG5nm6Jmv-XJvDM0PKC41EiQKyU,1828
 deepwork/templates/claude/skill-job-meta.md.jinja,sha256=SsK-_Tz5eeieaYGg9Q7S-MuaqbG7alWbKA0p2RcxhAg,2363
-deepwork/templates/claude/skill-job-step.md.jinja,sha256=UU4kXN95twzljfgrlVpMLvCMmp5CSdMdLeqJx9fWN8A,7677
+deepwork/templates/claude/skill-job-step.md.jinja,sha256=L42OQbD1HCq8idIH5kYIZQY9rwuO3DTRrsfn_6jkLPU,8549
 deepwork/templates/gemini/skill-job-meta.toml.jinja,sha256=FOkRNP3pGbvwcwwt3k6WF_qsCIkj1AbLYtF3mlkqAsA,2157
 deepwork/templates/gemini/skill-job-step.toml.jinja,sha256=GFVsHdPet5buy3TM6CcZ9pepVT2re0G4WABJ1CCS5y8,4845
 deepwork/utils/__init__.py,sha256=AtvE49IFI8Rg36O4cNIlzB-oxvkW3apFgXExn8GSk6s,38
@@ -64,8 +65,8 @@ deepwork/utils/fs.py,sha256=TbkcGGqck4lborFerbBLrpVMDUz3E5ZaW6X0_B2t76k,4821
 deepwork/utils/git.py,sha256=J4tAB1zE6-WMAEHbarevhmSvvPLkeKBpiRv1UxUVwYk,3748
 deepwork/utils/validation.py,sha256=SyFg9fIu1JCDMbssQgJRCTUNToDNcINccn8lje-tjts,851
 deepwork/utils/yaml_utils.py,sha256=INHhOmzC38fh7HYKLrq7vmS3dcuNsigH7_U71erS-hw,3127
-deepwork-0.4.0.dist-info/METADATA,sha256=c4n9ly-dvXGwAxm38mVdiQEm95gZUphI1DZxJ-r7OZY,13363
-deepwork-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-deepwork-0.4.0.dist-info/entry_points.txt,sha256=RhJBySzm619kh-yIdsAyfFXInAlY8Jm-39FLIBcOj2s,51
-deepwork-0.4.0.dist-info/licenses/LICENSE.md,sha256=W0EtJVYf0cQ_awukOCW1ETwNSpV2RKqnAGfoOjyz_K8,4126
-deepwork-0.4.0.dist-info/RECORD,,
+deepwork-0.5.1.dist-info/METADATA,sha256=y8X5xPFKdLEdrEqg5Hhx4KvRYXqE8r7R9VH3EaW-lT4,13363
+deepwork-0.5.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+deepwork-0.5.1.dist-info/entry_points.txt,sha256=RhJBySzm619kh-yIdsAyfFXInAlY8Jm-39FLIBcOj2s,51
+deepwork-0.5.1.dist-info/licenses/LICENSE.md,sha256=W0EtJVYf0cQ_awukOCW1ETwNSpV2RKqnAGfoOjyz_K8,4126
+deepwork-0.5.1.dist-info/RECORD,,