@yunhozz/arc 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/MANIFEST.sha256 +48 -35
  2. package/README.md +11 -0
  3. package/bin/arc-upgrade.mjs +3 -0
  4. package/claude/agents/arc-coder.md +1 -1
  5. package/claude/agents/arc-qa.md +2 -2
  6. package/claude/skill/SKILL.md +8 -8
  7. package/claude/skill/references/commit.md +4 -8
  8. package/claude/skill/references/coordination.md +6 -6
  9. package/claude/skill/references/git-recovery.md +3 -2
  10. package/claude/skill/references/handoff-prep.md +4 -2
  11. package/claude/skill/references/handoff.md +6 -7
  12. package/claude/skill/references/limits.md +1 -1
  13. package/claude/skill/references/planning.md +19 -40
  14. package/claude/skill/references/verification.md +8 -28
  15. package/claude/skill/references/visual-companion.md +1 -1
  16. package/codex/agents/arc-coder.toml +1 -0
  17. package/codex/agents/arc-planner.toml +2 -0
  18. package/codex/agents/arc-qa.toml +2 -0
  19. package/codex/agents/arc-reviewer.toml +2 -0
  20. package/codex/agents/arc-scouter.toml +2 -0
  21. package/codex/skill/SKILL.md +10 -11
  22. package/codex/skill/references/commit.md +9 -21
  23. package/codex/skill/references/coordination.md +5 -7
  24. package/codex/skill/references/git-recovery.md +21 -18
  25. package/codex/skill/references/handoff-prep.md +14 -16
  26. package/codex/skill/references/handoff-worktree.md +10 -12
  27. package/codex/skill/references/handoff.md +27 -44
  28. package/codex/skill/references/limits.md +1 -1
  29. package/codex/skill/references/planning.md +34 -61
  30. package/codex/skill/references/verification.md +22 -50
  31. package/codex/skill/references/visual-companion.md +6 -8
  32. package/lib/cli/choices.mjs +4 -4
  33. package/lib/cli/completion.mjs +10 -8
  34. package/lib/cli/index.mjs +5 -5
  35. package/lib/cli/postinstall.mjs +17 -0
  36. package/lib/cli/root.mjs +2 -1
  37. package/lib/cli/terminal.mjs +19 -0
  38. package/lib/cli/upgrade.mjs +57 -0
  39. package/lib/installer/plan.mjs +3 -2
  40. package/lib/installer/upgrade-state.mjs +29 -0
  41. package/lib/installer/upgrade.mjs +34 -0
  42. package/lib/npm/context.mjs +36 -0
  43. package/lib/npm/process.mjs +17 -0
  44. package/lib/npm/upgrade.mjs +29 -0
  45. package/lib/release/artifact.mjs +163 -0
  46. package/package.json +3 -2
  47. package/scripts/pack-release.mjs +9 -0
  48. package/scripts/postinstall.mjs +4 -0
  49. package/scripts/verify-release.mjs +6 -0
package/MANIFEST.sha256 CHANGED
@@ -1,23 +1,24 @@
1
- cbd254348f60c8610d0e5c4b8216c9772c0bd5dbfef324796da516b87054b06e README.md
1
+ 85cea3cfddbf92091b1eec35feaea339e70fc2a1faa65099c99cc6318aec1cc2 README.md
2
+ d41edeb8c6631dee30c67c705d4edad977aa1631627ec9de59c013f8990f4018 bin/arc-upgrade.mjs
2
3
  484d9b2002ce542c87589bb719d644d3762706aad28a6ee010024875f8cc00e2 bin/arc.mjs
3
- 947c0d09355ba3e3dede51192430fe3166ba3b6bb4589c271f6fdbc2bda9b109 claude/agents/arc-coder.md
4
+ d853d31ba0d1a04661adf8cae1df11058455cb5d366c52312888c9dd2e9a1fb8 claude/agents/arc-coder.md
4
5
  91a2c62f4ea3ff00145407411fbbe62aa02fb7608af8f33bbd3d1719fc9d2f13 claude/agents/arc-planner.md
5
- 715b594438b6c216a6e4c918503b72fa518b432e646c969a0ff0021d82d41740 claude/agents/arc-qa.md
6
+ d864e57a1b2b6d69435a17a5c56a0e2c68d26592dd5e510be8d0fa341762cad1 claude/agents/arc-qa.md
6
7
  bd51442a5e76d4b61cbeb7f42d43cbcc7bab890db0d39ef16002ae13f5317c34 claude/agents/arc-reviewer.md
7
8
  c20162438bb8ac6905164268f867a8f1cfdbbfd51ddfd7e795cc211cc7f8c858 claude/agents/arc-scouter.md
8
- 9a8fc52b0355648777b26a6ce6497546fb82c3021791d5802709c160c23e86e7 claude/skill/SKILL.md
9
+ 525c92fb52cc45c2f779176629e11c3a21f4e4434648cd5d6e4f6d7657f536f6 claude/skill/SKILL.md
9
10
  0bf77247b82371b3fe12a8dbe8fd2415c98d06e676d2c234b086b1f1e661b9db claude/skill/hooks/git-policy.json
10
11
  b188c24d1339367acfe16b81be5743298e498856915e5e91b45e1a7220dad602 claude/skill/hooks/role-git-guard.mjs
11
12
  5126d44470486cb2581790b7c8d1605c4d0ee2448b725cf536ba1141eb40fa81 claude/skill/hooks/runtime-gate.mjs
12
- 92bf36c605f9ff17237f1b40ab084bddf5a58645dedabe80e7bd62a54dba7afe claude/skill/references/commit.md
13
- 48322180252bd9dc8e59a379178faa58865ca2d4cf6192f7b3c964dc3f935bdc claude/skill/references/coordination.md
14
- 66489f92a60a9261ce8d10ec38bd2595cd5bc4739972a1466f4d5da1895c4df9 claude/skill/references/git-recovery.md
15
- b2f91dfc0951b4f575430fbc660eaf979ce4322ad563ca5c738ad9a09f489fb8 claude/skill/references/handoff-prep.md
16
- 3a5014dea06ab282f8afd26675744527700aa4635252bf7efc2a56a96c1283a5 claude/skill/references/handoff.md
17
- 10eaf353b5c35ce0d51c10c37ca6cb181121cd20517c793d82c7f5dc5563dff6 claude/skill/references/limits.md
18
- 077c6e9a8c7e099743a0938e3cf2539e585cbc1b1169ace9d6bebbf0add50eb9 claude/skill/references/planning.md
19
- 7451d22e62a8ed9624c8eacef03475eb5ed32b6b7b7c83344c58b5dd281ba2e6 claude/skill/references/verification.md
20
- 0950dd5973db2578547dddfbed1dbe6000c821fda77e2c54da513ff328b5716d claude/skill/references/visual-companion.md
13
+ 3926dbf9c7c244ebbb0baee17b1163387979793cb81c28e90977473d1e0a85e9 claude/skill/references/commit.md
14
+ 33ccd670b9d365abcc03edbfa26761ad00970df8e46633799beee4e72e6148fe claude/skill/references/coordination.md
15
+ 90198f8bc6d9e99cbdb32604413c708753ff8503954b6b120aa7c7f00719de96 claude/skill/references/git-recovery.md
16
+ d4b3100626831b23f0b1cf0106ef9f3bc7e6f3d14864e9dd93ae0f8063b5bdda claude/skill/references/handoff-prep.md
17
+ 42a13f77f2b28d660236237dff88cab166f052a178295cef253a774fd6fc8e40 claude/skill/references/handoff.md
18
+ 4172c1c8ba397ceb561e437cc6ef02d4c2d7e7ed3df1400a4efbf4b46ddca4fa claude/skill/references/limits.md
19
+ 93a7001c6ad4215170fa331261c2d58835fcdad823724f024d5c81a450133340 claude/skill/references/planning.md
20
+ 78704f725dd82bf49f7916ef5522e8c52040ccb05e109b568796d8a9f6e52e6e claude/skill/references/verification.md
21
+ cae43b5105a1300e87526bcc286516519863b2f8c5f70cd6fe1e0950b196a762 claude/skill/references/visual-companion.md
21
22
  30d8cdcb9d7ab6396cab09cd9f5cf6b8003f5490fb5c0ffe9f5acffbb0534978 claude/skill/runtime/adapters/claude.mjs
