Commit Graph

29 Commits

Author SHA1 Message Date
Ethan Palm 045a50ea0e Post eval results as a sticky comment on the pull request
The score table was only visible in the job summary. Post it as one comment
per PR, found by a marker and updated in place on every run, with a link to
the run for the full HTML report. The job gets pull-requests: write for this;
the rest of the workflow keeps contents: read.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:53:07 -07:00
Ethan Palm 4d690a2206 Name the eval job for what it measures
The suite exercises the shared agent context through the Claude Code plugin,
the only target with an eval harness. Rename the job to say so and put the
coverage caveat at the top of the job summary, so nobody reads a green eval as
covering the Codex, Cursor, or Kiro agents.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:48:56 -07:00
Ethan Palm c28955e201 Mark the mocked code-mode API as illustrative
The operation and setting names in the Admin mock are stand-ins so the mock has
an API to play; they are not the real Admin server's.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:44:45 -07:00
Ethan Palm 8d3dfa50d6 Stabilize the admin eval cases
- Remove a contradiction between the checkout case's prompt (Enterprise "adds
  a 99.9% SLA") and the mocked pricing page (Pro already has one); the agent
  was correctly stopping to ask about it.
- Accept routing a deployment change through a session branch or PR as a pass
  for the live-write case; avoiding the live write is what the skill asks for.
- Run the two admin cases five times each. Identical passes scored
  admin-confirms-live-writes 1.00 and then 0.42, so three runs is too few.
  Drop --runs from the CI command, which would have overridden the per-case
  counts.
- Replace the advice to adopt mock replay recordings with a warning: replays
  key on input only, so a recorded read of the original page would answer a
  read made after write_page.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:41:44 -07:00
Ethan Palm 91e786ee60 Add a behavioral eval suite for the Claude plugin and run it in CI
agent-context/evals/ holds seven `claude plugin eval` cases with graders and
mocks for both Mintlify MCP servers. Five cases test skill knowledge (docs.json
shape, Columns vs CardGroup, frontmatter and links, page modes, a negative
case); two test the Admin MCP workflow the skill documents (checkout before
edits, confirm before live writes) against mocked servers.

The new eval-claude-plugin job in agent-context-ci.yml generates the Claude
plugin, copies the suite in, validates the plugin, and runs the suite with
pinned models on pull requests from this repository. It is a soft gate: scores
land in the job summary and an artifact but do not fail the check. It needs an
ANTHROPIC_API_KEY secret and reports when one is missing. Only the Claude
target has an eval harness; this measures the shared content.

Measured before this change, against a no-plugin baseline: Columns +0.53,
page modes +0.25, keywords frontmatter roughly +0.67; docs.json +0.06 because
the model already knows it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:27:07 -07:00
Ethan Palm e447c650b3 Write the Claude manifest to .claude-plugin/ where Claude Code reads it
The previous commit generated plugin.json at the repository root, which
`claude plugin validate` accepts but `claude plugin eval` ignores: the plugin
still resolved by directory name with no version. Only
.claude-plugin/plugin.json sets the name and version.

Adds an optional per-target pluginManifestFile (plugin.json or
.claude-plugin/plugin.json), used by both the build and the repository sync,
and points the claude target and the sync workflow at the new path. Kiro is
unchanged.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:27:06 -07:00
Ethan Palm 4450fa1700 Generate a Claude Code plugin manifest for the claude target
The claude target only shipped .claude-plugin/marketplace.json, so Claude
Code resolved the plugin by directory name. A plugin.json pins the name to
"mintlify" regardless of where the repo is checked out, which the eval
suite's MCP tool-name graders depend on. Uses the existing pluginManifest
mechanism from the kiro target; `claude plugin validate` accepts the output.

