@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.
- package/MANIFEST.sha256 +48 -35
- package/README.md +11 -0
- package/bin/arc-upgrade.mjs +3 -0
- package/claude/agents/arc-coder.md +1 -1
- package/claude/agents/arc-qa.md +2 -2
- package/claude/skill/SKILL.md +8 -8
- package/claude/skill/references/commit.md +4 -8
- package/claude/skill/references/coordination.md +6 -6
- package/claude/skill/references/git-recovery.md +3 -2
- package/claude/skill/references/handoff-prep.md +4 -2
- package/claude/skill/references/handoff.md +6 -7
- package/claude/skill/references/limits.md +1 -1
- package/claude/skill/references/planning.md +19 -40
- package/claude/skill/references/verification.md +8 -28
- package/claude/skill/references/visual-companion.md +1 -1
- package/codex/agents/arc-coder.toml +1 -0
- package/codex/agents/arc-planner.toml +2 -0
- package/codex/agents/arc-qa.toml +2 -0
- package/codex/agents/arc-reviewer.toml +2 -0
- package/codex/agents/arc-scouter.toml +2 -0
- package/codex/skill/SKILL.md +10 -11
- package/codex/skill/references/commit.md +9 -21
- package/codex/skill/references/coordination.md +5 -7
- package/codex/skill/references/git-recovery.md +21 -18
- package/codex/skill/references/handoff-prep.md +14 -16
- package/codex/skill/references/handoff-worktree.md +10 -12
- package/codex/skill/references/handoff.md +27 -44
- package/codex/skill/references/limits.md +1 -1
- package/codex/skill/references/planning.md +34 -61
- package/codex/skill/references/verification.md +22 -50
- package/codex/skill/references/visual-companion.md +6 -8
- package/lib/cli/choices.mjs +4 -4
- package/lib/cli/completion.mjs +10 -8
- package/lib/cli/index.mjs +5 -5
- package/lib/cli/postinstall.mjs +17 -0
- package/lib/cli/root.mjs +2 -1
- package/lib/cli/terminal.mjs +19 -0
- package/lib/cli/upgrade.mjs +57 -0
- package/lib/installer/plan.mjs +3 -2
- package/lib/installer/upgrade-state.mjs +29 -0
- package/lib/installer/upgrade.mjs +34 -0
- package/lib/npm/context.mjs +36 -0
- package/lib/npm/process.mjs +17 -0
- package/lib/npm/upgrade.mjs +29 -0
- package/lib/release/artifact.mjs +163 -0
- package/package.json +3 -2
- package/scripts/pack-release.mjs +9 -0
- package/scripts/postinstall.mjs +4 -0
- package/scripts/verify-release.mjs +6 -0
package/MANIFEST.sha256
CHANGED
|
@@ -1,23 +1,24 @@
|
|
|
1
|
-
|
|
1
|
+
85cea3cfddbf92091b1eec35feaea339e70fc2a1faa65099c99cc6318aec1cc2 README.md
|
|
2
|
+
d41edeb8c6631dee30c67c705d4edad977aa1631627ec9de59c013f8990f4018 bin/arc-upgrade.mjs
|
|
2
3
|
484d9b2002ce542c87589bb719d644d3762706aad28a6ee010024875f8cc00e2 bin/arc.mjs
|
|
3
|
-
|
|
4
|
+
d853d31ba0d1a04661adf8cae1df11058455cb5d366c52312888c9dd2e9a1fb8 claude/agents/arc-coder.md
|
|
4
5
|
91a2c62f4ea3ff00145407411fbbe62aa02fb7608af8f33bbd3d1719fc9d2f13 claude/agents/arc-planner.md
|
|
5
|
-
|
|
6
|
+
d864e57a1b2b6d69435a17a5c56a0e2c68d26592dd5e510be8d0fa341762cad1 claude/agents/arc-qa.md
|
|
6
7
|
bd51442a5e76d4b61cbeb7f42d43cbcc7bab890db0d39ef16002ae13f5317c34 claude/agents/arc-reviewer.md
|
|
7
8
|
c20162438bb8ac6905164268f867a8f1cfdbbfd51ddfd7e795cc211cc7f8c858 claude/agents/arc-scouter.md
|
|
8
|
-
|
|
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
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
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
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
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
|
-
|
|
68
|
-
|
|
69
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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,
|
|
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.
|
package/claude/agents/arc-qa.md
CHANGED
|
@@ -17,7 +17,7 @@ hooks:
|
|
|
17
17
|
onFailure: block
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
#
|
|
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,
|
|
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.
|
package/claude/skill/SKILL.md
CHANGED
|
@@ -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
|
|
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,
|
|
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;
|
|
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.
|
|
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
|
|
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,
|
|
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
|
|
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,
|
|
69
|
-
|
|
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
|
|
89
|
-
|
|
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
|
|
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
|
|
138
|
-
and [handoff preparation](handoff-prep.md)
|
|
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
|
|
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
|
-
|
|
32
|
-
with no new approval boundary at its report. Unknown implementation is not blanket authorization:
|
|
33
|
-
implementation if findings materially change scope, method, or risk, or leave a new material decision.
|
|
34
|
-
and obtain any required design/spec/plan approvals before that implementation. A probe-only request
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
144
|
-
record each hold or serialization reason instead of
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
165
|
-
|
|
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]
|