Skip to content

docs: Update for REFINER and reviewers [doc-updater] - #696

Merged
jwbron merged 1 commit into
mainfrom
egg/doc-update-refiner-roles
Feb 15, 2026
Merged

docs: Update for REFINER and reviewers [doc-updater]#696
jwbron merged 1 commit into
mainfrom
egg/doc-update-refiner-roles

Conversation

@james-in-a-box

Copy link
Copy Markdown
Contributor

docs: Update for REFINER and phase-specific reviewers [doc-updater]

Update documentation to reflect changes from commit 1ccefb2 (PR #690):

What changed:

  • Added REFINER role for refine phase (dedicated analysis agent)
  • Added REVIEWER_REFINE for refine phase review
  • Added REVIEWER_PLAN for plan phase review
  • Removed unified reviewer from refine phase
  • Added plan reviewer to plan phase (alongside unified)

Documentation updates:

  • README.md: Added "Refine Phase Roles" section, updated reviewer tables
  • docs/guides/sdlc-pipeline.md: Updated multi-reviewer architecture table and specialized reviewer list
  • docs/development/STRUCTURE.md: Broadened agent_roles.py description to cover all roles

Triggered by: #690

Authored-by: egg

Update documentation to reflect new agent roles added in #690:
- Add REFINER role for refine phase
- Add REVIEWER_REFINE for dedicated refine phase review
- Add REVIEWER_PLAN for dedicated plan phase review
- Update reviewer tables to show phase-specific reviewers

Triggered by: 1ccefb2 (PR #690)

Authored-by: egg

@egg-reviewer egg-reviewer Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No agent-mode design concerns. This is a documentation-only PR reflecting role additions (REFINER, REVIEWER_REFINE, REVIEWER_PLAN) from PR #690. No agent workflow, prompt design, or output format changes are involved.

— Authored by egg

@james-in-a-box

This comment has been minimized.

@egg-reviewer egg-reviewer Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documentation-only PR — verified all claims against the codebase.

Verification results:

  1. REFINER role (agent_roles.py:424-456): Correctly described. Runs first in refine phase with no dependencies. Documentation accurately states it "analyzes task, researches codebase, evaluates options, recommends approach."

  2. REVIEWER_REFINE (agent_roles.py:572-593): Correctly added to refine phase reviewers, replacing the unified reviewer. Depends on REFINER. Phase mapping at line 756-759 confirms [REVIEWER_REFINE, REVIEWER_AGENT_DESIGN] for refine phase.

  3. REVIEWER_PLAN (agent_roles.py:595-616): Correctly added alongside unified and agent-design reviewers for plan phase. Depends on TASK_PLANNER and RISK_ANALYST. Phase mapping at line 751-755 confirms [REVIEWER_UNIFIED, REVIEWER_AGENT_DESIGN, REVIEWER_PLAN].

  4. Phase reviewer table in sdlc-pipeline.md: Matches _PHASE_REVIEWERS dict exactly.

  5. STRUCTURE.md: Broadened description from specific role names to "all agent and reviewer roles" — appropriate since the file now defines many more roles than the original four.

  6. README.md: New "Refine Phase Roles" section and updated execution model text ("after the refiner completes" vs old "after the coder completes") are accurate.

No issues found. All documentation changes faithfully reflect the code introduced in PR #690.

— Authored by egg

@james-in-a-box

Copy link
Copy Markdown
Contributor Author

egg review completed. View run logs

1 previous review(s) hidden.

@jwbron
jwbron merged commit 8e0e82b into main Feb 15, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant