@ikon85/agent-workflow-kit 0.33.0 → 0.34.0

package/agent-workflow-kit.package.json

@@ -1,5 +1,5 @@
 {
-  "kitVersion": "0.33.0",
+  "kitVersion": "0.34.0",
   "files": [
     {
       "path": ".agents/skills/ask-matt/SKILL.md",
@@ -7,7 +7,7 @@
       "ownerSkill": "ask-matt",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "0e17025bf5f0c8363cc36031697b544d97978b3d3bbe4ebf39770fa878802a5e",
+      "sha256": "0581a5d3a784b33108ab159fc1732b11aa3a5ac145791a8551c93dd6bc83007c",
       "mode": 420,
       "origin": "kit"
     },
@@ -27,7 +27,7 @@
       "ownerSkill": "audit-skills",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "662c4dec0c03716c468f202f73f52140ceba84e092873e6619692dde6d7ed0f2",
+      "sha256": "99884fdb3370c5ba82167633c8cbdcf60b980a5f23e196d05695c6c416fe6ab9",
       "mode": 420,
       "origin": "kit"
     },
@@ -37,7 +37,7 @@
       "ownerSkill": "board-to-waves",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "203211bc1bd149918783de4ead312d94c4faf1e4ba25d2625ce34f99a0806282",
+      "sha256": "f51112a6eccb40b7029d5a94bfa0d1406e94abe51017f7a8b50d3b2bb74cf376",
       "mode": 420,
       "origin": "kit"
     },
@@ -57,7 +57,7 @@
       "ownerSkill": "code-review",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "9d0e54bd73bd4cdd810e714f1a5af07a4cd00b7cc07fe360e587abbf3005f2aa",
+      "sha256": "ca372c944ff134e2dc280b9841da29ba2a51cbfe6ef664fbf28258bdc110a774",
       "mode": 420,
       "origin": "kit"
     },
@@ -77,7 +77,7 @@
       "ownerSkill": "codebase-design",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "21c3264953bd30ee87b181a3ccaf0e70649f461e5ffd7dc654acee4ba1788b31",
+      "sha256": "c3ede6a6dddc2e3913a824e77b4e26bd11608c904702f4991ce8cc9cae30da1c",
       "mode": 420,
       "origin": "kit"
     },
@@ -107,7 +107,7 @@
       "ownerSkill": "codex-adapter-sync",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "ae398e40308e6ad8d6091c418435e2dca8a4f67e526ab85efa88e8e57c0354c2",
+      "sha256": "5c1822faf8f9c043d37e2f879c5c824ca9c421bb4c7be2cbdb627a33b3ac7b65",
       "mode": 420,
       "origin": "kit"
     },
@@ -327,7 +327,7 @@
       "ownerSkill": "improve-codebase-architecture",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "16214837a810306d358315e433d7abc174f64d8f0558b643678d887c876852d3",
+      "sha256": "a61a0b4b3bfd78826b87a75bcf73783f8e496e5625f18e8ed59bddb24e2cce40",
       "mode": 420,
       "origin": "kit"
     },
@@ -347,7 +347,7 @@
       "ownerSkill": "improve-codebase-architecture",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "594ef87762120abab778e454c27d240bf5b2c3411f7fe6c5f6ff028a6cdfeb4b",
+      "sha256": "dbe584d6afcae38072ecd8b86ff427f3d0cb5b90e7c8dcec55eef871e15b5f68",
       "mode": 420,
       "origin": "kit"
     },
@@ -377,7 +377,7 @@
       "ownerSkill": "kit-update",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "249a45761bcb95148b1567d1bc4d1b622b9b8c41519de4e67b1ef4e33c9ee9fd",
+      "sha256": "c3487295864d1d8d765e1c453c80daf77d3f08a2b0017f614e44e85170913624",
       "mode": 420,
       "origin": "kit"
     },
@@ -417,7 +417,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "38247cadf15179e6f916674118fed6f0a19eb1097f123183a91bb18802113943",
+      "sha256": "849454b9e0af6df72bf611d1c3f00c475f132c728be22654a9794c8622fbce52",
       "mode": 420,
       "origin": "kit"
     },
