@rayburst/cc 1.0.23 → 1.0.25
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/commands/rb/implement.md +2 -136
- package/package.json +1 -1
package/commands/rb/implement.md
CHANGED
|
@@ -48,18 +48,6 @@ Examples:
|
|
|
48
48
|
|
|
49
49
|
## Workflow
|
|
50
50
|
|
|
51
|
-
### Step 0: Check for Resume State
|
|
52
|
-
|
|
53
|
-
Before anything else, check if a previous `rb:implement` session was interrupted:
|
|
54
|
-
|
|
55
|
-
1. Run `cat .claude/rb-session.md 2>/dev/null` (via Bash).
|
|
56
|
-
2. If the file exists and is non-empty:
|
|
57
|
-
- If a `cardId` was passed as input, check if it matches the `cardId` in the file. If it matches (or no input was given), follow the `## Resume Instructions` section in the file exactly.
|
|
58
|
-
- If a different `cardId` was passed, ask the user: "A previous session for `<title from file>` is still in progress. Resume it, or start fresh with `<input cardId>`?"
|
|
59
|
-
3. If the file does not exist, proceed normally from Step 1.
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
51
|
### Step 0b: Resolve MCP Prefix
|
|
64
52
|
|
|
65
53
|
Read `.claude/rb-config.md` and parse the `## MCP Role Assignments` table. Find the row where `Role` is `engineer` and read its `MCP Server Name`.
|
|
@@ -172,7 +160,7 @@ Then in Step 6 (Enter Plan Mode), prepend a **"Fixing QA Failures"** section to
|
|
|
172
160
|
|
|
173
161
|
If no prior failure comment or validation report is found, proceed normally.
|
|
174
162
|
|
|
175
|
-
### Step 4: Move Card to `in-progress`
|
|
163
|
+
### Step 4: Move Card to `in-progress`
|
|
176
164
|
|
|
177
165
|
Before entering plan mode, move the card so the board reflects active work:
|
|
178
166
|
|
|
@@ -180,44 +168,6 @@ Before entering plan mode, move the card so the board reflects active work:
|
|
|
180
168
|
<MCP_PREFIX>move_card({ cardId: "<cardId>", status: "in-progress" })
|
|
181
169
|
```
|
|
182
170
|
|
|
183
|
-
Then **immediately** write an early session file so the card ID and intent survive a `/clear` or context compaction that might happen during plan approval:
|
|
184
|
-
|
|
185
|
-
```bash
|
|
186
|
-
cat > .claude/rb-session.md << 'RBEOF'
|
|
187
|
-
# rb:implement Session
|
|
188
|
-
|
|
189
|
-
## Session Info
|
|
190
|
-
- **sessionTitle:** rb:implement — <card title>
|
|
191
|
-
- **cardId:** <cardId>
|
|
192
|
-
- **cardTitle:** <card title>
|
|
193
|
-
- **startedAt:** <ISO timestamp>
|
|
194
|
-
- **currentPhase:** Plan mode — plan not yet approved; re-enter plan mode and present it to the user
|
|
195
|
-
|
|
196
|
-
## MCP Prefix
|
|
197
|
-
`<MCP_PREFIX>`
|
|
198
|
-
|
|
199
|
-
## Acceptance Criteria
|
|
200
|
-
<list each criterion: - [criterionId] title — description>
|
|
201
|
-
|
|
202
|
-
## Implementation Todos (in order)
|
|
203
|
-
<list each todo item from the card's todo list, with checkbox: - [ ] todo text>
|
|
204
|
-
|
|
205
|
-
## Resume Instructions
|
|
206
|
-
|
|
207
|
-
IMPORTANT: You are resuming an interrupted `rb:implement` session. Context was cleared or compacted during plan approval. The card is already `in-progress`. Do NOT start over from Step 0. Execute the following immediately:
|
|
208
|
-
|
|
209
|
-
1. Re-read the acceptance criteria and todos listed above.
|
|
210
|
-
2. Enter plan mode (`EnterPlanMode`) and present the implementation plan to the user for approval.
|
|
211
|
-
3. After user approves, post the plan as a card comment, then implement all todos in order.
|
|
212
|
-
4. After ALL todos are complete and code is written, run:
|
|
213
|
-
`<MCP_PREFIX>move_card({ cardId: "<cardId>", status: "validation" })`
|
|
214
|
-
5. Post an implementation summary comment:
|
|
215
|
-
`<MCP_PREFIX>add_comment({ cardId: "<cardId>", content: "## Implementation Complete\n\nReady for QA validation.\n\n### What was built\n<brief summary>\n\n### Files changed\n- <file>\n\n### Criteria coverage\n- <criterion>: satisfied via <explanation>" })`
|
|
216
|
-
6. Delete this session file: `rm .claude/rb-session.md`
|
|
217
|
-
7. Print: "## Implementation Complete: <card title>\n\nCard ID: <cardId>\nStatus: → validation\n\nRun /rb:validate-card <cardId> to run QA validation."
|
|
218
|
-
RBEOF
|
|
219
|
-
```
|
|
220
|
-
|
|
221
171
|
### Step 5: Conflict Detection
|
|
222
172
|
|
|
223
173
|
Before planning, detect criteria in *other* active features that this implementation might break.
|
|
@@ -291,46 +241,6 @@ After the user approves the plan (via `ExitPlanMode`), post a concise summary to
|
|
|
291
241
|
|
|
292
242
|
Keep the comment under 5000 characters. Use plain markdown prose — no raw code snippets or code fences with actual code (describe the approach, don't paste it).
|
|
293
243
|
|
|
294
|
-
**Immediately after posting the plan comment**, update the session file — BEFORE writing any code. The early session file from Step 4 already exists; overwrite it now with the post-approval state so the resume instructions reflect that the plan is approved:
|
|
295
|
-
|
|
296
|
-
Overwrite `.claude/rb-session.md` with the execution context:
|
|
297
|
-
|
|
298
|
-
```bash
|
|
299
|
-
cat > .claude/rb-session.md << 'RBEOF'
|
|
300
|
-
# rb:implement Session
|
|
301
|
-
|
|
302
|
-
## Session Info
|
|
303
|
-
- **sessionTitle:** rb:implement — <card title>
|
|
304
|
-
- **cardId:** <cardId>
|
|
305
|
-
- **cardTitle:** <card title>
|
|
306
|
-
- **startedAt:** <ISO timestamp>
|
|
307
|
-
- **currentPhase:** Execute Implementation — plan approved, starting first todo item
|
|
308
|
-
|
|
309
|
-
## MCP Prefix
|
|
310
|
-
`<MCP_PREFIX>` (e.g. `mcp__rayburst-rb-engineer-780086__`)
|
|
311
|
-
|
|
312
|
-
## Acceptance Criteria
|
|
313
|
-
<list each criterion: - [criterionId] title — description>
|
|
314
|
-
|
|
315
|
-
## Implementation Todos (in order)
|
|
316
|
-
<list each todo item from the card's todo list, with checkbox: - [ ] todo text>
|
|
317
|
-
|
|
318
|
-
## Resume Instructions
|
|
319
|
-
|
|
320
|
-
IMPORTANT: You are resuming an interrupted `rb:implement` session. The plan was already approved and posted as a card comment. Do NOT re-enter plan mode. Do NOT ask the user what to do. Execute the following steps immediately:
|
|
321
|
-
|
|
322
|
-
1. Run `<MCP_PREFIX>get_card({ cardId: "<cardId>" })` to get current card state.
|
|
323
|
-
2. Check which todos are still incomplete. Continue from the first incomplete todo.
|
|
324
|
-
3. Implement each remaining todo item in order — write the actual code changes.
|
|
325
|
-
4. After ALL todos are complete and code is written, run:
|
|
326
|
-
`<MCP_PREFIX>move_card({ cardId: "<cardId>", status: "validation" })`
|
|
327
|
-
5. Post an implementation summary comment:
|
|
328
|
-
`<MCP_PREFIX>add_comment({ cardId: "<cardId>", content: "## Implementation Complete\n\nReady for QA validation.\n\n### What was built\n<brief summary>\n\n### Files changed\n- <file>\n\n### Criteria coverage\n- <criterion>: satisfied via <explanation>" })`
|
|
329
|
-
6. Delete this session file: `rm .claude/rb-session.md`
|
|
330
|
-
7. Print: "## Implementation Complete: <card title>\n\nCard ID: <cardId>\nStatus: → validation\n\nRun /rb:validate-card <cardId> to run QA validation."
|
|
331
|
-
RBEOF
|
|
332
|
-
```
|
|
333
|
-
|
|
334
244
|
### Step 8: Execute Implementation
|
|
335
245
|
|
|
336
246
|
Switch to execute mode. Work through the implementation:
|
|
@@ -348,45 +258,6 @@ Switch to execute mode. Work through the implementation:
|
|
|
348
258
|
cd rayburst-api && npm run check
|
|
349
259
|
```
|
|
350
260
|
|
|
351
|
-
**At each major phase boundary** (e.g., after backend is complete, before starting frontend), rewrite `.claude/rb-session.md` with an updated `currentPhase` that contains the exact next action. Do NOT just sed one line — rewrite the whole file so the Resume Instructions stay complete. The `currentPhase` value should be precise enough that after compaction you know exactly what code to write next. Examples:
|
|
352
|
-
- `Frontend phase — implement /legacy route in src/routes/legacy/index.tsx`
|
|
353
|
-
- `Wrap-up — all todos done, next: move card to validation and post summary comment`
|
|
354
|
-
|
|
355
|
-
```bash
|
|
356
|
-
cat > .claude/rb-session.md << 'RBEOF'
|
|
357
|
-
# rb:implement Session
|
|
358
|
-
|
|
359
|
-
## Session Info
|
|
360
|
-
- **sessionTitle:** rb:implement — <card title>
|
|
361
|
-
- **cardId:** <cardId>
|
|
362
|
-
- **cardTitle:** <card title>
|
|
363
|
-
- **startedAt:** <ISO timestamp>
|
|
364
|
-
- **currentPhase:** <precise description of exact next action>
|
|
365
|
-
|
|
366
|
-
## MCP Prefix
|
|
367
|
-
`<MCP_PREFIX>`
|
|
368
|
-
|
|
369
|
-
## Acceptance Criteria
|
|
370
|
-
<list each criterion: - [criterionId] title — description>
|
|
371
|
-
|
|
372
|
-
## Remaining Todos
|
|
373
|
-
<list only the NOT YET COMPLETE todos: - [ ] todo text>
|
|
374
|
-
|
|
375
|
-
## Resume Instructions
|
|
376
|
-
|
|
377
|
-
IMPORTANT: You are resuming an interrupted `rb:implement` session. Context was compacted and you lost track of the workflow. The plan was already approved. Do NOT re-enter plan mode. Do NOT ask the user what to do. Execute the following steps immediately:
|
|
378
|
-
|
|
379
|
-
1. Your exact next action is: **<currentPhase>**
|
|
380
|
-
2. Complete that action, then work through any remaining todos above in order.
|
|
381
|
-
3. After ALL todos are done and code is written, run:
|
|
382
|
-
`<MCP_PREFIX>move_card({ cardId: "<cardId>", status: "validation" })`
|
|
383
|
-
4. Post an implementation summary comment:
|
|
384
|
-
`<MCP_PREFIX>add_comment({ cardId: "<cardId>", content: "## Implementation Complete\n\nReady for QA validation.\n\n### What was built\n<brief summary>\n\n### Files changed\n- <file>\n\n### Criteria coverage\n- <criterion>: satisfied via <explanation>" })`
|
|
385
|
-
5. Delete this session file: `rm .claude/rb-session.md`
|
|
386
|
-
6. Print: "## Implementation Complete: <card title>\n\nCard ID: <cardId>\nStatus: → validation\n\nRun /rb:validate-card <cardId> to run QA validation."
|
|
387
|
-
RBEOF
|
|
388
|
-
```
|
|
389
|
-
|
|
390
261
|
**At-risk criteria preservation**: If Step 5 flagged criteria from other features, verify after each relevant change that the behavior described in those criteria is still correct.
|
|
391
262
|
|
|
392
263
|
### Step 9: Verify Criteria
|
|
@@ -402,16 +273,12 @@ If any criterion is clearly not satisfied, loop back to Step 8 and fix it before
|
|
|
402
273
|
|
|
403
274
|
### Step 10: Move Card to `validation` and Print Summary
|
|
404
275
|
|
|
405
|
-
Move the card to `validation` status
|
|
276
|
+
Move the card to `validation` status:
|
|
406
277
|
|
|
407
278
|
```
|
|
408
279
|
<MCP_PREFIX>move_card({ cardId: "<cardId>", status: "validation" })
|
|
409
280
|
```
|
|
410
281
|
|
|
411
|
-
```bash
|
|
412
|
-
rm -f .claude/rb-session.md
|
|
413
|
-
```
|
|
414
|
-
|
|
415
282
|
Post a brief implementation summary comment:
|
|
416
283
|
|
|
417
284
|
```
|
|
@@ -511,7 +378,6 @@ Parse the `data:` line from the SSE response to extract the JSON result.
|
|
|
511
378
|
- **Do NOT fix failing criteria during QA** — report them, return the card, and stop
|
|
512
379
|
- **If conflict detection finds at-risk criteria, STOP and prompt** — do not silently proceed
|
|
513
380
|
- **If user cancels after conflict detection, move card back to `ready`** before stopping
|
|
514
|
-
- **Context auto-clean** — compact or delegate to subagent after each major implementation phase
|
|
515
381
|
- **Implementation comments under 5000 characters** — no raw code in comment content
|
|
516
382
|
- **Validation criterion comments under 500 characters** — plain prose only, no backticks
|
|
517
383
|
- **Run `/rb:init` first** if `.claude/rb-config.md` is missing
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rayburst/cc",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.25",
|
|
4
4
|
"description": "Rayburst slash commands for Claude Code — /rb:init, /rb:plan, /rb:sync, /rb:status, /rb:validate-feature, /rb:validate-card, /rb:implement, /rb:discover",
|
|
5
5
|
"bin": {
|
|
6
6
|
"rayburst-cc": "bin/install.js"
|