Extract Implementer clarification into handoff guidance

README.md

@@ -8,7 +8,7 @@ Public source for RelayView-maintained instruction-only role skills and an illus
 | --- | --- | --- | --- |
 | `packages/{planner,implementer,reviewer}-investigation` | Maintained automatic guidance | One matching role / step each | 0.7.0 |
 | `packages/planner-scope` | Maintained default | Planner / planning | 0.8.1 |
-| `packages/implementer-handoff` | Maintained default | Implementer / implementation | 0.2.0 |
+| `packages/implementer-handoff` | Maintained default | Implementer / implementation | 0.9.0 |
 | `packages/issue-designer-default` | Maintained default | Designer / design | 0.6.1 |
 | `packages/designer-wayfinder`, `designer-grilling` | Optional manual guidance | Designer / design | 0.6.0 |
 | `packages/designer-prototype` | Optional manual guidance | Designer / design | 0.6.2 |

packages/implementer-handoff/SKILL.md

@@ -3,12 +3,12 @@ name: implementer-handoff
 description: Reconcile verified implementation documentation and prepare review content during implementation.
 metadata:
   relayview-display-name: Implementer handoff
-  relayview-version: 0.2.0
+  relayview-version: 0.9.0
 ---
 
 # Implementer handoff
 
-During the assigned implementation step, keep the repository's current-behavior documentation aligned with the code and checks you actually completed. Read the project's documentation rules and the relevant existing contract before editing it. Use the [handoff guide](handoff.md) for the documentation disposition and review content.
+During the assigned implementation step, keep the repository's current-behavior documentation aligned with the code and checks you actually completed. Read the project's documentation rules and the relevant existing contract before editing it. Use the [handoff guide](handoff.md) for implementation clarification, documentation disposition and review content.
 
 Prepare a concise, attributable review handoff when the assigned workflow gives you a place to submit one. Identify the exact candidate, focused checks and their observed results, any manual evidence and its observer, unresolved limitations, and the documentation disposition. A command attempted is not a check passed; report failures and stale evidence explicitly.
 

packages/implementer-handoff/handoff.md

@@ -1,5 +1,11 @@
 # Handoff guide
 
+## Implementation and clarification
+
+Read the relevant files and make focused changes. Use the assigned investigation method for repository discovery; this handoff method owns clarification and report preparation.
+
+Ask the planner for more information when blocked after reasonable investigation. If the final contract appears wrong, explain the mismatch clearly, make the safest local correction if obvious within the authoritative scope, and validate it. Clarification methods guide communication; scope changes require owner authority.
+
 ## Documentation
 
 - Update the current-behavior contract only for behavior verified on the candidate. Keep proposed work clearly proposed.

packages/implementer-handoff/relayview-skill.json

@@ -2,18 +2,18 @@
   "schemaVersion": 1,
   "source": {
     "kind": "first-party",
-    "reference": "v0.2.0"
+    "reference": "v0.9.0"
   },
   "role": "implementer",
   "step": "implementation",
   "files": [
     {
       "path": "SKILL.md",
-      "sha256": "bfeafa2d7780fe2c0bb4206ab9a03acd12804347ceb0f3ffb3e06e1be514c852"
+      "sha256": "a826d49f478018190539843022b83c11e7a034fa3597edcc85b8a57c65ac434d"
     },
     {
       "path": "handoff.md",
-      "sha256": "303c3e792cf0e8da6215e6eeb69f5a2f1f2bd0b67db016160d9e83a970ad95d3"
+      "sha256": "17a32948aeb0e0359c92924219e6c328f3422773d5d878ffbcf0bf2f07a99aeb"
     }
   ]
 }

tests/test_packages.py

@@ -12,6 +12,14 @@ ROOT = Path(__file__).resolve().parents[1]
 
 
 class PackageTests(unittest.TestCase):
+    def test_handoff_clarification_method(self):
+        package = ROOT / "packages/implementer-handoff"
+        check_package(package)
+        text = (package / "handoff.md").read_text()
+        self.assertIn("blocked after reasonable investigation", text)
+        self.assertIn("scope changes require owner authority", text)
+        self.assertNotIn("Trace load order", text)
+
     def test_schema_two_claim_policy_bounds(self):
         with tempfile.TemporaryDirectory() as directory:
             package = Path(directory) / "planner-scope"