rig-create 0.0.0-stage → 1.0.0

package/templates/example-chain/checkpoints/3-rig-review.json

@@ -0,0 +1,424 @@
+{
+  "schema": "rig-create/example-checkpoint@1",
+  "stage": 3,
+  "name": "3-rig-review",
+  "chain_step": 71,
+  "pending": {
+    "act": "Review and approve the rig",
+    "commands": [
+      "rig-create review 1 --verdict accepted --by user --review rig-review --verbatim-file evidence/approval.txt --source synthetic example",
+      "rig-create signoff rig-review --by user --verbatim-file evidence/approval.txt --version 1"
+    ],
+    "command_roles": [
+      "human",
+      "human"
+    ],
+    "awaits": [
+      "versions[n=1].verdicts[review=rig-review]",
+      "signoffs[stage=rig-review]"
+    ]
+  },
+  "expected_findings": {
+    "refusals": [],
+    "warnings": []
+  },
+  "project_sha256": "327efa3dbb0f2997e37164b7d534002597efeddd1f43595d4e1ff3a77bcad2e3",
+  "files": [
+    {
+      "path": ".gitignore",
+      "sha256": "58c9530777d5b5503615514bc2545fd25df42143f211572872dfa984c3c64d99"
+    },
+    {
+      "path": "AGENTS.md",
+      "sha256": "45434490fe024269fb2b879d00bcd14d8909426fd703433b39d729410708628c"
+    },
+    {
+      "path": "CLAUDE.md",
+      "sha256": "4f21b640d3591d6fc8614b18f1cef324097184c735bdd845562ef214a523612a"
+    },
+    {
+      "path": "derived/drafts/chain/config.json",
+      "sha256": "740f7d38e7f4242cea692602f501a69fec4ed8c11adb048607054d795c12c4e3"
+    },
+    {
+      "path": "derived/drafts/chain/input/painting_in_rig.png",
+      "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts/background.png",
+      "sha256": "c180182b6666fb4d90d4f91e210bda103a4081f1ad7c45006db392fa6c4eaf36"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts/eye_l.png",
+      "sha256": "c080dceac3b4d8fbc824ebb0ebffe61047f10af4e2cdd8d51b32bf779691617e"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts/eye_r.png",
+      "sha256": "c080dceac3b4d8fbc824ebb0ebffe61047f10af4e2cdd8d51b32bf779691617e"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts/face.png",
+      "sha256": "9626a5008eb90b22ab7623cb79048ed521c6aa651254287bbc9df8606b9f0bf7"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts/lantern.png",
+      "sha256": "79ff42136a509e98032352ef9f8c0857a5d7f16667eb629bc048b9b8ef24d96a"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts/torso.png",
+      "sha256": "adf6cd5d92568c5f51028df2874b69f4df5ff1d0e3a94484784c867e543cd912"
+    },
+    {
+      "path": "derived/drafts/chain/input/parts.json",
+      "sha256": "fb0b74d03b7e71d1c2bb2a6fe0ca1ef7415239863ea8eb95fc271b6eee38a0b7"
+    },
+    {
+      "path": "derived/drafts/chain/input/recomposite_rig.png",
+      "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+    },
+    {
+      "path": "derived/drafts/chain/interview-requirements.json",
+      "sha256": "214ddb880e94a575cd4afb35f99ddfa3d90198b88095550f20e0b980d2fd0cff"
+    },
+    {
+      "path": "derived/drafts/chain/out/check/build/run.json",
+      "sha256": "9ff4b765bc7f84587c8f0d1c7dbdde2f5c4ba36cc1924948e5ef6b28f439b796"
+    },
+    {
+      "path": "derived/drafts/chain/out/check/build/skeleton.atlas",
+      "sha256": "68f9cb5eea7a194d59fb14d5c2363894b2eca78c26bf9aee67a760955a6125f3"
+    },
+    {
+      "path": "derived/drafts/chain/out/check/build/skeleton.json",
+      "sha256": "8e2b5edae8cce48ca98587ddb458f38406d28ba7fb7ade02dbd2a0bc8f28e03d"
+    },
+    {
+      "path": "derived/drafts/chain/out/check/build/skeleton.model.json",
+      "sha256": "3c899fedb29f61722790c7ae54686d92dad2980699c416b0912dc7883c016d46"
+    },
+    {
+      "path": "derived/drafts/chain/out/check/build/skeleton.png",
+      "sha256": "1b1836dc1a2700302723ebfebc8fd2be918ba69dff41029788a90595c426c6b2"
+    },
+    {
+      "path": "derived/drafts/chain/out/images/background.png",
+      "sha256": "24eb570320b9e27ce6449b54e82abd811043b9a63f48387f13cbba2dbed5c5f8"
+    },
+    {
+      "path": "derived/drafts/chain/out/images/eye_l.png",
+      "sha256": "97da226ecba85a1af18173df4eb28d72b0828cda8c171f8d4a2995a3da9cc733"
+    },
+    {
+      "path": "derived/drafts/chain/out/images/eye_r.png",
+      "sha256": "97da226ecba85a1af18173df4eb28d72b0828cda8c171f8d4a2995a3da9cc733"
+    },
+    {
+      "path": "derived/drafts/chain/out/images/face.png",
+      "sha256": "e2bd0d0736b3ecda20d6a08840468a2d46738c226631fd73e280dab3719c9e4c"
+    },
+    {
+      "path": "derived/drafts/chain/out/images/lantern.png",
+      "sha256": "733d1cc36c0d1a01f1d330085316f8bcccb8d4331e2f20b9a3dfe2a3407a7041"
+    },
+    {
+      "path": "derived/drafts/chain/out/images/torso.png",
+      "sha256": "356a2a89f530ef7ab5719eefa2cfbff37f8f39a274f41689f13a9c7a2d76adf5"
+    },
+    {
+      "path": "derived/drafts/chain/out/mesh_report.json",
+      "sha256": "06a55efc24facba602ba370a225f5835ce6a95e210a3760707977d2f1a8e36db"
+    },
+    {
+      "path": "derived/drafts/chain/out/motion.json",
+      "sha256": "727746f1a894513ea33c26b984ceb637f7eef06e935cb174ad99ad65826ec5c9"
+    },
+    {
+      "path": "derived/drafts/chain/out/rig.json",
+      "sha256": "d266d58324d252e7c932ad41f856284a277e3c84204f7a081de7a5e1d3935de3"
+    },
+    {
+      "path": "derived/drafts/chain/out/run.json",
+      "sha256": "15cb992b723fc182c0e8d82d840cb85faaac32d4498b850a20f68fe0a263c1b9"
+    },
+    {
+      "path": "derived/review/v1/config.json",
+      "sha256": "740f7d38e7f4242cea692602f501a69fec4ed8c11adb048607054d795c12c4e3"
+    },
+    {
+      "path": "derived/review/v1/interview-requirements.json",
+      "sha256": "214ddb880e94a575cd4afb35f99ddfa3d90198b88095550f20e0b980d2fd0cff"
+    },
+    {
+      "path": "derived/review/v1/out/check/build/run.json",
+      "sha256": "9ff4b765bc7f84587c8f0d1c7dbdde2f5c4ba36cc1924948e5ef6b28f439b796"
+    },
+    {
+      "path": "derived/review/v1/out/check/build/skeleton.atlas",
+      "sha256": "68f9cb5eea7a194d59fb14d5c2363894b2eca78c26bf9aee67a760955a6125f3"
+    },
+    {
+      "path": "derived/review/v1/out/check/build/skeleton.json",
+      "sha256": "8e2b5edae8cce48ca98587ddb458f38406d28ba7fb7ade02dbd2a0bc8f28e03d"
+    },
+    {
+      "path": "derived/review/v1/out/check/build/skeleton.model.json",
+      "sha256": "3c899fedb29f61722790c7ae54686d92dad2980699c416b0912dc7883c016d46"
+    },
+    {
+      "path": "derived/review/v1/out/check/build/skeleton.png",
+      "sha256": "1b1836dc1a2700302723ebfebc8fd2be918ba69dff41029788a90595c426c6b2"
+    },
+    {
+      "path": "derived/review/v1/out/parts/background.png",
+      "sha256": "c180182b6666fb4d90d4f91e210bda103a4081f1ad7c45006db392fa6c4eaf36"
+    },
+    {
+      "path": "derived/review/v1/out/parts/eye_l.png",
+      "sha256": "c080dceac3b4d8fbc824ebb0ebffe61047f10af4e2cdd8d51b32bf779691617e"
+    },
+    {
+      "path": "derived/review/v1/out/parts/eye_r.png",
+      "sha256": "c080dceac3b4d8fbc824ebb0ebffe61047f10af4e2cdd8d51b32bf779691617e"
+    },
+    {
+      "path": "derived/review/v1/out/parts/face.png",
+      "sha256": "9626a5008eb90b22ab7623cb79048ed521c6aa651254287bbc9df8606b9f0bf7"
+    },
+    {
+      "path": "derived/review/v1/out/parts/lantern.png",
+      "sha256": "79ff42136a509e98032352ef9f8c0857a5d7f16667eb629bc048b9b8ef24d96a"
+    },
+    {
+      "path": "derived/review/v1/out/parts/torso.png",
+      "sha256": "adf6cd5d92568c5f51028df2874b69f4df5ff1d0e3a94484784c867e543cd912"
+    },
+    {
+      "path": "derived/review/v1/out/parts.json",
+      "sha256": "fb0b74d03b7e71d1c2bb2a6fe0ca1ef7415239863ea8eb95fc271b6eee38a0b7"
+    },
+    {
+      "path": "derived/review/v1/out/rig/images/background.png",
+      "sha256": "24eb570320b9e27ce6449b54e82abd811043b9a63f48387f13cbba2dbed5c5f8"
+    },
+    {
+      "path": "derived/review/v1/out/rig/images/eye_l.png",
+      "sha256": "97da226ecba85a1af18173df4eb28d72b0828cda8c171f8d4a2995a3da9cc733"
+    },
+    {
+      "path": "derived/review/v1/out/rig/images/eye_r.png",
+      "sha256": "97da226ecba85a1af18173df4eb28d72b0828cda8c171f8d4a2995a3da9cc733"
+    },
+    {
+      "path": "derived/review/v1/out/rig/images/face.png",
+      "sha256": "e2bd0d0736b3ecda20d6a08840468a2d46738c226631fd73e280dab3719c9e4c"
+    },
+    {
+      "path": "derived/review/v1/out/rig/images/lantern.png",
+      "sha256": "733d1cc36c0d1a01f1d330085316f8bcccb8d4331e2f20b9a3dfe2a3407a7041"
+    },
+    {
+      "path": "derived/review/v1/out/rig/images/torso.png",
+      "sha256": "356a2a89f530ef7ab5719eefa2cfbff37f8f39a274f41689f13a9c7a2d76adf5"
+    },
+    {
+      "path": "derived/review/v1/out/rig/mesh_report.json",
+      "sha256": "06a55efc24facba602ba370a225f5835ce6a95e210a3760707977d2f1a8e36db"
+    },
+    {
+      "path": "derived/review/v1/out/rig/motion.json",
+      "sha256": "727746f1a894513ea33c26b984ceb637f7eef06e935cb174ad99ad65826ec5c9"
+    },
+    {
+      "path": "derived/review/v1/out/rig/rig.json",
+      "sha256": "d266d58324d252e7c932ad41f856284a277e3c84204f7a081de7a5e1d3935de3"
+    },
+    {
+      "path": "derived/review/v1/out/rig/run.json",
+      "sha256": "15cb992b723fc182c0e8d82d840cb85faaac32d4498b850a20f68fe0a263c1b9"
+    },
+    {
+      "path": "evidence/.gitkeep",
+      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+    },
+    {
+      "path": "evidence/approval.txt",
+      "sha256": "e05bbdcecef4e5783efa2415eea975b0abdbf4454bf9143d5fb650c0c513eb83"
+    },
+    {
+      "path": "evidence/diff-components.json",
+      "sha256": "6727d1165b72f75c2e18d7734854be6939f6339849f42378588ee90bf3a8f39d"
+    },
+    {
+      "path": "evidence/interview/assemble.json",
+      "sha256": "ad043df33c7ca22710d61b7f26676ead657cfbbd76c57d5c56a255340f3ddc38"
+    },
+    {
+      "path": "evidence/interview/bones.json",
+      "sha256": "ec52614827d9fe6931e7593595f2c11f58a4861db579d725615be8928e9722df"
+    },
+    {
+      "path": "evidence/interview/constraints.json",
+      "sha256": "f848462e9b4098f67389aab6bc3478d0a990edf793efe4d61a6a60ac0a87ad00"
+    },
+    {
+      "path": "evidence/interview/meshes.json",
+      "sha256": "035cd9b43b52bae6e1de98063d7e87d42e198dab3655a61bdf564f88cdc8c3c9"
+    },
+    {
+      "path": "evidence/interview/motion.json",
+      "sha256": "82a3831e8f95abee27c19bdcb81cd7448d9d20cb84b43b45fcee121bd77d4373"
+    },
+    {
+      "path": "evidence/interview/reference.json",
+      "sha256": "00fd672f2125a1879249a57726f7fbc2f0ec9510587b7c6433caae1686ec6b9a"
+    },
+    {
+      "path": "evidence/interview/rig_type.json",
+      "sha256": "be6ce065cede003d5df3dc2d1392b403e7bec174a90182afe7280e7b926bc931"
+    },
+    {
+      "path": "evidence/interview/seethrough.json",
+      "sha256": "2f66f51b295c2fab3a362ff48df3322c346b9f2f84de23c9b736226c2fb030d0"
+    },
+    {
+      "path": "evidence/parts-check.json",
+      "sha256": "9b1527d1426c313c2ca1322f92530972e3fd0b109aba25f18877171af35b2ba1"
+    },
+    {
+      "path": "evidence/parts-review.json",
+      "sha256": "ec87618dcb99bdf9a636245132a6e5455edbe62b40e80c830e83decb2e978611"
+    },
+    {
+      "path": "evidence/review-reads/a12dea02d32508acc99386f894af76a14f1c85f45f804db2aa6b4dea5297973f.json",
+      "sha256": "a12dea02d32508acc99386f894af76a14f1c85f45f804db2aa6b4dea5297973f"
+    },
+    {
+      "path": "evidence/setup.png",
+      "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+    },
+    {
+      "path": "evidence/split-config.json",
+      "sha256": "09894c45fb493a697713d2055cbd294b0cb2c9c28cf9d2cda41334d8f1904100"
+    },
+    {
+      "path": "evidence/structure.json",
+      "sha256": "41b532a263a8f40997a9c5d3c155e2fa943b26c2b3e61ed03ddcf29ee0d8011d"
+    },
+    {
+      "path": "evidence/v1/config.json",
+      "sha256": "740f7d38e7f4242cea692602f501a69fec4ed8c11adb048607054d795c12c4e3"
+    },
+    {
+      "path": "evidence/v1/interview-requirements.json",
+      "sha256": "214ddb880e94a575cd4afb35f99ddfa3d90198b88095550f20e0b980d2fd0cff"
+    },
+    {
+      "path": "inputs/painting.png",
+      "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+    },
+    {
+      "path": "inputs/references/.gitkeep",
+      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+    },
+    {
+      "path": "outputs/v1/out/check/build/run.json",
+      "sha256": "9ff4b765bc7f84587c8f0d1c7dbdde2f5c4ba36cc1924948e5ef6b28f439b796"
+    },
+    {
+      "path": "outputs/v1/out/check/build/skeleton.atlas",
+      "sha256": "68f9cb5eea7a194d59fb14d5c2363894b2eca78c26bf9aee67a760955a6125f3"
+    },
+    {
+      "path": "outputs/v1/out/check/build/skeleton.json",
+      "sha256": "8e2b5edae8cce48ca98587ddb458f38406d28ba7fb7ade02dbd2a0bc8f28e03d"
+    },
+    {
+      "path": "outputs/v1/out/check/build/skeleton.model.json",
+      "sha256": "3c899fedb29f61722790c7ae54686d92dad2980699c416b0912dc7883c016d46"
+    },
+    {
+      "path": "outputs/v1/out/check/build/skeleton.png",
+      "sha256": "1b1836dc1a2700302723ebfebc8fd2be918ba69dff41029788a90595c426c6b2"
+    },
+    {
+      "path": "outputs/v1/out/painting_in_rig.png",
+      "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+    },
+    {
+      "path": "outputs/v1/out/parts/background.png",
+      "sha256": "c180182b6666fb4d90d4f91e210bda103a4081f1ad7c45006db392fa6c4eaf36"
+    },
+    {
+      "path": "outputs/v1/out/parts/eye_l.png",
+      "sha256": "c080dceac3b4d8fbc824ebb0ebffe61047f10af4e2cdd8d51b32bf779691617e"
+    },
+    {
+      "path": "outputs/v1/out/parts/eye_r.png",
+      "sha256": "c080dceac3b4d8fbc824ebb0ebffe61047f10af4e2cdd8d51b32bf779691617e"
+    },
+    {
+      "path": "outputs/v1/out/parts/face.png",
+      "sha256": "9626a5008eb90b22ab7623cb79048ed521c6aa651254287bbc9df8606b9f0bf7"
+    },
+    {
+      "path": "outputs/v1/out/parts/lantern.png",
+      "sha256": "79ff42136a509e98032352ef9f8c0857a5d7f16667eb629bc048b9b8ef24d96a"
+    },
+    {
+      "path": "outputs/v1/out/parts/torso.png",
+      "sha256": "adf6cd5d92568c5f51028df2874b69f4df5ff1d0e3a94484784c867e543cd912"
+    },
+    {
+      "path": "outputs/v1/out/parts.json",
+      "sha256": "fb0b74d03b7e71d1c2bb2a6fe0ca1ef7415239863ea8eb95fc271b6eee38a0b7"
+    },
+    {
+      "path": "outputs/v1/out/rig/images/background.png",
+      "sha256": "24eb570320b9e27ce6449b54e82abd811043b9a63f48387f13cbba2dbed5c5f8"
+    },
+    {
+      "path": "outputs/v1/out/rig/images/eye_l.png",
+      "sha256": "97da226ecba85a1af18173df4eb28d72b0828cda8c171f8d4a2995a3da9cc733"
+    },
+    {
+      "path": "outputs/v1/out/rig/images/eye_r.png",
+      "sha256": "97da226ecba85a1af18173df4eb28d72b0828cda8c171f8d4a2995a3da9cc733"
+    },
+    {
+      "path": "outputs/v1/out/rig/images/face.png",
+      "sha256": "e2bd0d0736b3ecda20d6a08840468a2d46738c226631fd73e280dab3719c9e4c"
+    },
+    {
+      "path": "outputs/v1/out/rig/images/lantern.png",
+      "sha256": "733d1cc36c0d1a01f1d330085316f8bcccb8d4331e2f20b9a3dfe2a3407a7041"
+    },
+    {
+      "path": "outputs/v1/out/rig/images/torso.png",
+      "sha256": "356a2a89f530ef7ab5719eefa2cfbff37f8f39a274f41689f13a9c7a2d76adf5"
+    },
+    {
+      "path": "outputs/v1/out/rig/mesh_report.json",
+      "sha256": "06a55efc24facba602ba370a225f5835ce6a95e210a3760707977d2f1a8e36db"
+    },
+    {
+      "path": "outputs/v1/out/rig/motion.json",
+      "sha256": "727746f1a894513ea33c26b984ceb637f7eef06e935cb174ad99ad65826ec5c9"
+    },
+    {
+      "path": "outputs/v1/out/rig/rig.json",
+      "sha256": "d266d58324d252e7c932ad41f856284a277e3c84204f7a081de7a5e1d3935de3"
+    },
+    {
+      "path": "outputs/v1/out/rig/run.json",
+      "sha256": "15cb992b723fc182c0e8d82d840cb85faaac32d4498b850a20f68fe0a263c1b9"
+    },
+    {
+      "path": "package.json",
+      "sha256": "0a22e147646e4b1774a05c89bb5f4153aeacacb79ec046af8416524888a518c1"
+    },
+    {
+      "path": "project.json",
+      "sha256": "327efa3dbb0f2997e37164b7d534002597efeddd1f43595d4e1ff3a77bcad2e3"
+    }
+  ]
+}

package/templates/example-chain/checkpoints/4-direction-post/AGENTS.md

@@ -0,0 +1,134 @@
+# Agent guide
+
+One painting in, one rig and its takes out. Start here.
+
+## Start here
+
+1. Read `project.json` first. Only its decisions count. Copy chat decisions
+   verbatim, with speaker and time.
+2. Run `rig-create next` to derive the next moves and whose they are.
+3. Resume per [PROJECT.md § How an agent resumes a project](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#how-an-agent-resumes-a-project).
+
+Update stale pins with `rig-create packages upgrade --by <operator>`; see PROJECT.md.
+
+Declare the project's painting with `init --painting <file> --origin <words>`
+or `input add <path> --painting --origin <words>`. `project.json.painting` binds
+one input and survives restart; only it checks siblings for duplicate artwork.
+Older records may omit it.
+
+## The order, and what you may not do
+
+`interview` → `plan-approved` → `parts` → `parts-review` (the parts, by eye) →
+`rigging-interview` → `rigging` → `rig-review` (the rig, still frame) → `post-interview` → `post` →
+`direction-review` → `accepted`. Any stage can become `paused`.
+
+- Only a person's `signoffs[]` advances `stage` or passes a plan checkpoint.
+  You may draft, propose, build and measure in any stage; production rigging
+  waits for `rigging-interview` ([PROJECT.md § Stages](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#stages)).
+- Never derive answers from the image. Offer a pick per ask, with one reasoned
+  recommendation, Other and auto. Retain the shown set; never preselect.
+- Record "auto" as delegated, with your decision on the item. It is never a
+  blank for you to fill later.
+- Before asking the user to sign the interview, run `rig-create interview --check`: it names every `null` answer.
+
+## The user's four steps
+
+1. **Parts and meshes**. Ask framing/source. Review a labelled draft's parts and
+   mesh/chest structure. `parts-review` records its Review API response.
+   The latest receipt must approve the draft for `structure-snapshot --draft <id> --out <f>`
+   and `signoff parts-review --draft <id> --structure-file <f>`; record component triage with `diff-classes --diff-report <p> --by agent` ([PROJECT.md § Labelled draft rigs](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#labelled-draft-rigs-and-structure-decisions)).
+2. **Rigging interview**. Ask fresh bones, deformation, physics and motion
+   against approved parts/structure; use interview-options/answer/decision.
+3. **Rig and animation**. Keep rig feedback.
+   Ingest: `review <version> --from-review <actId>`.
+4. **Direction**. `job open --rig <post>` asks the verdict only.
+   Ingest `review <post> --from-review <actId>`, then `job open --plan` for
+   record-page sign-off (source-linked Review).
+
+Ask: `job open --reviewer <id> --role owner --question <id>` or `--plan`;
+ingest `--from-review <actId>`, then advance.
+
+Use `advance <stage>`, `step-status <id>`; see `rig-create --help`.
+`advance parts-review` needs `--parts-check <report> --parts <assembled dir>`,
+refusing [`PARTS_CHECK_MISSING`, `PARTS_CHECK_UNREAD`, `PARTS_CHECK_INVALID`, `PARTS_CHECK_CHANGED`, `PARTS_CHECK_FAILED`, `PARTS_CHECK_STALE`](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#parts-stage-check-at-the-parts--parts-review-move).
+In `parts`, record an `intake-report` preflight and offer its choice, both advisory:
+[PROJECT.md § Advisory intake reports](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#advisory-intake-reports).
+
+Drafts stay under `derived/drafts/<id>/`, never versions/handoff. Old records
+warn: preserve history and dates; adopt choices explicitly.
+
+## Before you ask, plan or show
+
+- **Prior words.** In adopted projects, show them verbatim as a tailored option
+  with source/date; require a pick. Legacy derivation: [INTERVIEW.md § Derived answers](https://github.com/rig-c/create/blob/main/docs/INTERVIEW.md#derived-answers).
+- **Projection.** Ask and record it per [CHECKS.md § Projection and ground](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#projection-and-ground).
+- **Upscale first** a painting smaller than the rig needs (SOURCE.md, step 2 below).
+- **The crux is a bar.** Before rigging, name every risk band, count background
+  or doubled pixels over every frame and both physics/breath extremes, and
+  report the maximum and its frame. Cover every band crossing another bone.
+- **Bars before sign-off.** Each reading names its command, checked against
+  installed `--help`. A reading with no command is a STOP before sign-off.
+  Loop bars: INTERVIEW.md, "Bars have reading commands".
+- **Appearance needs a person**, not a step bar: [CHECKS.md § Appearance bar wording](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#appearance-bar-wording).
+- **Nothing unnamed.** Add no motion, chain or physics the user did not name. A
+  reference ("move like X") is read for what it shows; anything more is a
+  question, not a default.
+- **Re-run first, cut last**, never a polygon in code or config: the ladder in
+  SOURCE.md, step 2 below.
+- **A full-screen scene is a CG build.** For `rig_type` `fullscreen.*`, each
+  rig version declares the gates in [CHECKS.md § CG gates](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#cg-gates). Refusals are the art's to fix.
+- **The bust is meshed** unless the `meshes` guide excludes it with a reason
+  ([CHECKS.md § The bust at meshes](https://github.com/rig-c/create/blob/main/docs/CHECKS.md#the-bust-at-meshes)).
+- **Overlaps.** A piece over a part with its own animation (glasses over
+  eyelids) holds none of that part's pixels, or the animation shows its copy.
+- **Pairs.** Measure left/right symmetry against the painting before calling a
+  pair uneven ([CRAFT.md G8](https://github.com/rig-c/create/blob/main/docs/CRAFT.md#for-the-gates-not-the-interview)).
+- **Look before the user does**, at native resolution and every boundary the
+  crux names: a whole-figure |composite − painting| map, every component listed
+  by box and part with a status (in the painting / fixed / left, why). Use the
+  true stack of part images, not a render flattened on white; crop on white and
+  on mid-grey, as white hides light fringes. Eye boxes a
+  reviewer chose are not the check: a seam outside them got through.
+
+## Where things go
+
+Each folder's lifetime and git status: [PROJECT.md § Data is split by lifetime](https://github.com/rig-c/create/blob/main/docs/PROJECT.md#data-is-split-by-lifetime).
+
+## What to read, and why
+
+1. **Before the interview**: INTERVIEW.md, and CRAFT.md for the default at each
+   waypoint (both linked below); parts AUTHORING §3, *`config.json`, field by
+   field*; [CHECKS.md](https://github.com/rig-c/create/blob/main/docs/CHECKS.md) before a sign-off.
+2. **Before `seethrough` and `assemble`**: SOURCE.md, the order of the split and
+   the cut: [re-running a bad split](https://github.com/rig-c/create/blob/main/docs/SOURCE.md#re-run-first),
+   [where a cut is allowed](https://github.com/rig-c/create/blob/main/docs/SOURCE.md#where-a-cut-is-allowed);
+   then parts AUTHORING *See-through head-run source reading*, *Source before
+   scissors* and *Limbs: cut at their joints*.
+3. **Before rigging**: [CRAFT.md § For the gates](https://github.com/rig-c/create/blob/main/docs/CRAFT.md#for-the-gates-not-the-interview)
+   (G1–G9); core RIGGING and MOTION; parts AUTHORING §7, the bars `check` enforces.
+4. **Before showing the user**: [LESSONS.md § The self-check](https://github.com/rig-c/create/blob/main/docs/LESSONS.md#the-self-check),
+   the [per-frame seam count](https://github.com/rig-c/create/blob/main/docs/LESSONS.md#count-the-seam-bar-over-every-frame),
+   [what to show first](https://github.com/rig-c/create/blob/main/docs/LESSONS.md#what-to-show-the-user-first).
+
+Read installed docs here at `package.json`'s pins to match tools, not memory.
+Run refusal `(see … guide …)` commands before changes.
+
+- [@rig-c/parts README.md](node_modules/@rig-c/parts/README.md): painting-to-rig pipeline and command order.
+- [@rig-c/parts docs/AUTHORING.md](node_modules/@rig-c/parts/docs/AUTHORING.md): config fields, interview waypoints and refusal remedies.
+- [@rig-c/parts docs/PAINTING.md](node_modules/@rig-c/parts/docs/PAINTING.md): what makes a painting riggable, and the check to run on it before See-through.
+- [@rig-c/parts docs/DEPTH.md](node_modules/@rig-c/parts/docs/DEPTH.md): when the plan has a head turn driven by depth.
+- [@rig-c/parts docs/STABILITY.md](node_modules/@rig-c/parts/docs/STABILITY.md): stable commands, fields and outputs.
+- [@rig-c/parts docs/MIGRATION.md](node_modules/@rig-c/parts/docs/MIGRATION.md): only when the pinned version is bumped.
+- [@rig-c/core README.md](node_modules/@rig-c/core/README.md): rigc scope, commands and documentation.
+- [@rig-c/core docs/AUTHORING.md](node_modules/@rig-c/core/docs/AUTHORING.md): rig/motion formats, build loop and failure remedies.
+- [@rig-c/core docs/RIGGING.md](node_modules/@rig-c/core/docs/RIGGING.md): bones and pivots at the bones waypoint.
+- [@rig-c/core docs/MOTION.md](node_modules/@rig-c/core/docs/MOTION.md): key-pose motions at the motion waypoint.
+- [@rig-c/core docs/FACE.md](node_modules/@rig-c/core/docs/FACE.md): blink, gaze and head-turn plans.
+- [@rig-c/core docs/INGEST.md](node_modules/@rig-c/core/docs/INGEST.md): only when you were handed a skeleton this project did not author.
+
+Project organisation: rig-c/create docs (not installed).
+
+- [docs/PROJECT.md](https://github.com/rig-c/create/blob/main/docs/PROJECT.md): the folder, stages and sign-offs, the plan, versions, and `project.json` field by field.
+- [docs/INTERVIEW.md](https://github.com/rig-c/create/blob/main/docs/INTERVIEW.md): how to ask, and the shape every answer, delegation and piece of feedback takes.
+- [docs/CRAFT.md](https://github.com/rig-c/create/blob/main/docs/CRAFT.md): the default to propose at each waypoint.
+- [docs/COLLECTIONS.md](https://github.com/rig-c/create/blob/main/docs/COLLECTIONS.md): when this project is a member of a collection.

package/templates/example-chain/checkpoints/4-direction-post/CLAUDE.md

@@ -0,0 +1,3 @@
+@AGENTS.md
+
+The agent guide for this project is AGENTS.md, imported above. It is the only copy: change it there, not here.

package/templates/example-chain/checkpoints/4-direction-post/evidence/approval.txt

@@ -0,0 +1 @@
+Approve this synthetic geometric example.

package/templates/example-chain/checkpoints/4-direction-post/evidence/diff-components.json

@@ -0,0 +1,34 @@
+{
+  "spec": "rig-parts-diff-components/1",
+  "stack": {
+    "path": "assembled/render/recomposite_rig.png",
+    "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+  },
+  "painting": {
+    "path": "painting.png",
+    "sha256": "02e6ea41dfec89a7eced0f66b98e0fea048846c6f4174fa1cc7631fe360e614f"
+  },
+  "definition": {
+    "metric": "max-absolute-rgb-channel",
+    "threshold": 40,
+    "comparison": ">",
+    "connectivity": 8,
+    "floor_px": 2,
+    "coordinates": "native",
+    "y": "down",
+    "origin": "top-left",
+    "resampling": "none",
+    "covered_alpha_above": 128,
+    "width": 128,
+    "height": 128,
+    "inside_sha256": null
+  },
+  "error_px": 0,
+  "uncovered_error_px": 0,
+  "components": [],
+  "below_floor": {
+    "count": 0,
+    "px": 0,
+    "uncovered_px": 0
+  }
+}