docs: add LLMs.txt and Changelog section

.changeset/chatty-breads-watch.md

@@ -0,0 +1,5 @@
+---
+"@stackflow/docs": minor
+---
+
+Add LLMs.txt and changelog section

docs/.gitignore

@@ -1,3 +1,6 @@
 /.next
 /out
-.open-next
+.open-next
+
+/public/llms-*.txt
+/public/llms.txt

docs/next.config.mjs

@@ -14,6 +14,9 @@ export default withNextra({
     defaultLocale: "en",
     localeDetection: false,
   },
+  typescript: {
+    ignoreBuildErrors: true,
+  },
 });
 
 import { initOpenNextCloudflareForDev } from "@opennextjs/cloudflare";

docs/package.json

@@ -5,7 +5,8 @@
   "description": "Mobile-first stack navigator framework with Composable Plugin System",
   "license": "MIT",
   "scripts": {
-    "build": "next build",
+    "build:llms": "yarn tsx scripts/generate-llms-txt.ts",
+    "build": "yarn build:llms && next build",
     "start": "next start",
     "dev": "next -p 6006",
     "preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
@@ -27,13 +28,17 @@
     "autoprefixer": "^10.4.20",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.1",
+    "gray-matter": "^4.0.3",
     "lucide-react": "^0.451.0",
     "next": "^14.2.4",
     "nextra": "^2.13.4",
     "nextra-theme-docs": "^2.13.4",
     "postcss": "^8.4.47",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "remark": "^15.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-stringify": "^11.0.0",
     "simple-reveal": "^0.8.0",
     "tailwind-merge": "^2.5.3",
     "tailwindcss": "^3.4.13"
@@ -42,6 +47,7 @@
     "@seed-design/stylesheet": "^1.0.4",
     "@types/node": "^22.7.5",
     "react-lazy-load-image-component": "^1.6.2",
+    "tsx": "^4.20.6",
     "typescript": "^5.6.3",
     "wrangler": "^4.12.1"
   }

docs/pages/docs/_meta.en.json

@@ -1,4 +1,6 @@
 {
   "get-started": "Get Started",
-  "advanced": "Advanced Usage"
+  "advanced": "Advanced Usage",
+  "ai-integration": "AI Integration",
+  "changelog": "Changelog"
 }

docs/pages/docs/_meta.ko.json

@@ -1,4 +1,6 @@
 {
   "get-started": "시작하기",
-  "advanced": "활용하기"
+  "advanced": "활용하기",
+  "ai-integration": "AI 통합",
+  "changelog": "변경 이력"
 }

docs/pages/docs/ai-integration/_meta.en.json

@@ -0,0 +1,3 @@
+{
+  "llms-txt": "LLMs.txt"
+}

docs/pages/docs/ai-integration/_meta.ko.json

@@ -0,0 +1,3 @@
+{
+  "llms-txt": "LLMs.txt"
+}

docs/pages/docs/ai-integration/llms-txt.en.mdx

