@orchestrator-claude/definitions 3.37.0 → 3.37.2

package/manifest.json

@@ -1,23 +1,15 @@
 {
   "schema": "orchestrator-definitions/v1",
   "namespace": "orchestrator",
-  "version": "3.37.0",
-  "generatedAt": "2026-07-28T16:31:43.981Z",
+  "version": "3.37.2",
+  "generatedAt": "2026-09-18T20:29:54.022Z",
   "definitions": {
     "agents": [
       {
         "slug": "adversarial-reviewer",
         "file": "agents/adversarial-reviewer.md",
         "version": "1.0.0",
-        "checksum": "sha256:415cfdd33d71b388a3a6eaf2a05e3d986ae7d04596a3219b6938a3b5a0308b6f",
-        "supersedes": null,
-        "metadata": {}
-      },
-      {
-        "slug": "ai-architect",
-        "file": "agents/ai-architect.md",
-        "version": "1.0.0",
-        "checksum": "sha256:d127f87259b037addd802dc89032a88b7dc30f7e652285a6fb507b51eefe628a",
+        "checksum": "sha256:c0b517b21c2e7dd7c3360f255f8e3c9dd68a82106ae9ae32de84d6ffca557ae2",
         "supersedes": null,
         "metadata": {}
       },
@@ -25,7 +17,7 @@
         "slug": "api-extractor",
         "file": "agents/api-extractor.md",
         "version": "1.0.0",
-        "checksum": "sha256:fb4317ef3cf46d3d048daa5f8391efd450601fc00be08f3397da7eefd6cc9255",
+        "checksum": "sha256:f3f71e93097fd2db1d45c4026b207c9b05ae2f43a731c51eb967dc50a4296108",
         "supersedes": null,
         "metadata": {}
       },
@@ -33,7 +25,7 @@
         "slug": "azure-devops-engineer",
         "file": "agents/azure-devops-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:18befb94cf8c49a45d41269ea15e443e2201f163a76d2ca4d3d479eac12a3368",
+        "checksum": "sha256:eaa237e23a18163eb5c2566b9b3b6f6e9a862ffbd2f1be224acb4c9f7d300f54",
         "supersedes": null,
         "metadata": {}
       },
@@ -41,7 +33,7 @@
         "slug": "business-rule-miner",
         "file": "agents/business-rule-miner.md",
         "version": "1.0.0",
-        "checksum": "sha256:95901214e3a0867043ce6c6edf44a4e28dfbe0442269a0cb146b8d6113e93ebb",
+        "checksum": "sha256:3d32899ae60014f0d2b29594c20f638dea2a30a4e923e2fe7458e0317c05358b",
         "supersedes": null,
         "metadata": {}
       },
@@ -49,7 +41,7 @@
         "slug": "cicd-platform-engineer",
         "file": "agents/cicd-platform-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:01dc1c3f15fc905c7ecc65c6c29a3ca908e29a8f418febf3b5d34cbcf3a711e9",
+        "checksum": "sha256:b539a0e6d2a8e97c91c57f005ef6ddbc0d64f4e482b3d80af0b0afbf80e4e3fe",
         "supersedes": null,
         "metadata": {}
       },
@@ -57,7 +49,7 @@
         "slug": "ciclo-engineer",
         "file": "agents/ciclo-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:f370f35c80527b16658984e9da65cb58ec4bec74d5647eb6102a4e2f78871a0a",
+        "checksum": "sha256:b2f83b97ddbf6e4afe18c42122ffe5c40db31fa98df156c93e74c31344188a31",
         "supersedes": null,
         "metadata": {}
       },
@@ -65,7 +57,7 @@
         "slug": "code-archaeologist",
         "file": "agents/code-archaeologist.md",
         "version": "1.0.0",
-        "checksum": "sha256:4e0bde577f9aa8e564718629cf72a63531db4de20b89217403cda2922d868484",
+        "checksum": "sha256:1c7d32874c8da6a46ce5c5692edaa1dadc81d044b7fa59b44bca2822fc3db263",
         "supersedes": null,
         "metadata": {}
       },
