docs: 1.7.0 release

astro.config.mjs

@@ -1,6 +1,7 @@
 // @ts-check
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
+import llmsTxt from 'starlight-llms-txt';
 
 // https://astro.build/config
 export default defineConfig({
@@ -28,36 +29,78 @@ export default defineConfig({
 					href: 'https://github.com/gaia-react/gaia',
 				},
 			],
+			plugins: [
+				// Generates /llms.txt, /llms-full.txt, /llms-small.txt, and per-set files
+				// so Claude Code (and other agents) can ingest these docs cleanly.
+				llmsTxt({
+					projectName: 'GAIA',
+					description:
+						'GAIA is a React and TypeScript framework that ships with a Claude Code configuration layer: slash commands, skills, hooks, rules, and agents that give Claude structure and focus when working in the codebase. Scaffold a project with `npx create-gaia my-app`. This documentation covers installing GAIA and using its commands, skills, and supporting machinery.',
+					details: [
+						'GAIA has two audiences.',
+						'',
+						'Adopters run `npx create-gaia` and get a scaffolded project with the commands, skills, hooks, rules, and agents that ship in the release.',
+						'',
+						'Contributors work on the GAIA template repo itself and additionally have the release tooling, bundled CLI internals, CI workflows, and wiki internals documented under `contributors/`.',
+						'',
+						'The abridged documentation below covers adopter surface only. Contributor documentation is available as a separate set.',
+					].join('\n'),
+					// Lead with install, then follow the sidebar order.
+					promote: [
+						'index*',
+						'getting-started/**',
+						'workflow/**',
+						'maintenance/**',
+						'skills/**',
+						'reference/**',
+					],
+					// Push contributor pages to the end of llms-full.txt (they sort near
+					// the top alphabetically otherwise).
+					demote: ['contributors/**'],
+					// Keep contributor-only surface out of the compact adopter file.
+					exclude: ['contributors/**'],
+					customSets: [
+						{
+							label: 'Contributor documentation',
+							paths: ['contributors/**'],
+							description:
+								'for people working on the GAIA template repo itself: CI workflows, the bundled CLI, releases, health audits, and wiki internals. Not needed if you installed GAIA with `npx create-gaia`.',
+						},
+					],
+				}),
+			],
 			sidebar: [
 				{
 					label: 'Getting started',
 					items: [
 						{ label: 'Quick Start', slug: 'index' },
 						{ label: '/gaia-init', slug: 'getting-started/gaia-init' },
-						{ label: '/setup-gaia-ci', slug: 'getting-started/setup-gaia-ci' },
-						{ label: '/setup-cloned-gaia-project', slug: 'getting-started/setup-cloned-gaia-project' },
+						{ label: '/setup-gaia', slug: 'getting-started/setup-gaia' },
 					],
 				},
 				{
-					label: 'Commands',
+					label: 'Workflow',
 					items: [
-						{ label: 'Overview', slug: 'commands' },
-						{ label: '/gaia-plan', slug: 'commands/plan' },
-						{ label: '/gaia-spec', slug: 'commands/spec' },
-						{ label: '/gaia-handoff and pickup', slug: 'commands/handoff-pickup' },
-						{ label: '/gaia-forensics', slug: 'commands/forensics' },
-						{ label: '/update-deps', slug: 'commands/update-deps' },
-						{ label: '/update-gaia', slug: 'commands/update-gaia' },
+						{ label: 'Overview', slug: 'workflow' },
+						{ label: '/gaia-spec', slug: 'workflow/spec' },
+						{ label: '/gaia-plan', slug: 'workflow/plan' },
+						{ label: '/gaia-handoff', slug: 'workflow/handoff' },
+						{ label: '/gaia-pickup', slug: 'workflow/pickup' },
+						{ label: '/gaia-forensics', slug: 'workflow/forensics' },
 					],
 				},
 				{
 					label: 'Maintenance',
 					items: [
 						{ label: 'Overview', slug: 'maintenance' },
-						{ label: '/gaia-fitness', slug: 'commands/fitness' },
-						{ label: '/gaia-audit', slug: 'commands/audit' },
-						{ label: '/gaia-harden', slug: 'commands/harden' },
-						{ label: '/gaia-wiki', slug: 'commands/wiki' },
+						{ label: 'GAIA CI', slug: 'maintenance/gaia-ci' },
+						{ label: '/gaia-fitness', slug: 'maintenance/fitness' },
+						{ label: '/gaia-audit', slug: 'maintenance/audit' },
+						{ label: '/gaia-debt', slug: 'maintenance/debt' },
+						{ label: '/gaia-harden', slug: 'maintenance/harden' },
+						{ label: '/gaia-wiki', slug: 'maintenance/wiki' },
+						{ label: '/update-deps', slug: 'maintenance/update-deps' },
+						{ label: '/update-gaia', slug: 'maintenance/update-gaia' },
 					],
 				},
 				{
@@ -66,6 +109,7 @@ export default defineConfig({
 						{ label: 'Overview', slug: 'skills' },
 						{ label: 'Code skills', slug: 'skills/code' },
 						{ label: 'Scaffolders', slug: 'skills/scaffolders' },
+						{ label: 'React performance', slug: 'skills/react-performance' },
 					],
 				},
 				{
@@ -78,6 +122,7 @@ export default defineConfig({
 				},
 				{
 					label: 'Contributors',
+					collapsed: true,
 					items: [
 						{ label: 'Overview', slug: 'contributors' },
 						{ label: 'CI workflows', slug: 'contributors/ci' },

package.json

@@ -11,9 +11,10 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.39.1",
-    "astro": "^6.2.2",
-    "sharp": "^0.34.5"
+    "@astrojs/starlight": "^0.41.2",
+    "astro": "^7.0.5",
+    "sharp": "^0.35.3",
+    "starlight-llms-txt": "^0.11.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": [