@@ -0,0 +1,21 @@
+---
+title: LLMs.txt
+---
+
+# LLMs.txt
+
+We provide an LLMs.txt setup to help large language models (LLMs) easily understand Stackflow.
+
+### Structure
+
+We provide the following LLMs.txt files:
+
+- [llms.txt](https://stackflow.so/llms.txt): The main file that describes the structure of all LLMs.txt files.
+- [llms-full.txt](https://stackflow.so/llms-full.txt): Includes all Stackflow documentation.
+- [llms-changelog.txt](https://stackflow.so/llms-changelog.txt): Contains the latest updates and changes so you can review version-by-version history.
+
+### Using with AI tools
+#### Cursor
+You can include the LLMs.txt files in your project using Cursor's @Docs feature.
+
+[**Learn more about Cursor @Docs**](https://docs.cursor.com/context/@-symbols/@-docs)

docs/pages/docs/ai-integration/llms-txt.ko.mdx

@@ -0,0 +1,21 @@
+---
+title: LLMs.txt
+---
+
+# LLMs.txt
+
+대규모 언어 모델(LLM)이 Stackflow를 쉽게 이해할 수 있도록 LLMs.txt를 제공합니다.
+
+### 구조
+
+다음과 같은 LLMs.txt 파일들을 제공합니다:
+
+- [llms.txt](https://stackflow.so/llms.txt): LLMs.txt 파일들의 구조를 제공하는 메인 파일입니다.
+- [llms-full.txt](https://stackflow.so/llms-full.txt): Stackflow의 모든 문서를 포함합니다.
+- [llms-changelog.txt](https://stackflow.so/llms-changelog.txt): 최신 업데이트와 변경사항을 포함하여 버전별 변경 내역을 확인할 수 있습니다.
+
+### AI 도구와 함께 사용하기
+#### Cursor
+Cursor의 @Docs 기능을 사용하여 프로젝트에 LLMs.txt 파일을 포함할 수 있습니다.
+
+[**Cursor @Docs에 대해 자세히 알아보기**](https://docs.cursor.com/context/@-symbols/@-docs)

docs/pages/docs/changelog.en.mdx

@@ -0,0 +1,22 @@
+---
+title: Changelog
+---
+
+## 2025.10.24 #2
+
+Add LLMs.txt and changelog section
+
+Released packages:
+- 📦 [@stackflow/docs@2.1.0](https://npmjs.com/package/@stackflow/docs/v/2.1.0)
+
+---
+
+## 2025.10.24
+
+Add LLMs.txt and changelog section
+
+Released packages:
+- 📦 [@stackflow/docs@2.1.0](https://npmjs.com/package/@stackflow/docs/v/2.1.0)
+
+---
+

docs/pages/docs/changelog.ko.mdx

@@ -0,0 +1,22 @@
+---
+title: Changelog
+---
+
+## 2025.10.24 #2
+
+Add LLMs.txt and changelog section
+
+Released packages:
+- 📦 [@stackflow/docs@2.1.0](https://npmjs.com/package/@stackflow/docs/v/2.1.0)
+
+---
+
+## 2025.10.24
+
+Add LLMs.txt and changelog section
+
+Released packages:
+- 📦 [@stackflow/docs@2.1.0](https://npmjs.com/package/@stackflow/docs/v/2.1.0)
+
+---
+

docs/pages/docs/get-started/_meta.en.json

@@ -4,5 +4,6 @@
   "activity": "Activity",
   "navigating-activities": "Navigating Activities",
   "navigating-step": "Navigating Step",
-  "getting-state": "Getting State"
+  "getting-state": "Getting State",
+  "ai-integration": "AI Integration"
 }

docs/pages/docs/get-started/_meta.ko.json

@@ -4,5 +4,6 @@
   "activity": "액티비티",
   "navigating-activities": "액티비티 탐색하기",
   "navigating-step": "스텝 탐색하기",
-  "getting-state": "상태 가져오기"
+  "getting-state": "상태 가져오기",
+  "ai-integration": "AI 통합"
 }

docs/scripts/generate-llms-txt.ts

@@ -0,0 +1,70 @@
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { remark } from "remark";
+import remarkGfm from "remark-gfm";
+import remarkStringify from "remark-stringify";
+import { baseUrl } from "../utils/constants";
+import { getAllPages } from "../utils/get-all-pages";
+
+async function generateLlmsFull() {
+  const pages = getAllPages();
+  const content = pages
+    .map((page) => `# ${page.title}\n\n${page.content}`)
+    .join("\n\n");
+
+  const outputPath = path.join(process.cwd(), "public/llms-full.txt");
+  fs.writeFileSync(outputPath, content);
+  console.log(`Generated ${outputPath}`);
+}
+
+async function generateLlmsChangelog() {
+  const changelogPath = path.join(process.cwd(), "pages/docs/changelog.en.mdx");
+  const fileContent = fs.readFileSync(changelogPath, "utf-8");
+  const { content } = matter(fileContent);
+
+  const processed = await remark()
+    .use(remarkGfm)
+    .use(remarkStringify)
+    .process(content);
+
+  const response = `# Stackflow - Changelog\n\n${String(processed)}`;
+
+  const outputPath = path.join(process.cwd(), "public/llms-changelog.txt");
+  fs.writeFileSync(outputPath, response);
+  console.log(`Generated ${outputPath}`);
+}
+
+async function generateLlmsIndex() {
+  const content = `
+# Stackflow Documentation for LLMs
+
+## Documentation Sets
+
+- [llms-full.txt](${new URL("/llms-full.txt", baseUrl)}): Complete documentation of Stackflow
+- [llms-changelog.txt](${new URL("/llms-changelog.txt", baseUrl)}): Latest updates and version history
+`.trim();
+
+  const outputPath = path.join(process.cwd(), "public/llms.txt");
+  fs.writeFileSync(outputPath, content);
+  console.log(`Generated ${outputPath}`);
+}
+
+async function main() {
+  try {
+    // Ensure public directory exists
+    const publicDir = path.join(process.cwd(), "public");
+    if (!fs.existsSync(publicDir)) {
+      fs.mkdirSync(publicDir);
+    }
+
+    await generateLlmsFull();
+    await generateLlmsChangelog();
+    await generateLlmsIndex();
+  } catch (error) {
+    console.error("Error generating LLMS txt files:", error);
+    process.exit(1);
+  }
+}
+
+main();

docs/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": false,
+    "noEmit": true,
+    "incremental": true,
+    "module": "esnext",
+    "esModuleInterop": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve"
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

docs/utils/constants.ts

@@ -0,0 +1,4 @@
+export const baseUrl =
+  process.env.NODE_ENV === "development"
+    ? new URL("http://localhost:6006")
+    : new URL(process.env.NEXT_PUBLIC_SITE_URL || "https://stackflow.so");

docs/utils/get-all-pages.ts

@@ -0,0 +1,56 @@
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+
+interface Page {
+  path: string;
+  title: string;
+  description?: string;
+  content: string;
+  data: Record<string, any>;
+}
+
+export function getAllPages(): Page[] {
+  const pagesDir = path.join(process.cwd(), "pages");
+  const files = getAllMdxFiles(pagesDir);
+
+  return files
+    .map((filePath) => {
+      const relativePath = path.relative(pagesDir, filePath);
+      const fileContent = fs.readFileSync(filePath, "utf-8");
+      const { data, content } = matter(fileContent);
+
+      return {
+        path: relativePath,
+        title: data.title || "",
+        description: data.description,
+        content,
+        data,
+      };
+    })
+    .filter((page) => {
+      // API routes, _app, _document 등 제외
+      if (page.path.startsWith("api/")) return false;
+      if (page.path.startsWith("_")) return false;
+
+      return true;
+    })
+    .sort((a, b) => a.path.localeCompare(b.path));
+}
+
+function getAllMdxFiles(dir: string, fileList: string[] = []): string[] {
+  const files = fs.readdirSync(dir);
+
+  files.forEach((file) => {
+    const filePath = path.join(dir, file);
+    const stat = fs.statSync(filePath);
+
+    if (stat.isDirectory()) {
+      getAllMdxFiles(filePath, fileList);
+    } else if (file.endsWith(".mdx") || file.endsWith(".md")) {
+      fileList.push(filePath);
+    }
+  });
+
+  return fileList;
+}

package.json

@@ -11,19 +11,21 @@
     "packages/*",
     "extensions/*"
   ],
+  "type": "module",
   "scripts": {
     "build": "ultra -r build",
     "build:dts": "ultra -r --build build:dts",
     "clean": "ultra -r clean",
     "dev": "ultra -r --concurrency 100 dev",
     "format": "biome check --write .",
     "lint": "biome lint .",
-    "changeset:version": "changeset version && yarn install --no-immutable",
+    "changeset:version": "yarn generate:changelog && changeset version && yarn install --no-immutable",
     "release": "yarn clean && yarn build && changeset && yarn changeset:version && changeset publish",
     "release:canary": "yarn clean && yarn build && changeset pre enter canary && changeset && yarn changeset:version && changeset publish && changeset pre exit",
     "test": "yarn build && ultra -r test",
     "typecheck": "ultra -r typecheck",
-    "version": "yarn install && git stage yarn.lock"
+    "version": "yarn install && git stage yarn.lock",
+    "generate:changelog": "yarn node scripts/generate-changelog.ts"
   },
   "resolutions": {
     "@mdx-js/react": "3.0.1",
@@ -32,7 +34,13 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.1.4",
+    "@changesets/assemble-release-plan": "^6.0.9",
     "@changesets/cli": "^2.28.1",
+    "@changesets/config": "^3.1.1",
+    "@changesets/pre": "^2.0.2",
+    "@changesets/read": "^0.6.5",
+    "@changesets/types": "^6.1.0",
+    "@manypkg/get-packages": "~1.1.3",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.14.9",
     "@types/react": "^18.3.3",