Use deepwork CLI for hook commands instead of python -m

.claude/settings.json

@@ -155,7 +155,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python -m deepwork.hooks.rules_check"
+            "command": "deepwork hook rules_check"
           }
         ]
       }
@@ -166,7 +166,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python -m deepwork.hooks.rules_check"
+            "command": "deepwork hook rules_check"
           }
         ]
       }

doc/architecture.md

@@ -1147,7 +1147,7 @@ The hooks are installed to `.claude/settings.json` during `deepwork sync`:
 {
   "hooks": {
     "Stop": [
-      {"matcher": "", "hooks": [{"type": "command", "command": "python -m deepwork.hooks.rules_check"}]}
+      {"matcher": "", "hooks": [{"type": "command", "command": "deepwork hook rules_check"}]}
     ]
   }
 }

src/deepwork/core/hooks_syncer.py

@@ -35,8 +35,10 @@ def get_command(self, project_path: Path) -> str:
             Command string to execute
         """
         if self.module:
-            # Python module - run directly with python -m
-            return f"python -m {self.module}"
+            # Python module - use deepwork hook CLI for portability
+            # Extract hook name from module path (e.g., "deepwork.hooks.rules_check" -> "rules_check")
+            hook_name = self.module.rsplit(".", 1)[-1]
+            return f"deepwork hook {hook_name}"
         elif self.script:
             # Script path is: .deepwork/jobs/{job_name}/hooks/{script}
             script_path = self.job_dir / "hooks" / self.script

tests/unit/test_hooks_syncer.py

@@ -43,7 +43,7 @@ def test_get_command_for_module(self, temp_dir: Path) -> None:
         )
 
         cmd = entry.get_command(temp_dir)
-        assert cmd == "python -m deepwork.hooks.rules_check"
+        assert cmd == "deepwork hook rules_check"
 
 
 class TestJobHooks: