Skip to content

Commit 4cc4c99

Browse files
authored
feat: add 4 Genesis-strategic tutorials (AFFiNE, Plane, MetaGPT, A2A Protocol) (#162)
New tutorials for repos directly relevant to the Taskade Genesis competitive landscape: - AFFiNE (66K stars): Open-source AI workspace — docs, whiteboards, databases, AI copilot - Plane (47K stars): AI-native project management — issues, cycles, wiki, AI features - MetaGPT (66K stars): Multi-agent role-based collaboration for software generation - A2A Protocol (23K stars): Google's Agent-to-Agent interoperability standard Each tutorial: 9 files (README + 8 chapters), v2 format compliant, with mermaid diagrams, code examples, and cross-references. Total: 14K+ lines of new content. Repository now contains 195 tutorials (was 191).
1 parent 8ad4e47 commit 4cc4c99

49 files changed

Lines changed: 14163 additions & 213 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CONTENT_GAPS_ANALYSIS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ This document tracks structural and quality gaps that impact completeness and di
66

77
| Metric | Value |
88
|:-------|:------|
9-
| Tutorial directories | 191 |
10-
| Tutorials with exactly 8 numbered chapters | 188 |
9+
| Tutorial directories | 195 |
10+
| Tutorials with exactly 8 numbered chapters | 192 |
1111
| Tutorials with >8 numbered chapters | 3 |
1212
| Tutorials with 0 numbered chapters | 0 |
1313
| Tutorials with partial chapter coverage (1-7) | 0 |

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,8 @@ Build autonomous AI systems that reason, plan, and collaborate.
208208
| **[Open SWE](tutorials/open-swe-tutorial/)** | 5.3K+ | Python | Async cloud coding agent architecture and migration playbook |
209209
| **[HumanLayer](tutorials/humanlayer-tutorial/)** | 9.6K+ | Python | Context engineering and human-governed coding-agent workflows |
210210
| **[Wshobson Agents](tutorials/wshobson-agents-tutorial/)** | 29.9K+ | TypeScript | Pluginized multi-agent workflows with specialist Claude Code agents |
211+
| **[MetaGPT](tutorials/metagpt-tutorial/)** | 66K+ | Python | Multi-agent framework with role-based collaboration (PM, Architect, Engineer) for software generation |
212+
| **[A2A Protocol](tutorials/a2a-protocol-tutorial/)** | 23K+ | Python/TypeScript | Google's Agent-to-Agent protocol for cross-platform agent interoperability and discovery |
211213

212214
### 🧠 LLM Frameworks & RAG
213215

@@ -266,6 +268,8 @@ Full-stack AI chat platforms and copilots.
266268
| **[GPT-OSS](tutorials/gpt-oss-tutorial/)** | 6.4K+ | TypeScript | Open-source GPT implementation |
267269
| **[Claude Quickstarts](tutorials/claude-quickstarts-tutorial/)** | 13.7K+ | Python/TypeScript | Production Claude integration patterns |
268270
| **[Cherry Studio](tutorials/cherry-studio-tutorial/)** | 40.5K+ | TypeScript | Multi-provider AI desktop workspace with assistants, documents, and MCP tools |
271+
| **[AFFiNE](tutorials/affine-tutorial/)** | 66K+ | TypeScript | Open-source Notion + Miro alternative with docs, whiteboards, databases, and AI copilot |
272+
| **[Plane](tutorials/plane-tutorial/)** | 47K+ | Python/TypeScript | AI-native project management with issues, cycles, modules, wiki, and AI features |
269273

270274
### 🔧 Developer Tools & Productivity
271275

TUTORIAL_STRUCTURE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ tutorials/<tutorial-name>/
1717

1818
| Pattern | Count |
1919
|:--------|:------|
20-
| `root_only` | 191 |
20+
| `root_only` | 195 |
2121
| `docs_only` | 0 |
2222
| `index_only` | 0 |
2323
| `mixed` | 0 |

categories/ai-ml-platforms.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,10 @@
167167
- [Vibe Kanban](../tutorials/vibe-kanban-tutorial/)
168168
- [Whisper Cpp](../tutorials/whisper-cpp-tutorial/)
169169
- [Wshobson Agents](../tutorials/wshobson-agents-tutorial/)
170+
- [AFFiNE](../tutorials/affine-tutorial/)
171+
- [Plane](../tutorials/plane-tutorial/)
172+
- [MetaGPT](../tutorials/metagpt-tutorial/)
173+
- [A2A Protocol](../tutorials/a2a-protocol-tutorial/)
170174

171175
## Suggest Additions
172176

discoverability/query-hub.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Auto-generated high-intent query landing surface mapped to the most relevant tutorials.
44

5-
- Total tutorials indexed: **191**
5+
- Total tutorials indexed: **195**
66
- Query hubs: **6**
77
- Source: `scripts/generate_discoverability_assets.py`
88

discoverability/search-intent-map.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22

33
Auto-generated topical clusters to strengthen internal linking and query-to-tutorial mapping.
44

5-
- Total tutorials: **191**
5+
- Total tutorials: **195**
66
- Total clusters: **9**
77
- Source: `scripts/generate_discoverability_assets.py`
88

99
## ai-app-frameworks
1010

11-
- tutorial_count: **25**
11+
- tutorial_count: **26**
1212

1313
- [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)
1414
- intents: production-operations
@@ -50,6 +50,8 @@ Auto-generated topical clusters to strengthen internal linking and query-to-tuto
5050
- intents: production-operations
5151
- [OpenBB Tutorial: Complete Guide to Investment Research Platform](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/openbb-tutorial/README.md)
5252
- intents: general-learning
53+
- [Plane Tutorial: AI-Native Project Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plane-tutorial/README.md)
54+
- intents: general-learning
5355
- [Semantic Kernel Tutorial: Microsoft's AI Orchestration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/semantic-kernel-tutorial/README.md)
5456
- intents: general-learning
5557
- [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
5860
- intents: general-learning
5961
- [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)
6062
- intents: production-operations
61-
- [n8n AI Tutorial: Workflow Automation with AI](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/n8n-ai-tutorial/README.md)
62-
- intents: general-learning
63+
- ... plus 1 more tutorials in this cluster
6364

6465
## ai-coding-agents
6566

66-
- tutorial_count: **85**
67+
- tutorial_count: **87**
6768

69+
- [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)
70+
- intents: agentic-coding
6871
- [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)
6972
- intents: production-operations, agentic-coding
7073
- [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
113116
- intents: agentic-coding
114117
- [Cline Tutorial: Agentic Coding with Human Control](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/cline-tutorial/README.md)
115118
- intents: agentic-coding
116-
- [CodeMachine CLI Tutorial: Orchestrating Long-Running Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/codemachine-cli-tutorial/README.md)
117-
- intents: agentic-coding
118-
- ... plus 60 more tutorials in this cluster
119+
- ... plus 62 more tutorials in this cluster
119120

120121
## data-and-storage
121122

122-
- tutorial_count: **8**
123+
- tutorial_count: **9**
123124

125+
- [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)
126+
- intents: general-learning
124127
- [Athens Research: Deep Dive Tutorial](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/athens-research-tutorial/README.md)
125128
- intents: architecture-deep-dive
126129
- [ClickHouse Tutorial: High-Performance Analytical Database](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/clickhouse-tutorial/README.md)

discoverability/tutorial-directory.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,19 @@
22

33
This page is auto-generated from the tutorial index and is intended as a fast browse surface for contributors and search crawlers.
44

5-
- Total tutorials: **191**
5+
- Total tutorials: **195**
66
- Source: `scripts/generate_discoverability_assets.py`
77

88
## A
99

10+
- [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)
11+
- 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.
1012
- [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)
1113
- 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.
1214
- [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)
1315
- Learn how to use google/adk-python to build, evaluate, and deploy modular AI agent systems with strong tooling, session controls, and production rollouts.
16+
- [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)
17+
- 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.
1418
- [AG2 Tutorial: Next-Generation Multi-Agent Framework](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md)
1519
- Build collaborative AI agent systems with AG2, the community-driven successor to AutoGen.
1620
- [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
284288
- A deep technical walkthrough of MeiliSearch covering Lightning Fast Search Engine.
285289
- [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)
286290
- A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.
291+
- [MetaGPT Tutorial: Multi-Agent Software Development with Role-Based Collaboration](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/metagpt-tutorial/README.md)
292+
- In one sentence: Give MetaGPT a product idea, and a virtual software company of AI agents designs, architects, codes, and tests it for you.
287293
- [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)
288294
- Learn how to use SWE-agent/mini-swe-agent to run compact, high-performing software-engineering agent workflows with minimal scaffolding and strong reproducibility.
289295
- [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
351357
- AI Photo Management Revolution: Enhanced facial recognition, LLM integrations, and advanced organization features mark PhotoPrism's evolution.
352358
- [Plandex Tutorial: Large-Task AI Coding Agent Workflows](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plandex-tutorial/README.md)
353359
- Learn how to use plandex-ai/plandex for large codebase tasks with strong context management, cumulative diff review, model packs, and self-hosted operations.
360+
- [Plane Tutorial: AI-Native Project Management](https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plane-tutorial/README.md)
361+
- Open-source AI-native project management that rivals Jira and Linear — with issues, cycles, modules, and wiki built in.
354362
- [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)
355363
- Learn how to use OthmanAdi/planning-with-files to run Manus-style file-based planning workflows across Claude Code and other AI coding environments.
356364
- [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

Lines changed: 129 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,40 @@
11
{
22
"project": "awesome-code-docs",
3-
"tutorial_count": 191,
3+
"tutorial_count": 195,
44
"tutorials": [
5+
{
6+
"cluster": "ai-coding-agents",
7+
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/a2a-protocol-tutorial/README.md",
8+
"index_path": "tutorials/a2a-protocol-tutorial/README.md",
9+
"intent_signals": [
10+
"agentic-coding"
11+
],
12+
"keywords": [
13+
"a2a",
14+
"protocol",
15+
"building",
16+
"interoperable",
17+
"agent",
18+
"google",
19+
"standard",
20+
"agents",
21+
"discover",
22+
"communicate",
23+
"delegate",
24+
"tasks",
25+
"each",
26+
"other",
27+
"open",
28+
"now",
29+
"linux",
30+
"foundation"
31+
],
32+
"path": "tutorials/a2a-protocol-tutorial",
33+
"repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/a2a-protocol-tutorial",
34+
"slug": "a2a-protocol-tutorial",
35+
"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.",
36+
"title": "A2A Protocol Tutorial: Building Interoperable Agent Systems With Google's Agent-to-Agent Standard"
37+
},
538
{
639
"cluster": "ai-app-frameworks",
740
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/activepieces-tutorial/README.md",
@@ -65,6 +98,39 @@
6598
"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.",
6699
"title": "ADK Python Tutorial: Production-Grade Agent Engineering with Google's ADK"
67100
},
101+
{
102+
"cluster": "data-and-storage",
103+
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/affine-tutorial/README.md",
104+
"index_path": "tutorials/affine-tutorial/README.md",
105+
"intent_signals": [
106+
"general-learning"
107+
],
108+
"keywords": [
109+
"affine",
110+
"open",
111+
"source",
112+
"workspace",
113+
"whiteboards",
114+
"databases",
115+
"toeverything",
116+
"extend",
117+
"self",
118+
"host",
119+
"modern",
120+
"knowledge",
121+
"combining",
122+
"documents",
123+
"powered",
124+
"blocksuite",
125+
"crdt",
126+
"based"
127+
],
128+
"path": "tutorials/affine-tutorial",
129+
"repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/affine-tutorial",
130+
"slug": "affine-tutorial",
131+
"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.",
132+
"title": "AFFiNE Tutorial: Open-Source AI Workspace with Docs, Whiteboards, and Databases"
133+
},
68134
{
69135
"cluster": "ai-coding-agents",
70136
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/ag2-tutorial/README.md",
@@ -3666,6 +3732,40 @@
36663732
"summary": "A deep technical walkthrough of Mem0 covering Building Production-Ready AI Agents with Scalable Long-Term Memory.",
36673733
"title": "Mem0 Tutorial: Building Production-Ready AI Agents with Scalable Long-Term Memory"
36683734
},
3735+
{
3736+
"cluster": "ai-coding-agents",
3737+
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/metagpt-tutorial/README.md",
3738+
"index_path": "tutorials/metagpt-tutorial/README.md",
3739+
"intent_signals": [
3740+
"architecture-deep-dive",
3741+
"agentic-coding"
3742+
],
3743+
"keywords": [
3744+
"metagpt",
3745+
"multi",
3746+
"agent",
3747+
"software",
3748+
"development",
3749+
"role",
3750+
"based",
3751+
"collaboration",
3752+
"one",
3753+
"sentence",
3754+
"give",
3755+
"product",
3756+
"idea",
3757+
"virtual",
3758+
"company",
3759+
"agents",
3760+
"designs",
3761+
"architects"
3762+
],
3763+
"path": "tutorials/metagpt-tutorial",
3764+
"repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/metagpt-tutorial",
3765+
"slug": "metagpt-tutorial",
3766+
"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.",
3767+
"title": "MetaGPT Tutorial: Multi-Agent Software Development with Role-Based Collaboration"
3768+
},
36693769
{
36703770
"cluster": "ai-coding-agents",
36713771
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/mini-swe-agent-tutorial/README.md",
@@ -4484,6 +4584,34 @@
44844584
"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.",
44854585
"title": "Plandex Tutorial: Large-Task AI Coding Agent Workflows"
44864586
},
4587+
{
4588+
"cluster": "ai-app-frameworks",
4589+
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/plane-tutorial/README.md",
4590+
"index_path": "tutorials/plane-tutorial/README.md",
4591+
"intent_signals": [
4592+
"general-learning"
4593+
],
4594+
"keywords": [
4595+
"plane",
4596+
"native",
4597+
"management",
4598+
"open",
4599+
"source",
4600+
"rivals",
4601+
"jira",
4602+
"linear",
4603+
"issues",
4604+
"cycles",
4605+
"modules",
4606+
"wiki",
4607+
"built"
4608+
],
4609+
"path": "tutorials/plane-tutorial",
4610+
"repo_url": "https://github.com/johnxie/awesome-code-docs/tree/main/tutorials/plane-tutorial",
4611+
"slug": "plane-tutorial",
4612+
"summary": "Open-source AI-native project management that rivals Jira and Linear \u2014 with issues, cycles, modules, and wiki built in.",
4613+
"title": "Plane Tutorial: AI-Native Project Management"
4614+
},
44874615
{
44884616
"cluster": "ai-coding-agents",
44894617
"file_url": "https://github.com/johnxie/awesome-code-docs/blob/main/tutorials/planning-with-files-tutorial/README.md",

0 commit comments

Comments
 (0)