refactor: rename 13 tutorial directories to consistent -tutorial suffix

README.md

@@ -71,7 +71,7 @@ Use this quick-start map if you searched for a specific outcome.
 | task-driven autonomous agents | [BabyAGI](tutorials/babyagi-tutorial/) | [AutoGen](tutorials/autogen-tutorial/) → [CrewAI](tutorials/crewai-tutorial/) → [LangGraph](tutorials/langgraph-tutorial/) |
 | build RAG systems | [LlamaIndex](tutorials/llamaindex-tutorial/) | [Haystack](tutorials/haystack-tutorial/) → [RAGFlow](tutorials/ragflow-tutorial/) |
 | run LLMs locally or at scale | [Ollama](tutorials/ollama-tutorial/) | [llama.cpp](tutorials/llama-cpp-tutorial/) → [vLLM](tutorials/vllm-tutorial/) → [LiteLLM](tutorials/litellm-tutorial/) |
-| build AI apps with TypeScript/Next.js | [Vercel AI SDK](tutorials/vercel-ai-tutorial/) | [CopilotKit](tutorials/copilotkit-tutorial/) → [LobeChat](tutorials/lobechat-ai-platform/) |
+| build AI apps with TypeScript/Next.js | [Vercel AI SDK](tutorials/vercel-ai-tutorial/) | [CopilotKit](tutorials/copilotkit-tutorial/) → [LobeChat](tutorials/lobechat-tutorial/) |
 | taskade ai / genesis / mcp workflows | [Taskade](tutorials/taskade-tutorial/) | [Taskade Docs](tutorials/taskade-docs-tutorial/) → [Taskade MCP](tutorials/taskade-mcp-tutorial/) → [Taskade Awesome Vibe Coding](tutorials/taskade-awesome-vibe-coding-tutorial/) → [MCP Servers](tutorials/mcp-servers-tutorial/) |
 | build MCP tools and integrations | [MCP Python SDK](tutorials/mcp-python-sdk-tutorial/) | [FastMCP](tutorials/fastmcp-tutorial/) → [MCP Servers](tutorials/mcp-servers-tutorial/) → [MCP Quickstart Resources](tutorials/mcp-quickstart-resources-tutorial/) → [Create Python Server](tutorials/create-python-server-tutorial/) → [MCP Docs Repo](tutorials/mcp-docs-repo-tutorial/) → [Create TypeScript Server](tutorials/create-typescript-server-tutorial/) → [Awesome MCP Servers](tutorials/awesome-mcp-servers-tutorial/) → [Composio](tutorials/composio-tutorial/) → [Daytona](tutorials/daytona-tutorial/) → [GenAI Toolbox](tutorials/genai-toolbox-tutorial/) → [awslabs/mcp](tutorials/awslabs-mcp-tutorial/) → [MCP Inspector](tutorials/mcp-inspector-tutorial/) → [MCP Registry](tutorials/mcp-registry-tutorial/) → [MCP Specification](tutorials/mcp-specification-tutorial/) → [MCP TypeScript SDK](tutorials/mcp-typescript-sdk-tutorial/) → [MCP Go SDK](tutorials/mcp-go-sdk-tutorial/) → [MCP Rust SDK](tutorials/mcp-rust-sdk-tutorial/) → [MCP Java SDK](tutorials/mcp-java-sdk-tutorial/) → [MCP C# SDK](tutorials/mcp-csharp-sdk-tutorial/) → [MCP Swift SDK](tutorials/mcp-swift-sdk-tutorial/) → [MCP Kotlin SDK](tutorials/mcp-kotlin-sdk-tutorial/) → [MCP Ruby SDK](tutorials/mcp-ruby-sdk-tutorial/) → [MCP PHP SDK](tutorials/mcp-php-sdk-tutorial/) → [MCP Ext Apps](tutorials/mcp-ext-apps-tutorial/) → [MCPB](tutorials/mcpb-tutorial/) → [use-mcp](tutorials/use-mcp-tutorial/) → [MCP Use](tutorials/mcp-use-tutorial/) → [MCP Chrome](tutorials/mcp-chrome-tutorial/) → [Firecrawl MCP Server](tutorials/firecrawl-mcp-server-tutorial/) |
 
@@ -252,9 +252,9 @@ Full-stack AI chat platforms and copilots.
 
 | Tutorial | Stars | Stack | What You'll Learn |
 |:---------|:-----:|:------|:------------------|
-| **[LobeChat](tutorials/lobechat-ai-platform/)** | 71K+ | Next.js | Modern AI chat, plugins, theming |
-| **[Dify](tutorials/dify-platform-deep-dive/)** | 60K+ | Python/React | Visual LLM app builder |
-| **[Flowise](tutorials/flowise-llm-orchestration/)** | 35K+ | Node.js/React | Visual LLM workflow orchestration |
+| **[LobeChat](tutorials/lobechat-tutorial/)** | 71K+ | Next.js | Modern AI chat, plugins, theming |
+| **[Dify](tutorials/dify-tutorial/)** | 60K+ | Python/React | Visual LLM app builder |
+| **[Flowise](tutorials/flowise-tutorial/)** | 35K+ | Node.js/React | Visual LLM workflow orchestration |
 | **[CopilotKit](tutorials/copilotkit-tutorial/)** | 15K+ | React/TypeScript | In-app AI copilots |
 | **[Chatbox](tutorials/chatbox-tutorial/)** | 24K+ | JavaScript/React | Multi-provider chat client |
 | **[Vercel AI SDK](tutorials/vercel-ai-tutorial/)** | 21K+ | TypeScript | AI-powered React/Next.js apps |
@@ -293,7 +293,7 @@ AI coding assistants, build systems, and dev infrastructure.
 | **[Claude Task Master](tutorials/claude-task-master-tutorial/)** | - | TypeScript | AI-powered task management |
 | **[CopilotKit](tutorials/copilotkit-tutorial/)** | 15K+ | React | In-app AI assistants |
 | **[Nanocoder](tutorials/nanocoder-tutorial/)** | - | TypeScript | AI coding agent internals |
-| **[Codex Analysis](tutorials/codex-analysis-platform/)** | - | TypeScript | Static analysis platform and LSP architecture |
+| **[Codex Analysis](tutorials/codex-analysis-tutorial/)** | - | TypeScript | Static analysis platform and LSP architecture |
 | **[Turborepo](tutorials/turborepo-tutorial/)** | 27K+ | Rust | High-performance monorepo builds |
 | **[n8n AI](tutorials/n8n-ai-tutorial/)** | 52K+ | Node.js | Visual AI workflow automation |
 | **[Activepieces](tutorials/activepieces-tutorial/)** | 20.8K+ | TypeScript | Open-source automation platform, custom pieces, and admin governance |
@@ -411,15 +411,15 @@ Data platforms, knowledge management, and observability.
 |:---------|:-----:|:------|:------------------|
 | **[Supabase](tutorials/supabase-tutorial/)** | 75K+ | PostgreSQL/TypeScript | Realtime DB, auth, edge functions |
 | **[PostHog](tutorials/posthog-tutorial/)** | 23K+ | Python/TypeScript | Product analytics, feature flags |
-| **[NocoDB](tutorials/nocodb-database-platform/)** | 50K+ | Node.js/Vue | Open-source Airtable alternative |
-| **[Teable](tutorials/teable-database-platform/)** | 15K+ | TypeScript/PostgreSQL | Multi-dimensional data platform |
+| **[NocoDB](tutorials/nocodb-tutorial/)** | 50K+ | Node.js/Vue | Open-source Airtable alternative |
+| **[Teable](tutorials/teable-tutorial/)** | 15K+ | TypeScript/PostgreSQL | Multi-dimensional data platform |
 | **[SiYuan](tutorials/siyuan-tutorial/)** | 25K+ | Go/TypeScript | Privacy-first knowledge management |
-| **[Logseq](tutorials/logseq-knowledge-management/)** | 34K+ | ClojureScript | Local-first knowledge graph |
+| **[Logseq](tutorials/logseq-tutorial/)** | 34K+ | ClojureScript | Local-first knowledge graph |
 | **[OpenBB](tutorials/openbb-tutorial/)** | 35K+ | Python | Open-source financial terminal |
-| **[Athens Research](tutorials/athens-research-knowledge-graph/)** | - | ClojureScript | Graph-based knowledge system |
-| **[Obsidian Outliner](tutorials/obsidian-outliner-plugin/)** | - | TypeScript | Obsidian plugin architecture |
+| **[Athens Research](tutorials/athens-research-tutorial/)** | - | ClojureScript | Graph-based knowledge system |
+| **[Obsidian Outliner](tutorials/obsidian-outliner-tutorial/)** | - | TypeScript | Obsidian plugin architecture |
 | **[ClickHouse](tutorials/clickhouse-tutorial/)** | 39K+ | C++ | Column-oriented analytics DB |
-| **[PostgreSQL Planner](tutorials/postgresql-query-planner/)** | - | C | Query planning internals |
+| **[PostgreSQL Planner](tutorials/postgresql-tutorial/)** | - | C | Query planning internals |
 | **[MeiliSearch](tutorials/meilisearch-tutorial/)** | 48K+ | Rust | Lightning-fast search engine |
 | **[PhotoPrism](tutorials/photoprism-tutorial/)** | 36K+ | Go | AI-powered photo management |
 | **[Liveblocks](tutorials/liveblocks-tutorial/)** | 4K+ | TypeScript | Real-time collaboration infra |
@@ -431,10 +431,10 @@ Low-level systems, cloud native, and infrastructure patterns.
 
 | Tutorial | Stars | Stack | What You'll Learn |
 |:---------|:-----:|:------|:------------------|
-| **[Kubernetes Operators](tutorials/kubernetes-operator-patterns/)** | - | Go | Production-grade K8s operator patterns |
-| **[React Fiber](tutorials/react-fiber-internals/)** | - | JavaScript | React reconciler internals |
+| **[Kubernetes Operators](tutorials/kubernetes-operator-tutorial/)** | - | Go | Production-grade K8s operator patterns |
+| **[React Fiber](tutorials/react-fiber-tutorial/)** | - | JavaScript | React reconciler internals |
 | **[Dyad](tutorials/dyad-tutorial/)** | 19K+ | TypeScript | Local AI app development |
-| **[LangChain Architecture](tutorials/langchain-architecture-guide/)** | - | Python | LangChain deep architecture guide |
+| **[LangChain Architecture](tutorials/langchain-architecture-tutorial/)** | - | Python | LangChain deep architecture guide |
 | **[n8n MCP](tutorials/n8n-mcp-tutorial/)** | - | TypeScript | Model Context Protocol with n8n |
 | **[Firecrawl](tutorials/firecrawl-tutorial/)** | 22K+ | Python | LLM-ready web data extraction |
 

categories/databases-storage.md

@@ -13,17 +13,17 @@
 | Goal | Recommended Starting Tutorial | Next Tutorials |
 |:-----|:------------------------------|:---------------|
 | Build app backends quickly | [Supabase](../tutorials/supabase-tutorial/) | [PostHog](../tutorials/posthog-tutorial/) |
-| Understand Airtable-style platforms | [NocoDB](../tutorials/nocodb-database-platform/) | [Teable](../tutorials/teable-database-platform/) |
+| Understand Airtable-style platforms | [NocoDB](../tutorials/nocodb-tutorial/) | [Teable](../tutorials/teable-tutorial/) |
 | Learn search and retrieval systems | [MeiliSearch](../tutorials/meilisearch-tutorial/) | [Chroma](../tutorials/chroma-tutorial/) → [LanceDB](../tutorials/lancedb-tutorial/) |
-| Learn analytical internals | [ClickHouse](../tutorials/clickhouse-tutorial/) | [PostgreSQL Planner](../tutorials/postgresql-query-planner/) |
-| Build knowledge systems | [Logseq](../tutorials/logseq-knowledge-management/) | [Athens Research](../tutorials/athens-research-knowledge-graph/) |
+| Learn analytical internals | [ClickHouse](../tutorials/clickhouse-tutorial/) | [PostgreSQL Planner](../tutorials/postgresql-tutorial/) |
+| Build knowledge systems | [Logseq](../tutorials/logseq-tutorial/) | [Athens Research](../tutorials/athens-research-tutorial/) |
 
 ## Featured Data Tutorial Tracks
 
-- [NocoDB](../tutorials/nocodb-database-platform/)
-- [Teable](../tutorials/teable-database-platform/)
+- [NocoDB](../tutorials/nocodb-tutorial/)
+- [Teable](../tutorials/teable-tutorial/)
 - [ClickHouse](../tutorials/clickhouse-tutorial/)
-- [PostgreSQL Query Planner](../tutorials/postgresql-query-planner/)
+- [PostgreSQL Query Planner](../tutorials/postgresql-tutorial/)
 - [MeiliSearch](../tutorials/meilisearch-tutorial/)
 - [Liveblocks](../tutorials/liveblocks-tutorial/)
 

categories/systems-programming.md

@@ -12,16 +12,16 @@
 
 | Goal | Recommended Starting Tutorial | Next Tutorials |
 |:-----|:------------------------------|:---------------|
-| Learn React internals | [React Fiber](../tutorials/react-fiber-internals/) | [LangChain Architecture](../tutorials/langchain-architecture-guide/) |
-| Learn production K8s control loops | [Kubernetes Operators](../tutorials/kubernetes-operator-patterns/) | [n8n MCP](../tutorials/n8n-mcp-tutorial/) |
+| Learn React internals | [React Fiber](../tutorials/react-fiber-tutorial/) | [LangChain Architecture](../tutorials/langchain-architecture-tutorial/) |
+| Learn production K8s control loops | [Kubernetes Operators](../tutorials/kubernetes-operator-tutorial/) | [n8n MCP](../tutorials/n8n-mcp-tutorial/) |
 | Learn web-scale data extraction | [Firecrawl](../tutorials/firecrawl-tutorial/) | [OpenHands](../tutorials/openhands-tutorial/) for autonomous SWE workflows |
 | Learn local-first app runtime design | [Dyad](../tutorials/dyad-tutorial/) | [VibeSDK](../tutorials/vibesdk-tutorial/) |
 
 ## Featured Systems Tracks
 
-- [Kubernetes Operator Patterns](../tutorials/kubernetes-operator-patterns/)
-- [React Fiber Internals](../tutorials/react-fiber-internals/)
-- [LangChain Architecture Guide](../tutorials/langchain-architecture-guide/)
+- [Kubernetes Operator Patterns](../tutorials/kubernetes-operator-tutorial/)
+- [React Fiber Internals](../tutorials/react-fiber-tutorial/)
+- [LangChain Architecture Guide](../tutorials/langchain-architecture-tutorial/)
 - [Firecrawl](../tutorials/firecrawl-tutorial/)
 
 ## Related Hubs

categories/web-frameworks.md

@@ -11,19 +11,19 @@
 
 | Goal | Recommended Starting Tutorial | Next Tutorials |
 |:-----|:------------------------------|:---------------|
-| Build AI apps with TypeScript | [Vercel AI SDK](../tutorials/vercel-ai-tutorial/) | [CopilotKit](../tutorials/copilotkit-tutorial/) → [LobeChat](../tutorials/lobechat-ai-platform/) |
+| Build AI apps with TypeScript | [Vercel AI SDK](../tutorials/vercel-ai-tutorial/) | [CopilotKit](../tutorials/copilotkit-tutorial/) → [LobeChat](../tutorials/lobechat-tutorial/) |
 | Build chat/product interfaces | [Chatbox](../tutorials/chatbox-tutorial/) | [Open WebUI](../tutorials/open-webui-tutorial/) → [Perplexica](../tutorials/perplexica-tutorial/) |
-| Understand visual workflow products | [Flowise](../tutorials/flowise-llm-orchestration/) | [Dify](../tutorials/dify-platform-deep-dive/) |
+| Understand visual workflow products | [Flowise](../tutorials/flowise-tutorial/) | [Dify](../tutorials/dify-tutorial/) |
 | Build with vibe-coding UX patterns | [Stagewise](../tutorials/stagewise-tutorial/) | [Dyad](../tutorials/dyad-tutorial/) → [bolt.diy](../tutorials/bolt-diy-tutorial/) → [VibeSDK](../tutorials/vibesdk-tutorial/) |
 
 ## Featured Framework/App Tracks
 
 - [Vercel AI SDK](../tutorials/vercel-ai-tutorial/)
 - [CopilotKit](../tutorials/copilotkit-tutorial/)
-- [LobeChat](../tutorials/lobechat-ai-platform/)
+- [LobeChat](../tutorials/lobechat-tutorial/)
 - [Stagewise](../tutorials/stagewise-tutorial/)
-- [Flowise](../tutorials/flowise-llm-orchestration/)
-- [Dify](../tutorials/dify-platform-deep-dive/)
+- [Flowise](../tutorials/flowise-tutorial/)
+- [Dify](../tutorials/dify-tutorial/)
 
 ## Related Hubs
 

discoverability/query-coverage.json

@@ -382,27 +382,27 @@
           "title": "CopilotKit Tutorial: Building AI Copilots for React Applications"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-tutorial/README.md",
           "intent_signals": [
             "architecture-deep-dive"
           ],
-          "slug": "lobechat-ai-platform",
+          "slug": "lobechat-tutorial",
           "title": "LobeChat AI Platform: Deep Dive Tutorial"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-tutorial/README.md",
           "intent_signals": [
             "architecture-deep-dive"
           ],
-          "slug": "flowise-llm-orchestration",
+          "slug": "flowise-tutorial",
           "title": "Flowise LLM Orchestration: Deep Dive Tutorial"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-tutorial/README.md",
           "intent_signals": [
             "architecture-deep-dive"
           ],
-          "slug": "dify-platform-deep-dive",
+          "slug": "dify-tutorial",
           "title": "Dify Platform: Deep Dive Tutorial"
         },
         {

discoverability/query-hub.md

@@ -139,11 +139,11 @@ Recommended tutorials:
   - Build robust AI product features with vercel/ai, including streaming, structured outputs, tool loops, framework integration, and production deployment patterns.
 - [CopilotKit Tutorial: Building AI Copilots for React Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/copilotkit-tutorial/README.md)
   - Create in-app AI assistants, chatbots, and agentic UIs with the open-source CopilotKit framework.
-- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-ai-platform/README.md)
+- [LobeChat AI Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/lobechat-tutorial/README.md)
   - LobeChat — An open-source, modern-design AI chat framework for building private LLM applications.
-- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-llm-orchestration/README.md)
+- [Flowise LLM Orchestration: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/flowise-tutorial/README.md)
   - Flowise — An open-source visual tool for building LLM workflows with a drag-and-drop interface.
-- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-platform-deep-dive/README.md)
+- [Dify Platform: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dify-tutorial/README.md)
   - Dify — An open-source LLM application development platform for building workflows, RAG pipelines, and AI agents with a visual interface.
 - [Open WebUI Tutorial: Self-Hosted AI Workspace and Chat Interface](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/open-webui-tutorial/README.md)
   - Learn how to run and operate open-webui/open-webui as a self-hosted AI interface with model routing, RAG workflows, multi-user controls, and production deployment patterns.

discoverability/release-claims-report.json

@@ -16,7 +16,7 @@
     },
     {
       "age_days": 1302,
-      "file": "tutorials/athens-research-knowledge-graph/README.md",
+      "file": "tutorials/athens-research-tutorial/README.md",
       "line": "- latest release: [`v2.0.0`](https://github.com/athensresearch/athens/releases/tag/v2.0.0) (published 2022-08-22)",
       "line_number": 119,
       "parsed_date": "2022-08-22"
@@ -51,7 +51,7 @@
     },
     {
       "age_days": 166,
-      "file": "tutorials/codex-analysis-platform/README.md",
+      "file": "tutorials/codex-analysis-tutorial/README.md",
       "line": "- latest release: [`v5.9.3`](https://github.com/microsoft/TypeScript/releases/tag/v5.9.3) (published 2025-10-01)",
       "line_number": 31,
       "parsed_date": "2025-10-01"
@@ -156,7 +156,7 @@
     },
     {
       "age_days": 182,
-      "file": "tutorials/teable-database-platform/README.md",
+      "file": "tutorials/teable-tutorial/README.md",
       "line": "- latest release: [`v1.10.0`](https://github.com/teableio/teable/releases/tag/v1.10.0) (published 2025-09-15)",
       "line_number": 123,
       "parsed_date": "2025-09-15"