# tradecatlabs/vibe-coding-cn architecture

> Architecture diagram of the GitHub repository tradecatlabs/vibe-coding-cn, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tradecatlabs/vibe-coding-cn
- Repository: https://github.com/tradecatlabs/vibe-coding-cn

## Overview

This repository is primarily a Chinese Vibe Coding learning resource, presenting a workflow from idea and structured requirements through AI-assisted implementation, quality checks, and review. The supplied tree also contains independent executable tools and research projects, rather than one integrated runtime. The graph keeps those products separate and shows their documented or excerpt-supported calls. Several README capabilities have no corresponding source paths in the supplied tree, and unsampled connections are omitted.

Main entry points: [`tools/chat-vault/services/chat-vault/src/parsers/__init__.py`](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/__init__.py) (Parser registry), [`tools/chat-vault/services/chat-vault/src/main.py`](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/main.py) (Chat vault operator), [`research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py`](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py) (Candidate pipeline), [`tools/external/MCPlayerTransfer/main.py`](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/main.py) (World operator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_governance["Governance Tools"]
  node_gov_bundle["Context bundle"]
  node_gov_validator["Package validator"]
  node_gov_creation["Governance setup"]
end

subgraph group_math["Math Research"]
  node_math_entry["Research CLI"]
  node_math_pipeline["Candidate pipeline<br/>[pipeline.py]"]
  node_math_evidence["Evidence handling<br/>[evidence.py]"]
  node_math_runtime["Bounded runtime<br/>[runtime.py]"]
  node_math_store[("Research store<br/>[store.py]")]
end

subgraph group_chat["Chat Vault"]
  node_chat_operator(("Chat vault operator<br/>[main.py]"))
  node_chat_config["Source configuration<br/>[config.py]"]
  node_chat_registry["Parser registry<br/>[__init__.py]"]
  node_chat_contract["Session contract<br/>[base.py]"]
  node_chat_codex["Codex parser<br/>[codex.py]"]
  node_chat_kiro["Kiro parser<br/>[kiro.py]"]
  node_chat_claude["Claude parser<br/>[claude.py]"]
  node_chat_gemini["Gemini parser<br/>[gemini.py]"]
  node_chat_watcher["File watcher<br/>[watcher.py]"]
  node_chat_storage[("Session database<br/>[storage.py]")]
end

subgraph group_utilities["Standalone Utilities"]
  node_mc_operator(("World operator<br/>[main.py]"))
  node_mc_extract["Player extraction<br/>[extract_player.py]"]
  node_mc_import["Player import<br/>[import_player.py]"]
  node_prompt_library["Prompt library<br/>[main.py]"]
end

node_learner(("Learner / Engineer"))
node_vibe_workflow["Vibe workflow"]

node_learner -->|"learns workflow"| node_vibe_workflow
node_vibe_workflow -.->|"builds task context"| node_gov_bundle
node_vibe_workflow -.->|"reuses prompts"| node_prompt_library
node_gov_bundle -->|"outputs validation inputs"| node_gov_validator
node_gov_creation -.->|"sets up package"| node_gov_validator
node_math_entry -.->|"runs research"| node_math_pipeline
node_math_pipeline -->|"records evidence"| node_math_evidence
node_math_pipeline -->|"runs bounded checks"| node_math_runtime
node_math_pipeline -->|"reads and updates"| node_math_store
node_chat_operator -->|"loads settings"| node_chat_config
node_chat_operator -->|"selects parsers"| node_chat_registry
node_chat_operator -->|"starts monitoring"| node_chat_watcher
node_chat_operator -->|"stores and queries"| node_chat_storage
node_chat_registry -->|"exports parser"| node_chat_codex
node_chat_registry -->|"exports parser"| node_chat_kiro
node_chat_registry -->|"exports parser"| node_chat_claude
node_chat_registry -->|"exports parser"| node_chat_gemini
node_chat_codex -->|"implements contract"| node_chat_contract
node_chat_kiro -->|"implements contract"| node_chat_contract
node_mc_operator -->|"dispatches extract"| node_mc_extract
node_mc_operator -->|"dispatches import"| node_mc_import

click node_gov_bundle "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-harness-cn/governance/tools/governance_context_bundle.py"
click node_gov_validator "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-harness-cn/governance/tools/validate_governance_package.py"
click node_gov_creation "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-harness-cn/governance/tools/init_governance_package.py"
click node_math_entry "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/query_problem_library.py"
click node_math_pipeline "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py"
click node_math_evidence "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/evidence.py"
click node_math_runtime "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/runtime.py"
click node_math_store "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/store.py"
click node_chat_operator "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/main.py"
click node_chat_config "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/config.py"
click node_chat_registry "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/__init__.py"
click node_chat_contract "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/base.py"
click node_chat_codex "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/codex.py"
click node_chat_kiro "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/kiro.py"
click node_chat_claude "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/claude.py"
click node_chat_gemini "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/gemini.py"
click node_chat_watcher "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/watcher.py"
click node_chat_storage "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/storage.py"
click node_mc_operator "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/main.py"
click node_mc_extract "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/src/extract_player.py"
click node_mc_import "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/src/import_player.py"
click node_prompt_library "https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/prompts-library/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gov_bundle,node_gov_validator,node_gov_creation toneBlue
class node_math_entry,node_math_pipeline,node_math_evidence,node_math_runtime,node_math_store toneAmber
class node_chat_operator,node_chat_config,node_chat_registry,node_chat_contract,node_chat_codex,node_chat_kiro,node_chat_claude,node_chat_gemini,node_chat_watcher,node_chat_storage toneMint
class node_mc_operator,node_mc_extract,node_mc_import,node_prompt_library toneRose
class node_learner,node_vibe_workflow toneIndigo
```

## Components

### Governance Tools

- [Context bundle](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-harness-cn/governance/tools/governance_context_bundle.py): `research/vibe-harness-cn/governance/tools/governance_context_bundle.py`
- [Package validator](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-harness-cn/governance/tools/validate_governance_package.py): `research/vibe-harness-cn/governance/tools/validate_governance_package.py`
- [Governance setup](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-harness-cn/governance/tools/init_governance_package.py): `research/vibe-harness-cn/governance/tools/init_governance_package.py`

### Math Research

- [Research CLI](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/query_problem_library.py): `research/vibe-mathing-cn-public/scripts/query_problem_library.py`
- [Candidate pipeline](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py): `research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py`
- [Evidence handling](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/evidence.py): `research/vibe-mathing-cn-public/scripts/vibe_mathing/evidence.py`
- [Bounded runtime](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/runtime.py): `research/vibe-mathing-cn-public/scripts/vibe_mathing/runtime.py`
- [Research store](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/research/vibe-mathing-cn-public/scripts/vibe_mathing/store.py): `research/vibe-mathing-cn-public/scripts/vibe_mathing/store.py`

### Chat Vault

- [Chat vault operator](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/main.py): `tools/chat-vault/services/chat-vault/src/main.py`
- [Source configuration](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/config.py): `tools/chat-vault/services/chat-vault/src/config.py`
- [Parser registry](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/__init__.py): `tools/chat-vault/services/chat-vault/src/parsers/__init__.py`
- [Session contract](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/base.py): `tools/chat-vault/services/chat-vault/src/parsers/base.py`
- [Codex parser](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/codex.py): `tools/chat-vault/services/chat-vault/src/parsers/codex.py`
- [Kiro parser](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/kiro.py): `tools/chat-vault/services/chat-vault/src/parsers/kiro.py`
- [Claude parser](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/claude.py): `tools/chat-vault/services/chat-vault/src/parsers/claude.py`
- [Gemini parser](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/parsers/gemini.py): `tools/chat-vault/services/chat-vault/src/parsers/gemini.py`
- [File watcher](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/watcher.py): `tools/chat-vault/services/chat-vault/src/watcher.py`
- [Session database](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/chat-vault/services/chat-vault/src/storage.py): `tools/chat-vault/services/chat-vault/src/storage.py`

### Standalone Utilities

- [World operator](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/main.py): `tools/external/MCPlayerTransfer/main.py`
- [Player extraction](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/src/extract_player.py): `tools/external/MCPlayerTransfer/src/extract_player.py`
- [Player import](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/external/MCPlayerTransfer/src/import_player.py): `tools/external/MCPlayerTransfer/src/import_player.py`
- [Prompt library](https://github.com/tradecatlabs/vibe-coding-cn/blob/develop/tools/prompts-library/main.py): `tools/prompts-library/main.py`

### Other components

- **Learner / Engineer**
- **Vibe workflow**

## Connections

- Learner / Engineer → Vibe workflow: learns workflow (evidence: `README.md`)
- Vibe workflow → Context bundle: builds task context
- Vibe workflow → Prompt library: reuses prompts
- Context bundle → Package validator: outputs validation inputs (evidence: `research/vibe-harness-cn/governance/tools/governance_context_bundle.py`)
- Governance setup → Package validator: sets up package
- Research CLI → Candidate pipeline: runs research
- Candidate pipeline → Evidence handling: records evidence (evidence: `research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py`)
- Candidate pipeline → Bounded runtime: runs bounded checks (evidence: `research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py`)
- Candidate pipeline → Research store: reads and updates (evidence: `research/vibe-mathing-cn-public/scripts/vibe_mathing/pipeline.py`)
- Chat vault operator → Source configuration: loads settings (evidence: `tools/chat-vault/services/chat-vault/src/main.py`)
- Chat vault operator → Parser registry: selects parsers (evidence: `tools/chat-vault/services/chat-vault/src/main.py`)
- Chat vault operator → File watcher: starts monitoring (evidence: `tools/chat-vault/services/chat-vault/src/main.py`)
- Chat vault operator → Session database: stores and queries (evidence: `tools/chat-vault/services/chat-vault/src/main.py`)
- Parser registry → Codex parser: exports parser (evidence: `tools/chat-vault/services/chat-vault/src/parsers/__init__.py`)
- Parser registry → Kiro parser: exports parser (evidence: `tools/chat-vault/services/chat-vault/src/parsers/__init__.py`)
- Parser registry → Claude parser: exports parser (evidence: `tools/chat-vault/services/chat-vault/src/parsers/__init__.py`)
- Parser registry → Gemini parser: exports parser (evidence: `tools/chat-vault/services/chat-vault/src/parsers/__init__.py`)
- Codex parser → Session contract: implements contract (evidence: `tools/chat-vault/services/chat-vault/src/parsers/codex.py`)
- Kiro parser → Session contract: implements contract (evidence: `tools/chat-vault/services/chat-vault/src/parsers/kiro.py`)
- World operator → Player extraction: dispatches extract (evidence: `tools/external/MCPlayerTransfer/main.py`)
- World operator → Player import: dispatches import (evidence: `tools/external/MCPlayerTransfer/main.py`)