openplanr 2.4.0 → 2.6.0

package/lib/host-packages/openai/.claude-plugin/marketplace.json

@@ -4,14 +4,14 @@
     "name": "AsemDevs"
   },
   "metadata": {
-    "version": "2.4.0",
+    "version": "2.6.0",
     "description": "Generated local OpenPlanr package."
   },
   "plugins": [
     {
       "name": "planr",
       "source": "./openplanr",
-      "version": "2.4.0",
+      "version": "2.6.0",
       "description": "Host-native OpenPlanr skills for OpenAI coding agents.",
       "strict": true
     }

package/lib/host-packages/openai/openplanr/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "planr",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Host-native OpenPlanr planning, delivery, review, design, and operating skills.",
   "author": {
     "name": "AsemDevs"

package/lib/host-packages/openai/openplanr/.openplanr-content.json

@@ -8,7 +8,7 @@
   "files": [
     {
       "path": ".codex-plugin/plugin.json",
-      "digest": "sha256:e49c5b68381e89a94d8df74d1813f2efa9bf4d75ff7f7d9f260c06147a90c199"
+      "digest": "sha256:86914866190aef3f24b1ec71289d84363ad4d20d9d08266bc526e1971542c4b7"
     },
     {
       "path": "skills/artifact/agents/openai.yaml",
@@ -276,7 +276,7 @@
     },
     {
       "path": "skills/design-loop/openplanr.skill.json",
-      "digest": "sha256:8e4eeb36590194963d6e8f6448e8d991658bf93a2070b0cb446b45ad793e3a49"
+      "digest": "sha256:e74d98bbf31c030727e6cf2bd306b760d1bba2449bbb247148fe6c1dbc684f7b"
     },
     {
       "path": "skills/design-loop/references/craft.md",
@@ -300,7 +300,7 @@
     },
     {
       "path": "skills/design-loop/references/handoff.md",
-      "digest": "sha256:dddc50fe5167884b38523fcbcb99cb3525fd28a5ccf7999409212f52845e9219"
+      "digest": "sha256:238ef2f458c84e0c7832ad7267d79cb234390c5a1016b636dba04fe0e7304774"
     },
     {
       "path": "skills/design-loop/references/review.md",
@@ -328,7 +328,7 @@
     },
     {
       "path": "skills/design-loop/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
     },
     {
       "path": "skills/design-loop/scripts/runtime/notices/entities.txt",
@@ -348,7 +348,15 @@
     },
     {
       "path": "skills/design-loop/scripts/runtime/packages/design/templates/studio/enhancements.js",
-      "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
+      "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
+    },
+    {
+      "path": "skills/design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.css",
+      "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
+    },
+    {
+      "path": "skills/design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.js",
+      "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
     },
     {
       "path": "skills/design-loop/scripts/runtime/packages/design/templates/studio/share.css",
@@ -368,7 +376,7 @@
     },
     {
       "path": "skills/design-loop/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:d3a009b9b304680df08d3ec30bccea5b0baf7444fee4f65e90708125535d8773"
+      "digest": "sha256:005fd84b459d0673203781da7693ffb28b379ef73096213fd6df5c2606617730"
     },
     {
       "path": "skills/design-loop/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -410,6 +418,18 @@
       "path": "skills/design-loop/scripts/runtime/packages/protocol/schemas/v1.10.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:ba8ac124e47e8f8310214445b1752cc6706d3a7265a87c9f9685a7e9df84f0b1"
     },
+    {
+      "path": "skills/design-loop/scripts/runtime/packages/protocol/schemas/v1.11.0/design-handoff-readiness.schema.json",
+      "digest": "sha256:51277b0c353989c7166535b6b8c752226fd436b735e451940c79a3f6a9c8eb12"
+    },
+    {
+      "path": "skills/design-loop/scripts/runtime/packages/protocol/schemas/v1.11.0/design-implementation-handoff.schema.json",
+      "digest": "sha256:706227c6663dce427f724584bd2d6cb4c65123171ec6540c3ec30e6a36b4d68b"
+    },
+    {
+      "path": "skills/design-loop/scripts/runtime/packages/protocol/schemas/v1.11.0/design-planning-lineage.schema.json",
+      "digest": "sha256:e54a4026444de9cd6092aae4b3bfe7f527254941c07fb29253ea8bb6f2ee8486"
+    },
     {
       "path": "skills/design-loop/scripts/runtime/packages/protocol/schemas/v1.11.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:2339f1babeef83bb7a19d53232a12ac432652a4da7e49c8a5417ff795a0265ed"
@@ -448,7 +468,7 @@
     },
     {
       "path": "skills/design-review/openplanr.skill.json",
-      "digest": "sha256:11c7f60feaba70cb6bc439244164ec946ae76c68c4bf46bd4d1d8c916d80ee90"
+      "digest": "sha256:388904d851b0da0e6bc9171db229f80facca68a417bb4e458bf5eebf6cd12be3"
     },
     {
       "path": "skills/design-review/references/craft.md",
@@ -472,7 +492,7 @@
     },
     {
       "path": "skills/design-review/references/handoff.md",
-      "digest": "sha256:dddc50fe5167884b38523fcbcb99cb3525fd28a5ccf7999409212f52845e9219"
+      "digest": "sha256:238ef2f458c84e0c7832ad7267d79cb234390c5a1016b636dba04fe0e7304774"
     },
     {
       "path": "skills/design-review/references/review.md",
@@ -500,7 +520,7 @@
     },
     {
       "path": "skills/design-review/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
     },
     {
       "path": "skills/design-review/scripts/runtime/notices/entities.txt",
@@ -520,7 +540,15 @@
     },
     {
       "path": "skills/design-review/scripts/runtime/packages/design/templates/studio/enhancements.js",
-      "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
+      "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
+    },
+    {
+      "path": "skills/design-review/scripts/runtime/packages/design/templates/studio/handoff-center.css",
+      "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
+    },
+    {
+      "path": "skills/design-review/scripts/runtime/packages/design/templates/studio/handoff-center.js",
+      "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
     },
     {
       "path": "skills/design-review/scripts/runtime/packages/design/templates/studio/share.css",
@@ -540,7 +568,7 @@
     },
     {
       "path": "skills/design-review/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:d3a009b9b304680df08d3ec30bccea5b0baf7444fee4f65e90708125535d8773"
+      "digest": "sha256:005fd84b459d0673203781da7693ffb28b379ef73096213fd6df5c2606617730"
     },
     {
       "path": "skills/design-review/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -582,6 +610,18 @@
       "path": "skills/design-review/scripts/runtime/packages/protocol/schemas/v1.10.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:ba8ac124e47e8f8310214445b1752cc6706d3a7265a87c9f9685a7e9df84f0b1"
     },
+    {
+      "path": "skills/design-review/scripts/runtime/packages/protocol/schemas/v1.11.0/design-handoff-readiness.schema.json",
+      "digest": "sha256:51277b0c353989c7166535b6b8c752226fd436b735e451940c79a3f6a9c8eb12"
+    },
+    {
+      "path": "skills/design-review/scripts/runtime/packages/protocol/schemas/v1.11.0/design-implementation-handoff.schema.json",
+      "digest": "sha256:706227c6663dce427f724584bd2d6cb4c65123171ec6540c3ec30e6a36b4d68b"
+    },
+    {
+      "path": "skills/design-review/scripts/runtime/packages/protocol/schemas/v1.11.0/design-planning-lineage.schema.json",
+      "digest": "sha256:e54a4026444de9cd6092aae4b3bfe7f527254941c07fb29253ea8bb6f2ee8486"
+    },
     {
       "path": "skills/design-review/scripts/runtime/packages/protocol/schemas/v1.11.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:2339f1babeef83bb7a19d53232a12ac432652a4da7e49c8a5417ff795a0265ed"
@@ -612,7 +652,7 @@
     },
     {
       "path": "skills/design-review/SKILL.md",
-      "digest": "sha256:2ef0b93b8132f4c84982b8e94ce58c4ef5c10642df9f9e63148fa3aa23b0d15e"
+      "digest": "sha256:1abdbeffe66b6afadb51d3719486665ee374f8aba9bf17ddf54ac4e1f185dc23"
     },
     {
       "path": "skills/design/agents/openai.yaml",
@@ -620,7 +660,7 @@
     },
     {
       "path": "skills/design/openplanr.skill.json",
-      "digest": "sha256:208206addf0dc8337f1914256ba6b655edf570d7cdfb7ebd62c73b29299fba95"
+      "digest": "sha256:b6fb1882f9147414964469f6e3b8089c2ca8d55c0f4a7f92e66b5a107db68051"
     },
     {
       "path": "skills/design/references/craft.md",
@@ -644,7 +684,7 @@
     },
     {
       "path": "skills/design/references/handoff.md",
-      "digest": "sha256:dddc50fe5167884b38523fcbcb99cb3525fd28a5ccf7999409212f52845e9219"
+      "digest": "sha256:238ef2f458c84e0c7832ad7267d79cb234390c5a1016b636dba04fe0e7304774"
     },
     {
       "path": "skills/design/references/review.md",
@@ -672,7 +712,7 @@
     },
     {
       "path": "skills/design/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
     },
     {
       "path": "skills/design/scripts/runtime/notices/entities.txt",
@@ -692,7 +732,15 @@
     },
     {
       "path": "skills/design/scripts/runtime/packages/design/templates/studio/enhancements.js",
-      "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
+      "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
+    },
+    {
+      "path": "skills/design/scripts/runtime/packages/design/templates/studio/handoff-center.css",
+      "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
+    },
+    {
+      "path": "skills/design/scripts/runtime/packages/design/templates/studio/handoff-center.js",
+      "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
     },
     {
       "path": "skills/design/scripts/runtime/packages/design/templates/studio/share.css",
@@ -712,7 +760,7 @@
     },
     {
       "path": "skills/design/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:d3a009b9b304680df08d3ec30bccea5b0baf7444fee4f65e90708125535d8773"
+      "digest": "sha256:005fd84b459d0673203781da7693ffb28b379ef73096213fd6df5c2606617730"
     },
     {
       "path": "skills/design/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -754,6 +802,18 @@
       "path": "skills/design/scripts/runtime/packages/protocol/schemas/v1.10.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:ba8ac124e47e8f8310214445b1752cc6706d3a7265a87c9f9685a7e9df84f0b1"
     },
+    {
+      "path": "skills/design/scripts/runtime/packages/protocol/schemas/v1.11.0/design-handoff-readiness.schema.json",
+      "digest": "sha256:51277b0c353989c7166535b6b8c752226fd436b735e451940c79a3f6a9c8eb12"
+    },
+    {
+      "path": "skills/design/scripts/runtime/packages/protocol/schemas/v1.11.0/design-implementation-handoff.schema.json",
+      "digest": "sha256:706227c6663dce427f724584bd2d6cb4c65123171ec6540c3ec30e6a36b4d68b"
+    },
+    {
+      "path": "skills/design/scripts/runtime/packages/protocol/schemas/v1.11.0/design-planning-lineage.schema.json",
+      "digest": "sha256:e54a4026444de9cd6092aae4b3bfe7f527254941c07fb29253ea8bb6f2ee8486"
+    },
     {
       "path": "skills/design/scripts/runtime/packages/protocol/schemas/v1.11.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:2339f1babeef83bb7a19d53232a12ac432652a4da7e49c8a5417ff795a0265ed"
@@ -784,7 +844,7 @@
     },
     {
       "path": "skills/design/SKILL.md",
-      "digest": "sha256:0ba7b0388e7acc4f9111a5cc69f8d55a1dc2ba54ab20e8274ff7384f4410c9ec"
+      "digest": "sha256:3265e760e594a16eadc88d46045a3c80546797fcc5cd11985b9c7ccfd89df014"
     },
     {
       "path": "skills/diagram/agents/openai.yaml",
@@ -908,12 +968,16 @@
     },
     {
       "path": "skills/plan/openplanr.skill.json",
-      "digest": "sha256:18ed9de64dccee4d48bb9e94074cade3c6cda46e3c5eb9957eb96f4d319695a8"
+      "digest": "sha256:e91d221a286bd91b3b7a2343cea8c73564cb3401b968854d38bcf8a9790131f1"
     },
     {
       "path": "skills/plan/references/artifact-contract.md",
       "digest": "sha256:b120b3f0380776db2a126cb05e2cd917710389bdd665574fe014aa5d6222914e"
     },
+    {
+      "path": "skills/plan/references/design-handoff.md",
+      "digest": "sha256:b918cc16855412a75028e1a014832c2ced59b0349461a24d9e1fdcfc336b9f5f"
+    },
     {
       "path": "skills/plan/schemas/design-document.schema.json",
       "digest": "sha256:bd84d34b42f9451f9ff836105a7a6c92b2d74209aa82f6a0dd973532edf99422"
@@ -928,7 +992,7 @@
     },
     {
       "path": "skills/plan/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
     },
     {
       "path": "skills/plan/scripts/planning-ids.mjs",
@@ -952,7 +1016,15 @@
     },
     {
       "path": "skills/plan/scripts/runtime/packages/design/templates/studio/enhancements.js",
-      "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
+      "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
+    },
+    {
+      "path": "skills/plan/scripts/runtime/packages/design/templates/studio/handoff-center.css",
+      "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
+    },
+    {
+      "path": "skills/plan/scripts/runtime/packages/design/templates/studio/handoff-center.js",
+      "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
     },
     {
       "path": "skills/plan/scripts/runtime/packages/design/templates/studio/share.css",
@@ -972,7 +1044,7 @@
     },
     {
       "path": "skills/plan/scripts/runtime/packages/protocol/package.json",
-      "digest": "sha256:d3a009b9b304680df08d3ec30bccea5b0baf7444fee4f65e90708125535d8773"
+      "digest": "sha256:005fd84b459d0673203781da7693ffb28b379ef73096213fd6df5c2606617730"
     },
     {
       "path": "skills/plan/scripts/runtime/packages/protocol/registry/artifact-theme.json",
@@ -1014,6 +1086,18 @@
       "path": "skills/plan/scripts/runtime/packages/protocol/schemas/v1.10.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:ba8ac124e47e8f8310214445b1752cc6706d3a7265a87c9f9685a7e9df84f0b1"
     },
+    {
+      "path": "skills/plan/scripts/runtime/packages/protocol/schemas/v1.11.0/design-handoff-readiness.schema.json",
+      "digest": "sha256:51277b0c353989c7166535b6b8c752226fd436b735e451940c79a3f6a9c8eb12"
+    },
+    {
+      "path": "skills/plan/scripts/runtime/packages/protocol/schemas/v1.11.0/design-implementation-handoff.schema.json",
+      "digest": "sha256:706227c6663dce427f724584bd2d6cb4c65123171ec6540c3ec30e6a36b4d68b"
+    },
+    {
+      "path": "skills/plan/scripts/runtime/packages/protocol/schemas/v1.11.0/design-planning-lineage.schema.json",
+      "digest": "sha256:e54a4026444de9cd6092aae4b3bfe7f527254941c07fb29253ea8bb6f2ee8486"
+    },
     {
       "path": "skills/plan/scripts/runtime/packages/protocol/schemas/v1.11.0/design-review-metadata-payload.schema.json",
       "digest": "sha256:2339f1babeef83bb7a19d53232a12ac432652a4da7e49c8a5417ff795a0265ed"
@@ -1044,7 +1128,7 @@
     },
     {
       "path": "skills/plan/SKILL.md",
-      "digest": "sha256:6cf56b17592d6dc12527582e9a9656025b603c2a8d03bccf838466e3f8dcb4a6"
+      "digest": "sha256:9bffae95a3a760daa58dbfdf5d6e4ae6b9015549a0fea4dab754b7f05ca7355e"
     },
     {
       "path": "skills/release/agents/openai.yaml",
@@ -1088,7 +1172,11 @@
     },
     {
       "path": "skills/ship/openplanr.skill.json",
-      "digest": "sha256:1a2c6b2f7c69b364bbf6f2e7cc90abfcf75eaac4e8d10f4d4fd60af7d101e3a8"
+      "digest": "sha256:4ad07e8b30a574bd7f12f87fe3852103c20241dd1e73dfcdb25e250c6b7d28f4"
+    },
+    {
+      "path": "skills/ship/references/design-lineage.md",
+      "digest": "sha256:0cf8cce235b6e258c066e65dcc25480f10aca6f0c3200de332fc278e3b7975a9"
     },
     {
       "path": "skills/ship/references/result-contract.md",
@@ -1100,7 +1188,7 @@
     },
     {
       "path": "skills/ship/SKILL.md",
-      "digest": "sha256:487b0a3fa73c319292a407cc2e6e5a2e65bd657ff21c9615b0d61c3b755fe012"
+      "digest": "sha256:fdf8113b3f5564d5ddd5a4d93d47ec2994c3e8fefa94fa37bc1e5efbe6798c9c"
     },
     {
       "path": "skills/spec/agents/openai.yaml",
@@ -1171,5 +1259,5 @@
       "digest": "sha256:53698324b62f43b672ce8fe1654c526c96fb202e313442f09c6fc1e72268677e"
     }
   ],
-  "contentDigest": "sha256:c8487dca175135756a56c5da0536c6a70958ee85ea704b745315ec6226e6e037"
+  "contentDigest": "sha256:43d99dd0fba75e793114c9a0d31f741cfd7e9e96ce00c63eb3b44ef41314c0fe"
 }

package/lib/host-packages/openai/openplanr/skills/design/SKILL.md

@@ -71,3 +71,6 @@ Review for focused iteration on an existing direction.
 For company reviews and implementation handoff, follow
 [team-review.md](references/team-review.md). Keep review guidance outside product
 screens, preserve reviewer intent, and let the owner approve the refined handoff.
+After approval, **Continue to Plan** is one explicit owner action that returns a
+host-native `/planr:plan` or `$planr:plan` invocation bound to the exact package.
+It does not write planning files, dispatch an agent, change Git, or start Ship.

package/lib/host-packages/openai/openplanr/skills/design/openplanr.skill.json

@@ -3,7 +3,7 @@
   "schemaVersion": "1.0.0",
   "protocolVersion": "1.8.0",
   "skillId": "planr-design",
-  "skillVersion": "2.0.0",
+  "skillVersion": "2.1.0",
   "entrypoint": "SKILL.md",
   "hosts": [
     "claude-code",
@@ -198,6 +198,28 @@
         "cursor"
       ]
     },
