Skip to content

docs(migration): align skill and trajectory assertion docs#1687

Merged
christso merged 2 commits into
mainfrom
promptfoo-stale-grader-docs
Jul 6, 2026
Merged

docs(migration): align skill and trajectory assertion docs#1687
christso merged 2 commits into
mainfrom
promptfoo-stale-grader-docs

Conversation

@christso

@christso christso commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Summary

Current AgentV docs and AI-facing authoring references now teach the Promptfoo-compatible skill and trajectory assertion names directly. The old current-docs trajectory page has been replaced with a trajectory:* assertion page, Promptfoo parity now marks skill-used / not-skill-used and supported trajectory:* assertions as aligned, and remaining public examples avoid stale score type names.

Related: av-kfik.45.4

Search Policy

Final stale-name search over current docs, skills-data, examples, and non-versioned docs leaves only intentional categories:

  • Migration guidance in skills-data/agentv-eval-migrations/references/breaking-changes.md and skills-data/agentv-eval-writer/SKILL.md.
  • Historical planning/ADR/brainstorm files under docs/, which are not current canonical docs.
  • examples/features/latency-assertions/README.md, which explicitly documents unsupported legacy per-tool latency fields and points users to trajectory:* plus script assertions.
  • Archived version snapshots under apps/web/src/content/docs/docs/v4.42.4/** were intentionally not edited.

Validation

  • bun run validate:examples
  • bun run lint
  • bun --filter @agentv/web build
  • bun --filter @agentv/web check:routes
  • git diff --check

Code review: dedicated ce-code-review subagent dispatch was unavailable in this session, so I performed a manual diff scan focused on docs route consistency, YAML snippet shape, and stale-name policy.

Post-Deploy Monitoring & Validation

No additional operational monitoring required. This is documentation, skills-data, and example fixture cleanup only; it does not change runtime assertion behavior.


Compound Engineering
GPT-5

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 6, 2026

Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: 17e247e
Status: ✅  Deploy successful!
Preview URL: https://d6657081.agentv.pages.dev
Branch Preview URL: https://promptfoo-stale-grader-docs.agentv.pages.dev

View logs

@christso christso merged commit 0d9c676 into main Jul 6, 2026
8 checks passed
@christso christso deleted the promptfoo-stale-grader-docs branch July 6, 2026 02:04
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