feat: add 4 Genesis-strategic tutorials (AFFiNE, Plane, MetaGPT, A2A)

CONTENT_GAPS_ANALYSIS.md

@@ -6,8 +6,8 @@ This document tracks structural and quality gaps that impact completeness and di
 
 | Metric | Value |
 |:-------|:------|
-| Tutorial directories | 191 |
-| Tutorials with exactly 8 numbered chapters | 188 |
+| Tutorial directories | 195 |
+| Tutorials with exactly 8 numbered chapters | 192 |
 | Tutorials with >8 numbered chapters | 3 |
 | Tutorials with 0 numbered chapters | 0 |
 | Tutorials with partial chapter coverage (1-7) | 0 |

README.md

@@ -208,6 +208,8 @@ Build autonomous AI systems that reason, plan, and collaborate.
 | **[Open SWE](tutorials/open-swe-tutorial/)** | 5.3K+ | Python | Async cloud coding agent architecture and migration playbook |
 | **[HumanLayer](tutorials/humanlayer-tutorial/)** | 9.6K+ | Python | Context engineering and human-governed coding-agent workflows |
 | **[Wshobson Agents](tutorials/wshobson-agents-tutorial/)** | 29.9K+ | TypeScript | Pluginized multi-agent workflows with specialist Claude Code agents |
+| **[MetaGPT](tutorials/metagpt-tutorial/)** | 66K+ | Python | Multi-agent framework with role-based collaboration (PM, Architect, Engineer) for software generation |
+| **[A2A Protocol](tutorials/a2a-protocol-tutorial/)** | 23K+ | Python/TypeScript | Google's Agent-to-Agent protocol for cross-platform agent interoperability and discovery |
 
 ### 🧠 LLM Frameworks & RAG
 
@@ -266,6 +268,8 @@ Full-stack AI chat platforms and copilots.
 | **[GPT-OSS](tutorials/gpt-oss-tutorial/)** | 6.4K+ | TypeScript | Open-source GPT implementation |
 | **[Claude Quickstarts](tutorials/claude-quickstarts-tutorial/)** | 13.7K+ | Python/TypeScript | Production Claude integration patterns |
 | **[Cherry Studio](tutorials/cherry-studio-tutorial/)** | 40.5K+ | TypeScript | Multi-provider AI desktop workspace with assistants, documents, and MCP tools |
+| **[AFFiNE](tutorials/affine-tutorial/)** | 66K+ | TypeScript | Open-source Notion + Miro alternative with docs, whiteboards, databases, and AI copilot |
+| **[Plane](tutorials/plane-tutorial/)** | 47K+ | Python/TypeScript | AI-native project management with issues, cycles, modules, wiki, and AI features |
 
 ### 🔧 Developer Tools & Productivity
 

TUTORIAL_STRUCTURE.md

@@ -17,7 +17,7 @@ tutorials/<tutorial-name>/
 
 | Pattern | Count |
 |:--------|:------|
-| `root_only` | 191 |
+| `root_only` | 195 |
 | `docs_only` | 0 |
 | `index_only` | 0 |
 | `mixed` | 0 |

categories/ai-ml-platforms.md

@@ -167,6 +167,10 @@
 - [Vibe Kanban](../tutorials/vibe-kanban-tutorial/)
 - [Whisper Cpp](../tutorials/whisper-cpp-tutorial/)
 - [Wshobson Agents](../tutorials/wshobson-agents-tutorial/)
+- [AFFiNE](../tutorials/affine-tutorial/)
+- [Plane](../tutorials/plane-tutorial/)
+- [MetaGPT](../tutorials/metagpt-tutorial/)
+- [A2A Protocol](../tutorials/a2a-protocol-tutorial/)
 
 ## Suggest Additions
 

discoverability/query-hub.md

@@ -2,7 +2,7 @@
 
 Auto-generated high-intent query landing surface mapped to the most relevant tutorials.
 
-- Total tutorials indexed: **191**
+- Total tutorials indexed: **195**
 - Query hubs: **6**
 - Source: `scripts/generate_discoverability_assets.py`
 

discoverability/search-intent-map.md

@@ -2,13 +2,13 @@
 
 Auto-generated topical clusters to strengthen internal linking and query-to-tutorial mapping.
 
-- Total tutorials: **191**
+- Total tutorials: **195**
 - Total clusters: **9**
 - Source: `scripts/generate_discoverability_assets.py`
 
 ## ai-app-frameworks
 
-- tutorial_count: **25**
+- 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
@@ -50,6 +50,8 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
   - intents: production-operations
 - [OpenBB Tutorial: Complete Guide to Investment Research Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md)
   - intents: general-learning
