@temporal-architect/claude-plugin 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jacob Barzee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @temporal-architect/claude-plugin
+
+The skills payload for the [temporal-architect Claude Code plugin](https://github.com/jmbarzee/temporal-architect).
+
+You almost certainly don't want to install this directly. It's the npm-side
+delivery vehicle that Claude Code's marketplace mechanism pulls from when a
+user installs the `temporal-architect` plugin.
+
+## Install (the user-facing way)
+
+```text
+/plugin marketplace add jmbarzee/temporal-architect
+/plugin install temporal-architect@temporal-architect
+```
+
+Bundles:
+
+- **Skills** — `temporal-architect-design`, `temporal-architect-author-go`, and
+  `temporal-architect-author-infra`, available to Claude as auto-discoverable agent skills.
+- **MCP server** — the `twf` MCP server (via `npx -y @temporal-architect/twf mcp`),
+  exposing TWF parser tools, embedded spec resources, and skill prompts.
+
+The plugin definition itself lives in
+[`.claude-plugin/marketplace.json`](https://github.com/jmbarzee/temporal-architect/blob/main/.claude-plugin/marketplace.json)
+at the repo root and uses `strict: false` to declare components inline. This
+npm package contributes only the `skills/` payload.
+
+## Source of truth
+
+The skills shipped here are a build-time copy of the canonical
+[`skills/`](https://github.com/jmbarzee/temporal-architect/tree/main/skills) at
+the repo root. Edit there, then `make build-claude-plugin` regenerates the
+copy. The copy is gitignored — it only exists in this directory after a
+local build or during npm publish.
+
+## License
+
+MIT — see the bundled `LICENSE` (copied from the repo root at pack time).

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@temporal-architect/claude-plugin",
+  "version": "0.9.0",
+  "description": "Claude Code plugin payload for temporal-architect — the `.twf` architecture toolchain for designing, validating, and implementing entire Temporal systems (design, Go-authoring, and infra-provisioning skills, plus the twf MCP server).",
+  "license": "MIT",
+  "homepage": "https://github.com/jmbarzee/temporal-architect",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jmbarzee/temporal-architect-dist",
+    "directory": "packages/npm/claude-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/jmbarzee/temporal-architect/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "claude-plugin",
+    "temporal",
+    "workflow",
+    "twf",
+    "architecture",
+    "system design",
+    "mcp"
+  ],
+  "files": [
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepack": "cp ../../../LICENSE LICENSE",
+    "postpack": "rm -f LICENSE"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/MANIFEST.json

@@ -0,0 +1,373 @@
+{
+  "version": "v0.9.0",
+  "root": "skills",
+  "file_count": 73,
+  "total_bytes": 396474,
+  "files": [
+    {
+      "path": "MANIFEST.md",
+      "size": 4254,
+      "sha256": "3afdfadca9821c48bb3710f3e3ff62e0bb925a2856cdefaf95103b31ecea8186"
+    },
+    {
+      "path": "temporal-architect-author-go/README.md",
+      "size": 999,
+      "sha256": "2e46ba11aafc3bc031712698326d421c4c06281bc050db90775c5dd857f24236"
+    },
+    {
+      "path": "temporal-architect-author-go/SKILL.md",
+      "size": 12045,
+      "sha256": "126e414e59d99af8dd2bb6fec56ce725707dcb7d1ab311f8914b7875392624e3"
+    },
+    {
+      "path": "temporal-architect-author-go/SUBAGENT_ADOPTION.md",
+      "size": 7371,
+      "sha256": "7de7b6a7c59ac9d34d6572c5d8e0eff6ab1c741876f82aea8615a7a65cb9e194"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/activity-call.md",
+      "size": 2543,
+      "sha256": "baae81a991f009e5b9a8bc71691de9e069848bd8d5ef05a254d074fa2d51af24"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/activity-def.md",
+      "size": 2409,
+      "sha256": "58f222ed5ae6f6b60362dd9ddf431c35cd18bd21bb787c8eb16235e92c45ec8f"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/assignment.md",
+      "size": 1341,
+      "sha256": "5c8c0e87391469cad42855b73516937b6d7798457e975cc303a2258d1712254c"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/await-all.md",
+      "size": 2516,
+      "sha256": "38372b6a0460aba61964571ff0e2153c5c0cf11fd6f591a182ff21952cc1ac5e"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/await-one.md",
+      "size": 7259,
+      "sha256": "c2aea56de4a7a49e475d3bc966ba7bda6195e7d1da0edb1287e28ddca2d92623"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/await-timer.md",
+      "size": 963,
+      "sha256": "5180ce93b6a62517f8b09a8cf4179ce9f071c408d21b8771332214f3d446f16e"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/close.md",
+      "size": 1985,
+      "sha256": "c1bb60956727e537b1811d9f0dcf358767be8add2ee85dd5f65c01590e34b353"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/composite-patterns.md",
+      "size": 6452,
+      "sha256": "27e09a61b486667c680580e681ab0dc27dacf499168138c190e6c50387003555"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/condition.md",
+      "size": 2191,
+      "sha256": "7a9f1f31f6beec56bfbfb9e9bb7d663506ce9750151b9a32a8bae77ea922bd56"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/control-flow.md",
+      "size": 3065,
+      "sha256": "2021ab5c5ffeee72bd5b3493a2ef15c8119d32f2dccba9ae9e7ca26953807843"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/dependency-resolution.md",
+      "size": 1629,
+      "sha256": "48669909edd2e948c7b03a028a1a652f07da043e325033e2c604f3ff7a29170e"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/detach.md",
+      "size": 2485,
+      "sha256": "000e97ebd9b7e5d4ad425c89274d77912aecceae7cdc11767c54fa2464329681"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/heartbeat.md",
+      "size": 2900,
+      "sha256": "67977d94bdb3ca80887670a38bdbcfa9edae3a210a2c5e0a8c13569f7887819b"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/nexus-service-def.md",
+      "size": 3497,
+      "sha256": "41e4f6a0c01e6a8f75fa3ff360c42ee45d117b51eedf199325d19e5406a422f0"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/nexus.md",
+      "size": 2049,
+      "sha256": "c2f521e6d20225badad9aaef418097ad0e84dfbf5d46f824732cf1685cad8c2b"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/options.md",
+      "size": 4666,
+      "sha256": "41a6e25bd0fb87cb490c270f618cd1339133ab9227e1d6563ae09f25349e69ee"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/promise.md",
+      "size": 2476,
+      "sha256": "2fad47675d803dd157fc4a342dcac824f8df3ac0c7721d6900c48cd1fc9eb3ba"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/proto-driven.md",
+      "size": 7470,
+      "sha256": "db7388afdc1ac3a27743826f64f65a87633b6fbf13bc1da2c5fd89da826a2ac5"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/query-handler.md",
+      "size": 1450,
+      "sha256": "bd6b66d4b126423c2a05bfc8bddfa2bc5608f967fdd4c07bd41478f24dcabe3f"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/signal-handler.md",
+      "size": 2900,
+      "sha256": "e953ee2ecac5ebbc344f71c4004d15c7c0cb98807dd7bd1d8bd6f3ca796e8676"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/three-layer-testing.md",
+      "size": 7217,
+      "sha256": "860337a4d464c0f7b1e539a123abe5c0c9c5123685c850cbc1778477d5566e79"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/types.md",
+      "size": 3846,
+      "sha256": "c442f491adae176b51809e987d97b1a37bfc3ec3f840a240a2449f4818e0bb11"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/update-handler.md",
+      "size": 3279,
+      "sha256": "14872fab4cc4c0e80a6e9eea9fa0728c314c2d4c962f5c8a470c35a7611036f4"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/worker.md",
+      "size": 10293,
+      "sha256": "2e73f0f9f2a56962ff9ce61a7bea76d78efc42dc87ad4d5dc451f066a49d71ea"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/workflow-call.md",
+      "size": 2071,
+      "sha256": "da4dff1e7750301858d2af905785afe7104ca7a8e62da7156121035cfe3e7fc4"
+    },
+    {
+      "path": "temporal-architect-author-go/reference/workflow-def.md",
+      "size": 1874,
+      "sha256": "ae023bb104a2b8a37e9576650cb13e91a3e34f650ba8b0db868c70ed542cd6a7"
+    },
+    {
+      "path": "temporal-architect-author-infra/README.md",
+      "size": 1254,
+      "sha256": "e79e7f71a25409c9f84fd1c7fdd4807c9810ed3a9327b8fa839899771ba1bde4"
+    },
+    {
+      "path": "temporal-architect-author-infra/SKILL.md",
+      "size": 9118,
+      "sha256": "dd57f3308d3ea429926ae63c5e93717587d2cf83cb730ce75c45dbc29d7e9944"
+    },
+    {
+      "path": "temporal-architect-author-infra/reference/tcld.md",
+      "size": 3940,
+      "sha256": "2c5c4f6fa5b3380b42e4dff26bafef10cca3f1998e02877c5edd923f12e01403"
+    },
+    {
+      "path": "temporal-architect-author-infra/reference/terraform.md",
+      "size": 5178,
+      "sha256": "cb8087a00f5b966987eda6cb938215014d9a04f1a41e63c01caeb83d46620125"
+    },
+    {
+      "path": "temporal-architect-design/README.md",
+      "size": 1021,
+      "sha256": "536d4cbdde8f526de2f5e9675798c77d588c2b218453e33e57ecec90d5c24e43"
+    },
+    {
+      "path": "temporal-architect-design/SKILL.md",
+      "size": 15302,
+      "sha256": "249388112c454f79ea135ecc3ed54868f1f8b91ef52281136b924ff5cf75af49"
+    },
+    {
+      "path": "temporal-architect-design/reference/LANGUAGE.md",
+      "size": 399,
+      "sha256": "0b7a8338dd5376d5f461b5f11443933d310bd6bed2883650cd8f91cbd364e5ed"
+    },
+    {
+      "path": "temporal-architect-design/reference/anti-patterns.md",
+      "size": 13999,
+      "sha256": "a0938fdb4937fbd88c62c3f8fb80c673df3f0d68720d6780970e516efc8dba6d"
+    },
+    {
+      "path": "temporal-architect-design/reference/common-errors.md",
+      "size": 9037,
+      "sha256": "8829d66240e59ef95e81c10544b85283091102468a7b768fb5e7c712389ab8f4"
+    },
+    {
+      "path": "temporal-architect-design/reference/core-principles.md",
+      "size": 3951,
+      "sha256": "c27d169baf6bf72e5b508ee130c75ccf50f1c4b4dab7e1fc1f95f280fe90781b"
+    },
+    {
+      "path": "temporal-architect-design/reference/design-checklist.md",
+      "size": 3351,
+      "sha256": "ac5eea965436614a15ff24ab9811da0f86d097d5f506e235fd64caad01429c54"
+    },
+    {
+      "path": "temporal-architect-design/reference/namespaces.md",
+      "size": 4217,
+      "sha256": "56d79ba149394ffd645916a7495247d6fef60918b461c8a7081f7af99569c5c3"
+    },
+    {
+      "path": "temporal-architect-design/reference/notation-examples.md",
+      "size": 9269,
+      "sha256": "9dfea38be2e151a694453998c6efcd8715b900ebbe0e36a0f978f2d7fc1fd38b"
+    },
+    {
+      "path": "temporal-architect-design/reference/notation-reference.md",
+      "size": 5656,
+      "sha256": "41592828cb0d587c8eed8b17f8f76f60bed8e86f60c883e5e4102721276b1e46"
+    },
+    {
+      "path": "temporal-architect-design/reference/primitives-reference.md",
+      "size": 4396,
+      "sha256": "d6605500b3925a80323860dfc6ae356c56efb41edb07daa828a4fde82974c4f1"
+    },
+    {
+      "path": "temporal-architect-design/reference/project-discovery-subagent.md",
+      "size": 4894,
+      "sha256": "e64b1469c2d6f5dcfdd38659e25b8a7c3d4f5ecb4afdcb9e90034329e67cc9fd"
+    },
+    {
+      "path": "temporal-architect-design/reference/reverse-engineering.md",
+      "size": 5270,
+      "sha256": "c802a6d440916a72919060ad21e2801e5e78e0c2facc08a6ac46d123ffac632f"
+    },
+    {
+      "path": "temporal-architect-design/reference/twf-conventions.md",
+      "size": 2912,
+      "sha256": "9724bb70433ceefebb8c22097acb4c6890f8e0228b5fefb5a0835f0ef84a78f6"
+    },
+    {
+      "path": "temporal-architect-design/reference/workflow-boundaries.md",
+      "size": 2586,
+      "sha256": "9f851c0af03a9bf95b8a6d5ec5dfd56a2d6d128c386383756f42d4c5db39da85"
+    },
+    {
+      "path": "temporal-architect-design/topics/activities-advanced.md",
+      "size": 9747,
+      "sha256": "6b2bbde57b055a0c550885a465fecbc79a2dfde7edce0c7973d565f66c01da22"
+    },
+    {
+      "path": "temporal-architect-design/topics/activities-advanced.twf",
+      "size": 3178,
+      "sha256": "6e6fcf1adb0e002ca35196fa4502ad79378bc9ffcd0e68c9976edbcd3ff31459"
+    },
+    {
+      "path": "temporal-architect-design/topics/child-workflows.md",
+      "size": 11078,
+      "sha256": "384739095340feb0d158bb244a5c108e5b9df2c2c9f48da3ddc4ee14e4d13e50"
+    },
+    {
+      "path": "temporal-architect-design/topics/child-workflows.twf",
+      "size": 4889,
+      "sha256": "d773d0ba57fc7da7bb7b4d476f046ccfabfe37632f616b6ed5f0e4a696dd9b28"
+    },
+    {
+      "path": "temporal-architect-design/topics/long-running.md",
+      "size": 7149,
+      "sha256": "6772d7646d57288dc758a43ec8c930456822d5ca24ababaea07d27afcdd49404"
+    },
+    {
+      "path": "temporal-architect-design/topics/long-running.twf",
+      "size": 2608,
+      "sha256": "3e4f37ec0ef64358b00043bb257bd70956b530e7f6ac3ea9b2b6049549096c90"
+    },
+    {
+      "path": "temporal-architect-design/topics/nexus.md",
+      "size": 8428,
+      "sha256": "188f8e15ac16a9e75613363df8222aeb214d7ae460a6fcf47f715c82f5a59409"
+    },
+    {
+      "path": "temporal-architect-design/topics/nexus.twf",
+      "size": 4637,
+      "sha256": "d167e46d16c01455c2af346fe8af15e42bf2b90a9b4734b6091c5cd8767b6541"
+    },
+    {
+      "path": "temporal-architect-design/topics/patterns.md",
+      "size": 13335,
+      "sha256": "e963a1a1f2e3841c96aad08b5ecca3e7cfc52e8239af29816008a972c72f758e"
+    },
+    {
+      "path": "temporal-architect-design/topics/patterns.twf",
+      "size": 10171,
+      "sha256": "f7947716f3258993fff79de598129eb18783698f9271946eb1bfa87857a96e2d"
+    },
+    {
+      "path": "temporal-architect-design/topics/promises-conditions.md",
+      "size": 4998,
+      "sha256": "d34c43b734f31b8a3863e973c4c8ee869b738d1c09e6271613a09e21d4fceff3"
+    },
+    {
+      "path": "temporal-architect-design/topics/promises-conditions.twf",
+      "size": 5529,
+      "sha256": "5c550e4b531e81de0a886adde568953ca52c646de6e9e54e77ac5b2819456090"
+    },
+    {
+      "path": "temporal-architect-design/topics/signals-queries-updates.md",
+      "size": 12981,
+      "sha256": "5f79e7d1fdcaf6c2c0769d0a1d40f37226713cd0f1204aa4e66e5f40e13721b3"
+    },
+    {
+      "path": "temporal-architect-design/topics/signals-queries-updates.twf",
+      "size": 6628,
+      "sha256": "0248befa0889fd35ae59d8027910961499ed69623a4a79e0f6af86f1de34ec42"
+    },
+    {
+      "path": "temporal-architect-design/topics/task-queues.md",
+      "size": 7643,
+      "sha256": "47c0bdf11517516b0949876d88e9352578e3c9b0d0c543ee1e8e352f2c178480"
+    },
+    {
+      "path": "temporal-architect-design/topics/task-queues.twf",
+      "size": 5827,
+      "sha256": "75af6d10de2d52366fe91aa2c4aad67fa21c0a21c051f9c730bdc5a015d871af"
+    },
+    {
+      "path": "temporal-architect-design/topics/testing.md",
+      "size": 11725,
+      "sha256": "c06175ac136cf2b278cc1edab84ce074738998028c503eb7ef7b0666a8e8753e"
+    },
+    {
+      "path": "temporal-architect-design/topics/testing.twf",
+      "size": 5243,
+      "sha256": "34b1a9e399767fbdcf4c8d3b3e29f3999985619313c803758e2d851ee3da02e0"
+    },
+    {
+      "path": "temporal-architect-design/topics/timers-scheduling.md",
+      "size": 4168,
+      "sha256": "3e41baf677d4ea3aff3011f31fbb0fbc88873de97c698c353c2723bf78c70d7e"
+    },
+    {
+      "path": "temporal-architect-design/topics/timers-scheduling.twf",
+      "size": 3530,
+      "sha256": "099fa6f65e498ec897b66e0db52437df1a221e1740d7d6a169b62d92530113e5"
+    },
+    {
+      "path": "temporal-architect-design/topics/versioning.md",
+      "size": 11755,
+      "sha256": "0697f629e351d332bbb5a6c798576516e12dce567b91c49589923bcb8b62d7b3"
+    },
+    {
+      "path": "temporal-architect-design/topics/versioning.twf",
+      "size": 4675,
+      "sha256": "5813ee3a2808dd226619225282c2ea612c4aaf49fe320b2f944c0602b8330d63"
+    },
+    {
+      "path": "temporal-architect/SKILL.md",
+      "size": 9177,
+      "sha256": "0cefde6d7e750a601f9665265e1e0a9490654d192b8b293704fb026c0b7db065"
+    },
+    {
+      "path": "temporal-architect/reference/decomposition.md",
+      "size": 6130,
+      "sha256": "205bb84e3e8febe563ab5696c94346184896a66d61335201229befa629af3ba1"
+    }
+  ]
+}

package/skills/MANIFEST.md

@@ -0,0 +1,121 @@
+# Skills Bundle Manifest
+
+Each `v*` release of `temporal-architect` attaches a deterministic tarball of
+the `skills/` tree as a GitHub Release asset, so downstream consumers
+(prompt builders, doc tooling, non-Go runtimes) can pin a single archive +
+checksum instead of vendoring individual files or scraping raw GitHub URLs.
+
+This document is the stable contract for that bundle.
+
+## Asset names
+
+```
+skills-vX.Y.Z.tar.gz          # the bundle (always gzipped tar)
+SHA256SUMS                    # checksum file shared with the twf binaries
+```
+
+The `SHA256SUMS` file is the same one that pins the `twf-*` binaries, so
+verification flows uniformly:
+
+```bash
+grep "skills-vX.Y.Z.tar.gz" SHA256SUMS | sha256sum --check
+```
+
+## Tarball layout
+
+The tarball reproduces the repo's `skills/` directory verbatim, with one
+addition — a `MANIFEST.json` at the root:
+
+```
+skills/
+  MANIFEST.json
+  temporal-architect-design/
+    SKILL.md
+    reference/...
+    topics/...
+  temporal-architect-author-go/
+    SKILL.md
+    reference/...
+  temporal-architect-author-infra/
+    SKILL.md
+    reference/...
+```
+
+The top-level directory is always `skills/`. Untar in place to drop the
+tree at any location.
+
+## `MANIFEST.json` schema
+
+```json
+{
+  "version":     "v0.3.0",
+  "root":        "skills",
+  "file_count":  60,
+  "total_bytes": 280417,
+  "files": [
+    {
+      "path":   "temporal-architect-design/SKILL.md",
+      "size":   9150,
+      "sha256": "b871ea8b982130d282c5578d2847b319525f87bc8a9dec98cf23fcc2b0819be3"
+    }
+  ]
+}
+```
+
+### Field semantics
+
+| Field         | Type    | Notes                                                                |
+|---------------|---------|----------------------------------------------------------------------|
+| `version`     | string  | Matches the Git tag (e.g. `v0.3.0`); is the `--version` flag value.  |
+| `root`        | string  | Top-level directory inside the tarball. Always `"skills"`.           |
+| `file_count`  | integer | Number of entries in `files`.                                        |
+| `total_bytes` | integer | Sum of `size` across all files. Excludes `MANIFEST.json` itself.     |
+| `files`       | array   | Sorted lexicographically by `path`. Excludes `MANIFEST.json`.        |
+| `files[].path`   | string  | Forward-slash, relative to `root` (e.g. `"temporal-architect-design/SKILL.md"`). |
+| `files[].size`   | integer | File size in bytes.                                                |
+| `files[].sha256` | string  | Lowercase-hex SHA-256 of the file's raw bytes.                    |
+
+`MANIFEST.json` does not include an entry for itself. This keeps the
+schema's hash → file-content invariant trivially verifiable without
+solving a fixed-point equation.
+
+## Determinism guarantees
+
+- File entries in `MANIFEST.json` are sorted by `path` (lexicographic).
+- Tar headers use a fixed mtime (Unix epoch), uid/gid 0, mode 0644 for
+  regular files and 0755 for directories, and PAX format.
+- The gzip header is written without an embedded filename or timestamp.
+- Two runs over the same source bytes (and same `--version`) produce
+  byte-identical archives — and therefore identical `SHA256SUMS` entries.
+
+This makes the bundle safe to checksum-pin in lockfiles and CI caches.
+
+## Verification snippet
+
+```bash
+# Download once
+curl -sSfLO https://github.com/jmbarzee/temporal-architect/releases/download/vX.Y.Z/skills-vX.Y.Z.tar.gz
+curl -sSfLO https://github.com/jmbarzee/temporal-architect/releases/download/vX.Y.Z/SHA256SUMS
+
+# Verify tarball
+grep "skills-vX.Y.Z.tar.gz" SHA256SUMS | sha256sum --check
+
+# Extract and verify every file against its manifest entry
+tar -xzf skills-vX.Y.Z.tar.gz
+( cd skills && jq -r '.files[] | "\(.sha256)  \(.path)"' MANIFEST.json \
+  | sha256sum --check )
+```
+
+A non-zero exit from either `sha256sum --check` means the bundle was
+tampered with or built non-reproducibly — fail closed.
+
+## Producing the bundle locally
+
+```bash
+make build-skills-archive VERSION=0.3.0          # → dist/skills-v0.3.0.tar.gz
+make build-skills-archive VERSION=v0.3.0         # equivalent
+```
+
+The generator lives at `internal/release/gen-skills-manifest/`. It walks `skills/`,
+computes hashes, and writes the archive — no third-party deps beyond
+the Go standard library.