@@ -73,7 +65,7 @@
         "slug": "debug-sidecar",
         "file": "agents/debug-sidecar.md",
         "version": "1.0.0",
-        "checksum": "sha256:0f0d2b6fa6f161e4378fadf048fa5b9c9a131d33e6d5f859671c221b5ae244bf",
+        "checksum": "sha256:574eefb72d824948753c49957dace9814b9b03b3c11083a8accf006d5de2f15d",
         "supersedes": null,
         "metadata": {}
       },
@@ -81,7 +73,7 @@
         "slug": "doc-sidecar",
         "file": "agents/doc-sidecar.md",
         "version": "1.0.0",
-        "checksum": "sha256:fb199f4faa59ba28f40cb7057b5b063b49c454b48c92ad63a41596f48fcbc99c",
+        "checksum": "sha256:ef2e994d7d827a2797049d76820dcaa4b76141e91bd879933054eb8bcf4bcaf8",
         "supersedes": null,
         "metadata": {}
       },
@@ -89,7 +81,7 @@
         "slug": "docs-guardian",
         "file": "agents/docs-guardian.md",
         "version": "1.0.0",
-        "checksum": "sha256:b9d5b1a102a56f7927d43ccf3cb64332789c61a8c53ad1395bf1d6211d617c01",
+        "checksum": "sha256:fdefcdac038e9312c1eb65e5c4d65eae2cabb8bd80769b963ff0c05ae3656e3e",
         "supersedes": null,
         "metadata": {}
       },
@@ -97,7 +89,15 @@
         "slug": "frontend-engineer",
         "file": "agents/frontend-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:e8db8ab9d4b652c00a1aae41f8d7a528047482ac838239972f537f31a9fe740f",
+        "checksum": "sha256:29201e48691a79b5e535ac8a41df77ac20006f1768214f9d6c63f6e1ff839efc",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "harness-architect",
+        "file": "agents/harness-architect.md",
+        "version": "1.0.0",
+        "checksum": "sha256:bec6c0cecb552f6265bffcf76288c684968d5fe20fc4b6736e8d55ab25e1622e",
         "supersedes": null,
         "metadata": {}
       },
@@ -105,7 +105,7 @@
         "slug": "implementer",
         "file": "agents/implementer.md",
         "version": "1.0.0",
-        "checksum": "sha256:3d7ddb5a3be0f55055a51c2a0dde03cd4cde38b084a06090e507f4c548eaa9f1",
+        "checksum": "sha256:2b31b706bb11ad2d25abb7cbd441a3a0d430d3204338bf4860bade1a8bfab88d",
         "supersedes": null,
         "metadata": {}
       },
@@ -113,7 +113,7 @@
         "slug": "legacy-discoverer",
         "file": "agents/legacy-discoverer.md",
         "version": "1.0.0",
-        "checksum": "sha256:ce745da0ec97796e2682bb6f66626363f5b402ee0c0202c6270af7130f32ba90",
+        "checksum": "sha256:8974dbfa2cedeb21f5d4fad2b6d02f9b4db030400fcf132453bbea9398ac49f5",
         "supersedes": null,
         "metadata": {}
       },
@@ -121,7 +121,7 @@
         "slug": "legacy-synthesizer",
         "file": "agents/legacy-synthesizer.md",
         "version": "1.0.0",
-        "checksum": "sha256:1119ccefcd8f618cbaa51dea01350fdcbda1c654f232c8e256a73349257c61e4",
+        "checksum": "sha256:fe488535188a2405f0f74c5503542adce5a7d63a8b28e0595a785afeb9c1a3f5",
         "supersedes": null,
         "metadata": {}
       },
@@ -129,7 +129,7 @@
         "slug": "methodology-researcher",
         "file": "agents/methodology-researcher.md",
         "version": "1.0.0",
-        "checksum": "sha256:c6776cc9bd3205b3fcb643a37db21782f8ea026c215def9a1413311c6eec1ba1",
+        "checksum": "sha256:4f375cc980233bdc4ae1c32d047c6a1cbb53fce720c0b33e607e216b3d4a5b8b",
         "supersedes": null,
         "metadata": {}
       },
