johnxie · johnxie · Mar 21, 2026
diff --git a/discoverability/query-coverage.json b/discoverability/query-coverage.json
@@ -457,12 +457,12 @@
           "title": "Fireproof Tutorial: Local-First Document Database for AI-Native Apps"
         },
         {
-          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md",
+          "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md",
           "intent_signals": [
             "general-learning"
           ],
-          "slug": "botpress-tutorial",
-          "title": "Botpress Tutorial: Open Source Conversational AI Platform"
+          "slug": "comfyui-tutorial",
+          "title": "ComfyUI Tutorial: Mastering AI Image Generation Workflows"
         }
       ]
     },

diff --git a/discoverability/query-hub.md b/discoverability/query-hub.md
@@ -157,8 +157,8 @@ Recommended tutorials:
   - Learn how to use activepieces/activepieces to build, run, and govern production automation workflows with open-source extensibility, piece development, API control, and self-hosted operations.
 - [Fireproof Tutorial: Local-First Document Database for AI-Native Apps](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/fireproof-tutorial/README.md)
   - Learn how to use fireproof-storage/fireproof to build local-first, encrypted, sync-capable applications with a unified browser/Node/Deno API and React hooks.
-- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
-  - This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications
+- [ComfyUI Tutorial: Mastering AI Image Generation Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md)
+  - A deep technical walkthrough of ComfyUI covering Mastering AI Image Generation Workflows.
 
 ## Taskade AI, Genesis, and MCP Workflows
 

diff --git a/discoverability/search-intent-map.md b/discoverability/search-intent-map.md
@@ -8,14 +8,12 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
 
 ## ai-app-frameworks
 
-- tutorial_count: **27**
+- tutorial_count: **26**
 
 - [Activepieces Tutorial: Open-Source Automation, Pieces, and AI-Ready Workflow Operations](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md)
   - intents: production-operations
 - [BentoML Tutorial: Building Production-Ready ML Services](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bentoml-tutorial/README.md)
   - intents: production-operations
-- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
-  - intents: general-learning
 - [Chatbox Tutorial: Building Modern AI Chat Interfaces](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/chatbox-tutorial/README.md)
   - intents: general-learning
 - [ComfyUI Tutorial: Mastering AI Image Generation Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/comfyui-tutorial/README.md)
@@ -60,7 +58,9 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
   - intents: general-learning
 - [Turborepo Tutorial: High-Performance Monorepo Build System](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/turborepo-tutorial/README.md)
   - intents: general-learning
-- ... plus 2 more tutorials in this cluster
+- [Vercel AI SDK Tutorial: Production TypeScript AI Apps and Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/vercel-ai-tutorial/README.md)
+  - intents: production-operations
+- ... plus 1 more tutorials in this cluster
 
 ## ai-coding-agents
 
@@ -141,8 +141,10 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
 
 ## general-software
 
-- tutorial_count: **16**
+- tutorial_count: **17**
 