@@ -427,7 +427,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "2e2be2fb931147cf232b33c9c23379bcce47558a25756d54f89c6ef2e8a365c3",
+      "sha256": "ba8d7a3064f8241ae7be03259e219ba751c28dfa325d3e48a9344fdf2d589c1e",
       "mode": 420,
       "origin": "kit"
     },
@@ -447,7 +447,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "bfb547225c6950d4566f87a0da42e85c4c5803236d5adc0787aba265d5c91a53",
+      "sha256": "3a281805aee83a771675f8f80b9bd9dee3c1b2f2b2ca58001b37d8565a7d9d7d",
       "mode": 420,
       "origin": "kit"
     },
@@ -507,7 +507,7 @@
       "ownerSkill": "research",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "b0f80dd6ce09d17ae65e081f117da28fa988869fe72a0db72cb7d9a269f45f1d",
+      "sha256": "cc5bade9d420c572a00d19c6a26ca4f40cc01d16a5d17b4d698f10bbc25f2680",
       "mode": 420,
       "origin": "kit"
     },
@@ -557,7 +557,7 @@
       "ownerSkill": "scale-check",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "314c9b5c2ae701e670e9826432131cb597394e4e72aa2f24ec100d1c169b8134",
+      "sha256": "c0055c9d1f7e48d712d85f587a60b9a7d69ee6ae3084a2af3e906c508aa77231",
       "mode": 420,
       "origin": "kit"
     },
@@ -587,7 +587,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "032c9654baf6f5e60007e7d0767a96ab823a442ed86cb52e801836130c9b5ba2",
+      "sha256": "928a771ecadd4b199169f20deb79647894fe3c0675973b0b97050cad0b675cc4",
       "mode": 420,
       "origin": "kit"
     },
@@ -677,7 +677,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "f0d6809b86eec77cf54bccc30e6a7603d831678fcc8b5f52b4e073f9f56a72a8",
+      "sha256": "7281bb67588328aa4a788cbefe69f396c4617569335ce47cfb45bb5607d3205e",
       "mode": 420,
       "origin": "kit"
     },
@@ -737,7 +737,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "e690b4901867163ba1853036ae935324e8790cbb7090833027d477e1a6eb2412",
+      "sha256": "80f686464ed1faf663acb5bb0b40a8847f4e22d806be04368354e60701cc356d",
       "mode": 420,
       "origin": "kit"
     },
@@ -847,7 +847,7 @@
       "ownerSkill": "to-issues",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "cae01235d1647e30bf60df93d32cb2f9be1b5dc908429514287aaf648f8094e1",
+      "sha256": "13fe336c736adc290a4f3a2cd8a796336e402d3622fa0f03480d59480295fbc8",
       "mode": 420,
       "origin": "kit"
     },
@@ -897,7 +897,7 @@
       "ownerSkill": "to-waves",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "0229b717783054c87c42e088d1323990b6a30ffc80b337b6c14caf5e8f7964d1",
+      "sha256": "fedf58030c901568dc64801d273f73b5adbb400feb6b624e648dd21ab31ff23e",
       "mode": 420,
       "origin": "kit"
     },
@@ -1199,7 +1199,7 @@
       "ownerSkill": "ask-matt",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "acee6d16c4f77ba121eafc697706bceb9910fbf7d688683a1c3bfce8ab25bc11",
+      "sha256": "94507e052d8fcb2f0a3beb355ff930aa34863d84b3ebc827bfc61a4a582ba597",
       "mode": 420,
       "origin": "kit"
     },
@@ -1219,7 +1219,7 @@
       "ownerSkill": "audit-skills",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "dce7c13e9b9c2eb6fe9028f69fe2fe2d48ad50546327c9d9c1232191425f1b7c",
+      "sha256": "e56c26c4595bf0ba0f9788917c696e626bfe66896547ff4b6ff282f1c247476e",
       "mode": 420,
       "origin": "kit"
     },
@@ -1229,7 +1229,7 @@
       "ownerSkill": "board-to-waves",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "33c897cf670e57b41bf231be7cf1ce3e35634907c94f6b0e037a2eae19adf582",
+      "sha256": "efcee45fb2979da7c992e280ba72df9330a6cffdb848bf5f26b4a49b3e2f24cc",
       "mode": 420,
       "origin": "kit"
     },