@@ -137,7 +137,7 @@
         "slug": "operational-artifact-builder",
         "file": "agents/operational-artifact-builder.md",
         "version": "1.0.0",
-        "checksum": "sha256:81ec44ca7eec9abe190614ffec24c2aeb461b643b9ebb11762c8d30b1bf7f282",
+        "checksum": "sha256:86125998e16e8248defc4aec8fb95eb05ee374083ac756da2391dcf9eca0ec46",
         "supersedes": null,
         "metadata": {}
       },
@@ -145,7 +145,7 @@
         "slug": "orchestrator",
         "file": "agents/orchestrator.md",
         "version": "1.0.0",
-        "checksum": "sha256:4b7c8555d9fc7f50bb4c39f014bebc18ca1b1fd013517442816e289adce4ac92",
+        "checksum": "sha256:54ba6c1cec23eb571ad1fc991f92d413e7325516b70fc507fd2aef321c2d4363",
         "supersedes": null,
         "metadata": {}
       },
@@ -153,7 +153,7 @@
         "slug": "planner",
         "file": "agents/planner.md",
         "version": "1.0.0",
-        "checksum": "sha256:e7b9879ba51fcb721364883c699d89d9b2c400ac65ffb116a17415c28b07c378",
+        "checksum": "sha256:9984226243c6057da1a9444ec89bb4fce6918a7426816e357c2dc33806411c15",
         "supersedes": null,
         "metadata": {}
       },
@@ -161,7 +161,7 @@
         "slug": "presentation-engineer",
         "file": "agents/presentation-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:7a2f387f756fa314b51a386fa26e32ba7f9c2d38ee3a39a79e693a7c650ee093",
+        "checksum": "sha256:315304c540811affd7af0e03ac3175be0ed3b0496e2d1262558f2156d01f90fd",
         "supersedes": null,
         "metadata": {}
       },
@@ -169,7 +169,7 @@
         "slug": "python-data-engineer",
         "file": "agents/python-data-engineer.md",
         "version": "1.0.0",
-        "checksum": "sha256:9569c039469baffd0e1a9173d93b156652781ab201e8f9c9dd13fed0e945eabe",
+        "checksum": "sha256:d0e680f76a3c2aaf799ce7fe88a22e6dc45597e64724fc2c5e44dac159f7660e",
         "supersedes": null,
         "metadata": {}
       },
@@ -177,7 +177,7 @@
         "slug": "researcher",
         "file": "agents/researcher.md",
         "version": "1.0.0",
-        "checksum": "sha256:3552e394f2c89d1a093e97eafe2fa243d565f7dc3d560deb88454786bd4bccb0",
+        "checksum": "sha256:d6939ea09a5982b34a581994334409e210295bd4d1f3a3597b162e323f8550f7",
         "supersedes": null,
         "metadata": {}
       },
@@ -185,7 +185,7 @@
         "slug": "reviewer",
         "file": "agents/reviewer.md",
         "version": "1.0.0",
-        "checksum": "sha256:0e359fe1019dd70f565c1cd446f5bf6edfb95b421ccf8a89da1c17e0b22aa5f7",
+        "checksum": "sha256:2f79f7b8c48741b811457530f1181d8daf6da187d4961b51ebb840e609556522",
         "supersedes": null,
         "metadata": {}
       },
@@ -193,7 +193,7 @@
         "slug": "schema-extractor",
         "file": "agents/schema-extractor.md",
         "version": "1.0.0",
-        "checksum": "sha256:afd977bffce3ad83e68fee63f97a207412adb31c76472c4eb6ff8f806125b602",
+        "checksum": "sha256:f62bb48f46fd5e94890fd6699f190c4e61458d38609ac6ff890dbb8fbe9e88f5",
         "supersedes": null,
         "metadata": {}
       },
@@ -201,7 +201,7 @@
         "slug": "software-architect",
         "file": "agents/software-architect.md",
         "version": "1.0.0",
-        "checksum": "sha256:6842de9195cce9c82929c400132e310db360ee6578e85d9d9ee5ad1c3269c64a",
+        "checksum": "sha256:3b5a609553d85ba0ce1ef4da966a46bd49eca46846c8e84b8263616e9456afda",
         "supersedes": null,
         "metadata": {}
       },
