Skip to content

docs: record first tone_model_eval run (GROW-6139) - #729

Open
warp-agent-staging[bot] wants to merge 2 commits into
mainfrom
factory/grow-6139-tone-model-eval-run
Open

docs: record first tone_model_eval run (GROW-6139)#729
warp-agent-staging[bot] wants to merge 2 commits into
mainfrom
factory/grow-6139-tone-model-eval-run

Conversation

@warp-agent-staging

@warp-agent-staging warp-agent-staging Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Runs the merged .agents/skills/tone_model_eval/ skill (GROW-6133, now on main) for the first time and records the result. This is a report-only run — no code changes, no changes to AGENTS.md, style_lint.py, doc_quality_policy/, or any draft_* skill, and no model/schedule switch.

Setup: all 3 fixtures validated cleanly. Candidates: claude-5-1-fable-high (Claude Fable 5.1), claude-4-5-sonnet (current-default stand-in — see Notes below), claude-4-5-haiku and gpt-5-mini (cheaper candidates). Every candidate rewrote the identical full-page "before" text per fixture (fixed-input design). Judge: gemini-3.1-pro, a distinct model family from every candidate, scoring each of the 12 outputs blind in its own independent call.

Result: no meaningful difference found.

  • Adopt Fable-5.1-derived guidance: fails both pinned thresholds — concision-dimension margin over the default was 0.33 (need ≥1.0), mechanical-violation reduction was 0% (need ≥30%; every candidate had 0 buzzword/meta-opener violations).
  • Recommend a cheaper model for production copy passes: no candidate qualifies. All three cheaper/default candidates fail the ≥4.0 technical-fidelity floor (claude-4-5-sonnet 3.67, claude-4-5-haiku 3.00, gpt-5-mini 1.67), independent of their judge-score gap.

Composite judge scores (concision / avoids-over-explaining / technical-fidelity): claude-5-1-fable-high 4.33/5 (4.67/4.67/3.67); claude-4-5-sonnet 4.11/5 (4.33/4.33/3.67); claude-4-5-haiku 3.89/5 (4.33/4.33/3.00); gpt-5-mini 3.44/5 (4.33/4.33/1.67).

Per out_of_repo_handoff.md, a "no meaningful difference found" outcome skips that checklist entirely — no schedule or Agent Profile change to make.

Notes / assumptions:

  • claude-4-5-sonnet stands in for "the current production default model for docs drafting skills." Live oz-dev schedule list / schedule get discovery against every schedule referencing docs drafting/audit skills found no explicit model_id in any schedule config — per out_of_repo_handoff.md, that selection lives in the Warp app's Agent Profile UI, which isn't inspectable from this environment. auto was considered and rejected as the stand-in because it's a router that can resolve to different underlying models across calls, which would break the fixed-model comparison this eval depends on.
  • Every technical-fidelity score below 5 was manually spot-checked against the source text and reflects a real, verifiable defect, not judge noise: gpt-5-mini introduced an unsupported claim ("short-lived credentials for integrations") not present in the original quickstart draft, and claude-4-5-haiku dropped the BYOLLM fixture's "not admin-configurable" qualifier on host-priority order.

