@lvlup-sw/exarchos 2.7.1 → 2.8.0

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 (176) hide show
  1. package/.claude-plugin/plugin.json +3 -2
  2. package/agents/fixer.md +2 -1
  3. package/agents/implementer.md +2 -1
  4. package/agents/reviewer.md +2 -1
  5. package/agents/scaffolder.md +55 -0
  6. package/commands/discover.md +6 -0
  7. package/dist/exarchos.js +314 -335
  8. package/package.json +1 -1
  9. package/skills/claude/cleanup/SKILL.md +10 -4
  10. package/skills/claude/cleanup/references/merge-verification.md +8 -9
  11. package/skills/claude/debug/references/thorough-track.md +5 -2
  12. package/skills/claude/debug/references/troubleshooting.md +1 -1
  13. package/skills/claude/delegation/SKILL.md +4 -3
  14. package/skills/claude/delegation/references/agent-teams-saga.md +1 -3
  15. package/skills/claude/delegation/references/fixer-prompt.md +0 -1
  16. package/skills/claude/delegation/references/implementer-prompt.md +0 -1
  17. package/skills/claude/delegation/references/parallel-strategy.md +6 -11
  18. package/skills/claude/delegation/references/worked-example.md +3 -3
  19. package/skills/claude/delegation/references/workflow-steps.md +0 -2
  20. package/skills/claude/delegation/references/worktree-enforcement.md +1 -1
  21. package/skills/claude/discovery/SKILL.md +95 -0
  22. package/skills/claude/dogfood/SKILL.md +8 -2
  23. package/skills/claude/dogfood/references/report-template.md +4 -4
  24. package/skills/claude/oneshot-workflow/SKILL.md +9 -3
  25. package/skills/claude/prune-workflows/SKILL.md +6 -0
  26. package/skills/claude/quality-review/references/auto-transition.md +1 -1
  27. package/skills/claude/refactor/references/overhaul-track.md +1 -1
  28. package/skills/claude/shepherd/SKILL.md +14 -5
  29. package/skills/claude/shepherd/references/assess-checklist.md +7 -7
  30. package/skills/claude/shepherd/references/fix-strategies.md +4 -4
  31. package/skills/claude/synthesis/SKILL.md +27 -8
  32. package/skills/claude/synthesis/references/github-native-stacking.md +26 -30
  33. package/skills/claude/synthesis/references/merge-ordering.md +1 -1
  34. package/skills/claude/synthesis/references/synthesis-steps.md +6 -6
  35. package/skills/claude/synthesis/references/troubleshooting.md +11 -18
  36. package/skills/codex/cleanup/SKILL.md +10 -4
  37. package/skills/codex/cleanup/references/merge-verification.md +8 -9
  38. package/skills/codex/debug/references/thorough-track.md +5 -2
  39. package/skills/codex/debug/references/troubleshooting.md +1 -1
  40. package/skills/codex/delegation/SKILL.md +4 -3
  41. package/skills/codex/delegation/references/agent-teams-saga.md +1 -3
  42. package/skills/codex/delegation/references/fixer-prompt.md +0 -1
  43. package/skills/codex/delegation/references/implementer-prompt.md +0 -1
  44. package/skills/codex/delegation/references/parallel-strategy.md +6 -11
  45. package/skills/codex/delegation/references/worked-example.md +3 -3
  46. package/skills/codex/delegation/references/workflow-steps.md +0 -2
  47. package/skills/codex/delegation/references/worktree-enforcement.md +1 -1
  48. package/skills/codex/discovery/SKILL.md +95 -0
  49. package/skills/codex/dogfood/SKILL.md +8 -2
  50. package/skills/codex/dogfood/references/report-template.md +4 -4
  51. package/skills/codex/oneshot-workflow/SKILL.md +9 -3
  52. package/skills/codex/prune-workflows/SKILL.md +6 -0
  53. package/skills/codex/quality-review/references/auto-transition.md +1 -1
  54. package/skills/codex/refactor/references/overhaul-track.md +1 -1
  55. package/skills/codex/shepherd/SKILL.md +14 -5
  56. package/skills/codex/shepherd/references/assess-checklist.md +7 -7
  57. package/skills/codex/shepherd/references/fix-strategies.md +4 -4
  58. package/skills/codex/synthesis/SKILL.md +27 -8
  59. package/skills/codex/synthesis/references/github-native-stacking.md +26 -30
  60. package/skills/codex/synthesis/references/merge-ordering.md +1 -1
  61. package/skills/codex/synthesis/references/synthesis-steps.md +6 -6
  62. package/skills/codex/synthesis/references/troubleshooting.md +11 -18
  63. package/skills/copilot/cleanup/SKILL.md +10 -4
  64. package/skills/copilot/cleanup/references/merge-verification.md +8 -9
  65. package/skills/copilot/debug/references/thorough-track.md +5 -2
  66. package/skills/copilot/debug/references/troubleshooting.md +1 -1
  67. package/skills/copilot/delegation/SKILL.md +4 -3
  68. package/skills/copilot/delegation/references/agent-teams-saga.md +1 -3
  69. package/skills/copilot/delegation/references/fixer-prompt.md +0 -1
  70. package/skills/copilot/delegation/references/implementer-prompt.md +0 -1
  71. package/skills/copilot/delegation/references/parallel-strategy.md +6 -11
  72. package/skills/copilot/delegation/references/worked-example.md +3 -3
  73. package/skills/copilot/delegation/references/workflow-steps.md +0 -2
  74. package/skills/copilot/delegation/references/worktree-enforcement.md +1 -1
  75. package/skills/copilot/discovery/SKILL.md +95 -0
  76. package/skills/copilot/dogfood/SKILL.md +8 -2
  77. package/skills/copilot/dogfood/references/report-template.md +4 -4
  78. package/skills/copilot/oneshot-workflow/SKILL.md +9 -3
  79. package/skills/copilot/prune-workflows/SKILL.md +6 -0
  80. package/skills/copilot/quality-review/references/auto-transition.md +1 -1
  81. package/skills/copilot/refactor/references/overhaul-track.md +1 -1
  82. package/skills/copilot/shepherd/SKILL.md +14 -5
  83. package/skills/copilot/shepherd/references/assess-checklist.md +7 -7
  84. package/skills/copilot/shepherd/references/fix-strategies.md +4 -4
  85. package/skills/copilot/synthesis/SKILL.md +27 -8
  86. package/skills/copilot/synthesis/references/github-native-stacking.md +26 -30
  87. package/skills/copilot/synthesis/references/merge-ordering.md +1 -1
  88. package/skills/copilot/synthesis/references/synthesis-steps.md +6 -6
  89. package/skills/copilot/synthesis/references/troubleshooting.md +11 -18
  90. package/skills/cursor/cleanup/SKILL.md +10 -4
  91. package/skills/cursor/cleanup/references/merge-verification.md +8 -9
  92. package/skills/cursor/debug/references/thorough-track.md +5 -2
  93. package/skills/cursor/debug/references/troubleshooting.md +1 -1
  94. package/skills/cursor/delegation/SKILL.md +4 -3
  95. package/skills/cursor/delegation/references/agent-teams-saga.md +1 -3
  96. package/skills/cursor/delegation/references/fixer-prompt.md +0 -1
  97. package/skills/cursor/delegation/references/implementer-prompt.md +0 -1
  98. package/skills/cursor/delegation/references/parallel-strategy.md +6 -11
  99. package/skills/cursor/delegation/references/worked-example.md +3 -3
  100. package/skills/cursor/delegation/references/workflow-steps.md +0 -2
  101. package/skills/cursor/delegation/references/worktree-enforcement.md +1 -1
  102. package/skills/cursor/discovery/SKILL.md +95 -0
  103. package/skills/cursor/dogfood/SKILL.md +8 -2
  104. package/skills/cursor/dogfood/references/report-template.md +4 -4
  105. package/skills/cursor/oneshot-workflow/SKILL.md +9 -3
  106. package/skills/cursor/prune-workflows/SKILL.md +6 -0
  107. package/skills/cursor/quality-review/references/auto-transition.md +1 -1
  108. package/skills/cursor/refactor/references/overhaul-track.md +1 -1
  109. package/skills/cursor/shepherd/SKILL.md +14 -5
  110. package/skills/cursor/shepherd/references/assess-checklist.md +7 -7
  111. package/skills/cursor/shepherd/references/fix-strategies.md +4 -4
  112. package/skills/cursor/synthesis/SKILL.md +27 -8
  113. package/skills/cursor/synthesis/references/github-native-stacking.md +26 -30
  114. package/skills/cursor/synthesis/references/merge-ordering.md +1 -1
  115. package/skills/cursor/synthesis/references/synthesis-steps.md +6 -6
  116. package/skills/cursor/synthesis/references/troubleshooting.md +11 -18
  117. package/skills/generic/cleanup/SKILL.md +10 -4
  118. package/skills/generic/cleanup/references/merge-verification.md +8 -9
  119. package/skills/generic/debug/references/thorough-track.md +5 -2
  120. package/skills/generic/debug/references/troubleshooting.md +1 -1
  121. package/skills/generic/delegation/SKILL.md +4 -3
  122. package/skills/generic/delegation/references/agent-teams-saga.md +1 -3
  123. package/skills/generic/delegation/references/fixer-prompt.md +0 -1
  124. package/skills/generic/delegation/references/implementer-prompt.md +0 -1
  125. package/skills/generic/delegation/references/parallel-strategy.md +6 -11
  126. package/skills/generic/delegation/references/worked-example.md +3 -3
  127. package/skills/generic/delegation/references/workflow-steps.md +0 -2
  128. package/skills/generic/delegation/references/worktree-enforcement.md +1 -1
  129. package/skills/generic/discovery/SKILL.md +95 -0
  130. package/skills/generic/dogfood/SKILL.md +8 -2
  131. package/skills/generic/dogfood/references/report-template.md +4 -4
  132. package/skills/generic/oneshot-workflow/SKILL.md +9 -3
  133. package/skills/generic/prune-workflows/SKILL.md +6 -0
  134. package/skills/generic/quality-review/references/auto-transition.md +1 -1
  135. package/skills/generic/refactor/references/overhaul-track.md +1 -1
  136. package/skills/generic/shepherd/SKILL.md +14 -5
  137. package/skills/generic/shepherd/references/assess-checklist.md +7 -7
  138. package/skills/generic/shepherd/references/fix-strategies.md +4 -4
  139. package/skills/generic/synthesis/SKILL.md +27 -8
  140. package/skills/generic/synthesis/references/github-native-stacking.md +26 -30
  141. package/skills/generic/synthesis/references/merge-ordering.md +1 -1
  142. package/skills/generic/synthesis/references/synthesis-steps.md +6 -6
  143. package/skills/generic/synthesis/references/troubleshooting.md +11 -18
  144. package/skills/opencode/cleanup/SKILL.md +10 -4
  145. package/skills/opencode/cleanup/references/merge-verification.md +8 -9
  146. package/skills/opencode/debug/references/thorough-track.md +5 -2
  147. package/skills/opencode/debug/references/troubleshooting.md +1 -1
  148. package/skills/opencode/delegation/SKILL.md +4 -3
  149. package/skills/opencode/delegation/references/agent-teams-saga.md +1 -3
  150. package/skills/opencode/delegation/references/fixer-prompt.md +0 -1
  151. package/skills/opencode/delegation/references/implementer-prompt.md +0 -1
  152. package/skills/opencode/delegation/references/parallel-strategy.md +6 -11
  153. package/skills/opencode/delegation/references/worked-example.md +3 -3
  154. package/skills/opencode/delegation/references/workflow-steps.md +0 -2
  155. package/skills/opencode/delegation/references/worktree-enforcement.md +1 -1
  156. package/skills/opencode/discovery/SKILL.md +95 -0
  157. package/skills/opencode/dogfood/SKILL.md +8 -2
  158. package/skills/opencode/dogfood/references/report-template.md +4 -4
  159. package/skills/opencode/oneshot-workflow/SKILL.md +9 -3
  160. package/skills/opencode/prune-workflows/SKILL.md +6 -0
  161. package/skills/opencode/quality-review/references/auto-transition.md +1 -1
  162. package/skills/opencode/refactor/references/overhaul-track.md +1 -1
  163. package/skills/opencode/shepherd/SKILL.md +14 -5
  164. package/skills/opencode/shepherd/references/assess-checklist.md +7 -7
  165. package/skills/opencode/shepherd/references/fix-strategies.md +4 -4
  166. package/skills/opencode/synthesis/SKILL.md +27 -8
  167. package/skills/opencode/synthesis/references/github-native-stacking.md +26 -30
  168. package/skills/opencode/synthesis/references/merge-ordering.md +1 -1
  169. package/skills/opencode/synthesis/references/synthesis-steps.md +6 -6
  170. package/skills/opencode/synthesis/references/troubleshooting.md +11 -18
  171. package/skills/claude/delegation/references/pr-fixes-mode.md +0 -155
  172. package/skills/codex/delegation/references/pr-fixes-mode.md +0 -155
  173. package/skills/copilot/delegation/references/pr-fixes-mode.md +0 -155
  174. package/skills/cursor/delegation/references/pr-fixes-mode.md +0 -155
  175. package/skills/generic/delegation/references/pr-fixes-mode.md +0 -155
  176. package/skills/opencode/delegation/references/pr-fixes-mode.md +0 -155
