Skip to content

content: adopt depth-first prompts (v3) for refactor, api-contract, and feedback agents - #29

Merged
yohan-work merged 2 commits into
mainfrom
content/v3-batch-3
Sep 30, 2026
Merged

yohan-work merged 2 commits into
mainfrom
content/v3-batch-3

Conversation

@yohan-work

@yohan-work yohan-work commented Sep 30, 2026 •

Copy link
Copy Markdown
Owner

Summary

This is batch 3 of the v3 depth-rule rollout, after #26 and #27. For each of four agents I wrote a v3 prompt and added an out-of-scope case.

Each prompt ran on 3 cases × 2 samples, generated with claude-opus-5-5. Sonnet judged each pair blind, in both orders. A case run only counts when both orders agree.

Agent v3 vs baseline v3 vs current Decision
refactor-plan-agent 6–0 6–0 adopted (review 4/5)
api-contract-agent 6–0 5–1 adopted (review 4/5; the reviewer gave 5, capped because its own notes list invented details)
customer-feedback-clusterer 4–1 (1 inconsistent) 3–0 (3 inconsistent) adopted (review 4/5)
test-case-generator 5–1 2–2 (2 inconsistent) not adopted: ties the current prompt
  • Runbooks, outputs, and evaluationCriteria[2..] for the adopted agents now match what the new prompts produce, following step 6 in evals/README.md. evaluationCriteria[0] is unchanged.
  • Single judge model. While this batch was paused, another session judged six pairs with a GPT model. I set those verdicts aside, so they are not committed, and re-judged every pair with Sonnet. All recorded verdicts come from one judge model.
  • The runs, verdicts, and reviews for every variant are committed, including the variant that was not adopted.

Test plan

  • npm run check:data
  • npm run lint
  • npm run typecheck
  • npm test (34 pass)
  • npm run build

🤖 Generated with Claude Code

yohan-work and others added 2 commits September 30, 2026 13:05
…nd feedback agents

Batch 3 of the v3 rollout: each agent gets a new out-of-scope case and is
tested on 3 cases x 2 samples, blind pairwise judging in both orders.

- refactor-plan-agent v3: 6-0 vs baseline, 6-0 vs current. Adopted.
- api-contract-agent v3: 6-0 vs baseline, 5-1 vs current. Adopted.
- customer-feedback-clusterer v3: 4-1 vs baseline, 3-0 vs current. Adopted.
- test-case-generator v3: 5-1 vs baseline but 2-2 vs current. Not adopted.

Adopted agents' runbooks, outputs, and criteria are aligned with what the
new prompts produce (evals/README.md step 6). All verdicts come from the
same Sonnet judge; six GPT-judged pairs from a paused session were set
aside and re-judged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…core at 4

Address review on #29:
- api-contract-agent: the reviewer gave 5, but its own notes list invented
  example details and a case scored 4; the rubric reserves 5 for no
  invented facts. Record the reviewer's score and cap qualityScore at 4.
- api-contract-agent, refactor-plan-agent: checklist, failure modes, and
  criteria promised refusals the prompts do not instruct; describe only
  what the prompts say (scope marking, big-bang rewrite flag, behavior
  changes allowed when asked).
- Refresh stale realUseCases expectedResult for the three adopted agents.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@yohan-work
yohan-work merged commit dae648e into main Sep 30, 2026
1 check passed
@yohan-work
yohan-work deleted the content/v3-batch-3 branch September 30, 2026 04:12
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