22
23
  d30d118d3b42b805195ed05a3dea0ed3cf939eac811cf0228ca0b0cafeda7969 claude/skill/runtime/adapters/codex.mjs
23
24
  c5a56ac147f13e9f946f673ac57a5dadbb4560d1f9deaa7c3b60e703f39b2d83 claude/skill/runtime/capabilities.mjs
@@ -32,23 +33,23 @@ c93f08cf6cafb5d96007df33d00dadda676c54b074fb998c2e523ecfc5e23d30 claude/skill/r
32
33
  aa1361419c0137f74793847805a3abc076a8d782c6f590e2d28b8eee5c35065d claude/skill/runtime/store.mjs
33
34
  e4445f3582c55861907e11dfe97ea9e87c69bcc3ff773d3d583914c198f1d024 claude/skill/scripts/apply-models.py
34
35
  e4fe5d5718db1cf6ecc5ab289995aafc73de99bd0ed1fa9cf3ebc0815015109d claude/skill/scripts/model_config.py
35
- 7fe34f48ff1fb3b18257639cfe763b86c61b7e4f33e419f4d829529d2169d1d8 codex/agents/arc-coder.toml
36
- c9df6eaffd228a99ed4fd6604b032741c85f755bf8e4b2bd22af860f33bb7262 codex/agents/arc-planner.toml
37
- d79781ade7670a942f4b6b1a7c30406c6328195e395cc47ae0c5a4f3e9a5e449 codex/agents/arc-qa.toml
38
- c4911b92fc75c316e23164e0efbac5b5a25d7c9666fce0e1f5686e0f96867588 codex/agents/arc-reviewer.toml
39
- 13bf5608336871683f096fc0f305725fb87b5b9703195fbae42f33ef991a00f9 codex/agents/arc-scouter.toml
40
- d58e8a734bef143e808003b3f3c4e894528330256f10b52e36db5abcc3ae1fc0 codex/skill/SKILL.md
36
+ e88c798941158bf28b67a1f4687c8896d66417d9113b97a7324438c929cf2df5 codex/agents/arc-coder.toml
37
+ d9c718e4a1cce5fef343afbc623ebb82fd29b85f40270b84a0f1770f57a61a50 codex/agents/arc-planner.toml
38
+ 793d132db240208729c2d54068634e872ead72b573c0cd4648a6e2f50e5cc56c codex/agents/arc-qa.toml
39
+ 022f1abd7fd325ab543f6c7c5263a1d0c973be417a39ee8f3bb3295b44749fa3 codex/agents/arc-reviewer.toml
40
+ 0dc1905c3bb16e3b7117d9b38cab0c1e6e93f496afdb82f782ef830f1f3a6417 codex/agents/arc-scouter.toml
41
+ 79a113eebcaff301656fdc52f3713f0dad909ce7b55d6a0357504ca20eb48549 codex/skill/SKILL.md
41
42
  019f190ee7a2ccfea059a289ca971265574b043353f89bc96e219436c9827e9e codex/skill/hooks/runtime-gate.mjs
42
- 6bb10ba131c068ba29bd03f3c3efd58bd353c1be472718970839bf6b7dda7845 codex/skill/references/commit.md
43
- 6d9f098f0edf4dcb4152bd497067f8c156144a027a0e656a557085de330f8fff codex/skill/references/coordination.md
44
- c164e4c47e21edb10bb06ba010c684a9cdb0bea40d4cde32f60fb08315dfbb97 codex/skill/references/git-recovery.md
45
- 90a252fab344e19a3b68838fbe974cef9efc375b093b5ea0bbacb951d430174a codex/skill/references/handoff-prep.md
46
- 46c20384b87730f73d2bb1cba260571618eed1946f8006c466d08ca3b4546105 codex/skill/references/handoff-worktree.md
47
- e932e083a0aa99e44be126fd2873b9fd48fa855771a41c3184bb76365738db2a codex/skill/references/handoff.md
48
- 658314d60ed1ff78a1d931b5216a3b85f5f928821db915260ccf06d66e6e91ae codex/skill/references/limits.md
49
- 7bb0976062272c5f62692d96d6b9689284665d1cb22ee10ec514183fcf48f438 codex/skill/references/planning.md
50
- 99dddab8f92ca95a92ce238fb19cee2c433aff0983e6147c0b40e3f5ccad0117 codex/skill/references/verification.md
51
- 892017d193534039fb82cac1dd41f53a28037ea4b8bf255e4716d348adc7d6be codex/skill/references/visual-companion.md
43
+ ce8ab4dd1a69176fc4d76b2e9e3c81b9165586c3a29833fe855f2a085f22195e codex/skill/references/commit.md
44
+ 263b4d59d67bc365bcf9e658ebfba1d3896662c5fcdb0f45a87a30fd6b0fd43a codex/skill/references/coordination.md
45
+ be0a2e4050a0cad20d272775698be82dcc244081c4c1092de56e8a118de718b1 codex/skill/references/git-recovery.md
46
+ 39ce5bb81d1fa303394c8c2c6b0d306d9fc341a866654fdabb02a33e6f5c2dee codex/skill/references/handoff-prep.md
47
+ 272b60b91ac05139985611d1555c417eab3ca1783655a9196511a0eda02caaba codex/skill/references/handoff-worktree.md
48
+ 3338d9080415c3cdd4c7a5337f5c1f1d74e9f6cfb084181fe9cce78d906a1162 codex/skill/references/handoff.md
49
+ 89ae51633112f8c7bd71ab15940085e01e57d6582fb0d977c9efdf9d77ce9fc3 codex/skill/references/limits.md
50
+ ed40f33754e4b6df683fe567b91974a381cf99ebd5ec772b493a71f17f01d5a7 codex/skill/references/planning.md
51
+ 3b89adb5bfbf91ac4937b41cdd3a5ebb2ffb652826fff9d834489bd377245e2c codex/skill/references/verification.md
52
+ 23d928dc115b922e5418db9c89057dab2f19acb7c946420a55923d3bb5148417 codex/skill/references/visual-companion.md
52
53
  30d8cdcb9d7ab6396cab09cd9f5cf6b8003f5490fb5c0ffe9f5acffbb0534978 codex/skill/runtime/adapters/claude.mjs
53
54
  d30d118d3b42b805195ed05a3dea0ed3cf939eac811cf0228ca0b0cafeda7969 codex/skill/runtime/adapters/codex.mjs
54
55
  c5a56ac147f13e9f946f673ac57a5dadbb4560d1f9deaa7c3b60e703f39b2d83 codex/skill/runtime/capabilities.mjs
@@ -64,13 +65,16 @@ aa1361419c0137f74793847805a3abc076a8d782c6f590e2d28b8eee5c35065d codex/skill/ru
64
65
  57e93213dc97465757294cb9d0ae2f4eb2f1384b955c4ca2a39f2fa38f7a9bd7 codex/skill/scripts/apply-models.py
65
66
  bce13feeea37c78e5b0ddaf6bdd5ffd2fd0162eabc8c468667133edbabebe944 codex/skill/scripts/model_config.py