+- [Plane Tutorial: AI-Native Project Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plane-tutorial/README.md)
+  - intents: general-learning
 - [Semantic Kernel Tutorial: Microsoft's AI Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md)
   - intents: general-learning
 - [Supabase Tutorial: Building Modern Backend Applications](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/supabase-tutorial/README.md)
@@ -58,13 +60,14 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
   - intents: general-learning
 - [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
-- [n8n AI Tutorial: Workflow Automation with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/README.md)
-  - intents: general-learning
+- ... plus 1 more tutorials in this cluster
 
 ## ai-coding-agents
 
-- tutorial_count: **85**
+- tutorial_count: **87**
 
+- [A2A Protocol Tutorial: Building Interoperable Agent Systems With Google's Agent-to-Agent Standard](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/a2a-protocol-tutorial/README.md)
+  - intents: agentic-coding
 - [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md)
   - intents: production-operations, agentic-coding
 - [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md)
@@ -113,14 +116,14 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
   - intents: agentic-coding
 - [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md)
   - intents: agentic-coding
-- [CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md)
-  - intents: agentic-coding
-- ... plus 60 more tutorials in this cluster
+- ... plus 62 more tutorials in this cluster
 
 ## data-and-storage
 
-- tutorial_count: **8**
+- tutorial_count: **9**
 
+- [AFFiNE Tutorial: Open-Source AI Workspace with Docs, Whiteboards, and Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/affine-tutorial/README.md)
+  - intents: general-learning
 - [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-tutorial/README.md)
   - intents: architecture-deep-dive
 - [ClickHouse Tutorial: High-Performance Analytical Database](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md)

discoverability/tutorial-directory.md

@@ -2,15 +2,19 @@
 
 This page is auto-generated from the tutorial index and is intended as a fast browse surface for contributors and search crawlers.
 
-- Total tutorials: **191**
+- Total tutorials: **195**
 - Source: `scripts/generate_discoverability_assets.py`
 
 ## A
 
+- [A2A Protocol Tutorial: Building Interoperable Agent Systems With Google's Agent-to-Agent Standard](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/a2a-protocol-tutorial/README.md)
+  - Learn how agents discover, communicate, and delegate tasks to each other using the A2A protocol — the open standard (now Linux Foundation) for agent-to-agent interoperability.
 - [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)
   - 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.
 - [ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/adk-python-tutorial/README.md)
   - Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.
+- [AFFiNE Tutorial: Open-Source AI Workspace with Docs, Whiteboards, and Databases](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/affine-tutorial/README.md)
+  - Learn how to use toeverything/AFFiNE to build, extend, and self-host a modern knowledge workspace combining documents, whiteboards, and databases — powered by BlockSuite, CRDT-based collaboration, and integrated AI copilot features.
 - [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md)
   - Build collaborative AI agent systems with AG2, the community-driven successor to AutoGen.
 - [AgentGPT Tutorial: Building Autonomous AI Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/agentgpt-tutorial/README.md)
@@ -284,6 +288,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
   - A deep technical walkthrough of MeiliSearch covering Lightning Fast Search Engine.
 - [Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mem0-tutorial/README.md)
   - A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.
+- [MetaGPT Tutorial: Multi-Agent Software Development with Role-Based Collaboration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/metagpt-tutorial/README.md)
+  - In one sentence: Give MetaGPT a product idea, and a virtual software company of AI agents designs, architects, codes, and tests it for you.
 - [Mini-SWE-Agent Tutorial: Minimal Autonomous Code Agent Design at Benchmark Scale](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md)
   - Learn how to use SWE-agent/mini-swe-agent to run compact, high-performing software-engineering agent workflows with minimal scaffolding and strong reproducibility.
 - [Mistral Vibe Tutorial: Minimal CLI Coding Agent by Mistral](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mistral-vibe-tutorial/README.md)
@@ -351,6 +357,8 @@ This page is auto-generated from the tutorial index and is intended as a fast br
   - AI Photo Management Revolution: Enhanced facial recognition, LLM integrations, and advanced organization features mark PhotoPrism's evolution.
 - [Plandex Tutorial: Large-Task AI Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/README.md)
   - Learn how to use plandex-ai/plandex for large codebase tasks with strong context management, cumulative diff review, model packs, and self-hosted operations.
+- [Plane Tutorial: AI-Native Project Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plane-tutorial/README.md)
+  - Open-source AI-native project management that rivals Jira and Linear — with issues, cycles, modules, and wiki built in.
 - [Planning with Files Tutorial: Persistent Markdown Workflow Memory for AI Coding Agents](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md)
   - Learn how to use OthmanAdi/planning-with-files to run Manus-style file-based planning workflows across Claude Code and other AI coding environments.
 - [Playwright MCP Tutorial: Browser Automation for Coding Agents Through MCP](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/playwright-mcp-tutorial/README.md)

discoverability/tutorial-index.json

@@ -1,7 +1,40 @@
 {
   "project": "awesome-code-docs",
-  "tutorial_count": 191,
+  "tutorial_count": 195,
   "tutorials": [
+    {
+      "cluster": "ai-coding-agents",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/a2a-protocol-tutorial/README.md",
+      "index_path": "tutorials/a2a-protocol-tutorial/README.md",
+      "intent_signals": [
+        "agentic-coding"
+      ],
+      "keywords": [
+        "a2a",
+        "protocol",
+        "building",
+        "interoperable",
+        "agent",
+        "google",
+        "standard",
+        "agents",
+        "discover",
+        "communicate",
+        "delegate",
+        "tasks",
+        "each",
+        "other",
+        "open",
+        "now",
+        "linux",
+        "foundation"
+      ],
+      "path": "tutorials/a2a-protocol-tutorial",
+      "repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/a2a-protocol-tutorial",
+      "slug": "a2a-protocol-tutorial",
+      "summary": "Learn how agents discover, communicate, and delegate tasks to each other using the A2A protocol \u2014 the open standard (now Linux Foundation) for agent-to-agent interoperability.",
+      "title": "A2A Protocol Tutorial: Building Interoperable Agent Systems With Google's Agent-to-Agent Standard"
+    },
     {
       "cluster": "ai-app-frameworks",
       "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md",
@@ -65,6 +98,39 @@
       "summary": "Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.",
       "title": "ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK"
     },
+    {
+      "cluster": "data-and-storage",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/affine-tutorial/README.md",
+      "index_path": "tutorials/affine-tutorial/README.md",
+      "intent_signals": [
+        "general-learning"
+      ],
+      "keywords": [
+        "affine",
+        "open",
+        "source",
+        "workspace",
+        "whiteboards",
+        "databases",
+        "toeverything",
+        "extend",
+        "self",
+        "host",
+        "modern",
+        "knowledge",
+        "combining",
+        "documents",
+        "powered",
+        "blocksuite",
+        "crdt",
+        "based"
+      ],
+      "path": "tutorials/affine-tutorial",
+      "repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/affine-tutorial",
+      "slug": "affine-tutorial",
+      "summary": "Learn how to use toeverything/AFFiNE to build, extend, and self-host a modern knowledge workspace combining documents, whiteboards, and databases \u2014 powered by BlockSuite, CRDT-based collaboration, and integrated AI copilot features.",
+      "title": "AFFiNE Tutorial: Open-Source AI Workspace with Docs, Whiteboards, and Databases"
+    },
     {
       "cluster": "ai-coding-agents",
       "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md",
@@ -3666,6 +3732,40 @@
       "summary": "A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.",
       "title": "Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory"
     },
+    {
+      "cluster": "ai-coding-agents",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/metagpt-tutorial/README.md",
+      "index_path": "tutorials/metagpt-tutorial/README.md",
+      "intent_signals": [
+        "architecture-deep-dive",
+        "agentic-coding"
+      ],
+      "keywords": [
+        "metagpt",
+        "multi",
+        "agent",
+        "software",
+        "development",
+        "role",
+        "based",
+        "collaboration",
+        "one",
+        "sentence",
+        "give",
+        "product",
+        "idea",
+        "virtual",
+        "company",
+        "agents",
+        "designs",
+        "architects"
+      ],
+      "path": "tutorials/metagpt-tutorial",
+      "repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/metagpt-tutorial",
+      "slug": "metagpt-tutorial",
+      "summary": "In one sentence: Give MetaGPT a product idea, and a virtual software company of AI agents designs, architects, codes, and tests it for you.",
+      "title": "MetaGPT Tutorial: Multi-Agent Software Development with Role-Based Collaboration"
+    },
     {
       "cluster": "ai-coding-agents",
       "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md",
@@ -4484,6 +4584,34 @@
       "summary": "Learn how to use plandex-ai/plandex for large codebase tasks with strong context management, cumulative diff review, model packs, and self-hosted operations.",
       "title": "Plandex Tutorial: Large-Task AI Coding Agent Workflows"
     },
+    {
+      "cluster": "ai-app-frameworks",
+      "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plane-tutorial/README.md",
+      "index_path": "tutorials/plane-tutorial/README.md",
+      "intent_signals": [
+        "general-learning"
+      ],
+      "keywords": [
+        "plane",
+        "native",
+        "management",
+        "open",
+        "source",
+        "rivals",
+        "jira",
+        "linear",
+        "issues",
+        "cycles",
+        "modules",
+        "wiki",
+        "built"
+      ],
+      "path": "tutorials/plane-tutorial",
+      "repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/plane-tutorial",
+      "slug": "plane-tutorial",
+      "summary": "Open-source AI-native project management that rivals Jira and Linear \u2014 with issues, cycles, modules, and wiki built in.",
+      "title": "Plane Tutorial: AI-Native Project Management"
+    },
     {
       "cluster": "ai-coding-agents",
       "file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md",