docs: port coding-agents → build-with-agents rename to shell-docs#5023
Merged
Conversation
…-docs PR #4927 landed this rename in the legacy `docs/` tree, but `showcase/shell-docs` has its own content directory that was never updated. Changes: - Rename 11 `coding-agents.mdx` → `build-with-agents.mdx` (root + 10 integrations) - Update frontmatter title "Coding Agents" → "Build with agents" in all 11 files - Update `"coding-agents"` → `"build-with-agents"` in 9 integration meta.json nav files - Update root meta.json: rename entry + add React Native under new ---Platforms--- section - seo-redirects.ts: update S4/S15 subpath destinations; add S16 (coding-agents→build-with-agents) subpath rename for all legacy framework slugs; add CODING_AGENTS_RENAMES for root + all canonical framework slugs; fix stale destinations in F20, R12, R18, R19 - docs-render.tsx: update SUBPATH_TO_COMPONENT key "coding-agents" → "build-with-agents"
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📣 Social Copy GeneratorGenerate social media copies (Twitter/X, LinkedIn, Blog Post) for this PR using Claude.
|
CANONICAL_FRAMEWORKS was referenced in CODING_AGENTS_RENAMES but never defined, causing a TypeScript error. Derive it from FRAMEWORKS.map(canonicalSlug) so all 13 canonical slugs (langgraph-python, google-adk, strands, etc.) get /coding-agents → /build-with-agents redirects.
…d-slug frameworks S16 in SUBPATH_RENAMES already generates /<fw>/coding-agents → /<fw>/build-with-agents for all 13 legacy frameworks including unchanged-slug ones (agno, ag2, pydantic-ai, llamaindex, mastra, agent-spec, a2a). Including them in CANONICAL_FRAMEWORKS created 7 duplicate source entries in the redirect table, corrupting PostHog decommission attribution (the CA×<fw> IDs would never get traffic). Restrict CANONICAL_FRAMEWORKS to frameworks whose canonical slug differs from their legacy slug (langgraph-python, google-adk, crewai-crews, ms-agent-dotnet, strands, built-in-agent) — these are the ones S16 can't cover since S16 sources use legacy slugs.
…d snippet The root /build-with-agents page had 290 lines of inline content that had drifted from the canonical mcp-server-setup.mdx snippet: wrong MCP endpoint paths (/mcp vs /sse), and missing Tadata attribution Callout that every per-framework build-with-agents page renders. Replace with <MCPSetup /> to use the same shared snippet as the langgraph integration page, ensuring the root page and all framework pages render identical, authoritative content from a single source of truth.
…t with main main added its own CANONICAL_FRAMEWORKS const after this branch was cut. CI tests the merge commit, so the duplicate declaration caused a build error. Replace with an inline derivation from FRAMEWORKS so the variable is self-contained and never conflicts with whatever main defines.
onsclom
changed the title
onsclom
requested review from
jpr5,
marthakelly,
mme,
ranst91 and
tylerslaton
as code owners
tylerslaton
approved these changes
May 26, 2026
5 tasks
onsclom
added a commit
that referenced
this pull request
May 27, 2026
…page (#5039) ## Summary Adds the Skills installation section to the shell-docs `/build-with-agents` page ## Changes **`showcase/shell-docs/src/content/snippets/shared/guides/build-with-agents.mdx`** (new) - Single source of truth for the page content - Intro paragraph, `## CopilotKit Skills` section (Callout + Steps: install + starter prompt), `<MCPSetup />` as second section **`showcase/shell-docs/src/content/docs/build-with-agents.mdx`** - Replaced inline content with `<BuildWithAgents />` — delegates to the shared snippet - Icon updated to `BrainCircuit`, description updated to keyword-rich copy, `hideTOC: true` removed **`showcase/shell-docs/src/content/docs/integrations/built-in-agent/build-with-agents.mdx`** - Replaced `<SharedContent />` with `<BuildWithAgents />` so the skills section appears here too (built-in-agent uses `docs_mode: authored` and never falls through to the root page) **`showcase/shell-docs/src/content/snippets/shared/guides/mcp-server-setup.mdx`** - `## Overview` → `## MCP Docs Server` **`showcase/shell-docs/src/lib/docs-render.tsx`** + **`mdx-registry.tsx`** - Register `BuildWithAgents` in `SNIPPET_MAP` and component registry ## Acceptance criteria status - [x] `/coding-agents` redirects to `/build-with-agents` (PR #5023) - [x] React Native moved to Platforms section (PR #4927 / #5023) - [x] `npx skills add` flow documented with skills link and starter prompt - [x] MCP server install instructions present (existing content, now labeled correctly) - [x] Page structure follows Mastra "Build with AI" reference
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Ports the changes from PR #4927 to the live shell-docs app. PR #4927 renamed `coding-agents` → `build-with-agents` in the legacy `docs/` tree, but `showcase/shell-docs` has its own independent content directory that was never updated.
Changes
Test plan