@@ -1249,7 +1249,7 @@
       "ownerSkill": "code-review",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "9d0e54bd73bd4cdd810e714f1a5af07a4cd00b7cc07fe360e587abbf3005f2aa",
+      "sha256": "ca372c944ff134e2dc280b9841da29ba2a51cbfe6ef664fbf28258bdc110a774",
       "mode": 420,
       "origin": "kit"
     },
@@ -1269,7 +1269,7 @@
       "ownerSkill": "codebase-design",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "21c3264953bd30ee87b181a3ccaf0e70649f461e5ffd7dc654acee4ba1788b31",
+      "sha256": "ea8b97f3609d581ba6980a9bc0b9724081d879487652342fbb2dc2af3c74d937",
       "mode": 420,
       "origin": "kit"
     },
@@ -1639,7 +1639,7 @@
       "ownerSkill": "improve-codebase-architecture",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "8fffb7036b266d1a2e479911db75af8cda62a4ae08d74420dce9eb70aa14489e",
+      "sha256": "0ddd7ba6f6ab014518c519d6767d0141ebc3ee0d09d3931dceedcab6948e6191",
       "mode": 420,
       "origin": "kit"
     },
@@ -1659,7 +1659,7 @@
       "ownerSkill": "improve-codebase-architecture",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "bf96773f4ba75a53c8b916052e36a6c0f4bcae8b46b94bb72beb446048ca6d8a",
+      "sha256": "d2077e2e539bad27e3118b17810a97da35841a530e5f7b8dfc1ff88ab49f9d50",
       "mode": 420,
       "origin": "kit"
     },
@@ -1689,7 +1689,7 @@
       "ownerSkill": "kit-update",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "249a45761bcb95148b1567d1bc4d1b622b9b8c41519de4e67b1ef4e33c9ee9fd",
+      "sha256": "c3487295864d1d8d765e1c453c80daf77d3f08a2b0017f614e44e85170913624",
       "mode": 420,
       "origin": "kit"
     },
@@ -1729,7 +1729,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "38247cadf15179e6f916674118fed6f0a19eb1097f123183a91bb18802113943",
+      "sha256": "849454b9e0af6df72bf611d1c3f00c475f132c728be22654a9794c8622fbce52",
       "mode": 420,
       "origin": "kit"
     },
@@ -1739,7 +1739,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "2e2be2fb931147cf232b33c9c23379bcce47558a25756d54f89c6ef2e8a365c3",
+      "sha256": "ba8d7a3064f8241ae7be03259e219ba751c28dfa325d3e48a9344fdf2d589c1e",
       "mode": 420,
       "origin": "kit"
     },
@@ -1759,7 +1759,7 @@
       "ownerSkill": "orchestrate-wave",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "c9b4308875d59415b074de8b98130d0c2378fda6a4d1e6ac9c332c74b9a9ea97",
+      "sha256": "fb244997866b4ad01db7c7de8a22467d4c8399f030d236a517b6b9cc958d9177",
       "mode": 420,
       "origin": "kit"
     },
@@ -1819,7 +1819,7 @@
       "ownerSkill": "research",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "af378829f015775a3bcd65ff466826722e99359017ae6bae227ca4c9bd14049c",
+      "sha256": "8c8230cdabb1355d9fd1feeefc1ae14707f8b42aab999fb2577126310f4a5fa4",
       "mode": 420,
       "origin": "kit"
     },
@@ -1869,7 +1869,7 @@
       "ownerSkill": "scale-check",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "314c9b5c2ae701e670e9826432131cb597394e4e72aa2f24ec100d1c169b8134",
+      "sha256": "c0055c9d1f7e48d712d85f587a60b9a7d69ee6ae3084a2af3e906c508aa77231",
       "mode": 420,
       "origin": "kit"
     },
@@ -1919,7 +1919,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "032c9654baf6f5e60007e7d0767a96ab823a442ed86cb52e801836130c9b5ba2",
+      "sha256": "928a771ecadd4b199169f20deb79647894fe3c0675973b0b97050cad0b675cc4",
       "mode": 420,
       "origin": "kit"
     },
@@ -2009,7 +2009,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "f0d6809b86eec77cf54bccc30e6a7603d831678fcc8b5f52b4e073f9f56a72a8",
+      "sha256": "7281bb67588328aa4a788cbefe69f396c4617569335ce47cfb45bb5607d3205e",
       "mode": 420,
       "origin": "kit"
     },
@@ -2069,7 +2069,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "e690b4901867163ba1853036ae935324e8790cbb7090833027d477e1a6eb2412",
+      "sha256": "80f686464ed1faf663acb5bb0b40a8847f4e22d806be04368354e60701cc356d",
       "mode": 420,
       "origin": "kit"
     },
@@ -2187,7 +2187,7 @@
       "ownerSkill": "to-issues",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "874a636bde53180dab4d69b801c7d3a5c5cbdaf74e1969af56c8d7805163ef24",
+      "sha256": "60a41f58bbf0d1507c3116aeef7b8bb6ba62747866fd3bf8dff298c899341d93",
       "mode": 420,
       "origin": "kit"
     },
@@ -2237,7 +2237,7 @@
       "ownerSkill": "to-waves",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "0229b717783054c87c42e088d1323990b6a30ffc80b337b6c14caf5e8f7964d1",
+      "sha256": "fedf58030c901568dc64801d273f73b5adbb400feb6b624e648dd21ab31ff23e",
       "mode": 420,
       "origin": "kit"
     },
@@ -2399,7 +2399,7 @@
       "path": "docs/agents/wave-anchor-template.md",
       "kind": "template",
       "installRole": "consumer",
-      "sha256": "09a7c9378c5cba4d5c4d9f7e1e39041e60bbcaa3fea38731a2841bf0c5f0ceda",
+      "sha256": "92e52c6d1db28f37c012646de6d0b073bcdffde30d84f84499b55a7fd1240ab1",
       "mode": 420,
       "origin": "kit"
     },
@@ -2495,7 +2495,7 @@
       "path": "scripts/codex-exec.sh",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "c5d60648cb09343996efc98614dbd0c78b18672891bf466e5a8c5aba359d5df8",
+      "sha256": "a9a971a5a07f455739d2d8a7de3620fc601126af7e5a6eb83e8277a06b69aae6",
       "mode": 493,
       "origin": "kit"
     },
@@ -2803,6 +2803,22 @@
       "mode": 493,
       "origin": "kit"
     },
+    {
+      "path": "src/commands/routing-policy-update.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "1dfb532c26cea8ad4adefc3f0beb6a47774bb34f120e611d5a0dbab12b1d53bd",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/agentSurfaceRegistry.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "655f276b41f7cb2a7a8c4404c1bca11e36964c1137507755f5d3ea1f71c5e5a1",
+      "mode": 420,
+      "origin": "kit"
+    },
     {
       "path": "src/lib/atomicWrite.mjs",
       "kind": "script",
@@ -2815,7 +2831,23 @@
       "path": "src/lib/capabilityMatrix.mjs",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "9ea051edad14972281e8d19664eeec7dbd91d57b21e5d97e4eeea7323c5241e1",
+      "sha256": "183938e9580c6f17f52a2188e113eab615384291ff59b8ead7427ee751b88833",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/dispatchReceipt.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "fa995be02e1325c9e98f0ab0677ee5cb82b15cf4b696f44d056407cb72906081",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/frontendWorkloads.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "695cb784564ddfe24f42cd92463ad7fbc4baeb555a6a36a7e180830a5a917146",
       "mode": 420,
       "origin": "kit"
     },
@@ -2859,6 +2891,134 @@
       "mode": 420,
       "origin": "kit"
     },