@@ -8,15 +8,15 @@ PR stacking creates a chain of dependent pull requests that merge bottom-up into
8
8
 
9
9
  ## 1. PR Chain Creation
10
10
 
11
- Create PRs that chain together by setting each PR's `--base` to the previous branch:
11
+ Create PRs that chain together by setting each PR's base to the previous branch:
12
12
 
13
- ```bash
14
- # First PR in chain targets main
15
- gh pr create --base main --head feat/step-1 --title "feat: step 1" --body "..."
13
+ ```typescript
14
+ // First PR in chain targets main
15
+ exarchos_orchestrate({ action: "create_pr", base: "main", head: "feat/step-1", title: "feat: step 1", body: "..." })
16
16
 
17
- # Subsequent PRs target the previous PR's branch
18
- gh pr create --base feat/step-1 --head feat/step-2 --title "feat: step 2" --body "..."
19
- gh pr create --base feat/step-2 --head feat/step-3 --title "feat: step 3" --body "..."
17
+ // Subsequent PRs target the previous PR's branch
18
+ exarchos_orchestrate({ action: "create_pr", base: "feat/step-1", head: "feat/step-2", title: "feat: step 2", body: "..." })
19
+ exarchos_orchestrate({ action: "create_pr", base: "feat/step-2", head: "feat/step-3", title: "feat: step 3", body: "..." })
20
20
  ```
21
21
 
22
22
  The resulting chain looks like:
@@ -72,15 +72,14 @@ After rebasing a mid-stack branch, all downstream branches in the stack must als
72
72
 
73
73
  View the current PR chain and its state:
74
74
 
75
- ```bash
76
- # List all open PRs with base/head branch relationships
77
- gh pr list --json number,baseRefName,headRefName,title,state \
78
- --jq '.[] | "\(.number): \(.baseRefName) <- \(.headRefName) [\(.state)]"'
79
-
80
- # Example output:
81
- # 101: main <- feat/step-1 [OPEN]
82
- # 102: feat/step-1 <- feat/step-2 [OPEN]
83
- # 103: feat/step-2 <- feat/step-3 [OPEN]
75
+ ```typescript
76
+ // List all open PRs with base/head branch relationships
77
+ exarchos_orchestrate({ action: "list_prs", state: "open" })
78
+
79
+ // Example output shows PR numbers, base/head branches, titles, and state:
80
+ // 101: main <- feat/step-1 [OPEN]
81
+ // 102: feat/step-1 <- feat/step-2 [OPEN]
82
+ // 103: feat/step-2 <- feat/step-3 [OPEN]
84
83
  ```
