Skip to content

content: adopt depth-first prompts (v3) for security, performance, and release-notes agents - #30

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

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

Conversation

@yohan-work

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

Copy link
Copy Markdown
Owner

Summary

This is batch 4a of the v3 depth-rule rollout, after #26, #27, and #29. Each of the three agents got a v3 prompt and an out-of-scope case.

  • Each agent was tested on 3 cases × 2 samples, generated with claude-opus-5-5.
  • Sonnet judged the outputs blind, in both orders. A case run only counts when both orders agree.
  • Following the test-case lesson from batch 3, the prompts start with the output when the request already gives enough detail.
Agent v3 vs baseline v3 vs current Decision
security-checklist-agent 5–1 5–0 (1 inconsistent) adopted (review 4/5, re-reviewed against the aligned criteria)
performance-audit-agent 5–0 (1 inconsistent) 4–1 (1 inconsistent) adopted (review 4/5; the reviewer gave 5, capped because its notes cite unmarked inferences and a case scored 4)
release-notes-writer 5–0 (1 inconsistent) 4–1 (1 inconsistent) adopted (review 4/5)
  • For each agent I updated outputs, the runbook shape, checklist, and failure modes, the handoff starter, realUseCases[].expectedResult, and evaluationCriteria[2..]. They now describe only what the prompt instructs. evaluationCriteria[0] is unchanged.
  • I added the batch 4a lessons to evals/README.md.

Test plan

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

🤖 Generated with Claude Code

Review fix: the first reviews used the old criteria, because the runbook was aligned after the review. All three agents were re-reviewed against the aligned criteria, and evals/README.md now aligns the runbook before the review.

yohan-work and others added 2 commits September 30, 2026 13:23
…d release-notes agents

Batch 4a 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.

- security-checklist-agent v3: 5-1 vs baseline, 5-0 vs current. Adopted;
  reviewer's 5 capped at 4 (its notes cite very long output and a case
  scored 4).
- performance-audit-agent v3: 5-0 vs baseline, 4-1 vs current. Adopted.
- release-notes-writer v3: 5-0 vs baseline, 4-1 vs current. Adopted.

Runbooks, outputs, use-case results, and criteria are aligned with what
the new prompts instruct.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Address review on #30:
- The first reviews graded the new prompts against the old "assumptions,
  risks, and next actions separately" criterion, because the runbook was
  aligned after the review. Re-review all three against the aligned
  criteria and re-apply. Performance's reviewer 5 is capped at 4 (its
  notes cite unmarked inferences, long output, a case scored 4); security
  re-reviewed at 4.
- release-notes-writer: criterion promised [ASSUMPTION] tags the prompt
  never asks for; use its placeholder and question rules instead. Mark
  internal notes as produced only when requested.
- evals/README.md: align the runbook before the reviewer grades
  (steps 5 and 6 swapped).

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