Artifact decision: committing the report (rather than posting only to the ticket) because this repo already has an established .agents/logs/*_runs.md convention for exactly this purpose — a durable, append-only record that a later re-run (or the "recompute after model-config changes" step in out_of_repo_handoff.md) can diff against. Raw rows.jsonl + report.json + report.md are stored under .agents/logs/tone_model_eval/, mirroring the existing agent_doc_quality_baseline.md.agents/logs/baseline/ pattern.

Rework changes

Review found 1 IMPORTANT issue: the run log claimed the sub-5 technical-fidelity scores reflected manually verified real defects, but no candidate rewrite text was committed anywhere, so those claims were unverifiable. Fixed by committing all 12 raw candidate outputs (4 models × 3 fixtures) under .agents/logs/tone_model_eval/outputs/<fixture-id>__<model-id>.txt, and updating the run log's two cited defect examples to point at the specific committed file and rows.jsonl row for each.

Verification

  • python3 .agents/skills/tone_model_eval/score_outputs.py validate-fixtures3 fixtures valid.
  • python3 .agents/skills/tone_model_eval/test_score_outputs.py — 43 tests pass, unchanged.
  • python3 .agents/skills/doc_quality_policy/test_*.py (all 8 files) — pass, unchanged.
  • python3 .agents/skills/style_lint/style_lint.py --changed — 0 files scanned (no src/content/docs/ changes), 0 issues.
  • npm run build — succeeds.
  • No UI / computer_use step: headless report-only run with no src/content/docs/ page changes and no rendered UI surface.

Documentation risk

Risk: low
Rationale: Adds only an append-only run log and raw eval-report data files under .agents/logs/; no src/content/docs/ changes, no code changes, no public documentation claim.
Docs override: none

Unverified claims

None — internal tooling output only, no public documentation claims added.

Originating thread: https://warpdev.slack.com/archives/C09BVK0PL3Y/p1788971815025429

Runs the merged tone_model_eval skill's fixed-input copy-pass
comparison across all 3 fixtures against 4 candidate models
(claude-5-1-fable-high, claude-4-5-sonnet as the current-default
stand-in, claude-4-5-haiku, gpt-5-mini), scored blind by a fixed
judge model (gemini-3.1-pro, distinct family from every candidate).

Result: no meaningful difference found (concision margin 0.33 of the
required >=1.0; 0% mechanical-violation reduction of the required
>=30%), and no cheaper-model recommendation (every cheaper candidate
fails the technical-fidelity floor). out_of_repo_handoff.md's
checklist is not triggered by this outcome.

Adds .agents/logs/tone_model_eval_runs.md (new run log, following the
existing _runs.md convention) and the raw rows/report data under
.agents/logs/tone_model_eval/, so a later re-run has a baseline to
diff against.

Co-Authored-By: Warp <agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Sep 10, 2026
@vercel

vercel Bot commented Sep 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 10, 2026 9:44pm UTC

Request Review

@warp-agent-staging warp-agent-staging Bot added the warpy-factory Opened by the Warp factory agents label Sep 10, 2026
@warp-agent-staging
warp-agent-staging Bot marked this pull request as ready for review September 10, 2026 21:29
@warp-for-oss

warp-for-oss Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

@warp-agent-staging[bot]

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@warp-for-oss warp-for-oss 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.

Overview

This PR records the first tone_model_eval run by adding internal log artifacts and a run-log entry under .agents/logs/. The added JSON, JSONL, Markdown report, and run-log summary are consistent with the tone_model_eval report renderer and do not modify public documentation, production guidance, settings, or code.

Concerns

  • No blocking concerns found. The declared low documentation risk is appropriate for internal append-only eval logs, the spec context contains no approved requirements to validate against, and the security pass found no changed code or configuration that introduces a security concern.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@github-actions github-actions 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.

Review summary

The independent agent completed its review for this commit.

Findings

  • .agents/logs/tone_model_eval_runs.md:36 — [SUGGESTION] The 'Oz run' field reads 'see GROW-6139' instead of following the entry template's own - **Oz run**: [URL] format defined at line 20 of the same file. Requested resolution: replace with the actual Oz/Warp run URL for this eval run, or explicitly note why the URL is unavailable.

Verdict

Approve

@warp-agent-staging warp-agent-staging Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Review summary

The PR correctly records a complete, reproducible score aggregate, but it omits the candidate rewrites needed to validate its stated technical-fidelity defects. Found: 0 critical, 1 important, 0 suggestions, 0 nits. Request changes

Findings

  • .agents/logs/tone_model_eval_runs.md:37⚠️ [IMPORTANT] The run log says the non-5 technical-fidelity scores were manually verified from real defects, including an invented claim and a dropped qualifier, but the three listed data artifacts contain only scores, counts, and aggregates. They do not preserve any candidate rewrite or a durable link to one, so this review cannot perform the required spot-check or distinguish an accurate annotation from a judging or transcription error. Commit the per-fixture candidate rewrites (or link each row to a stable, access-controlled artifact containing the exact text) and identify the relevant row/output for each cited defect.

Verdict

Request changes

Comment thread .agents/logs/tone_model_eval_runs.md Outdated
- Recommend a cheaper model for production copy passes: **no candidate met the threshold** — `claude-4-5-sonnet` (judge gap 0.22, technical fidelity 3.67 < 4.0 min), `claude-4-5-haiku` (gap 0.44, fidelity 3.00 < 4.0), `gpt-5-mini` (gap 0.89, fidelity 1.67 < 4.0) all fail on technical fidelity.
- **Data**: `.agents/logs/tone_model_eval/2026-09-10-rows.jsonl`, `.agents/logs/tone_model_eval/2026-09-10-report.json`, `.agents/logs/tone_model_eval/2026-09-10-report.md`
- **Oz run**: see GROW-6139
- **Notes**: First run (GROW-6139). `claude-4-5-sonnet` stands in for "the current production default model for docs drafting skills" as a **documented assumption**: live `oz-dev schedule list`/`schedule get` discovery against every schedule referencing docs drafting/audit skills found no explicit `model_id` in any schedule config — model selection for ad hoc/event-triggered drafting runs lives in the Warp app's Agent Profile UI (per `out_of_repo_handoff.md`), which isn't inspectable from this environment. `auto` was considered and rejected as the stand-in because it's a router that can resolve to different underlying models across calls, which would break the fixed-model comparison this eval depends on. Every technical-fidelity score below 5 was manually spot-checked against the source text and reflects a real defect (e.g. `gpt-5-mini` introduced an unsupported claim — "short-lived credentials for integrations" — not present in the original quickstart draft; `claude-4-5-haiku` dropped the original's "not admin-configurable" qualifier on host-priority order), not judge noise. Per this outcome, `out_of_repo_handoff.md`'s checklist is skipped — no model/schedule/Agent Profile change to make.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

⚠️ [IMPORTANT] The run log says the non-5 technical-fidelity scores were manually verified from real defects, including an invented claim and a dropped qualifier, but the three listed data artifacts contain only scores, counts, and aggregates. They do not preserve any candidate rewrite or a durable link to one, so this review cannot perform the required spot-check or distinguish an accurate annotation from a judging or transcription error. Commit the per-fixture candidate rewrites (or link each row to a stable, access-controlled artifact containing the exact text) and identify the relevant row/output for each cited defect.

Review finding: the run log claimed the sub-5 technical-fidelity
scores reflected verified real defects, but no candidate rewrite
text was committed, so the claims were unverifiable.

Commit all 12 raw candidate outputs (4 models x 3 fixtures) under
.agents/logs/tone_model_eval/outputs/<fixture-id>__<model-id>.txt,
and point the run log's two cited defect examples at the specific
committed files and rows.jsonl entries.

Co-Authored-By: Warp <agent@warp.dev>

@github-actions github-actions 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.

Review summary

The independent agent completed its review for this commit.

Findings

  • No findings.

Verdict

Approve

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed warpy-factory Opened by the Warp factory agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants