You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- If **Status** is "blocked", resolve the blocker (ask human if needed).
315
296
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and then recall the spec-author.
316
-
- If **Status** is "completed", proceed to spec-critic.
297
+
- If **Status** is "completed", proceed to human spec validation.
317
298
- Update `## Orchestrator` → **Current step** to "spec-author-complete".
318
299
319
-
### 3. Spec critic
300
+
### 3. Human spec validation
320
301
321
-
Ask `spec-critic` to review and create/update the spec-critic.md. Pass `SPEC_DIR` so the agent knows the target path.
302
+
Present the completed spec to the human for explicit approval before proceeding to implementation contract authoring.
322
303
323
-
The spec-critic checks against the Definition of Ready (`docs/wiki/engineering/definition-of-ready.md`). Any unsatisfied criterion is a blocking issue.
304
+
Use the `question` tool to show the spec summary and ask for approval.
- If **Status** is "rejected" → loop back to spec-author (step 2).
328
-
- If any unchecked `- [ ]` items under **Blocking issues** → loop back to spec-author (step 2).
329
-
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and re-invoke spec-critic or previous agent depending on the questions and answers.
330
-
- When looping back: update `## Orchestrator` with loop note, set target agent's status to "in-progress" with context from blocking issues, re-invoke spec-author.
331
-
-**Note:** This is the one exception to the rule that sub-agents self-manage their own status. The orchestrator may temporarily reset a sub-agent's `**Status**` to "in-progress" during loop-backs. This is documented in the coordination.md template constraints.
332
-
- If gate passes, update `## Orchestrator` → **Current step** to "spec-critic-approved".
333
-
- Proceed to implementation-contract-author.
306
+
Record the decision in coordination.md `## Orchestrator` → **Notes**:
- If **Status** is "rejected" → loop back to implementation-contract-author (step 4).
358
342
- If any unchecked `- [ ]` items under **Blocking issues**:
359
-
- If the issue is a spec-level problem requiring spec.md changes → loop to spec-author (step 2). After spec-author fixes, orchestrator MUST invoke spec-critic to re-review the modified spec. If spec-critic accepts (coordination.md `## spec-critic`**Status** is `completed`), then proceed to implementation-contract-author (step 4). If spec-critic rejects, continue looping.
343
+
- If the issue is a spec-level problem requiring spec.md changes → loop to spec-author (step 2). After spec-author fixes, proceed to human spec validation (step 3). If the human approves the updated spec, continue to implementation-contract-author (step 4). If the human requests changes, continue looping back to spec-author.
360
344
- Otherwise → loop to implementation-contract-author (step 4).
361
345
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and re-invoke implementation-contract-critic or previous agent depending on the questions and answers.
362
346
- When looping: update `## Orchestrator` with loop note, set target agent's status to "in-progress" with context.
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and re-invoke code-implementer or previous agent depending on the questions and answers.
401
385
- Update `## Orchestrator` → **Current step**.
402
386
403
-
### 8. Code review
404
-
405
-
Ask `code-reviewer` to review and create/update the code-review.md. Pass `SPEC_DIR` so the agent knows the target path.
- If **Status** is "rejected" → loop back to code-implementer (step 7).
410
-
- If any unchecked `- [ ]` items under **Blocking issues** → loop back to code-implementer (step 7).
411
-
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and re-invoke code-reviewer or previous agent depending on the questions and answers.
412
-
- Always rerun code-reviewer after implementation modifications.
413
-
- Be sure to analyze rendering and confirm functional display using `buddd capture` and vision analyze tool.
414
-
- When looping: update `## Orchestrator` with loop note, set code-implementer status to "in-progress" with context.
415
-
- If gate passes, update `## Orchestrator` → **Current step**.
416
-
417
-
### 9. Governance update
387
+
### 8. Governance update
418
388
419
389
If the orchestrator decides an ADR is needed, invoke `adr-agent` on-demand by delegating to it.
420
390
The `adr-agent` is an on-demand tool, not a mandatory workflow step.
@@ -425,7 +395,7 @@ After `adr-agent` reports completion:
425
395
- Check **Blocking issues**: if present, resolve.
426
396
- Update `## Orchestrator` → **Current step**.
427
397
428
-
### 10. Wiki update
398
+
### 9. Wiki update
429
399
430
400
Ask `wiki-agent` to update the wiki content.
431
401
@@ -435,20 +405,7 @@ Gate:
435
405
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and re-invoke wiki-agent or previous agent depending on the questions and answers.
436
406
- Update `## Orchestrator` → **Current step**.
437
407
438
-
### 11. Final governance validation
439
-
440
-
Ask `governance-reviewer` for cross-document validation.
- If **Status** is "rejected" → resolve issues through the appropriate agent.
445
-
- If any unchecked `- [ ]` items under **Blocking issues** → resolve issues through the appropriate agent.
446
-
- If **Questions for human** is non-empty, ask human immediately using the `question` tool and record answer in coordination.md and re-invoke governance-reviewer or previous agent depending on the questions and answers.
447
-
- Always rerun governance-reviewer after modifications.
448
-
- When looping: update `## Orchestrator` with loop note, set target agent's status to "in-progress" with context.
449
-
- If gate passes, update `## Orchestrator` → **Current step**.
450
-
451
-
### 12. Done
408
+
### 10. Done
452
409
453
410
Set `## Orchestrator` → **Status** to "completed".
454
411
@@ -470,11 +427,8 @@ All artifacts stay in `SPEC_DIR` (e.g. `.specs/sprint-2026-06/<feature>/`). No f
470
427
- Never edit production code yourself.
471
428
- Never allow implementation from a raw user request.
472
429
- Never allow implementation from a spec alone.
473
-
- Never skip the spec critic.
474
430
- Never skip the implementation contract critic.
475
431
- Never skip human validation before implementation.
476
-
- Never skip the code reviewer.
477
-
- Never skip the governance reviewer.
478
432
- Never silently resolve critic or reviewer questions.
479
433
- Never ask the scout for repository dumps in normal mode.
480
434
- Never create or update ADR yourself, ask `adr-agent`.
0 commit comments