66
67
  800964b417c573aa7b2a07a76759a4750652222de63a985bc133d50194739358 install.command
67
- 92e329fcfb26899f524c31ce6cdb08997c274560b271d80d230ae303d6987f17 lib/cli/choices.mjs
68
- 7833879c00f296248bb37a367564ad0c5db07e2c441873a0b4e6a3c3733ca137 lib/cli/completion.mjs
69
- 6655cf91a3af427378755299433feb3f0086d43b047c4f6cd5a2c429f2812dba lib/cli/index.mjs
68
+ d8ed829763544877436f0e6bf349c5460db0c44cce73b75d38c5661c902536c4 lib/cli/choices.mjs
69
+ 640d1bfdda880c2f17149209ce35933ee9f4318b35166df2e86ff49e271d8fc5 lib/cli/completion.mjs
70
+ 0e0d5135fce87d00bda6a92c03ca39ad542841f80a785674d3f7ac446dbce014 lib/cli/index.mjs
71
+ fe34003f994ab962f60f6ec6e04e6c5f812ceb00936cef3d25365bc4c672707b lib/cli/postinstall.mjs
70
72
  515132cf88973720bb6197a849d896face56c23f3c7fc4681ae9123ffc576318 lib/cli/preset.mjs
71
73
  a575a94adc9461a7c5c051983b47d1a40a88fb8ee90fa469041cd99165cbb80f lib/cli/progress.mjs
72
- ad8ad2f47da6e1d3160d786628d768e8d95108f1a1c113a6a5305e7c85c438db lib/cli/root.mjs
74
+ b5497f312d0ad84efc5328def88197adffa239a18f4746ef12ea20059e36d6a8 lib/cli/root.mjs
75
+ 034a93e4127e303880dc347488e46214702b343da06f9ba7a7a6c757473622a5 lib/cli/terminal.mjs
73
76
  85f25429f208a4b45a36e66f89933d2bbfb470d6f52f032f70971817063e45f0 lib/cli/uninstall.mjs
77
+ 4fadbd52e4ecd0d95c7240037c84aa74714e1f9f764440e31d3ce3402c23b5b6 lib/cli/upgrade.mjs
74
78
  7719a16f6327ea3ba35206ee41c829ab967f865df9ebbd161129ca28babceb3d lib/installer/acquisition.mjs
75
79
  66bc9a18523f70ddbb1d9a0844173d311aabd2d00d9ed5c06ca6679179ba8b06 lib/installer/global-config.mjs
76
80
  061ff82e0c655f47b872610b6ad7bde5d1941eaf7c563491a44291c86b16a349 lib/installer/install.mjs
@@ -78,7 +82,7 @@ f9a0958fc424742f49ce6e2e0a49c7cf2bbe288e0cf3551d69a8a912c8f2709f lib/installer/
78
82
  64713575291e51971abc542df716baa99e9a530a489e92b2f8345b782e0ce4cd lib/installer/limits.mjs
79
83
  cec99b4e9c6e6b6c634c84fba978b93484011b6357b652b99b31612ac522a22d lib/installer/manifest.mjs
80
84
  1e6667f21dfa6eb427d7447df98038bbe534345ebb57d6b401f51efe1077f1ed lib/installer/package-references.mjs
81
- 92065a84b0f252cc8e90a76b24f110c615c11035e45e073fb00bb7cb5de83bdf lib/installer/plan.mjs
85
+ 383390bb5a73d3db85d4cfe7f8ae0502925552eacc66c849c0061cd82e487ebd lib/installer/plan.mjs
82
86
  5a7860583cadb57295bdac8296a6c8caa4cedf0d1823e7d08c57846ed8342ba5 lib/installer/preset.mjs
83
87
  4892d61cfe498a85f47f4a8044a831c853660365c98543eb14f4f4449b727c2f lib/installer/runtime-config.mjs
84
88
  e37be4e8b6f366201f42aeab5d7973baa8303b1f96461ee2ced6ce2e73da3bd2 lib/installer/shell-completion.mjs
@@ -87,14 +91,20 @@ c2ab7eda987cf62bba4dce1b7eb302f350a6c67679b0aaf063b3eea11eb010c5 lib/installer/
87
91
  07805edb471c54b87dcc827cf24264571a6427961989d508773b9751a39dc1f0 lib/installer/targets.mjs
88
92
  65ba12b4786b8b8c2cd65731a96475a64d1888644e8c68825bc369d74c266ab8 lib/installer/transaction.mjs
89
93
  f0606cd2cd4871d11e544b5ad8221e4d9050761d1d80ab94c9219eb7e494b375 lib/installer/uninstall.mjs
94
+ b83205b8244edd9868c91ffbf19864f84a51556b16e87c219b39916b8c31ed51 lib/installer/upgrade-state.mjs
95
+ 6274809b326a65bfc6cb5062226b276ef95cc386a5c90c0e70537930c7fd1822 lib/installer/upgrade.mjs
90
96
  2946f055d61fbe2ffd6af1c182096e01d8c1a4bfb0aa274547ce5e147dccfd19 lib/limits.mjs
91
97
  94c3315811e9694db4423c851437975e658949edb7706cf8124d6e1a4b60d0e5 lib/models/config.mjs
92
98
  a7afd79d4620abcf85f4954aab4599870d8e47b897490d1c5c774f256c5e8800 lib/models/index.mjs
93
99
  cc205194c9aa90887bb74c11cb0f5adb63f9da8afe660755a73c62d090309385 lib/models/profiles.mjs
100
+ acf28d52dac6a097e577da79ac8b9d2b30872a8f0ea66fc855db4b3f4863be5d lib/npm/context.mjs
101
+ ee81dee01b1623d95dda9b1d195ce2008811dfb54af3da8324a9e538238ac84e lib/npm/process.mjs
102
+ 8945c12db082a4a93bc71943d698cf60326e0ba45ae2a1caf6488a1dbc9d7cc7 lib/npm/upgrade.mjs
94
103
  7c36313221f36a9d08964017c79e8c7b3c848655f6a338f71a24ce508ac6e3ed lib/policy/claude-hook.mjs
95
104
  f32fcb03201c6a73d658a6b3107376f13d03f21503c568a7b4e71ff9b71dd426 lib/policy/placement.mjs
96
105
  09b5851cdbcb88b9d4d027e2d96aadb275660354ea64eef0aaa7583ec8090c3e lib/policy/render.mjs
97
106
  5fd21f28b7983a89de8d52033ea61003462586ae679dbf87843b8291a2a29237 lib/policy/role-policy.json
107
+ 80e270d526e9a9c5cac23fe6ae293c2fd25a0176e4a8060987fd19dafe2a4594 lib/release/artifact.mjs
98
108
  30d8cdcb9d7ab6396cab09cd9f5cf6b8003f5490fb5c0ffe9f5acffbb0534978 lib/runtime/adapters/claude.mjs
99
109
  d30d118d3b42b805195ed05a3dea0ed3cf939eac811cf0228ca0b0cafeda7969 lib/runtime/adapters/codex.mjs
100
110
  c5a56ac147f13e9f946f673ac57a5dadbb4560d1f9deaa7c3b60e703f39b2d83 lib/runtime/capabilities.mjs
@@ -110,7 +120,7 @@ aa1361419c0137f74793847805a3abc076a8d782c6f590e2d28b8eee5c35065d lib/runtime/st
110
120
  4174dfcfcd4d69a5486b91108ec03279cfd50644109c7457aa87f9ac877fb1ac lib/safe-fs/native.mjs
111
121
  ff9c33c8b3c2bd466d54ffbe4c7139ccd87c79c7de34a6c4cde92e9f6e9b42d2 native/binding.c
112
122
  205bedc1dee1a9ffa58124c6e21256a1f0cbe24f06f7c8d7cb0b99524cfab9d0 native/binding.gyp
113
- cf68d4fe7de6f0f4ba0cbaae10f05063504ba624103a440c1c5a03a4ed104dd5 package.json
123
+ 837e5eb730cc792d694939fd8cd5a5db41d6308052ac3fdae32bb0a9756ab51c package.json
114
124
  208c65cfde244d39ce45c3cf1b0acb128f04d21199b6b3fb5466e62db5b64af9 prebuilds/darwin-arm64/arc_safe_fs.node
115
125
  572887ac794d10a8b921d8168ea2328e31f05b45987611ff02c83114dba901af prebuilds/darwin-x64/arc_safe_fs.node
116
126
  2bb9443021f9d873712b26321de733eddd6794c45f0bc79e2d5dc98669196635 prebuilds/index.json
@@ -118,12 +128,15 @@ b98bb4ac757ebd6e8f8fc1eb7a6a4389e3a8199984baf6bb1c327a6f952c2c0d prebuilds/linu
118
128
  9f8c2c1e328ee287355bc36afc3173c00ed062611fbd1262e4d30fca83e979dc prebuilds/linux-x64-gnu/arc_safe_fs.node
119
129
  0750a576f8042248a35b55559ccc52ef787a7706de7901169ec929622f256643 scripts/build-native.mjs
120
130
  aa394307b1bba68ea7146f76bec479a21f2cbeff9ea18d0786516c677a2d9fbb scripts/check-installer-parity.mjs
131
+ de88500b49726973d1de71c0bbdf9c993e28720a5b3f28751992c023b617e04c scripts/pack-release.mjs
132
+ 21cb8f3c35ee69ee31e9243f5b8844ca48f1351e77368071f8d4de0116dd1dd7 scripts/postinstall.mjs
121
133
  52aa4334c02e1877822304e66959b12f98a1649a547d51b9271623221ef3573a scripts/probe-runtime-hooks.mjs
122
134
  9c6bce1c1ab29ba75b70742e4d67c1eb0d0a0cab31e06b8abd28b057253f32d0 scripts/update-manifest.mjs
123
135
  e99ca8fd7dbde12840097e3d68bef06037f04284474fc5006976da40758cf6bb scripts/update-role-policy.mjs
124
136
  38163bb8828e4b4ab6bedfad719dba744ef0d99a09c9b23a85b1076d8375f181 scripts/update-runtime-assets.mjs
125
137
  f7c5d8288905ed7a6f0e99e3668a34ed43a3c1a7a3157bc883f22ec94fe22e98 scripts/update-superpowers.mjs
126
138
  40f41cc52354e02d9743c7b8d270c187856aac02cd9d7996d19b1f1089355d88 scripts/vendor-toml.mjs
139
+ a8884682a56e563b64931a2e0b025ec50a18bc758b0de7f5a92b7890ac36c4a5 scripts/verify-release.mjs
127
140
  fa5659948374d4f555594f47f6da073b40dc503e921aeeece30df4362b3051a5 vendor/toml/LICENSE
128
141
  ef924a2a42c7f16761e7098c3ed8e04195ecbcb02d5c369db0aee76f251a409c vendor/toml/dist/date.js
129
142
  76f8e47f5fc57273748242d59570656d7c921a80bceb2291ca5a4d7a723e9f29 vendor/toml/dist/error.js
package/README.md CHANGED
@@ -53,6 +53,17 @@ npx --yes @yunhozz/arc preset smart --target codex
53
53
  npx --yes @yunhozz/arc uninstall --target codex
54
54
  ```
55
55
 
56
+ ## 🧰 Optional: use the global CLI
57
+
58
+ If you run ARC management commands regularly, you can install the CLI globally and keep using the `arc` command:
59
+
60
+ ```sh
61
+ npm i -g @yunhozz/arc
62
+ arc
63
+ ```
64
+
65
+ The first command installs the CLI. Run `arc` to install the ARC harness. Afterward, use `arc preset` or `arc uninstall` to manage it. `arc uninstall` removes the harness; `npm uninstall -g @yunhozz/arc` removes the CLI and leaves the harness installed.
66
+
56
67
  ## 🎛️ Models and language
57
68
 
58
69
  The Orchestrator uses the current conversation's model. The five specialist roles use the selected preset from their platform model file: [Codex](codex/skill/models.toml) · [Claude Code](claude/skill/models.toml). The configured language applies across ARC; an explicit user language request takes precedence.
@@ -0,0 +1,3 @@
1
+ import {runChild} from '../lib/cli/upgrade.mjs';
2
+ try{let bytes=Buffer.alloc(0);for await(const chunk of process.stdin){bytes=Buffer.concat([bytes,chunk]);if(bytes.length>4096)throw Error('Invalid private upgrade request');}process.exitCode=await runChild(JSON.parse(bytes.toString('utf8')));}
3
+ catch{process.stderr.write('Error: Invalid private upgrade request\n');process.exitCode=2;}
@@ -45,7 +45,7 @@ assigned skill instructions, and explicitly cited references.
45
45
 
46
46
  Preserve unrelated staged, unstaged, and untracked changes and edit ownership. MUST NOT automatically stash, reset, clean,
47
47
  unstage, discard, amend, delete branches/worktrees, change permissions to bypass a blocker, delete locks,
48
- or bypass sandbox restrictions. On an actual conflict, missing assigned path, command failure, unexpected Git state,
48
+ or bypass sandbox restrictions. On an actual conflict, missing assigned path, tool failure, unexpected Git state,
49
49
  or partial completion, stop dependent work and report observed workspace, branch/HEAD, index, files, completed steps,
50
50
  and needed resolution to Orchestrator. Do not retry or fall back automatically. Expected TDD RED is evidence,
51
51
  not an operational failure. After Orchestrator resolves a blocker, revalidate affected gates before resuming.
@@ -17,7 +17,7 @@ hooks:
17
17
  onFailure: block
18
18
  ---
19
19
 
20
- # Qa
20
+ # QA
21
21
 
22
22
  {{ARC_OUTPUT_LANGUAGE_POLICY}}
23
23
 
@@ -46,7 +46,7 @@ assigned skill instructions, and explicitly cited references.
46
46
 
47
47
  Preserve unrelated staged, unstaged, and untracked changes and edit ownership. MUST NOT automatically stash, reset, clean,
48
48
  unstage, discard, amend, delete branches/worktrees, change permissions to bypass a blocker, delete locks,
49
- or bypass sandbox restrictions. On an actual conflict, missing assigned path, command failure, unexpected Git state,
49
+ or bypass sandbox restrictions. On an actual conflict, missing assigned path, tool failure, unexpected Git state,
50
50
  or partial completion, stop dependent work and report observed workspace, branch/HEAD, index, files, completed steps,
51
51
  and needed resolution to Orchestrator. Do not retry or fall back automatically. Expected TDD RED is evidence,
52
52
  not an operational failure. After Orchestrator resolves a blocker, revalidate affected gates before resuming.
@@ -12,7 +12,7 @@ Orchestrator MUST NEVER author them and MUST NEVER invoke `brainstorming` or `wr
12
12
  If either auto-triggers in Orchestrator context, Orchestrator stops and routes to Planner, citing that skill's SKILL.md
13
13
  path in the brief. A user request to skip questions never waives design or approval gates; Planner returns questions to
14
14
  Orchestrator. Each top-level task (a plan task, or the whole request without a plan) gets a FRESH Coder,
15
- and each task that needs QA (risk-scaled, unchanged) gets a FRESH QA, never one reused from another task;
15
+ and each task that needs QA under Risk-scaled execution gets a FRESH QA, never one reused from another task;
16
16
  same-task rechecks may reuse.