+    {
+      "path": "src/lib/routeDispatcher.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "937274005959b1d96ef08a69af2fc4632571376787fa79a25b2109ab762a585c",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingAccessGraph.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "21fd08ddb8715a7fbb8bdf09307c9cb6fe9c9dd032732e56ed681780cc9b49ae",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingAdapters/claude.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "ad7a0670c697ceb3d8a845c24ae456296b46f17325d62b9c53f1128aaa48a26d",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingAdapters/codex.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "70c0843505cdf69318d45c58d21c8eb81bfd74910bd8544e4194fba736e0e1ca",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingCatalog.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "3d683dfdf31496503b40746645629c116111cda8be1dcb87575afaf8ac8aca28",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingEvidenceCache.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "3515f35815be245959f509c4c8defdf640b58a854d7f450c74b17fd14819ee04",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingIntent.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "1b6f599dc5f9fa3a5af41c48d7993cc05f2c2dd26ab60a23fc4a3026d0cc341a",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingPolicy.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "e5e23ff59ffa2147ed8c799f925c8b8f3f480ab7d370e52663fea005623861c1",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingProfile.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "3f28b39352fe517ab44dd7e896505ac0047a3a2f4f63ce7a55ce47feac7351a7",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingResolver.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "da8bbdc924a172ca9cfb3e24b35efd9cbf2d3157e2d29e65032600b840ad01d3",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingSources/artificialAnalysis.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "1b02382957e68e6dc46b58fbff0d69a5a28088be27d42daeb5b426d20eb29baf",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingSources/benchlm.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "f3a08be4fa870137b41c630400fb939491e9c7c29881d384e6d5df6fe7dff231",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingSources/codeArena.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "c90b1c7894704ace96e85f5c430cd61077e802dc21d591d51da84d027159b491",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingSources/deepswe.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "e5e4e69ca3aaec207e1b351003f67b4541543baf4b7be321a7659f9a9f57752b",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingSources/openhands.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "fc347c17277dc601f5206d47269268839a7ade5eba6a7a538521213f996ac89b",
+      "mode": 420,
+      "origin": "kit"
+    },
+    {
+      "path": "src/lib/routingSources/openhandsFrontend.mjs",
+      "kind": "script",
+      "installRole": "consumer",
+      "sha256": "698b7f265ce95dfe000233dbb6ed0eb3bb655bb9581f64264e4f5d8a2d75e169",
+      "mode": 420,
+      "origin": "kit"
+    },
     {
       "path": "src/lib/semver.mjs",
       "kind": "script",

package/docs/adr/0005-to-issues-is-the-planning-facade.md

@@ -0,0 +1,42 @@
+# to-issues is the single planning facade
+
+Status: accepted (2026-07-22, issue #197)
+
+The planning workflow exposes two mechanisms after `to-prd`: Feature PRDs are
+decomposed by `to-issues`, while Program PRDs are unfolded by a separately
+invoked `to-waves` skill which later calls `to-issues` for each wave. This makes
+the user identify an internal planning altitude even though the PRD already
+carries an explicit, durable identity that can select the correct mechanism.
+
+We decided that `to-issues` is the single user-facing Planning facade:
+
+1. A Feature PRD selects the existing atomic/promote mechanism.
+2. A Program PRD selects the existing program-graph engine currently owned by
+   `to-waves`, including its complete preview, validation, publication,
+   per-wave maturation, and execute-ready audits.
+3. Dispatch uses only explicit PRD identity (`prd: program` or its canonical
+   program type), never size heuristics or model judgment.
+4. The selected mode is reported visibly before mutation. Program mode retains
+   its full preview approval gate.
+5. `to-waves` remains an independently testable internal mechanism and may keep
+   a compatibility entrypoint, but routers and normal documentation always send
+   the user from `to-prd` to `to-issues`.
+
+## Considered options
+
+- **Keep two public next commands:** rejected because it leaks internal
+  decomposition mechanics and makes users repeat an altitude decision already
+  encoded in the PRD.
+- **Infer the mode from plan size or prose:** rejected because hidden heuristics
+  make the same command unpredictable and can publish the wrong board shape.
+- **Merge all program code physically into `to-issues`:** rejected because the
+  program graph is a coherent deep module with valuable separate tests; only
+  its public routing belongs behind the facade.
+
+## Consequences
+
+- The normal user path is always `grill → to-prd → to-issues`.
+- Feature and Program behavior remain distinguishable in audit output without
+  requiring the user to select their implementation skill.
+- Router, overview, skill prose, mirrors, and contract tests must agree on the
+  one-entry contract.

package/docs/adr/0006-routing-knowledge-access-and-policy-are-separate.md

@@ -0,0 +1,91 @@
+# Routing knowledge, access, and policy are separate
+
+Status: accepted (2026-07-22, Program #197)
+
+Planning cannot safely persist a concrete recommended model. Provider catalogs
+change, model names age, effort behavior differs by model, agent surfaces expose
+different controls, and a surface may reach another provider through a plugin
+or CLI transport. A recommendation that is correct in one session can therefore
+be nonexistent, unreachable, or unenforceable in the session that implements
+the work.
+
+We decided to keep three identities separate:
+
+1. The Kit-maintained **Evidence catalog** contains all known provider models
+   and observations, whether or not the active surface can use them. Each
+   decision-grade observation retains the complete configuration identity:
+   model, effort, harness, workload, source, benchmark version, uncertainty,
+   freshness, and cost.
+2. The user-local **Access graph** records the native and cross-provider paths
+   available from each agent surface. Claude Code and Codex attest only their
+   own runtime capabilities. A detected transport is not automatically approved,
+   and neither surface claims another surface's unverified capabilities.
+3. The user-local **Routing policy** records allowed surfaces and transports,
+   switching autonomy, optimization goals, and optional advanced overrides.
+   Personal choices do not alter catalog facts.
+
+Durable plans and issues contain only a provider-neutral **Routing intent**.
+At execution time a resolver compares all evidence-backed candidates, filters
+them through the Access graph and Routing policy, and produces a one-execution
+**Route decision**. It reports the best overall route separately from the best
+currently executable route. An unreachable preference follows the user's
+explicit handoff, fallback, or block policy.
+
+Every surface adapter declares how independently it can control model and
+effort: per spawn, through a named agent definition, through a session default,
+or not at all. Environment precedence is part of the capability proof. An AFK
+subagent requires enforced model and effort selection and emits a **Dispatch
+receipt** containing the requested and applied route, enforcement method, and
+policy/evidence revisions. Silent inheritance and unverified degradation are
+not valid AFK routes.
+
+Setup keeps the technical model behind a simple user decision. It presents a
+registry-driven list of familiar agent surfaces, preselects detected entries,
+and asks whether the Kit may switch automatically, ask before switching, or use
+only the current surface. Adapters establish providers, transports, model
+selectors, and effort controls. Model preferences and optimization overrides
+remain optional advanced settings.
+
+An existing installation without a routing profile receives this choice once
+through setup or the first compatible Kit update. Later updates perform a
+read-only preflight and ask again only when the profile is missing, invalid,
+materially stale, references a removed route, or a newly detected surface makes
+a meaningful choice available. Installing Kit mechanics and changing personal
+policy are separate transactions; unattended update never invents a decision.
+
+BenchLM may populate discovery, catalog, pricing, freshness, coverage, and
+corroboration signals. Its aggregate scores are not decision-grade routing
+observations because effort and harness identity may be collapsed and missing
+evidence may be estimated. DeepSWE, Artificial Analysis, OpenHands, Arena, and
+other benchmark-owner artifacts remain authoritative for the claims they
+actually measure. Local experience may calibrate policy but does not rewrite
+public evidence.
+
+## Considered options
+
+- **Persist a concrete model and effort in every issue:** rejected because the
+  recommendation ages and may not be executable on the implementing surface.
+- **Maintain separate Claude and Codex routing tables:** rejected because it
+  duplicates evidence, hides cross-provider routes, and lets the two surfaces
+  drift.
+- **Filter the shared table during setup:** rejected because current access is
+  a user/runtime fact, not a limit on routing knowledge.
+- **Ask users to describe transports and enforcement capabilities:** rejected
+  because these are adapter facts most users cannot answer reliably.
+- **Route directly from a composite leaderboard:** rejected because benchmark,
+  harness, effort, uncertainty, and workload boundaries would be lost.
+- **Re-run the routing interview on every Kit update:** rejected because a valid
+  user-owned profile should remain stable until a material choice changes.
+
+## Consequences
+
+- Model/provider churn updates the catalog and resolver without rewriting
+  durable issues.
+- Both Claude Code and Codex read one local policy while proving their own
+  execution capabilities independently.
+- Cross-provider dispatch is expressible without pretending that every surface
+  can reach every model.
+- The Kit must maintain source adapters, schema migration, capability probes,
+  last-known-good evidence, and dispatch receipts.
+- Different machines do not share personal routing state unless the user later
+  chooses an explicit export or private synchronization mechanism.