npm - openplanr - Versions diffs - 2.4.0 → 2.5.0 - Mend

openplanr 2.4.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

package/dist/dashboard/dashboard-manifest.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "kind": "openplanr-dashboard-build",
   "schemaVersion": "1.0.0",
-  "buildId": "dashboard-0.1.3-8602ee3a3b134707",
+  "buildId": "dashboard-0.1.4-20b68709bc139f8b",
   "entry": "index.html",
   "assets": [
     "assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2",
@@ -15,8 +15,8 @@
     "assets/geist-mono-symbols2-wght-normal-CO5SzqOn.woff2",
     "assets/geist-mono-vietnamese-wght-normal-DadHysG0.woff2",
     "assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2",
-    "assets/index-B74ddyXA.js",
-    "assets/index-B74ddyXA.js.map",
+    "assets/index-BaARCc1f.js",
+    "assets/index-BaARCc1f.js.map",
     "assets/index-Bk8DyO_2.css"
   ],
   "assetDigests": {
@@ -64,13 +64,13 @@
       "bytes": 8004,
       "sha256": "sha256:8fa40e5d248247735eb97a0bd593b8852440430600d6ba01364c31fe0abc1fe1"
     },
-    "assets/index-B74ddyXA.js": {
+    "assets/index-BaARCc1f.js": {
       "bytes": 942574,
-      "sha256": "sha256:a712e2c795e0aed70493edb66085616c8ef59cbf5a1ad3fcc4b52dffc67cca6e"
+      "sha256": "sha256:21060e351ae710d00ffcc2e84baa40a30a0a1a8d89aab99451091f1b7f4f060f"
     },
-    "assets/index-B74ddyXA.js.map": {
+    "assets/index-BaARCc1f.js.map": {
       "bytes": 3425939,
-      "sha256": "sha256:ff10c58e1b4fb7b21bf4980bd72cb9f5ee4ea43db660c3dd5a8701909880d49a"
+      "sha256": "sha256:9a8a382c016dd70e7781950eca3a33d050fd57a2c401ec7cfc1deb2a4f56f121"
     },
     "assets/index-Bk8DyO_2.css": {
       "bytes": 187656,
@@ -78,7 +78,7 @@
     },
     "index.html": {
       "bytes": 396,
-      "sha256": "sha256:0fc2c6cd199917b333318025a2169ddedff0d5b8d901a18ffc77653baa732b9c"
+      "sha256": "sha256:def5394173bb70660038c676f1c1ba5f0cb80760e33b1db8d51c9a1a8407c50b"
     }
   }
 }

package/dist/dashboard/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>OpenPlanr</title>
-    <script type="module" crossorigin src="./assets/index-B74ddyXA.js"></script>
+    <script type="module" crossorigin src="./assets/index-BaARCc1f.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-Bk8DyO_2.css">
   </head>
   <body>

package/lib/host-packages/adapter-registry.json CHANGED Viewed

@@ -2,12 +2,12 @@
   "kind": "host-native-adapter-registry",
   "schemaVersion": "1.0.0",
   "protocolVersion": "1.8.0",
