Skip to content

docs(adr): codify promptfoo-first provider authoring - #1710

Merged
christso merged 2 commits into
mainfrom
docs/av-fdco-promptfoo-first-adrs
Jul 7, 2026
Merged

docs(adr): codify promptfoo-first provider authoring#1710
christso merged 2 commits into
mainfrom
docs/av-fdco-promptfoo-first-adrs

Conversation

@christso

@christso christso commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

AgentV's durable direction now treats Promptfoo-compatible providers as the default authored system-under-test axis. The intentional authored-config differences are limited to environment, AgentV refs, and built-in agentv:* providers; direct Promptfoo compatibility applies to Promptfoo-native declarations, while AgentV-native pieces go through agentv export promptfoo.

The decision also keeps existing run-bundle and Dashboard target artifact fields out of this migration. Host/filesystem environment export may lower into generated Promptfoo extensions plus provider workdir config, and Docker export remains unsupported until a faithful runner boundary exists.

Details

  • Adds ADR 0019 for the Promptfoo-first provider authoring and export boundary.
  • Updates strategy, roadmap, concepts, AGENTS guidance, and product-boundary guidance to match providers / id / label authoring.
  • Cross-links older ADR 0016/0017/0018 decisions where ADR 0019 supersedes target/provider authoring, while preserving artifact target terminology as a separate decision.
  • Cleans stale wording that still suggested public targets or old target/provider identity semantics.

Validation

  • git diff --check
  • Targeted rg stale-claim scan for old public targets / non-canonical providers guidance. The only remaining hit is ADR 0019's intentional historical context describing the superseded state.
  • Attempted bunx biome check on changed Markdown docs, but Biome processes 0 Markdown files in this repo. No markdownlint, markdownlint-cli2, or vale executable is installed.

Related

Related: Bead av-fdco


Compound Engineering
GPT-5

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: 9d2629e
Status: ✅  Deploy successful!
Preview URL: https://105751bb.agentv.pages.dev
Branch Preview URL: https://docs-av-fdco-promptfoo-first.agentv.pages.dev

View logs

@christso
christso marked this pull request as ready for review July 7, 2026 00:39
@christso
christso merged commit 6912da1 into main Jul 7, 2026
8 checks passed
@christso
christso deleted the docs/av-fdco-promptfoo-first-adrs branch July 7, 2026 00:39
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