+    {
+      "path": "scripts/runtime/packages/design/templates/studio/handoff-center.css",
+      "kind": "asset",
+      "executable": false,
+      "hosts": [
+        "claude-code",
+        "codex",
+        "chatgpt",
+        "cursor"
+      ]
+    },
+    {
+      "path": "scripts/runtime/packages/design/templates/studio/handoff-center.js",
+      "kind": "asset",
+      "executable": false,
+      "hosts": [
+        "claude-code",
+        "codex",
+        "chatgpt",
+        "cursor"
+      ]
+    },
     {
       "path": "scripts/runtime/packages/design/templates/studio/share.css",
       "kind": "asset",
@@ -363,6 +385,39 @@
         "cursor"
       ]
     },
+    {
+      "path": "scripts/runtime/packages/protocol/schemas/v1.11.0/design-handoff-readiness.schema.json",
+      "kind": "schema",
+      "executable": false,
+      "hosts": [
+        "claude-code",
+        "codex",
+        "chatgpt",
+        "cursor"
+      ]
+    },
+    {
+      "path": "scripts/runtime/packages/protocol/schemas/v1.11.0/design-implementation-handoff.schema.json",
+      "kind": "schema",
+      "executable": false,
+      "hosts": [
+        "claude-code",
+        "codex",
+        "chatgpt",
+        "cursor"
+      ]
+    },
+    {
+      "path": "scripts/runtime/packages/protocol/schemas/v1.11.0/design-planning-lineage.schema.json",
+      "kind": "schema",
+      "executable": false,
+      "hosts": [
+        "claude-code",
+        "codex",
+        "chatgpt",
+        "cursor"
+      ]
+    },
     {
       "path": "scripts/runtime/packages/protocol/schemas/v1.11.0/design-review-metadata-payload.schema.json",
       "kind": "schema",

package/lib/host-packages/openai/openplanr/skills/design/references/handoff.md

@@ -40,6 +40,41 @@ Generated previews and copied runtimes are separate from authored source. Follow
 the project's tracking conventions; never discard editable source or the prior
 working revision merely to clean generated output.
 
+## Implementation package custody
+
+After review feedback has explicit owner decisions and the current review handoff
+is approved, the owner may prepare an implementation package. The package is a
+compact navigation and acceptance aid; it never replaces the design document,
+screen sources, `design-spec.md`, verification record, review ledger or approved
+review handoff.
+
+- Keep source references repository-relative and bind them to their exact revision
+  and integrity value. A screen, component, state, flow, token, review decision or
+  element anchor must resolve exactly once inside the repository.
+- Keep canonical bodies in their owning files. Do not embed whole HTML documents,
+  screenshots, design documents, review ledgers or source code in the package.
+- Give every implementation requirement observable verification and one or more
+  stable source references. Requirement IDs derive from canonical requirement
+  content and ordered references; do not renumber them for presentation.
+- Treat `implementation-handoff/draft.json` as the machine record and
+  `implementation-handoff/draft.md` as its generated human projection. Never edit
+  the Markdown independently. Portable import validates JSON first and then exact
+  Markdown parity; optional source verification can run fully offline.
+- Drafting, regeneration, export and import grant no Plan, Ship, Git, release,
+  publication or deployment authority. Package approval and immutable history are
+  separate owner actions.
+- Approval binds the exact draft version and internal content identity loaded by
+  the owner. The confirmation describes the title, revision, requirement count,
+  unresolved nonblocking items and `Prepare Plan` effect; integrity values stay
+  out of the decision copy.
+- Approved packages live below `implementation-handoff/versions/` and never
+  change. `implementation-handoff/current.json` is a small lifecycle pointer;
+  supersession and revocation append auditable events without rewriting history.
+  Regeneration always creates a newer draft version. Exact request retries reuse
+  their completed result, while reused request IDs with different input conflict.
+- Approval authorizes only preparation for a later Plan invocation. It never
+  starts Plan, Ship, an agent, a Git write, publication, release or deployment.
+
 Return concise links to the studio, document/source, specification and quality
 result. State the selected direction and any decisions still open. Plan can read
 the specification and selected sources to create UI tasks; it must not re-extract