-  "pipelineVersion": "0.47.0",
-  "pluginVersion": "2.4.0",
+  "pipelineVersion": "0.48.0",
+  "pluginVersion": "2.5.0",
   "adapters": [
     {
       "id": "claude-code",
-      "version": "2.4.0",
+      "version": "2.5.0",
       "capabilityLevel": "product",
       "installScopes": [
         "user",
@@ -19,7 +19,7 @@
     },
     {
       "id": "codex",
-      "version": "2.4.0",
+      "version": "2.5.0",
       "capabilityLevel": "product",
       "installScopes": [
         "user",
@@ -31,7 +31,7 @@
     },
     {
       "id": "cursor",
-      "version": "2.4.0",
+      "version": "2.5.0",
       "capabilityLevel": "workflow",
       "installScopes": [
         "project"

package/lib/host-packages/capability-map.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "kind": "openplanr-capability-map",
   "schemaVersion": "1.0.0",
-  "pluginVersion": "2.4.0",
+  "pluginVersion": "2.5.0",
   "families": [
     {
       "id": "planning",

package/lib/host-packages/claude/.claude-plugin/marketplace.json CHANGED Viewed

@@ -5,14 +5,14 @@
     "name": "AsemDevs"
   },
   "metadata": {
-    "version": "2.4.0",
+    "version": "2.5.0",
     "description": "Generated local OpenPlanr package."
   },
   "plugins": [
     {
       "name": "planr",
       "source": "./openplanr",
-      "version": "2.4.0",
+      "version": "2.5.0",
       "description": "Host-native OpenPlanr skills and role agents for Claude Code.",
       "strict": true
     }

package/lib/host-packages/claude/openplanr/.claude-plugin/plugin.json CHANGED Viewed

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

package/lib/host-packages/claude/openplanr/.openplanr-content.json CHANGED Viewed

@@ -8,7 +8,7 @@
   "files": [
     {
       "path": ".claude-plugin/plugin.json",
-      "digest": "sha256:5794fedfc3356b66d55de47a5ff85b6987a6c8b312bd9cd2c734177b2495487c"
+      "digest": "sha256:b3f1e63831be935ab83e7cccd226ed6c4f8f0b08119d359081b7cce06dc716dd"
     },
     {
       "path": "agents/planr-backend.md",
@@ -372,7 +372,7 @@
     },
     {
       "path": "skills/design-loop/openplanr.skill.json",
-      "digest": "sha256:8e4eeb36590194963d6e8f6448e8d991658bf93a2070b0cb446b45ad793e3a49"
+      "digest": "sha256:cecdbd16879f58de70d1158b776fb47ac5520e22c2d6c0d01b3c6b8c4c843ced"
     },
     {
       "path": "skills/design-loop/references/craft.md",
@@ -396,7 +396,7 @@
     },
     {
       "path": "skills/design-loop/references/handoff.md",
-      "digest": "sha256:dddc50fe5167884b38523fcbcb99cb3525fd28a5ccf7999409212f52845e9219"
+      "digest": "sha256:238ef2f458c84e0c7832ad7267d79cb234390c5a1016b636dba04fe0e7304774"
     },
     {
       "path": "skills/design-loop/references/review.md",
@@ -424,7 +424,7 @@
     },
     {
       "path": "skills/design-loop/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
     },
     {
       "path": "skills/design-loop/scripts/runtime/notices/entities.txt",
@@ -464,7 +464,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",
@@ -506,6 +506,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"
@@ -540,7 +552,7 @@
     },
     {
       "path": "skills/design-review/openplanr.skill.json",
-      "digest": "sha256:11c7f60feaba70cb6bc439244164ec946ae76c68c4bf46bd4d1d8c916d80ee90"
+      "digest": "sha256:6ac49ca8fd2f709aff25f192f55e9c530b95715a626af01afef2ed1d2170e340"
     },
     {
       "path": "skills/design-review/references/craft.md",
@@ -564,7 +576,7 @@
     },
     {
       "path": "skills/design-review/references/handoff.md",
-      "digest": "sha256:dddc50fe5167884b38523fcbcb99cb3525fd28a5ccf7999409212f52845e9219"
+      "digest": "sha256:238ef2f458c84e0c7832ad7267d79cb234390c5a1016b636dba04fe0e7304774"
     },
     {
       "path": "skills/design-review/references/review.md",
@@ -592,7 +604,7 @@
     },
     {
       "path": "skills/design-review/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
     },
     {
       "path": "skills/design-review/scripts/runtime/notices/entities.txt",
@@ -632,7 +644,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",
@@ -674,6 +686,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"
@@ -704,11 +728,11 @@
     },
     {
       "path": "skills/design-review/SKILL.md",
-      "digest": "sha256:2ef0b93b8132f4c84982b8e94ce58c4ef5c10642df9f9e63148fa3aa23b0d15e"
+      "digest": "sha256:1abdbeffe66b6afadb51d3719486665ee374f8aba9bf17ddf54ac4e1f185dc23"
     },
     {
       "path": "skills/design/openplanr.skill.json",
-      "digest": "sha256:208206addf0dc8337f1914256ba6b655edf570d7cdfb7ebd62c73b29299fba95"
+      "digest": "sha256:83457207042925d16148dd28054ef69f00c4358136da7eaadc286f01bc6a0797"
     },
     {
       "path": "skills/design/references/craft.md",
@@ -732,7 +756,7 @@
     },
     {
       "path": "skills/design/references/handoff.md",
-      "digest": "sha256:dddc50fe5167884b38523fcbcb99cb3525fd28a5ccf7999409212f52845e9219"
+      "digest": "sha256:238ef2f458c84e0c7832ad7267d79cb234390c5a1016b636dba04fe0e7304774"
     },
     {
       "path": "skills/design/references/review.md",
@@ -760,7 +784,7 @@
     },
     {
       "path": "skills/design/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
     },
     {
       "path": "skills/design/scripts/runtime/notices/entities.txt",
@@ -800,7 +824,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",
@@ -842,6 +866,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"
@@ -872,7 +908,7 @@
     },
     {
       "path": "skills/design/SKILL.md",
-      "digest": "sha256:0ba7b0388e7acc4f9111a5cc69f8d55a1dc2ba54ab20e8274ff7384f4410c9ec"
+      "digest": "sha256:3265e760e594a16eadc88d46045a3c80546797fcc5cd11985b9c7ccfd89df014"
     },
     {
       "path": "skills/diagram/openplanr.skill.json",
@@ -964,12 +1000,16 @@
     },
     {
       "path": "skills/plan/openplanr.skill.json",
-      "digest": "sha256:18ed9de64dccee4d48bb9e94074cade3c6cda46e3c5eb9957eb96f4d319695a8"
+      "digest": "sha256:a1e090540db3a4edc2694e1a24c6fc0af85838eb7ee3138cdc53f4be69803479"
     },
     {
       "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"
@@ -984,7 +1024,7 @@
     },
     {
       "path": "skills/plan/scripts/design.mjs",
-      "digest": "sha256:159012cae538612641c4d142ec2fb5054278e5a17cdadf5decf33becf78533d1"
+      "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
     },
     {
       "path": "skills/plan/scripts/planning-ids.mjs",
@@ -1028,7 +1068,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",
@@ -1070,6 +1110,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"
@@ -1100,7 +1152,7 @@
     },
     {
       "path": "skills/plan/SKILL.md",
-      "digest": "sha256:6cf56b17592d6dc12527582e9a9656025b603c2a8d03bccf838466e3f8dcb4a6"
+      "digest": "sha256:9bffae95a3a760daa58dbfdf5d6e4ae6b9015549a0fea4dab754b7f05ca7355e"
     },
     {
       "path": "skills/release/assets/changelog-template.md",
@@ -1136,7 +1188,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",
@@ -1148,7 +1204,7 @@
     },
     {
       "path": "skills/ship/SKILL.md",
-      "digest": "sha256:487b0a3fa73c319292a407cc2e6e5a2e65bd657ff21c9615b0d61c3b755fe012"
+      "digest": "sha256:fdf8113b3f5564d5ddd5a4d93d47ec2994c3e8fefa94fa37bc1e5efbe6798c9c"
     },
     {
       "path": "skills/spec/openplanr.skill.json",
@@ -1203,5 +1259,5 @@
       "digest": "sha256:53698324b62f43b672ce8fe1654c526c96fb202e313442f09c6fc1e72268677e"
     }
   ],
-  "contentDigest": "sha256:eb202b321a4c962fd48684883eae51048afd993d3ac4b2816991f3aefaa5a4db"
+  "contentDigest": "sha256:dc8f46efa9c9359caa6e9f53aa67e1468ac6e94b46ea628b149578453f22a668"
 }

package/lib/host-packages/claude/openplanr/skills/design/SKILL.md CHANGED Viewed

@@ -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/claude/openplanr/skills/design/openplanr.skill.json CHANGED Viewed

@@ -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",
@@ -363,6 +363,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/claude/openplanr/skills/design/references/handoff.md CHANGED Viewed

@@ -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