Skip to content

docs: align positioning to "actions runtime for enterprise AI agents"#1039

Open
torresmateo wants to merge 4 commits into
mainfrom
positioning/actions-runtime-alignment
Open

docs: align positioning to "actions runtime for enterprise AI agents"#1039
torresmateo wants to merge 4 commits into
mainfrom
positioning/actions-runtime-alignment

Conversation

@torresmateo

@torresmateo torresmateo commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator

What

Aligns the docs' top-of-funnel and machine-readable copy with the canonical Arcade Product Messaging Framework (Google Doc).

Canonical positioning applied:

  • Tagline: "Arcade is the actions runtime for enterprise AI agents" (drops "the only runtime for MCP" / "MCP Runtime" — MCP is the protocol, not the positioning; scope is enterprise).
  • Pillars: Enforce / Execute / Govern, paired with the searchable capability terms (Agent Authorization, Agent-Optimized Tools, Agent Lifecycle Governance) so keyword retrieval is preserved.
  • Enforce framed broadly — existing security stack (IdP/DLP/SIEM/compliance) plus per-action authorization, not just OAuth.

Changes

Finding File Change
P0 #1–3 scripts/generate-llmstxt.ts Rewrote the > blockquote + description to lead with "actions runtime for enterprise AI agents"; named Enforce/Execute/Govern; replaced 1000s with 7,500+ across 81 MCP servers
P1 #4–5 app/en/home/landing-page.tsx Hero H1 "MCP Runtime…" → "The actions runtime for enterprise AI agents."; reframed subhead to Enforce/Execute/Govern
P2 #7 app/en/home/landing-page.tsx "How Arcade Works" cards relabeled to Enforce — Agent Authorization / Execute — Agent-Optimized Tools / Govern — Agent Lifecycle Governance
P2 #6 app/en/get-started/about-arcade/page.mdx Broadened from auth-only to the three pillars; kept agent authorization as the Enforce deep-dive
P3 #8 app/layout.tsx Root meta description now carries the positioning sentence
P3 #10 app/en/home/page.mdx Home frontmatter description carries positioning + pillar keywords
#9 landing page + 4 agent-framework MDX overviews Tool count 7,000+7,500+ repo-wide

Notes

  • public/llms.txt not edited directly — it's generated from scripts/generate-llmstxt.ts and regenerates on the next build (source-only change, per review decision).
  • No asserted XX% proof points were introduced — the framework lists those as unfilled placeholders.
  • Vale style check runs in CI (the binary isn't installed in this environment, so it was skipped locally; lint/format hooks passed).
  • The <Button render=…> TypeScript diagnostics in landing-page.tsx are pre-existing (untouched design-system JSX), not introduced here.

🤖 Generated with Claude Code


Note

Low Risk
Copy and metadata only; no application logic, auth, or API behavior changes.

Overview
Repositions docs and marketing copy from MCP runtime framing to "Arcade is the actions runtime for enterprise AI agents", with Enforce / Execute / Govern paired to Agent Authorization, Agent-Optimized Tools, and Agent Lifecycle Governance.

The home landing page hero, subhead, integration CTAs, and How Arcade Works cards are rewritten around those pillars (including updated card links and icons). About Arcade gets new frontmatter plus an opening three-pillar section before the existing agent-authorization deep dive.

SEO and LLM-facing copy updates root generateMetadata, home page frontmatter, and the static header blocks in scripts/generate-llmstxt.ts (replacing "only runtime for MCP" and vague tool counts with 7,500+ across 81 MCP servers). Agent-framework overview/setup pages bump 7,000+ → 7,500+ for consistency.

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

Aligns top-of-funnel and machine-readable copy with the canonical Arcade
Product Messaging Framework: tagline "the actions runtime for enterprise AI
agents" and the Enforce / Execute / Govern pillars (paired with the searchable
capability terms Agent Authorization, Agent-Optimized Tools, Agent Lifecycle
Governance).

- llms.txt generator: rewrite blockquote + description to lead with "actions
  runtime for enterprise AI agents"; replace "1000s" with 7,500+/81 servers
  (public/llms.txt regenerates on next build)
- Landing hero: drop "MCP Runtime" → "The actions runtime for enterprise AI
  agents"; reframe subhead and "How Arcade Works" cards to Enforce/Execute/Govern
- About Arcade: broaden from auth-only to the three pillars; keep agent
  authorization as the Enforce deep-dive
- Root + home meta descriptions carry the positioning sentence
- Normalize tool count 7,000+ → 7,500+ repo-wide

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 29, 2026 2:54pm

Request Review

Comment thread app/en/home/landing-page.tsx Outdated
Comment thread app/en/home/landing-page.tsx Outdated
torresmateo and others added 2 commits June 29, 2026 11:51
Address review: Enforce is the umbrella, not a replacement for the managed-auth
language. Restore explicit OAuth, user-token, API-key, and secrets management
across the hero subhead, the Enforce card, the About-page Enforce bullet, and
the llms.txt Enforce description.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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