85
84
 
86
85
  To validate stack integrity, use the `validate_pr_stack` action via orchestrate:
@@ -97,32 +96,29 @@ exarchos_orchestrate({
97
96
  GitHub's native merge queue ensures PRs pass CI before merging:
98
97
 
99
98
  - **Enable:** Repository Settings > Rules > Branch protection > Require merge queue
100
- - **Auto-merge:** `gh pr merge --auto --squash` enables auto-merge once checks pass
99
+ - **Auto-merge:** `exarchos_orchestrate({ action: "merge_pr", prId: "<number>", strategy: "squash" })` enables auto-merge once checks pass
101
100
  - **For stacks:** Enable auto-merge on each PR, then merge bottom-up
102
101
 
103
- ```bash
104
- # Enable auto-merge on all PRs in the stack
105
- gh pr merge 101 --auto --squash
106
- gh pr merge 102 --auto --squash
107
- gh pr merge 103 --auto --squash
108
-
109
- # Merge the first PR to start the cascade
110
- gh pr merge 101 --squash
102
+ ```typescript
103
+ // Enable auto-merge on all PRs in the stack
104
+ exarchos_orchestrate({ action: "merge_pr", prId: "101", strategy: "squash" })
105
+ exarchos_orchestrate({ action: "merge_pr", prId: "102", strategy: "squash" })
106
+ exarchos_orchestrate({ action: "merge_pr", prId: "103", strategy: "squash" })
111
107
  ```
112
108
 
113
109
  After PR 101 merges and its branch is deleted, GitHub retargets PR 102 to `main`. If auto-merge is enabled on PR 102, it merges automatically once CI passes.
114
110
 
115
- ## 7. Graphite to GitHub-Native Equivalents
111
+ ## 7. Graphite to Exarchos MCP Equivalents
116
112
 
117
- | Graphite Command | GitHub-Native Equivalent |
113
+ | Graphite Command | Exarchos MCP Equivalent |
118
114
  |---|---|
119
115
  | `gt create <branch> -m "feat: ..."` | `git checkout -b <branch> && git commit -m "feat: ..." && git push -u origin <branch>` |
120
- | `gt submit --no-interactive --publish --stack` | `gh pr create --base <base> --title "..." --body "..."` (per PR) |
121
- | `gt log` | `gh pr list --json number,baseRefName,headRefName` |
116
+ | `gt submit --no-interactive --publish --stack` | `exarchos_orchestrate({ action: "create_pr", base: "<base>", title: "...", body: "..." })` (per PR) |
117
+ | `gt log` | `exarchos_orchestrate({ action: "list_prs", state: "open" })` |
122
118
  | `gt modify -m "..."` | `git commit --amend -m "..." && git push --force-with-lease` |
123
119
  | `gt sync` | `git fetch --prune && git rebase origin/main` |
124
120
  | `gt restack` | `git rebase origin/<base-branch>` per branch in stack |
125
- | `mcp__graphite__run_gt_cmd` | `gh` CLI directly via Bash tool |
121
+ | `mcp__graphite__run_gt_cmd` | `exarchos_orchestrate` VCS actions |
126
122
 
127
123
  ## 8. Error Handling
128
124
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## Overview
4
4
 
5
- GitHub-native stacked PRs merge bottom-up: the base branch merges first, then each dependent branch in sequence. This ordering is enforced by creating PRs with correct base branches and enabling auto-merge (`gh pr merge --auto --squash`).
5
+ GitHub-native stacked PRs merge bottom-up: the base branch merges first, then each dependent branch in sequence. This ordering is enforced by creating PRs with correct base branches and enabling auto-merge via `exarchos_orchestrate({ action: "merge_pr", prId: "<number>", strategy: "squash" })`.
6
6
 
7
7
  ## Stack Ordering Rules
8
8
 
@@ -74,7 +74,7 @@ The script queries GitHub's PR reviews API for each PR, filters for CodeRabbit r
74
74
  **On `passed: true`:** All PRs are APPROVED or have no CodeRabbit review -- proceed to Step 5.
75
75
  **On `passed: false`:** At least one PR has CHANGES_REQUESTED or PENDING. The output identifies which PRs need attention. Route to fix cycle:
76
76
  ```typescript
77
- Skill({ skill: "exarchos:delegate", args: "--pr-fixes [PR_URL]" })
77
+ Skill({ skill: "exarchos:shepherd", args: "[PR_URL]" })
78
78
  ```
79
79
  After fixes are applied, return to Step 4 to re-check.
80
80
 
@@ -121,13 +121,13 @@ mcp__plugin_exarchos_exarchos__exarchos_orchestrate({
121
121
 
122
122
  Create PRs for each branch in the stack (bottom-up) and enable auto-merge:
123
123
 
124
- ```bash
125
- # For each branch in the stack (bottom-up):
126
- gh pr create --base <parent-branch> --head <branch> --title "<type>: <what>" --body "<pr-body>"
127
- gh pr merge <number> --auto --squash
124
+ ```typescript
125
+ // For each branch in the stack (bottom-up):
126
+ exarchos_orchestrate({ action: "create_pr", base: "<parent-branch>", head: "<branch>", title: "<type>: <what>", body: "<pr-body>" })
127
+ exarchos_orchestrate({ action: "merge_pr", prId: "<number>", strategy: "squash" })
128
128
  ```
129
129
 
130
- After creation, use `gh pr list --json number,url,headRefName` to get the PR URLs for each stack entry.
130
+ After creation, use `exarchos_orchestrate({ action: "list_prs", state: "open" })` to get the PR URLs for each stack entry.
131
131
 
132
132
  ## Step 7: Cleanup After Merge
133
133
 
@@ -21,7 +21,7 @@ If tests fail during synthesis (they passed in review):
21
21
  ### Merge Queue Rejection
22
22
 
23
23
  If the merge queue rejects a PR:
24
- 1. Check CI status via `gh pr checks <number>` (or GitHub MCP `pull_request_read` with method `get_status` if available)
24
+ 1. Check CI status via `exarchos_orchestrate({ action: "check_ci", prId: "<number>" })`
25
25
  2. Fix failing checks
26
26
  3. Push fixes and re-enqueue
27
27
 
@@ -29,20 +29,13 @@ If the merge queue rejects a PR:
29
29
 
30
30
  If the user receives PR review comments:
31
31
 
32
- 1. Offer to address feedback:
32
+ 1. Route to the shepherd skill:
33
33
  ```typescript
34
- Skill({ skill: "exarchos:delegate", args: "--pr-fixes [PR_URL]" })
34
+ Skill({ skill: "exarchos:shepherd", args: "[PR_URL]" })
35
35
  ```
36
36
 
37
- 2. Delegate reads PR comments via gh CLI:
38
- ```bash
39
- gh pr view <number> --json reviews,comments
40
- ```
41
- > Or use GitHub MCP `pull_request_read` if available.
42
-
43
- 3. Creates fix tasks from review comments
44
- 4. After fixes, amend the commit with `git commit --amend -m "fix: <description>"` and push with `git push --force-with-lease`
45
- 5. Return to merge confirmation
37
+ 2. Shepherd reads PR comments, assesses CI, and applies fixes directly
38
+ 3. After fixes, return to merge confirmation
46
39
 
47
40
  ## Final Report Template
48
41
 
@@ -50,7 +43,7 @@ If the user receives PR review comments:
50
43
  ## Synthesis Complete
51
44
 
52
45
  ### Pull Requests
53
- [PR URLs from gh pr list]
46
+ [PR URLs from list_prs action]
54
47
 
55
48
  ### Stack Branches
56
49
  - task/001-types
@@ -88,11 +81,11 @@ If workflow state doesn't match git reality:
88
81
  3. Update state via `mcp__plugin_exarchos_exarchos__exarchos_workflow` with `action: "set"` to match git truth
89
82
 
90
83
  ## PR Creation Failed
91
- If `gh pr create` fails:
84
+ If `create_pr` fails:
92
85
  1. Check the error output for specific guidance
93
- 2. Run `gh pr list --json number,baseRefName,headRefName` to verify the branch state
86
+ 2. Run `exarchos_orchestrate({ action: "list_prs", state: "open" })` to verify the branch state
94
87
  3. If rebase conflict: run `git rebase origin/<base>` to resolve
95
- 4. If authentication issue: check GitHub token permissions
88
+ 4. If authentication issue: check VCS provider token permissions
96
89
 
97
90
  ## Stack Rebase Conflict
98
91
  If `git rebase` encounters conflicts:
@@ -104,8 +97,8 @@ If `git rebase` encounters conflicts:
104
97
 
105
98
  When Exarchos MCP tools are available:
106
99
 
107
- 1. **After stack submission:** Call `mcp__plugin_exarchos_exarchos__exarchos_event` with `action: "append"` with event type `stack.enqueued` including PR numbers from `gh pr list --json number`
108
- 2. **Monitor merge status:** Use `gh pr list --json number,state,mergedAt` to check stack/PR status
100
+ 1. **After stack submission:** Call `mcp__plugin_exarchos_exarchos__exarchos_event` with `action: "append"` with event type `stack.enqueued` including PR numbers from `exarchos_orchestrate({ action: "list_prs", state: "open" })`
101
+ 2. **Monitor merge status:** Use `exarchos_orchestrate({ action: "list_prs", state: "all" })` to check stack/PR status
109
102
  3. **On successful merge:** Call `mcp__plugin_exarchos_exarchos__exarchos_event` with `action: "append"` with event type `phase.transitioned` to mark workflow complete
110
103
 
111
104
  ## Performance Notes
@@ -1,155 +0,0 @@
1
- # PR Feedback Mode (--pr-fixes)
2
-
3
- When invoked with `--pr-fixes [PR_URL]`, delegation addresses human review feedback from a pull request instead of implementing from a plan.
4
-
5
- ## Priority Levels
6
-
7
- | Priority | Source | Description |
8
- |----------|--------|-------------|
9
- | 1 | `coderabbit:critical` | Critical issues + SPEC COMPLIANCE failures |
10
- | 2 | `human` | Human reviewer comments (authority over automation) |
11
- | 3 | `coderabbit:major` | Major issues + CODE QUALITY HIGH items |
12
- | 4 | `coderabbit:minor` | Minor issues |
13
-
14
- ## Process
15
-
16
- ### Step 1: Fetch All PR Feedback
17
-
18
- ```bash
19
- # Get full PR details including reviews and comments
20
- gh pr view <number> --json title,body,state,files,reviewDecision,reviews,comments
21
-
22
- # Get issue-level comments (pre-merge check summaries)
23
- gh issue view <number> --json comments
24
- ```
25
-
26
- > Or use GitHub MCP `pull_request_read` and `issue_read` if available.
27
-
28
- ### Step 2: Parse CodeRabbit Feedback
29
-
30
- **2a: Identify CodeRabbit comments** by author = `coderabbitai[bot]`
31
-
32
- **2b: Parse line comments by severity label:**
33
-
34
- | Label | Priority |
35
- |-------|----------|
36
- | `Critical` | 1 |
37
- | `Major` | 2 |
38
- | `Minor` | 3 |
39
-
40
- Extract from each comment:
41
- - Severity label (emoji + text)
42
- - File path and line number
43
- - Issue description
44
- - Suggested fix (from Proposed fix section if present)
45
-
46
- **2c: Parse pre-merge check summaries:**
47
- - `Status: FAIL` in Spec Review -> Priority 1
48
- - `Status: NEEDS_FIXES | BLOCKED` in Quality Review -> Priority 2
49
- - Extract items from `Missing:`, `Untested:`, `Scope Creep:` lists
50
-
51
- **2d: Parse reviews with `CHANGES_REQUESTED`:**
52
- - Note "Actionable comments posted: N" count
53
- - Cross-reference with line comments already parsed
54
-
55
- ### Step 3: Parse Human Comments (Priority 2)
56
-
57
- For non-CodeRabbit comments, assign `priority: 2` (human authority over automation).
58
-
59
- Skip comments that are:
60
- - Purely praise/acknowledgment ("LGTM", "Nice work")
61
- - Questions without action items
62
- - Already marked resolved
63
- - From other bots (CI notifications, etc.)
64
-
65
- ### Step 4: Create Fix Tasks
66
-
67
- For each actionable item, create a structured fix task:
68
-
69
- | Field | Description |
70
- |-------|-------------|
71
- | `id` | `fix-001`, `fix-002`, etc. |
72
- | `priority` | `1` (critical), `2` (human), `3` (major), `4` (minor) |
73
- | `source` | `"coderabbit:critical"`, `"human"`, `"coderabbit:major"`, `"coderabbit:minor"` |
74
- | `severity` | `"Critical"`, `"Major"`, `"Minor"`, or null |
75
- | `file` | File path |
76
- | `line` | Line number (if line comment) |
77
- | `issue` | Problem description |
78
- | `action` | Required change / suggested fix |
79
-
80
- ### Step 5: Sort and Display Fix Tasks
81
-
82
- Sort by priority (1->4), then by file path for grouping.
83
-
84
- ### Step 6: Track Fix Tasks
85
-
86
- Use TodoWrite to track all fix tasks with priority labels.
87
-
88
- ### Step 7: Dispatch Fixes (MANDATORY - Priority Order)
89
-
90
- **Dispatch sequence:**
91
- 1. Dispatch all P1 (critical) fixes in parallel
92
- 2. Wait for completion
93
- 3. Dispatch all P2 (human) fixes in parallel
94
- 4. Wait for completion
95
- 5. Dispatch all P3 (major) fixes in parallel
96
- 6. Wait for completion
97
- 7. Dispatch all P4 (minor) fixes in parallel
98
- 8. Wait for completion
99
-
100
- **Task prompt template:**
101
- ```typescript
102
- Task({
103
- subagent_type: "general-purpose",
104
- model: "opus",
105
- description: "Fix [P{priority} {severity}]: {issue summary}",
106
- prompt: `
107
- # Task: Fix PR Feedback - {issue summary}
108
-
109
- ## Priority
110
- {priority} - {source}
111
-
112
- ## Context
113
- PR: {PR_URL}
114
- Source: {source}
115
- Original feedback: "{original comment text}"
116
-
117
- ## Working Directory
118
- {absolute path to repo}
119
-
120
- ## Fix Required
121
- File: {file path}
122
- Line: {line number if applicable}
123
- Issue: {issue description}
124
- Action: {required change}
125
-
126
- ## TDD Requirements
127
- 1. Write a test that would catch this issue (if applicable)
128
- 2. Verify test fails
129
- 3. Implement the fix
130
- 4. Verify test passes
131
-
132
- ## Success Criteria
133
- - [ ] Issue addressed per feedback
134
- - [ ] Tests pass
135
- - [ ] No regressions introduced
136
- `
137
- })
138
- ```
139
-
140
- **CHECKPOINT:** Do NOT proceed to next priority level until all fixes in the current level have completed.
141
-
142
- ### Step 8: Push and Report
143
-
144
- After all fixes complete, commit and push:
145
- ```bash
146
- git add <fixed-files>
147
- git commit -m "fix: address PR review feedback"
148
- git push
149
- ```
150
-
151
- Report to user: total fixes by priority, files modified. Then auto-chain to `/exarchos:synthesize` for merge confirmation.
152
-
153
- ### Handling Missing CodeRabbit Comments
154
-
155
- If no CodeRabbit comments found, proceed with human comments only.
@@ -1,155 +0,0 @@
1
- # PR Feedback Mode (--pr-fixes)
2
-
3
- When invoked with `--pr-fixes [PR_URL]`, delegation addresses human review feedback from a pull request instead of implementing from a plan.
4
-
5
- ## Priority Levels
6
-
7
- | Priority | Source | Description |
8
- |----------|--------|-------------|
9
- | 1 | `coderabbit:critical` | Critical issues + SPEC COMPLIANCE failures |
10
- | 2 | `human` | Human reviewer comments (authority over automation) |
11
- | 3 | `coderabbit:major` | Major issues + CODE QUALITY HIGH items |
12
- | 4 | `coderabbit:minor` | Minor issues |
13
-
14
- ## Process
15
-
16
- ### Step 1: Fetch All PR Feedback
17
-
18
- ```bash
19
- # Get full PR details including reviews and comments
20
- gh pr view <number> --json title,body,state,files,reviewDecision,reviews,comments
21
-
22
- # Get issue-level comments (pre-merge check summaries)
23
- gh issue view <number> --json comments
24
- ```
25
-
26
- > Or use GitHub MCP `pull_request_read` and `issue_read` if available.
27
-
28
- ### Step 2: Parse CodeRabbit Feedback
29
-
30
- **2a: Identify CodeRabbit comments** by author = `coderabbitai[bot]`
31
-
32
- **2b: Parse line comments by severity label:**
33
-
34
- | Label | Priority |
35
- |-------|----------|
36
- | `Critical` | 1 |
37
- | `Major` | 2 |
38
- | `Minor` | 3 |
39
-
40
- Extract from each comment:
41
- - Severity label (emoji + text)
42
- - File path and line number
43
- - Issue description
44
- - Suggested fix (from Proposed fix section if present)
45
-
46
- **2c: Parse pre-merge check summaries:**
47
- - `Status: FAIL` in Spec Review -> Priority 1
48
- - `Status: NEEDS_FIXES | BLOCKED` in Quality Review -> Priority 2
49
- - Extract items from `Missing:`, `Untested:`, `Scope Creep:` lists
50
-
51
- **2d: Parse reviews with `CHANGES_REQUESTED`:**
52
- - Note "Actionable comments posted: N" count
53
- - Cross-reference with line comments already parsed
54
-
55
- ### Step 3: Parse Human Comments (Priority 2)
56
-
57
- For non-CodeRabbit comments, assign `priority: 2` (human authority over automation).
58
-
59
- Skip comments that are:
60
- - Purely praise/acknowledgment ("LGTM", "Nice work")
61
- - Questions without action items
62
- - Already marked resolved
63
- - From other bots (CI notifications, etc.)
64
-
65
- ### Step 4: Create Fix Tasks
66
-
67
- For each actionable item, create a structured fix task:
68
-
69
- | Field | Description |
70
- |-------|-------------|
71
- | `id` | `fix-001`, `fix-002`, etc. |
72
- | `priority` | `1` (critical), `2` (human), `3` (major), `4` (minor) |
73
- | `source` | `"coderabbit:critical"`, `"human"`, `"coderabbit:major"`, `"coderabbit:minor"` |
74
- | `severity` | `"Critical"`, `"Major"`, `"Minor"`, or null |
75
- | `file` | File path |
76
- | `line` | Line number (if line comment) |
77
- | `issue` | Problem description |
78
- | `action` | Required change / suggested fix |
79
-
80
- ### Step 5: Sort and Display Fix Tasks
81
-
82
- Sort by priority (1->4), then by file path for grouping.
83
-
84
- ### Step 6: Track Fix Tasks
85
-
86
- Use TodoWrite to track all fix tasks with priority labels.
87
-
88
- ### Step 7: Dispatch Fixes (MANDATORY - Priority Order)
89
-
90
- **Dispatch sequence:**
91
- 1. Dispatch all P1 (critical) fixes in parallel
92
- 2. Wait for completion
93
- 3. Dispatch all P2 (human) fixes in parallel
94
- 4. Wait for completion
95
- 5. Dispatch all P3 (major) fixes in parallel
96
- 6. Wait for completion
97
- 7. Dispatch all P4 (minor) fixes in parallel
98
- 8. Wait for completion
99
-
100
- **Task prompt template:**
101
- ```typescript
102
- Task({
103
- subagent_type: "general-purpose",
104
- model: "opus",
105
- description: "Fix [P{priority} {severity}]: {issue summary}",
106
- prompt: `
107
- # Task: Fix PR Feedback - {issue summary}
108
-
109
- ## Priority
110
- {priority} - {source}
111
-
112
- ## Context
113
- PR: {PR_URL}
114
- Source: {source}
115
- Original feedback: "{original comment text}"
116
-
117
- ## Working Directory
118
- {absolute path to repo}
119
-
120
- ## Fix Required
121
- File: {file path}
122
- Line: {line number if applicable}
123
- Issue: {issue description}
124
- Action: {required change}
125
-
126
- ## TDD Requirements
127
- 1. Write a test that would catch this issue (if applicable)
128
- 2. Verify test fails
129
- 3. Implement the fix
130
- 4. Verify test passes
131
-
132
- ## Success Criteria
133
- - [ ] Issue addressed per feedback
134
- - [ ] Tests pass
135
- - [ ] No regressions introduced
136
- `
137
- })
138
- ```
139
-
140
- **CHECKPOINT:** Do NOT proceed to next priority level until all fixes in the current level have completed.
141
-
142
- ### Step 8: Push and Report
143
-
144
- After all fixes complete, commit and push:
145
- ```bash
146
- git add <fixed-files>
147
- git commit -m "fix: address PR review feedback"
148
- git push
149
- ```
150
-
151
- Report to user: total fixes by priority, files modified. Then auto-chain to `/exarchos:synthesize` for merge confirmation.
152
-
153
- ### Handling Missing CodeRabbit Comments
154
-
155
- If no CodeRabbit comments found, proceed with human comments only.
@@ -1,155 +0,0 @@
1
- # PR Feedback Mode (--pr-fixes)
2
-
3
- When invoked with `--pr-fixes [PR_URL]`, delegation addresses human review feedback from a pull request instead of implementing from a plan.
4
-
5
- ## Priority Levels
6
-
7
- | Priority | Source | Description |
8
- |----------|--------|-------------|
9
- | 1 | `coderabbit:critical` | Critical issues + SPEC COMPLIANCE failures |
10
- | 2 | `human` | Human reviewer comments (authority over automation) |
11
- | 3 | `coderabbit:major` | Major issues + CODE QUALITY HIGH items |
12
- | 4 | `coderabbit:minor` | Minor issues |
13
-
14
- ## Process
15
-
16
- ### Step 1: Fetch All PR Feedback
17
-
18
- ```bash
19
- # Get full PR details including reviews and comments
20
- gh pr view <number> --json title,body,state,files,reviewDecision,reviews,comments
21
-
22
- # Get issue-level comments (pre-merge check summaries)
23
- gh issue view <number> --json comments
24
- ```
25
-
26
- > Or use GitHub MCP `pull_request_read` and `issue_read` if available.
27
-
28
- ### Step 2: Parse CodeRabbit Feedback
29
-
30
- **2a: Identify CodeRabbit comments** by author = `coderabbitai[bot]`
31
-
32
- **2b: Parse line comments by severity label:**
33
-
34
- | Label | Priority |
35
- |-------|----------|
36
- | `Critical` | 1 |
37
- | `Major` | 2 |
38
- | `Minor` | 3 |
39
-
40
- Extract from each comment:
41
- - Severity label (emoji + text)
42
- - File path and line number
43
- - Issue description
44
- - Suggested fix (from Proposed fix section if present)
45
-
46
- **2c: Parse pre-merge check summaries:**
47
- - `Status: FAIL` in Spec Review -> Priority 1
48
- - `Status: NEEDS_FIXES | BLOCKED` in Quality Review -> Priority 2
49
- - Extract items from `Missing:`, `Untested:`, `Scope Creep:` lists
50
-
51
- **2d: Parse reviews with `CHANGES_REQUESTED`:**
52
- - Note "Actionable comments posted: N" count
53
- - Cross-reference with line comments already parsed
54
-
55
- ### Step 3: Parse Human Comments (Priority 2)
56
-
57
- For non-CodeRabbit comments, assign `priority: 2` (human authority over automation).
58
-
59
- Skip comments that are:
60
- - Purely praise/acknowledgment ("LGTM", "Nice work")
61
- - Questions without action items
62
- - Already marked resolved
63
- - From other bots (CI notifications, etc.)
64
-
65
- ### Step 4: Create Fix Tasks
66
-
67
- For each actionable item, create a structured fix task:
68
-
69
- | Field | Description |
70
- |-------|-------------|
71
- | `id` | `fix-001`, `fix-002`, etc. |
72
- | `priority` | `1` (critical), `2` (human), `3` (major), `4` (minor) |
73
- | `source` | `"coderabbit:critical"`, `"human"`, `"coderabbit:major"`, `"coderabbit:minor"` |
74
- | `severity` | `"Critical"`, `"Major"`, `"Minor"`, or null |
75
- | `file` | File path |
76
- | `line` | Line number (if line comment) |
77
- | `issue` | Problem description |
78
- | `action` | Required change / suggested fix |
79
-
80
- ### Step 5: Sort and Display Fix Tasks
81
-
82
- Sort by priority (1->4), then by file path for grouping.
83
-
84
- ### Step 6: Track Fix Tasks
85
-
86
- Use TodoWrite to track all fix tasks with priority labels.
87
-
88
- ### Step 7: Dispatch Fixes (MANDATORY - Priority Order)
89
-
90
- **Dispatch sequence:**
91
- 1. Dispatch all P1 (critical) fixes in parallel
92
- 2. Wait for completion
93
- 3. Dispatch all P2 (human) fixes in parallel
94
- 4. Wait for completion
95
- 5. Dispatch all P3 (major) fixes in parallel
96
- 6. Wait for completion
97
- 7. Dispatch all P4 (minor) fixes in parallel
98
- 8. Wait for completion
99
-
100
- **Task prompt template:**
101
- ```typescript
102
- Task({
103
- subagent_type: "general-purpose",
104
- model: "opus",
105
- description: "Fix [P{priority} {severity}]: {issue summary}",
106
- prompt: `
107
- # Task: Fix PR Feedback - {issue summary}
108
-
109
- ## Priority
110
- {priority} - {source}
111
-
112
- ## Context
113
- PR: {PR_URL}
114
- Source: {source}
115
- Original feedback: "{original comment text}"
116
-
117
- ## Working Directory
118
- {absolute path to repo}
119
-
120
- ## Fix Required
121
- File: {file path}
122
- Line: {line number if applicable}
123
- Issue: {issue description}
124
- Action: {required change}
125
-
126
- ## TDD Requirements
127
- 1. Write a test that would catch this issue (if applicable)
128
- 2. Verify test fails
129
- 3. Implement the fix
130
- 4. Verify test passes
131
-
132
- ## Success Criteria
133
- - [ ] Issue addressed per feedback
134
- - [ ] Tests pass
135
- - [ ] No regressions introduced
136
- `
137
- })
138
- ```
139
-
140
- **CHECKPOINT:** Do NOT proceed to next priority level until all fixes in the current level have completed.
141
-
142
- ### Step 8: Push and Report
143
-
144
- After all fixes complete, commit and push:
145
- ```bash
146
- git add <fixed-files>
147
- git commit -m "fix: address PR review feedback"
148
- git push
149
- ```
150
-
151
- Report to user: total fixes by priority, files modified. Then auto-chain to `/exarchos:synthesize` for merge confirmation.
152
-
153
- ### Handling Missing CodeRabbit Comments
154
-
155
- If no CodeRabbit comments found, proceed with human comments only.