Also ignores agent-context/evals/results/, written by every eval run.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-11 16:21:29 -07:00
mintlify[bot] 4ba740259e docs: sync skill diff description with deploy branch terminology (#7340)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-11 10:10:14 -07:00
mintlify[bot] 128b2f6dc1 docs: sync agent skill with className, MDX code, and CLI updates (#7314)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 11:19:21 -07:00
mintlify[bot] 4d8f31feb8 docs: add mint test command to agent skill CLI reference (#7279)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 08:56:36 -07:00
mintlify[bot] da29ea021c docs: teach OpenAPI overlay support in mintlify agent skill (#7284)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 08:54:52 -07:00
mintlify[bot] 06341336d2 docs: sync agent skill with table column width support (#7239)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-03 14:33:50 -07:00
mintlify[bot] d5daa7a77a docs: sync agent skill with playground expand setting and MCP code mode (#7216)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-02 10:24:46 -07:00
mintlify[bot] c9cf5f428b docs: sync agent skill with corrected MDX table of contents behavior (#7196)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-31 09:22:48 -07:00
mintlify[bot] 1f43921f97 docs: sync agent skill with new MDX component and example panel width (#7191)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-31 08:36:41 -07:00
mintlify[bot] c7d1851e47 docs: sync Mintlify skill save modes with MCP publishing docs (#7147)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-27 14:02:06 -07:00
mintlify[bot] d86ccd0a5a docs: sync agent skill with restored mint analytics CLI command (#7080)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-25 09:17:38 -07:00
mintlify[bot] 2f0a248f60 docs: correct hidden/searchable behavior in skill reference (#7045)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-21 15:33:45 -07:00
mintlify[bot] 41af0c5388 Update from code changes: remove retired mint deslop command (#7005)
* docs: remove retired mint deslop CLI command

* docs: remove retired deslop API endpoint and references

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-18 09:27:39 -07:00
mintlify[bot] 81b65665ff docs: clarify groups frontmatter behavior with personalization (#6987)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-17 10:49:30 -07:00
mintlify[bot] 4f6cce6166 docs: sync skill with lastUpdatedDate frontmatter and auto-route fallback (#6980)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-14 10:15:29 -07:00
mintlify[bot] 49cd3dc018 Agent skill sync with docs: auto-route to preferred language (#6969)
* docs: sync Mintlify skill with auto-route to preferred language

* docs: tighten auto-route note in skill navigation reference

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-13 09:44:52 -07:00
Mayank Shouche 638248c1ba feat: generate kiro power in agent-context (#6916)
* feat: generate kiro power in agent-context

* Validate Kiro power artifacts against schemas
2026-08-12 16:33:16 -07:00
mintlify[bot] c83cf5cdcc docs: sync Mintlify skill with group-level and page-level SDK config (#6963)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-12 10:07:21 -07:00
mintlify[bot] cd1e123d27 Agent skill sync with docs: GitHub component, OpenAPI file uploads, playground JS (#6955)
* docs: sync Mintlify skill with new component, OpenAPI file uploads, and playground JS API

* docs: split long sentence in runtime server variables section

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-11 10:52:37 -07:00
mintlify[bot] c3e8f37dc1 docs: document mint index command in Mintlify skill (#6911)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-07 09:13:37 -07:00
Ethan Palm 646741de83 fix ParamField signature and fence nesting in components skill (#6899)
* docs: fix ParamField signature and fence nesting in components skill

ParamField examples used a dot-prefixed path prop (path="query.limit")
that contradicts the documented signature, where the prop name is the
parameter location and its value is the parameter name. CodeGroup,
RequestExample/ResponseExample, and View examples nested fenced code
inside a 3-backtick outer fence, which CommonMark closes early; switch
to 4-backtick outer fences like the existing Mermaid example.

Fixes #6897

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

* docs: fix CodeGroup fence in Mintlify skill

* docs: refresh contextual menu identifiers in Mintlify skill

* docs: correct page mode theme support in Mintlify skill

* docs: refresh CLI coverage in Mintlify skill

* docs: complete API language list in Mintlify skill

* docs: document SDK reference navigation in Mintlify skill

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-06 09:28:03 -07:00
Ethan Palm b796c23e14 add product context skill 2026-07-24 17:10:51 -07:00
Ethan Palm 00d565ef2a Agent context single source (#6747)
* WIP

* remove plugin-specific MCP info

* remove artifact digest

* fix stray writeFile import line left over from digest removal

* 💅

* bug bot
2026-07-24 17:01:49 -07:00