@@ -209,7 +209,7 @@
         "slug": "specifier",
         "file": "agents/specifier.md",
         "version": "1.0.0",
-        "checksum": "sha256:bdb559898180543129a9bf12c7871e266232d13d2299828ceee3e1b22606968d",
+        "checksum": "sha256:8bbab71d75ba96cc2638fd4dca6611b790ba8fd124f344507c5b12dd5aa348e9",
         "supersedes": null,
         "metadata": {}
       },
@@ -217,7 +217,7 @@
         "slug": "task-generator",
         "file": "agents/task-generator.md",
         "version": "1.0.0",
-        "checksum": "sha256:638ee5e2d1b294ea49978eb7fb7807076981ee084996aa584c341814121fa3d1",
+        "checksum": "sha256:a2d1082d8839f91f6eb6ee5a8b1071aced3c739c12dee5b5c6a8e48562c11ca1",
         "supersedes": null,
         "metadata": {}
       },
@@ -225,7 +225,7 @@
         "slug": "test-sidecar",
         "file": "agents/test-sidecar.md",
         "version": "1.0.0",
-        "checksum": "sha256:e4a83768419cd9c82b837321ddff16c512f37350f33f91d493e3c263eb8c1c76",
+        "checksum": "sha256:84ad7fc7236f030857e7b06be9bd1557469615838aaa5d8f77d0e4118c28dd45",
         "supersedes": null,
         "metadata": {}
       }
@@ -291,7 +291,7 @@
         "slug": "checkpoint-protocol",
         "file": "skills/checkpoint-protocol/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:eede6949734042e3ae8182066b9ec9051b77570597b1d1e488ebcca10699d857",
+        "checksum": "sha256:68c5b24b2d306858b5a7a1403cdfd63be59a208e4dd45041f3f4b805936c85ad",
         "supersedes": null,
         "metadata": {}
       },
@@ -299,7 +299,7 @@
         "slug": "ciclo-lane-dispatch",
         "file": "skills/ciclo-lane-dispatch/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:6dfb9a1687c7bc265016b3497609a3e1955af1edd13cbc846158fc30819a3d02",
+        "checksum": "sha256:36bcca4483a1170ea30e2478337f819bc755f6fbe60a954ef12f50e95c0becfc",
         "supersedes": null,
         "metadata": {}
       },
@@ -327,6 +327,14 @@
         "supersedes": null,
         "metadata": {}
       },
+      {
+        "slug": "fase-1b-projecao",
+        "file": "skills/fase-1b-projecao/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:8aefcef469b821674a8256612c13e241dd5d394378ccfd218a1cbab6869e0e6e",
+        "supersedes": null,
+        "metadata": {}
+      },
       {
         "slug": "finishing-branch",
         "file": "skills/finishing-branch/SKILL.md",
@@ -359,11 +367,19 @@
         "supersedes": null,
         "metadata": {}
       },
+      {
+        "slug": "lane-1-entrevista",
+        "file": "skills/lane-1-entrevista/SKILL.md",
+        "version": "1.0.0",
+        "checksum": "sha256:19f10164a2f69b4675f2ac251a327a9187eaa1c8c4151904a54eb030849494c7",
+        "supersedes": null,
+        "metadata": {}
+      },
       {
         "slug": "orchestrator",
         "file": "skills/orchestrator/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:6ddb60e928016c0f11b32f6ec48558618eb6bb70a42eea74a29f1fc562dfc2ab",
+        "checksum": "sha256:b7c730f89b80ab3ee4ed55cb3c5f8afca4b74446da6f3960679fdd82d065fac3",
         "supersedes": null,
         "metadata": {}
       },
@@ -475,7 +491,7 @@
         "slug": "workflow-coordination",
         "file": "skills/workflow-coordination/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:bde4601fc20c17662ba1eb794884811885d07aa93feb66a922a3443023a77e7d",
+        "checksum": "sha256:8934acd04e8df74ffcf85cc857a3f4215c48acb691ad69eddf8b204e432f25fa",
         "supersedes": null,
         "metadata": {}
       },
