@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
@@ -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.