17
17
 
18
18
  Follow user instructions and project guidance. Orchestrator uses the current chat model and answers a simple,
@@ -20,8 +20,7 @@ self-contained question (answerable from context or one quick read, no edits) di
20
20
  For substantive multistep work, Orchestrator coordinates implementation, configuration, tests, and mixed work.
21
21
  Assign material research/analysis and bounded read-only exploration of static code, documents, data, and logs/reports to Scouter.
22
22
  Orchestrator handles research directly when the needed material is already in its context or the check is a quick read
23
- of a few known
24
- files; all other material research/analysis and bounded exploration goes to Scouter with its configured settings (a
23
+ of a few known files; all other material research/analysis and bounded exploration goes to Scouter with its configured settings (a
25
24
  bounded lookup gets a narrow brief: known paths, specific facts, no synthesis). Route by object and deliverable,
26
25
  not verbs alone. Standalone document writing has no specialist auto-route. Design, spec, plan, and brainstorming drafts
27
26
  are not standalone document writing (see Role gate).
@@ -30,7 +29,7 @@ Live execution-state investigation or cleanup are outside Scouter scope and this
30
29
 
31
30
  ## Shared terms
32
31
 
33
- The handoff, git-recovery, and commit references and the Coder profile use these terms; context-specific commands,
32
+ The handoff, handoff-prep, verification, and commit references use these terms; context-specific commands,
34
33
  paths, and state checks still apply.
35
34
 
36
35
  - **Preservation rule**: preserve unrelated staged, unstaged, and untracked changes and edit ownership; never
@@ -43,12 +42,13 @@ paths, and state checks still apply.
43
42
  automatically; revalidate affected gates after resolution.
44
43
  - **Evidence verdict**: each criterion is proven, unmet, or unverified; passing runs, reports, or disposition never
45
44
  turn unverified into proven; reports keep unverified scope visible.
45
+ - **Common handoff gate**: the full verification Orchestrator passes before every Coder first start/restart and
46
+ Orchestrator direct edit; see [handoff](references/handoff.md#common-handoff-gate).
46
47
 
47
48
  ## Mandatory task references
48
49
 
49
50
  Orchestrator and each assigned role must read the applicable references before dependent decisions or actions,
50
- and Orchestrator must
51
- include in the role brief the accessible path and section name of each reference section the role must read.
51
+ and Orchestrator must include in the role brief the accessible path and section name of each reference section the role must read.
52
52
  Resolve paths relative to this installed skill directory.
53
53
  These contracts are conditional on the trigger, mandatory when triggered. Missing, inaccessible, or conflicting
54
54
  references must be reported to Orchestrator; stop dependent work until resolved.
@@ -62,8 +62,8 @@ Do not load all references on every task.
62
62
  | [handoff](references/handoff.md) | Every Coder first start/restart preparation by Orchestrator, and before each Orchestrator direct edit's first edit; Coder trusts the Orchestrator-verified brief under its profile and reads only brief-cited sections |
63
63
  | [handoff-prep](references/handoff-prep.md) | Execution-target choice request, each preparation Git mutation (branch creation/switch, staging, commit) |
64
64
  | [commit](references/commit.md) | Plan-task acceptance and its focused commit, resuming a task with an unclear commit result |
65
- | [verification](references/verification.md) | Orchestrator's verification design, QA/Reviewer assignment, correction rechecks, UI acceptance checks, risk classification, acceptance and completion; QA and Reviewer use their profiles and only brief-cited sections |
66
- | [git-recovery](references/git-recovery.md) | Branch collision, Git preparation failure, partial completion, metadata write denial recovery |
65
+ | [verification](references/verification.md) | Orchestrator's verification design, QA/Reviewer assignment, correction rechecks, UI acceptance checks, risk classification, acceptance and completion; QA and Reviewer use their profiles and only brief-cited sections |
66
+ | [git-recovery](references/git-recovery.md) | Branch collision, Git preparation failure, partial completion, metadata write denial, handoff record write denial recovery |
67
67
  | [visual-companion](references/visual-companion.md) | Visual companion offer or operation |
68
68
 
69
69
  Before classifying a small-task, plan-omission, or TDD exception, read the full conditions in [handoff](references/handoff.md), including Coder TDD and constraints and Orchestrator direct path for small tasks; read [planning](references/planning.md) for design/plan-depth judgments and [verification](references/verification.md) for the full risk criteria before deciding eligibility. An exception name or this index alone never establishes eligibility.
@@ -14,7 +14,10 @@ Planning documents have their own batch docs commit before Coder handoff.
14
14
 
15
15
  After commit, verify exact SHA, subject, included paths, branch/HEAD and remaining index/worktree state.
16
16
  Preserve unrelated changes; never automatically unstage, amend, reset, clean, stash, or delete branches.
17
- On failure, stop dependent work and report actual state and completed steps. MUST NOT blindly repeat a commit or staging command. Push, publication and merge require user authorization. Coder must not commit, even when explicitly assigned.
17
+ On failure, stop dependent work and report actual state and completed steps.
18
+ MUST NOT blindly repeat a commit or staging command.
19
+ Push, merge, publish, deploy, and install still follow their separate guidance and approval rules.
20
+ Coder must not commit, even when explicitly assigned.
18
21
 
19
22
  Hold the task commit for unmet or unresolved criteria, failed or not-run required checks, undispositioned findings or
20
23
  evidence gaps, scope expansion, ownership or staged scope/content mismatch, unexpected workspace/branch/HEAD/Git state,
@@ -57,13 +60,6 @@ Approval scope and continuity are defined in [planning](planning.md#authorizatio
57
60
  limits are defined in [verification](verification.md#completion-continuity). This plan-task commit contract adds no
58
61
  commit obligation to no-plan work and does not turn a local commit into overall completion.
59
62
 
60
- ## Automatic commit after plan-task acceptance
61
-
62
- Orchestrator accepts each approved top-level task by its own judgment and immediately creates one focused local commit
63
- for that
64
- task without additional user commit approval. Read [commit](commit.md) before the acceptance and commit.
65
- Push, merge, publish, deploy, and install still follow their separate guidance and approval rules.
66
-
67
63
 
68
64
  [ARC role policy: contract begin]
69
65
  Generated from lib/policy/role-policy.json; do not edit this managed section manually.
@@ -1,4 +1,4 @@
1
- # 역할 배정과 조정
1
+ # Role assignment and coordination
2
2
 
3
3
  Orchestrator reads this before the first specialist creation or assignment and related coordination decisions. Also read [limits](limits.md) and installed `../limits.toml` before first creation. Missing, inaccessible or conflicting references stop dependent work; report the exact paths.
4
4
 
@@ -41,8 +41,7 @@ Apply platform, user, and project instructions according to their precedence, th
41
41
  permissions, models, concurrency, routing, and approvals, then the local ARC reference assigned to the role. A called skill
42
42
  adds no agents or authority. Map executor requests such as `superpowers:executing-plans` and
43
43
  `superpowers:subagent-driven-development` to Orchestrator's dependency-aware coordination and risk-scaled verification;
44
- this replaces
45
- executor mechanics and any separate execution-method choice, including prompts in an existing local reference.
44
+ this replaces executor mechanics and any separate execution-method choice, including prompts in an existing local reference.
46
45
  Preserve plan approval, workspace, design, spec, and other applicable requirements, including TDD subject to the
47
46
  explicit ARC exception in [handoff](handoff.md#coder-tdd-and-constraints). Adapt local `brainstorming` role, save, and early spec commit instructions to
48
47
  ARC Planner ownership and evidence gates in planning/handoff; preserve upstream reference content. Report conflicts or
@@ -53,10 +52,9 @@ Orchestrator. Planner preserves complete requested drafts. Orchestrator integrat
53
52
  obtain approval; never author), routes decisions and required approvals,
54
53
  and owns development acceptance and completion. Orchestrator coordinates dependent implementation tasks sequentially and
55
54
  starts a fresh Coder for each top-level task; reuse the current Coder only for corrections, rework, or rechecks of the same
56
- task while the
57
- approved scope, workspace, ownership, and relevant context remain valid, after Orchestrator rechecks workspace,
55
+ task while the approved scope, workspace, ownership, and relevant context remain valid, after Orchestrator rechecks workspace,
58
56
  branch/HEAD and change state against the brief. A fresh Coder for the next task is a restart under handoff (choice reuse
59
- and restart brief rules are there). After an approved plan or acceptance-criteria amendment, start a fresh Coder for
57
+ and restart brief rules are in handoff). After an approved plan or acceptance-criteria amendment, start a fresh Coder for
60
58
  the remaining work even within the same task. Do not add per-task QA or
61
59
  review gates solely because a task boundary exists; apply risk requirements and specific approved obligations. If the
62
60
  next task depends on a still-unverified risky contract, complete applicable QA at that dependency boundary and
@@ -136,6 +134,8 @@ changes do not automatically reparent running agents or prove runtime parent beh
136
134
  For browser visualization needs read [visual-companion](visual-companion.md). Use only capabilities
137
135
  available within each role's exact allowlist; report unavailable capabilities and preserve unverified visual scope.
138
136
 
137
+ Claude profile `model` and `effort` frontmatter values are shipped defaults; installation overwrites them with the active `models.toml` preset values.
138
+
139
139
  [ARC role policy: contract begin]
140
140
  Generated from lib/policy/role-policy.json; do not edit this managed section manually.
141
141
  - [git.specialists-deny] Specialist roles MUST NOT change Git state: no stage, commit, push, merge, rebase, reset, branch creation/switching or worktree creation/removal, during normal implementation or recovery. Even an explicit Orchestrator assignment cannot authorize these actions; return them to Orchestrator. Read-only Git inspection remains allowed within the assigned scope.
@@ -1,6 +1,6 @@
1
1
  # Preserve state after failure
2
2
 
3
- Read on branch collision, Git preparation failure, partial completion, or Git metadata write denial.
3
+ Read on branch collision, Git preparation failure, partial completion, Git metadata write denial, or handoff record write denial.
4
4
 
5
5
  On an actual failed Git/tool command, partial completion, unexpected branch/HEAD, missing assigned path,
6
6
  or conflicting edit, stop dependent work. Inspect and record the actual absolute path, branch or detached HEAD, HEAD,
@@ -43,4 +43,5 @@ report the actual state.
43
43
  ## Handoff record write denial
44
44
 
45
45
  If writing the canonical handoff record is denied or unavailable, stop that write, report the path and error to
46
- Orchestrator, and do not change permissions or bypass the sandbox. Use the inline-record fallback in handoff.
46
+ Orchestrator, and do not change permissions or bypass the sandbox. Use the inline-record fallback in
47
+ [handoff.md](handoff.md).
@@ -3,6 +3,8 @@
3
3
  Claude v1 supports the current checkout only; ARC-managed worktree execution is unsupported.
4
4
  Do not create or attach worktrees as a fallback. Report unsupported requests before dependent work.
5
5
 
6
+ ## Execution-target and Git evidence gates
7
+
6
8
  ### Execution-target request gate
7
9
 
8
10
  Before requesting the user's execution-target choice, Orchestrator verifies and records planned document scope,
@@ -65,8 +67,8 @@ the task's main purpose and a short, specific lowercase kebab-case topic without
65
67
  | chore/ | Operational policy, tools, maintenance |
66
68
  | revert/ | Revert a prior change |
67
69
 
68
- Validate the name and check collisions before creation. If the base name exists, append `-2`, `-3`, and so on to the
69
- topic, choosing the first unused name (`chore/branch-policy`, then `chore/branch-policy-2`).
70
+ Validate the name and check collisions before creation. If the base name exists, never automatically substitute a
71
+ suffix; present a new candidate for explicit approval and use it only after the user approves it.
70
72
  Never reuse, delete, or overwrite an existing branch. Distinguish a lookup error from a missing branch;
71
73
  a lookup error blocks handoff and goes to git-recovery. Recheck workspace, branch or detached HEAD, base HEAD,
72
74
  and candidate before execution. If the target changes or a new collision changes the candidate, present it and obtain
@@ -85,8 +85,8 @@ Before any exception judgment, Orchestrator reads [Risk-scaled execution](verifi
85
85
 
86
86
  ## Common handoff gate
87
87
 
88
- Before every Coder first start/restart, Orchestrator passes the full gate in
89
- [handoff](handoff.md): applicable approvals/artifacts or valid omissions, explicit execution-target choice
88
+ Before every Coder first start/restart, Orchestrator passes the full gate:
89
+ applicable approvals/artifacts or valid omissions, explicit execution-target choice
90
90
  or verified reuse, intended accessible repository/workspace, actual Git identity/state, preservation/ownership,
91
91
  verified document commits or valid absence, and no unresolved failure/partial completion.
92
92
  Missing evidence, mismatches, unclear ownership or unresolved preparation block handoff and require Orchestrator
@@ -94,7 +94,7 @@ resolution and full revalidation. Handoff owns the evidence fields, canonical ha
94
94
  and reuse. Coder trusts the Orchestrator-verified brief and reports actual conflicts under its self-contained profile;
95
95
  never replace its local guards with a requirement to load Orchestrator procedures.
96
96
  Depth-2 roles use the supplied workspace and report path/state conflicts; they cannot create/switch workspaces or
97
- branches. The same conditions apply before a Orchestrator direct edit.
97
+ branches. The same conditions apply before an Orchestrator direct edit.
98
98
  Claude v1 supports the current checkout only; obtain the explicit current-branch or task-branch choice and complete
99
99
  approved document preparation under [handoff-prep](handoff-prep.md).
100
100
  ARC-managed worktree execution is unsupported; report an isolated worktree request before dependent work.
@@ -134,8 +134,8 @@ that scope; no duplicate approval is needed. Otherwise present the scope record
134
134
  approval before editing. Silence, an ambiguous response, or approval of other work is not approval.
135
135
  Orchestrator then verifies the same handoff gate as a Coder first start: explicit execution-target choice or valid
136
136
  reuse, accessible intended workspace and repository, branch or detached HEAD, HEAD, staged/unstaged/untracked state,
137
- preservation and ownership, and no unresolved failure or partial completion. Read the [handoff](handoff.md)
138
- and [handoff preparation](handoff-prep.md) references before checking this gate.
137
+ preservation and ownership, and no unresolved failure or partial completion. Read this reference
138
+ and [handoff preparation](handoff-prep.md) before checking this gate.
139
139
 
140
140
  Orchestrator edits only the approved files, preserves others' edits, and makes surgical changes without unrelated
141
141
  refactoring or unapproved dependencies. Behavior edits follow the Coder TDD rules and applicable recorded waiver
@@ -147,8 +147,7 @@ or any criterion fails, stop editing, record completed changes, and return subse
147
147
  flow. A failed focused check or a QA finding routes the correction to Coder, and it is rechecked; Orchestrator does not
148
148
  self-correct.
149
149
 
150
- Like other plan-skip
151
- paths, there is no automatic task commit; commits follow applicable guidance and user requests.
150
+ Like other plan-skip paths, there is no automatic task commit; commits follow applicable guidance and user requests.
152
151
 
153
152
 
154
153
  [ARC role policy: contract begin]
@@ -30,7 +30,7 @@ Serialize work when a batch does not fit. There are no reserved role slots.
30
30
 
31
31
  Preserve the ledger through continuation, resume and context compaction; reconcile actual instance
32
32
  IDs before dispatch. Ledger loss must never reset counters to zero. If reconstruction is incomplete,
33
- hold creation and report the unknown budget; use a conservative bound only with sufficient evidence.
33
+ hold creation and report the unknown budget; use a conservative upper bound only when the reconstructed records support it.
34
34
  Completion frees confirmed active capacity; it does not restore the total-created budget. Exhaustion holds new
35
35
  creation and requires reporting remaining work and budgets. It does not authorize skipping required
36
36
  QA or Reviewer, role freshness, approval, ownership, dependency or same-file edit gates.
@@ -27,11 +27,12 @@ a well-supported infeasibility result can complete it. Probe-only authorization
27
27
  or subsequent implementation. Record question, method/scope, criteria, and constraints; a sufficiently specific probe
28
28
  request can supply that approval. Match checks to probe purpose/risk and do not report probe evidence as product proof.
29
29
 
30
- If the user explicitly requests both a probe and implementation and the whole scope is sufficiently specified,
31
- classify the entire scope. When the entire scope meets Bounded conditions, the probe is an internal investigation
32
- with no new approval boundary at its report. Unknown implementation is not blanket authorization: hold affected
33
- implementation if findings materially change scope, method, or risk, or leave a new material decision. Reassess depth
34
- and obtain any required design/spec/plan approvals before that implementation. A probe-only request remains separate.
30
+ If the user explicitly requests both a probe and implementation and the whole scope is sufficiently specified, classify
31
+ the entire scope. When the entire scope meets the Bounded path criteria in Design path and plan depth, the probe is an
32
+ internal investigation with no new approval boundary at its report. Unknown implementation is not blanket authorization:
33
+ hold affected implementation if findings materially change scope, method, or risk, or leave a new material decision.
34
+ Reassess depth and obtain any required design/spec/plan approvals before that implementation. A probe-only request
35
+ remains separate.
35
36
 
36
37
  ## Formal drafting boundary
37
38
 
@@ -44,11 +45,11 @@ affected drafting or save and is reported to Orchestrator. Planned scope and pat
44
45
  Initial target preparation does not authorize Coder; the complete handoff gate still applies.
45
46
 
46
47
  Orchestrator classifies scope before implementation. The Orchestrator direct path for small tasks is defined only in
47
- SKILL.md ("Orchestrator direct path for small tasks"); follow it there and stop and reclassify if scope or risk changes.
48
+ [handoff](handoff.md#orchestrator-direct-path-for-small-tasks); follow it there and stop and reclassify if scope or risk changes.
48
49
  Everything else follows this reference. Brainstorming and writing-plans are instructions for existing roles,
49
50
  not extra agents; ARC routing and approval gates apply even if a skill names another executor.
50
- Report a missing required skill before its stage. Integrate means save, route, and obtain approval; never author.
51
- Significant risk is defined in SKILL.md Risk-scaled execution.
51
+ Report a missing required skill before its stage; it blocks that stage. Integrate means save, route, and obtain approval; never author.
52
+ Significant risk is defined in [verification](verification.md#risk-scaled-execution).
52
53
 
53
54
  When the request or brief is in Korean, Planner writes spec and plan titles and prose in Korean unless the user asks
54
55
  otherwise, preserving identifiers, skill/API names, code, paths, commands, and literal values.
@@ -85,7 +86,7 @@ a bounded path or document omission does not imply low risk, and architectural d
85
86
  answers/revisions, and obtains approvals; Orchestrator never runs brainstorming or writing-plans itself (SKILL.md
86
87
  Role gate); the direct path uses only a scope record.
87
88
  2. Spike: apply Probe scope above; distinguish probe-only authorization from a sufficiently specified combined scope.
88
- Bounded: approve a short design before Coder or a Orchestrator direct edit (Planner's design before
89
+ Bounded: approve a short design before Coder or an Orchestrator direct edit (Planner's design before
89
90
  Coder; a direct edit uses only an approved scope record). Architectural: approve the design, then Planner returns a
90
91
  complete spec draft and self-review; Orchestrator integrates, saves (user's path or
91
92
  `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`), self-reviews, and obtains written-spec approval before
@@ -100,7 +101,7 @@ a bounded path or document omission does not imply low risk, and architectural d
100
101
  assumptions/open decisions, verification requirements, and self-review. Orchestrator integrates, saves to the user's
101
102
  path or `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`, self-reviews, and obtains plan approval before Coder.
102
103
  Planner cannot save, implement, or request approval.
103
- 5. Every Coder first start and restart requires all applicable approvals and the common handoff gate (SKILL.md,
104
+ 5. Every Coder first start and restart requires all applicable approvals and the Common handoff gate (SKILL.md,
104
105
  handoff). Non-behavior configuration/documentation may skip inapplicable design/planning stages but not the gate.
105
106
 
106
107
  When Orchestrator's recorded plan-depth judgment requires a Bounded written spec, record that and its scope,
@@ -124,7 +125,7 @@ Substeps and checkboxes are progress, not commit units: one approved top-level t
124
125
  Orchestrator acceptance. Never list Reviewer as a per-task check. State final plan QA/integration verification
125
126
  separately with scope and timing; for significant work it lists the single independent Reviewer of the final full change
126
127
  after all tasks are accepted. Task boundaries add no QA gates; keep risk requirements, risky-dependency QA,
127
- and approved obligations. No-change, hold, and resume follow commit.
128
+ and approved obligations. No-change, hold, and resume follow [commit](commit.md).
128
129
 
129
130
  ## Dependency and readiness record
130
131
 
@@ -140,13 +141,16 @@ A task is ready only when all applicable approvals and execution preparation are
140
141
  are available and settled, predecessors have required evidence and Orchestrator acceptance plus verified focused
141
142
  commits (or accepted no-change records), ownership/resources do not conflict, its required check/QA path is available,
142
143
  and a subagent slot exists under both the configured ARC full-tree cap shared by all roles and any lower actual runtime
143
- limit. Report runtime limits. Start all ready independent tasks with fresh Coders concurrently within capacity;
144
- record each hold or serialization reason instead of silently following list order. Preserve existing risk gates.
144
+ limit (see [limits](limits.md)). Report runtime limits; ARC's cap is not a claim of runtime capability. Start all ready
145
+ independent tasks with fresh Coders concurrently within capacity; record each hold or serialization reason instead of
146
+ silently following list order. Preserve existing risk gates, risk-scaled QA/Reviewer timing and execution-target
147
+ restrictions.
145
148
 
146
149
  Update the map on completion, check evidence, acceptance, commit, slot return and new conflicts. Completion reports
147
150
  alone do not release dependents. Reevaluate newly ready tasks immediately without waiting for unrelated batch members;
148
151
  failed or ambiguous predecessors hold their dependent chain, while unaffected ready tasks may proceed. Dispatch still
149
- passes handoff.md for each task; commits and shared Git mutations follow commit.md. This record does not authorize
152
+ passes [handoff](handoff.md) for each task, refreshing assignment evidence there; commits, shared-checkout Git
153
+ coordination and shared Git mutations follow [commit](commit.md). This record does not authorize
150
154
  Orchestrator to rewrite Planner's approved task boundaries or waive approvals.
151
155
 
152
156
  For example, with A → B → C and independent D and two slots, start A and D. After A's required checks,
@@ -202,7 +206,7 @@ Do not modify external skills.
202
206
 
203
207
  | Path | Approvals and preparation |
204
208
  |---|---|
205
- | Spike probe | Approve question, method/scope, criteria, constraints; no spec/plan forced. If Coder runs the probe, pass the common gate after approval. Read-only investigation needs no gate. |
209
+ | Spike probe | Approve question, method/scope, criteria, constraints; no spec/plan forced. If Coder runs the probe, pass the Common handoff gate after approval. Read-only investigation needs no gate. |
206
210
  | Bounded, plan skipped | Approve the short design and record plan-skip criteria; select target, prepare any documents or record absence, pass the gate. |
207
211
  | Bounded, plan required | Approve short design and every required plan; a spec only when the depth judgment requires it, approved before dependent plans. One preparation batch, then the gate. |
208
212
  | Architectural | Approve design, then spec, then every plan; select and prepare the target before formal drafting; complete the set before batch commit, final verification, and the gate. |
@@ -231,31 +235,6 @@ Orchestrator briefs absolute ARC paths `references/superpowers/brainstorming/SKI
231
235
  `references/superpowers/writing-plans/SKILL.md`. Planner reads them directly; resolve relative references within each
232
236
  skill. Missing files stop the stage; report paths without global fallback. Keep ARC approval and ownership gates.
233
237
 
234
- ## Dependency analysis and parallel dispatch
235
-
236
- Before the first Coder assignment for an approved plan, Orchestrator records its dependency/readiness map and
237
- initial ready batch under [planning](planning.md), which owns record fields and readiness conditions.
238
- File separation alone never proves independence. Pass the full approval/preparation and handoff gates for every
239
- assignment; unresolved dependencies, shared contracts, or ownership conflicts hold affected work.
240
- Start all ready independent tasks concurrently with fresh Coders within capacity under [limits](limits.md)
241
- and any lower actual runtime limit; record capacity and serialization reasons. Same-file concurrent Coder edits are
242
- prohibited, even on different lines. ARC's cap is not a claim of runtime capability.
243
-
244
- Reassess readiness after completion reports, new check evidence, acceptance, commit, slot return, or a new conflict.
245
- Coder completion alone does not release dependents: require predecessor checks, Orchestrator acceptance and verified
246
- focused commit, or accepted no-change evidence under [commit](commit.md). Start newly ready tasks without
247
- waiting for unrelated batch members; failures hold affected dependents while unaffected ready work may continue.
248
- Preserve risk-scaled QA/Reviewer timing and execution-target restrictions. Shared-checkout Git coordination belongs to
249
- commit.md; refresh assignment evidence under [handoff](handoff.md).
250
-
251
-
252
- Design and plan depth are independent of verification risk. Planner alone uses local brainstorming/writing-plans
253
- (Role gate);
254
- Orchestrator integrates complete drafts and obtains applicable approvals. Architectural specs and Bounded written specs
255
- required by Orchestrator's recorded plan-depth judgment use planning save gates; a required plan alone does not require
256
- a spec. Obtain explicit execution-target choice and verify actual target preparation before formal drafting
257
- and saving. Complete all current-scope individual document approvals before the batch docs commit. A missing required skill blocks its stage.
258
-
259
238
 
260
239
  [ARC role policy: contract begin]
261
240
  Generated from lib/policy/role-policy.json; do not edit this managed section manually.
@@ -111,8 +111,7 @@ For Orchestrator, **Evidence verdict**: each criterion is proven, unmet, or unve
111
111
  ## Risk-scaled execution
112
112
 
113
113
  Orchestrator assigns edits exclusively to Coder except under the Orchestrator direct path in [handoff](handoff.md#orchestrator-direct-path-for-small-tasks), and determines affected
114
- behavior, risk,
115
- and smallest meaningful verification.
114
+ behavior, risk, and smallest meaningful verification.
116
115
 
117
116
  | Risk | Minimum flow |
118
117
  |---|---|
@@ -122,19 +121,15 @@ and smallest meaningful verification.
122
121
 
123
122
  Ordinary and significant plan tasks need a FRESH QA before acceptance; only small, low-risk tasks may be accepted on
124
123
  Orchestrator focused checks. Small, low risk means narrow, understood, readily reversible, and verifiable by focused
125
- checks. Ordinary behavior
126
- fails those conditions without a significant-risk trigger. Significant risk includes shared role/behavior contracts,
127
- shared state, lifecycle/integration order, security/permissions, data loss/migration, public interfaces, or costly
124
+ checks. Ordinary behavior fails those conditions without a significant-risk trigger. Significant risk includes shared
125
+ role/behavior contracts, shared state, lifecycle/integration order, security/permissions, data loss/migration, public interfaces, or costly
128
126
  installation/deployment/rollback. Substantial behavior or contract changes are significant regardless of file count.
129
- Unclear risk requires
130
- investigation or the higher flow. Environment failure does not waive checks or determine design depth.
127
+ Unclear risk requires investigation or the higher flow. Environment failure does not waive checks or determine design depth.
131
128
 
132
129
  Do not add per-task gates automatically. Reviewer is never a plan-task acceptance prerequisite; for significant work
133
- with a
134
- plan, it reviews the final full change once after all plan tasks are accepted with their risk-scaled checks,
130
+ with a plan, it reviews the final full change once after all plan tasks are accepted with their risk-scaled checks,
135
131
  following the last plan task's required checks and any QA recheck at the final relevant state; significant work without
136
- a plan
137
- keeps Reviewer after QA before acceptance. Preserve specific approved obligations and complete risky dependency checks
132
+ a plan keeps Reviewer after QA before acceptance. Preserve specific approved obligations and complete risky dependency checks
138
133
  before dependent implementation. Reuse evidence only when scope, relevant state, independence, freshness, and flow
139
134
  position satisfy each covered requirement; changes, failures, or missing/conflicting evidence invalidate affected reuse.
140
135
  QA checks independently without edits; Reviewer independently reads the final full change after QA for significant
@@ -144,25 +139,10 @@ explicitly dispositioned.
144
139
 
145
140
  Criterion verdicts follow the Evidence verdict.
146
141
 
147
- ### Final plan Reviewer correction loop
148
-
149
- For a plan's final overall Reviewer findings, including behavior findings, Orchestrator assigns
150
- Coder → Reviewer recheck with no QA reassignment. Repeat corrections and Reviewer rechecks until findings are resolved;
151
- the initial single full review does not prohibit necessary rechecks. Before the initial final overall Reviewer,
152
- risk-required checks and QA execution failures or unmet criteria still require Coder correction → QA recheck.
153
- This exception applies only to findings from the final overall Reviewer of work with a plan.
154
- Work without a plan retains its existing verification flow. Scope expansion, separate mandatory obligations,
155
- or unresolved evidence gaps hold affected work for Orchestrator to resolve and obtain required approvals.
156
- Orchestrator assigns corrections/rechecks and decides acceptance. Reviewer remains read-only, must not run QA
157
- checks or decide acceptance. Previous QA evidence must not be presented as post-fix execution evidence;
158
- report only checks actually performed, their actor, target state, results and remaining limits.
159
-
160
- Read verification for evidence fields, failure/finding flow, UI permissions, cleanup and acceptance reporting.
161
-
162
142
  Authorization evidence and probe/combined scope are owned by [planning](planning.md#authorization-and-scope);
163
143
  valid reuse and actual-state refresh by [handoff](handoff.md#authorization-continuity).
164
- After gates hold, continue approved no-doc scope through required checks and Orchestrator acceptance under
165
- [verification](verification.md#completion-continuity); a role report alone does not complete the work.
144
+ After gates hold, continue approved scope without saved documents through required checks and Orchestrator acceptance under
145
+ Completion continuity above; a role report alone does not complete the work.
166
146
 
167
147
 
168
148
  [ARC role policy: contract begin]