@@ -493,7 +509,7 @@
         "slug": "agent-git-guard",
         "file": "hooks/agent-git-guard.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:b40c4bbeed6c1b8ceaa4df98a2f359b844aea2154e143e91093394569e0f62ff",
+        "checksum": "sha256:aea3a29ca8fd3039db99798bb7db61df5c7621397d0efb0bd3a7f57a5122cd90",
         "supersedes": null,
         "metadata": {}
       },
@@ -501,7 +517,7 @@
         "slug": "dangling-guard",
         "file": "hooks/dangling-guard.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:0972d38c4d1a95108ad09c0c2b327bdac8160a2a345f815530a03cb516f8bdfe",
+        "checksum": "sha256:5180636d41b477c7d7823fc782329e9c828af96aa81caa966882ebd92d86edfe",
         "supersedes": null,
         "metadata": {}
       },
@@ -509,7 +525,7 @@
         "slug": "gate-guardian",
         "file": "hooks/gate-guardian.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:052b3e38eae63eb3cc520d6425e4e2ba08be4b200a20c4bbcd2deb3e4df7ed0c",
+        "checksum": "sha256:4211d19f890d2518bbda3ae38146485f2a692b3585794f9456e7157c9772e41e",
         "supersedes": null,
         "metadata": {}
       },
@@ -517,7 +533,7 @@
         "slug": "mailbox-listener",
         "file": "hooks/mailbox-listener.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:525ea9522a5c3415994236f89ebce8b578dae94aea3bc710fb9466e77bf235a8",
+        "checksum": "sha256:7df87c419e02be156cdbfb25a43f1ecdbe12e811925600ebe8be72b15a98f2c8",
         "supersedes": null,
         "metadata": {}
       },
@@ -525,31 +541,31 @@
         "slug": "playwright-output-guard",
         "file": "hooks/playwright-output-guard.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:cfc5807a23a0e89a703e09e91bb4c817cc61a6965235191f079bdeb42368e5cf",
+        "checksum": "sha256:e64853a734fad0a6eea67ecce6248e74f8d6e64f7658a4e7cdd8317b5dd4db0b",
         "supersedes": null,
         "metadata": {}
       },
       {
-        "slug": "post-compact",
-        "file": "hooks/post-compact.mjs",
+        "slug": "post-implement",
+        "file": "hooks/post-implement.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:06ba23353c8ce0afb1485e8465c455faa575523cd324237a5b3f564aca51a8cd",
+        "checksum": "sha256:bdcf2d1b0db7b61477dd123ed02d23683084ef512439a5372d7d2b0459ec28fa",
         "supersedes": null,
         "metadata": {}
       },
       {
-        "slug": "post-implement",
-        "file": "hooks/post-implement.mjs",
+        "slug": "pre-agent-dispatch",
+        "file": "hooks/pre-agent-dispatch.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:6e72e8e41c5671b1767c5f78d4d3a8cfc07c54f0a72bc8272f0620f256bbafab",
+        "checksum": "sha256:e4dfd078aa2a39bfd8a0655e90708e5693b267f7579b538173d20375346c6cfa",
         "supersedes": null,
         "metadata": {}
       },
       {
-        "slug": "pre-agent-dispatch",
-        "file": "hooks/pre-agent-dispatch.mjs",
+        "slug": "security-gate-honest",
+        "file": "hooks/security-gate-honest.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:2f9e62ecfed182281dfe0aefa9fc4801d1b3aea9226a7d8f0bc52db6ed93326b",
+        "checksum": "sha256:ddb7690d673fd98640e4ae18bd91ce425a3e135ab1ed5c89c683a17ad48f5e24",
         "supersedes": null,
         "metadata": {}
       },
@@ -557,7 +573,7 @@
         "slug": "session-start",
         "file": "hooks/session-start.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:a79a85062149f217483f971f0deb05759179c458b1d819901f357650dedbc67d",
+        "checksum": "sha256:f397e654327305c08e4a88853c45991924071f88195124f1e25cca7fd4c5f911",
         "supersedes": null,
         "metadata": {}
       },
