Remove clean markdown generation and artifacts.

.github/workflows/llmstxt.yml

@@ -2,8 +2,19 @@ name: Generate LLMs.txt
 
 on:
   workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - "app/en/**/*.mdx"
+      - "app/en/**/_meta.tsx"
+      - "scripts/generate-llmstxt.ts"
   pull_request:
     types: [opened, synchronize, reopened]
+    paths:
+      - "app/en/**/*.mdx"
+      - "app/en/**/_meta.tsx"
+      - "scripts/generate-llmstxt.ts"
 
 permissions:
   contents: write
@@ -73,6 +84,12 @@ jobs:
             evantahler
             torresmateo
 
+      - name: Request team review
+        if: steps.check-changes.outputs.has_changes == 'true' && steps.cpr.outputs.pull-request-number != ''
+        continue-on-error: true
+        run: gh pr edit ${{ steps.cpr.outputs.pull-request-number }} --add-reviewer ArcadeAI/engineering-tools-and-dx
+        env:
+          GH_TOKEN: ${{ secrets.DOCS_PUBLISHABLE_GH_TOKEN }}
       - name: Enable Pull Request Automerge
         if: steps.check-changes.outputs.has_changes == 'true' && github.event_name != 'pull_request'
         run: gh pr merge --squash --auto ${{ steps.cpr.outputs.pull-request-number }}

CLAUDE.md

@@ -15,6 +15,7 @@ pnpm vale:check       # Check docs against style rules
 ```
 
 Run a single test:
+
 ```bash
 pnpm vitest run tests/broken-link-check.test.ts
 ```
@@ -26,7 +27,7 @@ pnpm vitest run tests/broken-link-check.test.ts
 - **`app/_lib/`** — Data-fetching utilities (toolkit catalog, slug generation, static params).
 - **`app/api/`** — API routes (markdown export, toolkit-data, glossary).
 - **`toolkit-docs-generator/`** — Generates MCP toolkit documentation from server metadata JSON files in `toolkit-docs-generator/data/toolkits/`.
-- **`scripts/`** — Build/CI scripts (clean markdown export, Vale style fixes, redirect checking, pagefind indexing, i18n sync).
+- **`scripts/`** — Build/CI scripts (Vale style fixes, redirect checking, pagefind indexing, i18n sync).
 - **`tests/`** — Vitest tests (broken links, internal link validation, sitemap, smoke tests).
 - **`lib/`** — Next.js utilities (glossary remark plugin, llmstxt plugin).
 - **`next.config.ts`** — Contains ~138 redirect rules.

app/_components/copy-page-override.tsx

@@ -10,15 +10,16 @@ const DROPDOWN_IDENTIFIER = "Markdown for LLMs";
 
 /**
  * This component overrides the default nextra-theme-docs "Copy page" button behavior
- * to fetch clean markdown from our API instead of copying raw MDX source.
+ * to fetch markdown from our API instead of copying raw MDX source.
  */
 export function CopyPageOverride() {
   const pathname = usePathname();
 
   const fetchAndCopyMarkdown = useCallback(async (): Promise<boolean> => {
     try {
-      const markdownUrl = `/api/markdown${pathname}.md`;
-      const response = await fetch(markdownUrl);
+      const response = await fetch(pathname, {
+        headers: { Accept: "text/markdown" },
+      });
 
       if (!response.ok) {
         throw new Error(`Failed to fetch markdown: ${response.status}`);

app/_components/toolkit-docs/components/page-actions.tsx

@@ -1,16 +1,10 @@
 "use client";
 
-import { Check, Copy, ExternalLink } from "lucide-react";
-import { usePathname } from "next/navigation";
-import { useCallback, useState } from "react";
+import { ExternalLink } from "lucide-react";
 
 const GITHUB_JSON_BASE_URL =
   "https://github.com/ArcadeAI/docs/blob/main/toolkit-docs-generator/data/toolkits";
-const COPY_FEEDBACK_MS = 2000;
 
-/**
- * Builds the GitHub URL for editing the toolkit JSON file.
- */
 function buildGithubEditUrl(toolkitId: string): string {
   const jsonFileName = `${toolkitId.toLowerCase()}.json`;
   return `${GITHUB_JSON_BASE_URL}/${jsonFileName}`;
@@ -20,11 +14,6 @@ type EditJsonOnGithubProps = {
   toolkitId: string;
 };
 
-/**
- * EditJsonOnGithub
- *
- * Renders a link to edit the toolkit JSON file on GitHub.
- */
 export function EditJsonOnGithub({ toolkitId }: EditJsonOnGithubProps) {
   const editUrl = buildGithubEditUrl(toolkitId);
 
@@ -42,72 +31,16 @@ export function EditJsonOnGithub({ toolkitId }: EditJsonOnGithubProps) {
   );
 }
 
-/**
- * CopyPageButton
- *
- * Simple button that copies the generated markdown content on click.
- * Styled to match Nextra's native copy button.
- */
-function CopyPageButton() {
-  const pathname = usePathname();
-  const [copied, setCopied] = useState(false);
-  const [loading, setLoading] = useState(false);
-
-  const handleCopy = useCallback(async () => {
-    if (loading) {
-      return;
-    }
-
-    setLoading(true);
-    try {
-      const response = await fetch(`/api/markdown${pathname}.md`);
-      if (!response.ok) {
-        throw new Error("Failed to fetch markdown");
-      }
-      const content = await response.text();
-      await navigator.clipboard.writeText(content);
-      setCopied(true);
-      setTimeout(() => setCopied(false), COPY_FEEDBACK_MS);
-    } catch {
-      // Silent fail - user can retry
-    } finally {
-      setLoading(false);
-    }
-  }, [pathname, loading]);
-
-  return (
-    <button
-      className="inline-flex items-center gap-2 rounded-md border border-neutral-700 bg-neutral-800/50 px-3 py-1.5 font-medium text-sm text-neutral-200 transition-colors hover:bg-neutral-700/50 disabled:opacity-50"
-      disabled={loading}
-      onClick={handleCopy}
-      type="button"
-    >
-      {copied ? (
-        <Check className="h-4 w-4 text-green-400" />
-      ) : (
-        <Copy className="h-4 w-4" />
-      )}
-      {copied ? "Copied!" : "Copy page"}
-    </button>
-  );
-}
-
 type PageActionsBarProps = {
   toolkitId: string;
 };
 
-/**
- * PageActionsBar
- *
- * Renders the page actions bar with copy button and edit link.
- */
 export function PageActionsBar({ toolkitId }: PageActionsBarProps) {
   return (
     <div
       className="mb-4 flex flex-wrap items-center justify-end gap-4"
       data-toolkit-page-actions
     >
-      <CopyPageButton />
       <EditJsonOnGithub toolkitId={toolkitId} />
     </div>
   );