Skip to content

chore: add agent app-creation docs evaluation harness - #455

Draft
adidottxt wants to merge 3 commits into
mainfrom
adi/agent-app-creation-eval
Draft

chore: add agent app-creation docs evaluation harness#455
adidottxt wants to merge 3 commits into
mainfrom
adi/agent-app-creation-eval

Conversation

@adidottxt

Copy link
Copy Markdown
Contributor

Adds the evaluation harness for measuring agent-path prominence in the app-creation docs, split out of #454 so that PR carries only the docs change.

  • run.mjs fetches production and preview llms-full.txt, ranks each query's canonical page with a small fielded BM25 retriever, and gates on tokens-to-first-agent-path plus agent-only visibility checks.
  • claude-outcomes.mjs runs three Claude trials per query, using the retrieval output as the only documentation context.
  • 23 tests cover the scorers and retriever (node --test evals/agent-app-creation/*.test.mjs).

The Context7 comparison from the original PR was dropped; the local harness is the only gate.

Linear: https://linear.app/porter/issue/RUN-4007/chore-make-the-agent-path-more-prominent-in-the-app-creation-docs

@mintlify

mintlifyBot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

ProjectStatusPreviewUpdated (UTC)
porter🟢 ReadyView PreviewAug 12, 2026, 6:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

- Delete the dead codeSnippets response shape and its test/fixture remnants
- Extract shared CLI helpers (arg parsing via node:util, output writing,
gates table, main-error handling) into cli.mjs
- Deduplicate scoring constants and helpers; score each Claude run once
- Derive gate denominators from query groups instead of hard-coding counts
- Run Claude trials through a bounded worker pool (--concurrency, default 4)
- Index corpus chunks by page path; hoist token aliases; overlap visibility
fetches with corpus fetches
@adidottxt
adidottxt marked this pull request as draft August 12, 2026 19:57
Sign up for freeto 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

@adidottxt