@@ -573,7 +589,7 @@
         "slug": "subagent-start",
         "file": "hooks/subagent-start.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:6885e1629ec835d4de32bba7e3d43bee1ff8c1d1613fb26b212a15880c7ad952",
+        "checksum": "sha256:abfc51ee72c7d016ff31c57616e84a15fa5ab11a209827d87d29f5d1d8edc7e8",
         "supersedes": null,
         "metadata": {}
       },
@@ -581,7 +597,7 @@
         "slug": "subagent-stop",
         "file": "hooks/subagent-stop.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:b16c6215a41b9a3bc1be745980f46d1933fa06d8b21998b193278fec99868755",
+        "checksum": "sha256:ddab087a4096291073676ab1e67e4073c4fa689d68b2fbd3726d9503819934c4",
         "supersedes": null,
         "metadata": {}
       },
@@ -589,7 +605,7 @@
         "slug": "user-prompt",
         "file": "hooks/user-prompt.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:13a1e094729b5321374d2811c77784d4eb89ab99508cb0ab4ed7a43d1f1a95ee",
+        "checksum": "sha256:3379e410ecb9c1020ab2a508ee91da87ad8521624178c46c75578f98dbace70a",
         "supersedes": null,
         "metadata": {}
       },
@@ -597,7 +613,7 @@
         "slug": "verification-before-completion",
         "file": "hooks/verification-before-completion.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:349c03c12d939575d10f46af9d3e1c073b438860303e751d0d96fc51ab1cd924",
+        "checksum": "sha256:251ce5df35b2ec3dd4123f058a725657df4a11dc3bee8de1fef3738bc282ec8c",
         "supersedes": null,
         "metadata": {}
       },
@@ -605,7 +621,7 @@
         "slug": "workflow-guard",
         "file": "hooks/workflow-guard.mjs",
         "version": "1.0.0",
-        "checksum": "sha256:f1895e67e38dd57230a474dc6e88291df8720f9eba1d123d67d307b9335c8611",
+        "checksum": "sha256:e2e39b71f2a10826ad6edabdcf330f284c2b5bc23f9f0637f014e27e1945fcb0",
         "supersedes": null,
         "metadata": {}
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/definitions",
-  "version": "3.37.0",
+  "version": "3.37.2",
   "description": "Built-in definitions (agents, skills, hooks, workflows, KB seeds) for the Orchestrator ecosystem",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,9 @@
     "hooks-settings-template.json"
   ],
   "scripts": {
-    "build": "tsc && npm run bundle-hooks && npm run generate-manifest",
+    "build": "tsc && npm run bundle-hooks && npm run generate-hooks-matcher && npm run generate-manifest",
     "bundle-hooks": "npx tsx src/scripts/bundle-hooks.ts",
+    "generate-hooks-matcher": "npx tsx src/scripts/generate-hooks-matcher.ts",
     "generate-manifest": "npx tsx src/scripts/generate-manifest.ts",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -40,6 +41,7 @@
   },
   "dependencies": {
     "@orchestrator-claude/mcp-server": "^3.32.2",
+    "@orchestrator-claude/project-root-resolver": "*",
     "commander": "^14.0.0",
     "chalk": "^5.4.0"
   },

package/skills/checkpoint-protocol/SKILL.md

@@ -6,10 +6,16 @@ description: When and how to create workflow checkpoints. Use after completing t
 ## Checkpoint Creation Protocol
 
 ### Who follows this (TD-171)
-This protocol applies to the `implementer` **and all engineer-type committing agents** — any agent whose tool list holds `mcp__orchestrator-tools__createCheckpoint`: as of S290 that is `implementer`, `azure-devops-engineer`, `presentation-engineer`, `operational-artifact-builder`, `cicd-platform-engineer`, `python-data-engineer`, `frontend-engineer`. Engineer-types commit critical artifacts **outside `src/`** (IaC, pipelines, ETL, decks), so they need per-change git revertability too — "only `src/` commits matter" is wrong.
+This protocol applies to the `implementer` **and all engineer-type committing agents** — any agent whose tool list holds `mcp__orchestrator-tools__createCheckpoint`: as of S290 that is `implementer`, `azure-devops-engineer`, `presentation-engineer`, `operational-artifact-builder`, `cicd-platform-engineer`, `python-data-engineer`, `frontend-engineer`. Engineer-types commit critical artifacts **outside `src/`** (IaC, pipelines, ETL, decks), so they need per-change git revertability too — "only `src/` commits matter" is wrong. **That revertability comes from their own local commits, not from `createCheckpoint`** (see "Checkpoint vs git" below — corrected S444).
 
 ### Checkpoint vs git (read first)