+- [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
+  - intents: production-operations
 - [Claude Task Master Tutorial: AI-Powered Task Management for Developers](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/claude-task-master-tutorial/README.md)
   - intents: general-learning
 - [DSPy Tutorial: Programming Language Models](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/dspy-tutorial/README.md)

diff --git a/discoverability/tutorial-directory.md b/discoverability/tutorial-directory.md
@@ -53,7 +53,7 @@ This page is auto-generated from the tutorial index and is intended as a fast br
 - [bolt.diy Tutorial: Build and Operate an Open Source AI App Builder](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/bolt-diy-tutorial/README.md)
   - A production-focused deep dive into stackblitz-labs/bolt.diy: architecture, provider routing, safe edit loops, MCP integrations, deployment choices, and operational governance.
 - [Botpress Tutorial: Open Source Conversational AI Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md)
-  - This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications
+  - Important Notice (2025): Botpress v12 has been sunset and is no longer available for new deployments. However, existing customers with active v12 subscriptions remain fully supported.
 - [Browser Use Tutorial: AI-Powered Web Automation Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/browser-use-tutorial/README.md)
   - Learn how to use browser-use/browser-use to build agents that can navigate websites, execute workflows, and run reliable browser automation in production.
 

diff --git a/discoverability/tutorial-index.json b/discoverability/tutorial-index.json
@@ -662,27 +662,36 @@
       "title": "bolt.diy Tutorial: Build and Operate an Open Source AI App Builder"
     },
     {
-      "cluster": "ai-app-frameworks",
+      "cluster": "general-software",
       "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md",
       "index_path": "tutorials/botpress-tutorial/README.md",
       "intent_signals": [
-        "general-learning"
+        "production-operations"
       ],
       "keywords": [
         "botpress",
         "open",
         "source",
         "conversational",
-        "comprehensive",
-        "will",
-        "powerful",
-        "building",
-        "applications"
+        "important",
+        "notice",
+        "v12",
+        "has",
+        "been",
+        "sunset",
+        "longer",
+        "available",
+        "new",
+        "deployments",
+        "however",
+        "existing",
+        "customers",
+        "active"
       ],
       "path": "tutorials/botpress-tutorial",
       "repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/botpress-tutorial",
       "slug": "botpress-tutorial",
-      "summary": "This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications",
+      "summary": "Important Notice (2025): Botpress v12 has been sunset and is no longer available for new deployments. However, existing customers with active v12 subscriptions remain fully supported.",
       "title": "Botpress Tutorial: Open Source Conversational AI Platform"
     },
     {

diff --git a/discoverability/tutorial-itemlist.schema.json b/discoverability/tutorial-itemlist.schema.json
@@ -158,7 +158,7 @@
     },
     {
       "@type": "ListItem",
-      "description": "This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications",
+      "description": "Important Notice (2025): Botpress v12 has been sunset and is no longer available for new deployments. However, existing customers with active v12 subscriptions remain fully supported.",
       "name": "Botpress Tutorial: Open Source Conversational AI Platform",
       "position": 23,
       "url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md"

diff --git a/llms-full.txt b/llms-full.txt
@@ -138,8 +138,8 @@ Main repository:
 ## Botpress Tutorial: Open Source Conversational AI Platform
 - Path: tutorials/botpress-tutorial
 - Index: https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/botpress-tutorial/README.md
-- Summary: This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications
-- Keywords: botpress, open, source, conversational, comprehensive, will, powerful, building, applications
+- Summary: Important Notice (2025): Botpress v12 has been sunset and is no longer available for new deployments. However, existing customers with active v12 subscriptions remain fully supported.
+- Keywords: botpress, open, source, conversational, important, notice, v12, has, been, sunset, longer, available, new, deployments, however, existing, customers, active
 
 ## Browser Use Tutorial: AI-Powered Web Automation Agents
 - Path: tutorials/browser-use-tutorial

diff --git a/tutorials/README.md b/tutorials/README.md
@@ -16,7 +16,7 @@ Use this guide to navigate all tutorial tracks, understand structure rules, and
 |:-------|:------|
 | Tutorial directories | 191 |
 | Tutorial markdown files | 1722 |
-| Tutorial markdown lines | 1,048,148 |
+| Tutorial markdown lines | 1,049,121 |
 
 ## Source Verification Snapshot
 

diff --git a/tutorials/ag2-tutorial/README.md b/tutorials/ag2-tutorial/README.md
@@ -3,6 +3,7 @@ layout: default
 title: "AG2 Tutorial"
 nav_order: 73
 has_children: true
+format_version: v2
 ---
 
 # AG2 Tutorial: Next-Generation Multi-Agent Framework
@@ -19,6 +20,20 @@ has_children: true
 
 ---
 
+## Why This Track Matters
+
+AG2 is increasingly relevant for developers working with modern AI/ML infrastructure. Build collaborative AI agent systems with AG2, the community-driven successor to AutoGen, and this track helps you understand the architecture, key patterns, and production considerations.
+
+This track focuses on:
+
+- **Create Conversational Agents** that collaborate through natural dialogue
+- **Implement Code Execution** safely with Docker sandboxing
+- **Build Multi-Agent Systems** with group chat coordination
+- **Integrate External Tools** through function calling
+- **Design Complex Workflows** with nested and sequential patterns
+- **Handle Human-in-the-Loop** scenarios effectively
+- **Deploy Production Systems** with proper scaling and monitoring
+
 ## 🎯 What is AG2?
 
 **AG2**<sup>[View Repo](https://github.com/ag2ai/ag2)</sup> is the community-driven successor to Microsoft's AutoGen framework. It provides a powerful, open-source platform for building AI agents that can collaborate to solve complex tasks through natural conversation.
@@ -35,6 +50,9 @@ has_children: true
 
 > **Note**: The original AutoGen creators transitioned to AG2 to promote open governance. Microsoft continues developing AutoGen as part of their Agent Framework.
 
+
+## Mental Model
+
 ```mermaid
 flowchart TD
     A[User Task] --> B[AssistantAgent]
@@ -91,7 +109,7 @@ flowchart TD
 - **Group Chat** - Multiple agents collaborating
 - **Nested Chat** - Hierarchical agent structures
 
-## Tutorial Chapters
+## Chapter Guide
 
 1. **[Chapter 1: Getting Started](01-getting-started.md)** - Installation, setup, and your first AG2 agents
 2. **[Chapter 2: Agent Types](02-agent-types.md)** - Understanding and configuring different agents
@@ -103,7 +121,7 @@ flowchart TD
 8. **[Chapter 8: Production Deployment](08-production.md)** - Scaling, monitoring, and best practices
 9. **[Chapter 9: Enterprise Operations](09-enterprise-operations.md)** - Governance, evals, safety, and cost/perf tuning
 
-## What You'll Learn
+## What You Will Learn
 
 - **Create Conversational Agents** that collaborate through natural dialogue
 - **Implement Code Execution** safely with Docker sandboxing

diff --git a/tutorials/agentgpt-tutorial/README.md b/tutorials/agentgpt-tutorial/README.md
@@ -3,6 +3,7 @@ layout: default
 title: "AgentGPT Tutorial"
 nav_order: 14
 has_children: true
+format_version: v2
 ---
 
 # AgentGPT Tutorial: Building Autonomous AI Agents
@@ -18,6 +19,9 @@ AgentGPT<sup>[View Repo](https://github.com/reworkd/AgentGPT)</sup> is a platfor
 
 AgentGPT shows how to build AI systems that can break down complex objectives into manageable tasks, use various tools and APIs, and execute plans autonomously while maintaining safety and reliability.
 
+
+## Mental Model
+
 ```mermaid
 flowchart TD
     A[User Goal] --> B[Task Planning]
@@ -44,7 +48,18 @@ flowchart TD
     class K,L learning
 ```
 
-## Tutorial Chapters
+## Why This Track Matters
+
+AgentGPT is increasingly relevant for developers working with modern AI/ML infrastructure. A deep technical walkthrough of AgentGPT covering Building Autonomous AI Agents, and this track helps you understand the architecture, key patterns, and production considerations.
+
+This track focuses on:
+
+- understanding getting started with agentgpt
+- understanding agent architecture & design
+- understanding task planning & goal setting
+- understanding tool integration & apis
+
+## Chapter Guide
 
 Welcome to your journey through autonomous AI agent development! This tutorial explores how to build intelligent agents that can plan, execute, and learn autonomously.
 
@@ -64,7 +79,7 @@ Welcome to your journey through autonomous AI agent development! This tutorial e
 - latest release: [`v.1.0.0`](https://github.com/reworkd/AgentGPT/releases/tag/v.1.0.0) (published 2023-11-02)
 - status: **archived**
 
-## What You'll Learn
+## What You Will Learn
 
 By the end of this tutorial, you'll be able to:
 

diff --git a/tutorials/autogen-tutorial/README.md b/tutorials/autogen-tutorial/README.md
@@ -3,6 +3,7 @@ layout: default
 title: "Microsoft AutoGen Tutorial"
 nav_order: 21
 has_children: true
+format_version: v2
 ---
 
 # Microsoft AutoGen Tutorial: Building Multi-Agent AI Systems
@@ -18,6 +19,9 @@ Microsoft AutoGen<sup>[View Repo](https://github.com/microsoft/autogen)</sup> is
 
 AutoGen provides a flexible architecture for creating agent-based systems that can work together to accomplish tasks that would be difficult or impossible for a single AI model.
 
+
+## Mental Model
+
 ```mermaid
 flowchart TD
     A[User Request] --> B[Task Analysis]
@@ -45,7 +49,18 @@ flowchart TD
     class F output
 ```
 
-## Tutorial Chapters
+## Why This Track Matters
+
+Microsoft AutoGen is increasingly relevant for developers working with modern AI/ML infrastructure. A deep technical walkthrough of Microsoft AutoGen covering Building Multi-Agent AI Systems, and this track helps you understand the architecture, key patterns, and production considerations.
+
+This track focuses on:
+
+- understanding getting started with microsoft autogen
+- understanding agent architecture & roles
+- understanding agent communication
+- understanding tool integration
+
+## Chapter Guide
 
 Welcome to your journey through multi-agent AI systems! This tutorial explores how to build collaborative AI agents that can work together to solve complex problems.
 
@@ -64,7 +79,7 @@ Welcome to your journey through multi-agent AI systems! This tutorial explores h
 - stars: about **55.7k**
 - latest release: [`python-v0.7.5`](https://github.com/microsoft/autogen/releases/tag/python-v0.7.5) (published 2025-09-30)
 
-## What You'll Learn
+## What You Will Learn
 
 By the end of this tutorial, you'll be able to:
 

diff --git a/tutorials/bentoml-tutorial/README.md b/tutorials/bentoml-tutorial/README.md
@@ -3,6 +3,7 @@ layout: default
 title: "BentoML Tutorial"
 nav_order: 22
 has_children: true
+format_version: v2
 ---
 
 # BentoML Tutorial: Building Production-Ready ML Services
@@ -18,6 +19,9 @@ BentoML<sup>[View Repo](https://github.com/bentoml/BentoML)</sup> is the unified
 
 BentoML simplifies the ML deployment process by providing tools for model packaging, API serving, monitoring, and scaling, making it easy to take models from development to production.
 
+
+## Mental Model
+
 ```mermaid
 flowchart TD
     A[ML Model] --> B[BentoML Service]
@@ -49,7 +53,18 @@ flowchart TD
     class F output
 ```
 
-## Tutorial Chapters
+## Why This Track Matters
+
+BentoML is increasingly relevant for developers working with modern AI/ML infrastructure. A deep technical walkthrough of BentoML covering Building Production-Ready ML Services, and this track helps you understand the architecture, key patterns, and production considerations.
+
+This track focuses on:
+
+- understanding getting started with bentoml
+- understanding model packaging & services
+- understanding api development
+- understanding framework integration
+
+## Chapter Guide
 
 Welcome to your journey through production ML deployment! This tutorial explores how to build, deploy, and manage machine learning models at scale with BentoML.
 
@@ -68,7 +83,7 @@ Welcome to your journey through production ML deployment! This tutorial explores
 - stars: about **8.5k**
 - latest release: [`v1.4.36`](https://github.com/bentoml/BentoML/releases/tag/v1.4.36) (published 2026-03-06)
 
-## What You'll Learn
+## What You Will Learn
 
 By the end of this tutorial, you'll be able to:
 

diff --git a/tutorials/botpress-tutorial/README.md b/tutorials/botpress-tutorial/README.md
@@ -3,6 +3,7 @@ layout: default
 title: "Botpress Tutorial"
 nav_order: 24
 has_children: true
+format_version: v2
 ---
 
 # Botpress Tutorial: Open Source Conversational AI Platform
@@ -17,7 +18,18 @@ has_children: true
 
 ---
 
-## 🎯 What You'll Learn
+## Why This Track Matters
+
+Botpress is increasingly relevant for developers working with modern AI/ML infrastructure. **Important Notice (2025)**: Botpress v12 has been sunset and is no longer available for new deployments. However, existing customers with active v12 subscriptions remain fully supported, and this track helps you understand the architecture, key patterns, and production considerations.
+
+This track focuses on:
+
+- understanding getting started with botpress
+- understanding visual flow builder
+- understanding natural language understanding
+- understanding custom actions & code
+
+## What You Will Learn
 
 This comprehensive tutorial will guide you through Botpress, a powerful open source platform for building conversational AI applications:
 
@@ -35,7 +47,7 @@ This comprehensive tutorial will guide you through Botpress, a powerful open sou
 - stars: about **14.6k**
 - latest release: [`v12.30.9`](https://github.com/botpress/botpress/releases/tag/v12.30.9) (published 2023-06-22)
 
-## 📚 Tutorial Chapters
+## Chapter Guide
 
 1. **[Getting Started with Botpress](01-getting-started.md)** - Installation, setup, and first chatbot
 2. **[Visual Flow Builder](02-visual-flow-builder.md)** - Designing conversation flows
@@ -62,6 +74,9 @@ bp dev
 
 ## 🏗️ Architecture Overview
 
+
+## Mental Model
+
 ```mermaid
 graph TB
     A[User Interface] --> B[Botpress Studio]