Skip to content

Add hidden Agent Experience beta onboarding guide - #8419

Open
chitalian wants to merge 2 commits into
mainfrom
agent-experience-beta-guide
Open

chitalian wants to merge 2 commits into
mainfrom
agent-experience-beta-guide

Conversation

@chitalian

@chitalian chitalian commented Nov 11, 2026 •

Copy link
Copy Markdown
Member

What

First draft of a hidden onboarding guide for Agent Experience (AX) beta customers: /agent-experience-beta. It's not in docs.json navigation and has noindex: true, same pattern as poc-onboarding.mdx.

It covers: what AX is, key terms, how to open it, the three ways to create a story (manual, automatic, MCP with templates), story settings, test inboxes, story and run pages, findings and how they get marked fixed, All runs and export, credits and limits, the spend limit, and a suggested first week.

Light and dark screenshots for each view are in images/agent-experience/.

AX stories

AX run traces

How the screenshots were made

  • The shared devbox backend has no Preflight worker, so I ran a private mint-server box with the Preflight worker running locally under wrangler dev (local D1 and R2, containers off), and pointed the server at it with PREFLIGHT_WORKER_URL.
  • I seeded a fresh ax-beta org (enterprise, PREFLIGHT entitlement turned on) and filled the worker's D1 and R2 with synthetic data for a made-up "Acme" product: 5 stories, 80 runs over two weeks across Claude Code, Codex and opencode, open, fixed and dismissed findings, doc changes, automatic triggers, and traces.
  • The dashboard box ran the rebrand-preflight-to-ax branch (mintlify/mint#14719), so the screenshots show "Agent Experience". The UI copy in this guide matches that branch, so merge this after #14719.

To check

  • Product facts come from the current code: 100 credits per run (200 with browser), only finished runs billed, 10 stories, 10 active runs, 50 runs a day, 20-minute timeout, and findings marked fixed after 2 clean runs. Please confirm these are the limits we want to tell beta customers.
  • The five story templates are only available through MCP right now. The guide says so.
  • The dashboard path in the guide is Settings > Products > Agent Experience, which is where the sidebar showed it.
  • I ran mint broken-links, which passed. Vale isn't installed in this workspace, so I didn't run it.

🤖 Generated with Claude Code


Created by Justin Torre (justin@mintlify.com) with Replicas

Replicas Workspace Slack Thread

Co-Authored-By: replicas-connector[bot] <replicas-connector[bot]@users.noreply.github.com>


Note

Low Risk
Documentation-only addition with no runtime or product code changes; main risk is stale or incorrect beta limits/UI copy if product ships before the related dashboard rebrand (#14719).

Overview
Adds a new hidden docs page at agent-experience-beta.mdx for private-preview Agent Experience (AX) customers, using noindex: true and (per the PR) the same off-nav pattern as other beta onboarding guides.

The page is an end-to-end AX onboarding doc: product overview and terms, dashboard entry (Settings > Products > Agent Experience), story creation (manual, automatic, MCP/templates), story settings and test inboxes, reviewing stories/runs/findings, All runs export, credits/limits/spend caps, and a suggested first-week checklist. It links to /credits and /ai/mintlify-mcp and embeds light/dark screenshots under /images/agent-experience/.

Reviewed by Cursor Bugbot for commit f4f5747. Bugbot is set up for automated code reviews on this repo. Configure here.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: replicas-connector[bot] <replicas-connector[bot]@users.noreply.github.com>
@mintlify

mintlify Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 12, 2026, 4:06 AM

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: replicas-connector[bot] <replicas-connector[bot]@users.noreply.github.com>

This branch was successfully deployed

1 active deployment
staging — f4f57474 Deployed Nov 12, 2026 by mintlify[bot]
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