-- `createCheckpoint` is a **PostgreSQL state snapshot** (RFC-012), **INDEPENDENT of git** — you do NOT need to commit before calling it.
+
+> **CORRECTED S444 (TD-257).** This section previously read *"`createCheckpoint` is a PostgreSQL state snapshot (RFC-012), **INDEPENDENT of git**"*. **That was false, and it was measured false**, not argued: this repo carries **6 tags `orchestrator/*`**, each pointing at a real commit whose subject is `[orchestrator] <phase>: <the description a sub-agent typed>`. Calling the tool writes to git.
+
+- `createCheckpoint` **does touch git**: `CheckpointManager.create()` → `GitOperations.createCheckpointCommit()` makes a **real commit**, and `createCheckpointTag()` makes a **real tag** `orchestrator/<phase>/<ISO-timestamp>`. The commit message is `[orchestrator] <phase>: <your description>` — **the text you pass becomes a permanent git commit message**. Write it as if a human will read it in `git log` in a year, because they will.
+- You still do **not** need to commit before calling it — it commits what is already staged (it is not passed a file list, so it does not stage anything itself).
+- **It cannot restore anything, and nothing else can either.** Measured S444: `CheckpointManager.restore()` has no production caller, no REST route (`rg "restore" src/presentation/api/` → 0), reads a `commitHash` that the repository writes hardcoded as `''` (`RepositoryFactory.ts:165`), and ends in `throw new Error('Checkpoint revert not implemented for PostgreSQL')`. Four independent breaks. Treat a checkpoint as an **audit marker**, never as a safety net you can fall back on.
+- **Your real revertability is ordinary git** — the local commits described below, on the feature branch the orchestrator prepared. Not the checkpoint.
 - **Local commit YES, push NO (TD-171):** you MAY make local git commits for granular revertability, on the **feature branch the orchestrator prepared before dispatching you** (branch-before-dispatch, `/orchestrator` §2c.0). You MUST NEVER `git push` / `git merge` / `gh pr merge` — push/merge is orchestrator-owned (enforced by `agent-git-guard`, TD-169). Return your work in your report; the orchestrator pushes after its independent assert.
 
 ### When to Create
@@ -28,7 +34,16 @@ This protocol applies to the `implementer` **and all engineer-type committing ag
 - "Tasks T-001 to T-005: auth controller + tests"
 - "Pre-refactor checkpoint: before DI migration"
 
-### Recovery
-If you need to check previous checkpoints:
+### Recovery — read the limit before you rely on it
+
+`listCheckpoints` is **display only**. Measured S444: its handler does exactly `JSON.stringify(result, null, 2)` into an MCP text block (`packages/mcp-server/src/handlers/checkpoints-handlers.ts:55-66`) — zero side effects, no restore. There is **no recovery path in this system**; see "Checkpoint vs git" above.
+
+To *inspect* what was checkpointed:
 1. Call ToolSearch("select:mcp__orchestrator-tools__listCheckpoints")
 2. Call listCheckpoints with: { workflowId }
+
+Two things to expect, both measured S444 and neither yet fixed — do not read an empty list as "nothing happened":
+- `GET /api/v1/checkpoints` for this project returned `[]` (HTTP 200, with a positive control returning 200 + real data on the same token), while 6 `orchestrator/*` tags exist in git. **The git side and the database side disagree**, and the database side is the one that is empty.
+- The rows that do get written carry `commit_sha = ''` (`RepositoryFactory.ts:165`), so even a populated list would not point at a recoverable commit.
+
+**To actually recover work, use git directly** (`git log`, `git reflog`, `git show`) against your own local commits.