Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/guides/agent-development.md
Original file line number Diff line number Diff line change
Expand Up @@ -318,7 +318,7 @@ Agent prompts are built with role-appropriate context via `_build_role_context()

**Interface role** (overseer) receives pipeline state, health alerts, and agent logs.

When adding a new execution role, `_build_role_context()` will automatically provide the summarized context and filter tasks by role. If the role needs phase-specific instructions (like the tester's "Focus your testing on..." or the documenter's "Focus your documentation on..."), add a condition in `_build_role_context()` for the new role.
When adding a new execution role, `_build_role_context()` will automatically provide the summarized context and filter tasks by role. If the role needs phase-specific instructions (like the tester's "Focus your testing on..." or the documenter's "Document the current state of the code in the areas these tasks touch..."), add a condition in `_build_role_context()` for the new role.

**All producer roles** (analysis + execution; not reviewers or utility) also receive a `## Subagent use for exploration` directive via the shared `_EXPLORATION_SUBAGENT_GUIDANCE` constant in `orchestrator/routes/pipelines.py`. New producer prompt builders should include `lines.extend(_EXPLORATION_SUBAGENT_GUIDANCE)` to inherit this directive automatically ([#2814](https://github.com/jwbron/egg/issues/2814)).

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/agent-roles.md
Original file line number Diff line number Diff line change
Expand Up @@ -305,7 +305,7 @@ tests, and its mandate is two-fold: **(1) comprehensive regression coverage**

### `documenter`

**Purpose**: Update documentation and READMEs.
**Purpose**: Document the current state of the code.

**File access** (defaults — overridable per-repo via `role_patterns:` in `repositories.yaml`):
- Owned scope (allowed writes): **documentation and markdown only.**
Expand Down
6 changes: 3 additions & 3 deletions orchestrator/routes/pipelines.py
Original file line number Diff line number Diff line change
Expand Up @@ -14798,10 +14798,10 @@ def _build_agent_prompt(
"- Describe what the code does now, not what changed or when it changed.",
"- NEVER reference SDLC artifacts — slice numbers, TASK-N ids, phase or "
"HITL iteration numbers — in any doc, docstring, or inline comment you write.",
"- Include historical context (issue links, \"previously X\" rationale, "
'- Include historical context (issue links, "previously X" rationale, '
"migration notes) ONLY when it is tangibly valuable to a reader of the "
"current system, and prefer rationale (\"why it is this way\") over "
"chronology (\"what it used to be / when it changed\").",
'current system, and prefer rationale ("why it is this way") over '
'chronology ("what it used to be / when it changed").',
"- When updating an existing doc, fold the new state into the snapshot and "
"REMOVE now-stale ledger or historical entries rather than appending "
"another layer.",
Expand Down
Loading