Restructure AI docs into agentic-coding and vibe-coding

[atharvadeosthale]

• Split /docs/tooling/ai/ai-dev-tools into /agentic-coding (IDEs + CLI agents) and /vibe-coding (prompt-to-app tools); delete legacy /docs/tooling/mcp section
• Update all active refs (sidebar, AI overview, marketing, partial, responsible-ai); redirects cover old /mcp/* and /ai-dev-tools/* paths

[appwrite]

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)

Site	Status	Logs	Preview	QR
website 69d7f2670014e24571ca	Building	View Logs	Preview URL

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)

Site	Status	Logs	Preview	QR
website 68496a17000f03d62013	Queued	View Logs	Preview URL

---

Tip

Realtime gives you live updates for users, storage, functions, and databases

[greptile-apps]

Greptile Summary

This PR restructures the AI tooling docs by splitting the old /docs/tooling/ai/ai-dev-tools tree into /agents (IDE and CLI agent tools) and /vibe-coding (prompt-to-app platforms), and removes the legacy /docs/tooling/mcp section entirely. Redirects are added for all old /ai-dev-tools/* and /mcp/* paths, and references are updated across the sidebar, marketing pages, and the docs landing page.

• All card hrefs and sidebar links are updated consistently in the layout, AI overview page, marketing components, and the MCP partial; redirects cover every deleted path.
• Windsurf's page (/docs/tooling/ai/agents/windsurf) exists and has active redirects pointing to it, but the deleted MCP layout was the only sidebar that listed it — the new AI layout sidebar omits Windsurf entirely, leaving the page undiscoverable by navigation.
• src/routes/docs/+page.svelte was only partially updated: codex was migrated to the canonical agents/ path, while claude-code and cursor still reference the old /docs/tooling/mcp/ paths (functional via redirect, but inconsistent).

Confidence Score: 4/5

Safe to merge with one fix: the Windsurf docs page becomes undiscoverable after the MCP sidebar is removed.

The restructure is thorough and all redirects are in place, but deleting the MCP layout leaves the Windsurf page with no sidebar entry, no docs-landing card, and no marketing link — users can only reach it via a direct URL or an inbound redirect.

src/routes/docs/tooling/ai/+layout.svelte — the IDEs sidebar section needs a Windsurf entry to match the page that was renamed to agents/windsurf.

Important Files Changed

Filename	Overview
src/routes/docs/tooling/ai/+layout.svelte	Sidebar hrefs updated to new agents/ and vibe-coding/ paths; Windsurf page exists at agents/windsurf but has no sidebar entry after the MCP layout (the only place it was listed) was deleted.
src/redirects.json	Comprehensive redirects added for all old /docs/tooling/ai/ai-dev-tools/* paths; existing /docs/tooling/mcp/* redirects updated to point to new agents/ or vibe-coding/ destinations.
src/routes/docs/+page.svelte	Vibe-coding links updated; claude-code and cursor IDE entries still use old /docs/tooling/mcp/ paths (work via redirect, but inconsistent with the updated codex entry).
src/partials/mcp-add-ides-tools.md	All card hrefs updated to new agents/ and vibe-coding/ paths in both light and dark variants.
src/routes/(marketing)/(components)/ai.svelte	All tool hrefs updated to new agents/ paths correctly.
src/routes/(marketing)/(components)/platforms.svelte	Codex and Lovable hrefs updated to agents/ and vibe-coding/ paths.
src/routes/docs/tooling/ai/+page.markdoc	All card hrefs for agentic and vibe-coding sections updated to new paths in both light and dark variants.
src/routes/docs/tooling/mcp/+layout.svelte	Deleted as part of MCP section removal; all linked paths have redirects covering external inbound links.

Comments Outside Diff (1)

1. src/routes/docs/tooling/ai/+layout.svelte, line 50-76 (link)

   Windsurf missing from sidebar after MCP section deletion

   The old /docs/tooling/mcp/+layout.svelte (deleted by this PR) was the only sidebar that listed Windsurf. The new AI layout sidebar's "IDEs" section includes Claude Code, Codex, Cursor, VS Code, OpenCode, and Google Antigravity — but omits Windsurf. The page at /docs/tooling/ai/agents/windsurf exists and has active redirects pointing to it, but there is no sidebar link for it, no entry in the docs landing page (+page.svelte), and no marketing card, making it undiscoverable via navigation after this restructure.

_{Reviews (3): Last reviewed commit: "Rename agentic-coding to agents" | Re-trigger Greptile}