A browser-first tool that exports an API governance ruleset into agent-native artifacts — so the agents now writing and editing APIs can follow the rules while authoring, not just fail them after linting. No backend, no accounts; runs entirely in your browser. Live at agents.apicommons.org.
A Spectral ruleset is built to be executed. But an AI agent generating an API needs the same rules before it acts, as guidance it can read. This tool turns a ruleset into the artifacts that do that.
Part of the API Commons tools, alongside API Validator, API Governance MCP, Governance Coverage, and Spectral Ruleset Studio.
| Artifact | What it is |
|---|---|
| AGENTS.md governance block | Imperative rules (MUST / SHOULD / MAY) for the emerging AGENTS.md / agents.md repo convention, grouped by section — a coding agent follows them while authoring. |
| System-prompt instruction set | A compact, token-efficient priming block to steer an LLM/agent, rules ordered by strength. |
| Remediation prompt pack | The catalog's per-rule AI-remediation prompt fields as a JSON map keyed by rule id — an agent looks up the exact fix for a violation. |
| Compact rule digest | A machine-readable checklist (id, requirement, where, severity, tags) stripped of Spectral execution detail, for an agent to self-check against. |
Severity maps to strength for the prose artifacts: error → MUST, warn/info →
SHOULD (an agent should follow them while authoring), hint → MAY.
Pick a format (OpenAPI, AsyncAPI, Arazzo, …) and optionally filter by consumer
experience or a search term, then copy or download any of the four artifacts. Or switch
the source to Paste your own and drop in a Spectral ruleset (rules: map) to export
your governance.
It pairs with the Validator (which enforces the rules) and the Governance MCP (which lets an agent lint on demand): export the guidance here so the agent writes it right the first time, enforce with the others.
npm install
npm run data # rebuild public/rules.json from ../api-validator/rules/all-rules.yaml
npm run dev
npm run build # → dist/npm run data snapshots the catalog (id, title, description, message, given, severity,
tags, and the remediation prompt) into the committed
public/rules.json, so CI only runs vite build.
Everything runs client-side. Any ruleset you paste never leaves the page — there is no server.
Governance guidance — the human why: Guidance and Rules at guidance.apievangelist.com.
A project of API Evangelist, maintained openly under API Commons. Free to fork; API Evangelist offers expert API governance services when you want help. Apache-2.0.