Skip to content

docs(coding-agent): refresh workflowz notice with advisor + provenance patterns #2647

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
metaphorics wants to merge 1 commit into
base: main
Choose a base branch
from
+6 −0
Open

docs(coding-agent): refresh workflowz notice with advisor + provenance patterns #2647

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 4 additions & 0 deletions packages/coding-agent/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## [Unreleased]

### Changed

- Refreshed the hidden `workflowz` orchestration notice with two patterns: an "Advisor consult" (consult the `advisor` tool at a hard fork before committing) and "Provenance-rich context" (brief each subagent on which files/commits and what "done" means via a `local://` brief).

## [15.13.2] - 2026-06-15

### Added
Expand Down
2 changes: 2 additions & 0 deletions packages/coding-agent/src/prompts/system/workflow-notice.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,8 @@ Compose the harness the task calls for:
- **Completeness critic** — a final agent that asks "what's missing — modality not run, claim unverified, file unread?"; its answer is the next round.
- **Budget/count loops** — `while len(bugs) < 10:` to hit a target, or `while budget.total and budget.remaining() > 50_000:` to scale depth to the turn budget; `log()` each round.
- **No silent caps** — if you bound coverage (top-N, no-retry, sampling), `log()` what you dropped; silent truncation reads as "covered everything" when it didn't.
- **Advisor consult** — at a hard fork or when stuck, if the `advisor` tool is enabled, consult it for a second opinion from a more-capable paired model before committing to a direction; cheaper than a full judge panel for a single decision.

@roboomp roboomp Jun 15, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

should-fix: This notice now tells the agent to consult an advisor tool, but this PR/base branch does not register any advisor tool or mention it anywhere else in packages/coding-agent/packages/agent (advisor only appears in this added prompt/changelog text). If this lands before the advisor-tool PR, workflowz injects guidance for a tool the model cannot call; either stack this after that implementation or word this against an already-available mechanism.

- **Provenance-rich context** — hand each subagent which files/commits to touch, why, and what "done" looks like via a `local://` brief; never assume a subagent shares your context.

Scale to the ask: "find any bugs" → a few finders, single-vote verify. "thoroughly audit / be comprehensive" → larger finder pool, 3–5-vote adversarial pass, a synthesis stage.
</patterns>
Expand Down