From 82fefeb2b47f6e7fd0914fb0a768b42d77305ce7 Mon Sep 17 00:00:00 2001 From: jottakka Date: Thu, 16 Jul 2026 11:20:57 -0300 Subject: [PATCH 1/2] docs: describe the CI-driven llms.txt workflow Clarify that production builds no longer generate llms.txt and point contributors to the workflow-backed generation path. Co-authored-by: Cursor --- CLAUDE.md | 4 ++-- README.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index d0d643b17..56088322c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,7 +6,7 @@ Arcade documentation site built with Next.js + Nextra (App Router), using pnpm a ```bash pnpm dev # Local dev server (port 3000) -pnpm build # Full production build (toolkit-markdown → next build → pagefind) +pnpm build # Full Next.js production build pnpm lint # Lint with Ultracite (Biome-based) pnpm format # Auto-format with Ultracite pnpm test # Run all Vitest tests @@ -27,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 (Vale style fixes, redirect checking, pagefind indexing, i18n sync). +- **`scripts/`** — Build/CI scripts (Vale style fixes, redirect checking, llms.txt generation, 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. diff --git a/README.md b/README.md index 33d97c1d2..d6afafb16 100644 --- a/README.md +++ b/README.md @@ -54,11 +54,11 @@ The `vale:fix` command requires an API key in `.env.local`. Without one, you can - [STYLEGUIDE.md](./STYLEGUIDE.md) - Writing standards for voice, tone, and structure - [AGENTS.md](./AGENTS.md) - Instructions for AI assistants working on docs -## llms.txt Generation +## llms.txt generation -The project includes a Next.js plugin that automatically generates an `llms.txt` file following the [llms.txt specification](https://llmstxt.org/). This file helps LLMs understand and navigate the documentation. +The project includes a script that generates an `llms.txt` file following the [llms.txt specification](https://llmstxt.org/). This file helps LLMs understand and navigate the documentation. -**Automatic generation**: Runs during production builds (`pnpm build`) +**Automatic generation**: Runs in the `Generate LLMs.txt` GitHub workflow **Manual generation**: Run `pnpm llmstxt` to regenerate the file From e361ce450c939129eb0d8d299aba38d5108de10e Mon Sep 17 00:00:00 2001 From: jottakka Date: Thu, 16 Jul 2026 16:08:10 -0300 Subject: [PATCH 2/2] docs: remove stale llms.txt plugin reference Keep contributor architecture guidance aligned with the CI-driven llms.txt generator. Co-authored-by: Cursor --- CLAUDE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 56088322c..b7ed87149 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -29,7 +29,7 @@ pnpm vitest run tests/broken-link-check.test.ts - **`toolkit-docs-generator/`** — Generates MCP toolkit documentation from server metadata JSON files in `toolkit-docs-generator/data/toolkits/`. - **`scripts/`** — Build/CI scripts (Vale style fixes, redirect checking, llms.txt generation, i18n sync). - **`tests/`** — Vitest tests (broken links, internal link validation, sitemap, smoke tests). -- **`lib/`** — Next.js utilities (glossary remark plugin, llmstxt plugin). +- **`lib/`** — Next.js utilities (glossary remark plugin). - **`next.config.ts`** — Contains ~138 redirect rules. ## Content Authoring