feat: migrate all 61 v1 tutorials to format_version v2

- Add format_version: v2 to frontmatter of all 61 remaining tutorials
- Add "Why This Track Matters" section to all 61 (tutorial-specific)
- Add "Mental Model" heading above existing mermaid diagrams (42 tutorials)
- Fix heading mismatches to pass v2 validator
- Add missing "What You Will Learn" sections (8 tutorials)
- 191/191 tutorials now pass v2 format validation

Author: johnxie

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"
         }
       ]
     },

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
 

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)

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.
 

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"
     },
     {

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"

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

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,054 |
 
 ## Source Verification Snapshot
 

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,17 @@ 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
+
 ## 🎯 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 +47,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 +106,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 +118,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

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: