docs: update en/ README files to match actual directory structure

- Update README.md directory structure section
- Update mermaid diagram paths
- Update documents/README.md to match actual folders
- Fix prompts path references
This commit is contained in:
tukuaiai 2025-12-19 17:19:51 +08:00
parent 828505a2f1
commit 805892ea49
4 changed files with 100 additions and 115 deletions

View File

@ -350,23 +350,36 @@ The core structure of this `vibe-coding-cn` project primarily revolves around kn
│ └── XHS-image-to-PDF-conversion/ # Xiaohongshu image to PDF conversion tool.
├── i18n/en/prompts/ # Centralized storage for all types of AI prompts.
│ ├── 00-meta-prompts/ # Auxiliary prompts.
│ ├── 02-coding-prompts/ # Prompt collection specifically for programming and code generation.
│ │ └── ... (specific coding prompt files)
│ ├── 00-meta-prompts/ # Meta prompts (prompts that generate prompts)
│ ├── 01-system-prompts/ # AI system-level prompts for behavior and framework
│ │ └── ... (system prompts)
│ │
│ ├── 01-system-prompts/ # AI system-level prompts, used to set AI behavior and framework.
│ │ └── ... (other system prompts)
│ ├── 02-coding-prompts/ # Prompts for programming and code generation
│ │ └── ... (coding prompt files)
│ │
│ └── 03-user-prompts/ # User-defined or commonly used prompts.
│ ├── ASCII Art Generation.md # ASCII art generation prompts.
│ ├── Data Pipeline.md # Data pipeline processing prompts.
│ └── ... (other user prompts)
│ └── 03-user-prompts/ # User-defined or commonly used prompts
│ └── ... (user prompts)
├── i18n/en/skills/ # Centralized storage for all types of skills.
├── claude-skills # Meta-skill for generating SKILLS
│ ├── SKILL.md
│ └── ... (others)
└── ... (and other skills)
├── 00-meta-skills/ # Meta skills
│ └── claude-skills/ # Skills generator
├── 01-ai-tools/ # AI CLI tools
│ ├── claude-code-guide/
│ └── claude-cookbooks/
├── 02-databases/ # Database skills
│ ├── postgresql/
│ └── timescaledb/
├── 03-crypto/ # Cryptocurrency/quantitative
│ ├── ccxt/
│ ├── coingecko/
│ ├── cryptofeed/
│ ├── hummingbot/
│ └── polymarket/
└── 04-dev-tools/ # Development tools
├── telegram-dev/
├── twscrape/
├── snapdom/
└── proxychains/
```
---
@ -384,10 +397,10 @@ In one sentence: Vibe Coding = **Planning-driven + Context-fixed + AI Pair Execu
Core Asset Mapping:
```
i18n/en/prompts/
02-coding-prompts/ # Core prompts for demand clarification, planning, and execution chain.
01-system-prompts/ # System-level prompts constraining AI behavior.
00-meta-prompts/ # Auxiliary/cooperative prompts.
03-user-prompts/ # Reusable user-side prompts.
00-meta-prompts/ # Meta prompts for generating prompts
01-system-prompts/ # System-level prompts constraining AI behavior
02-coding-prompts/ # Core prompts for demand clarification, planning, and execution
03-user-prompts/ # Reusable user-side prompts
i18n/en/documents/
Templates and Resources/Code Organization.md, Templates and Resources/General Project Architecture Template.md, Methodology and Principles/Development Experience.md, Methodology and Principles/System Prompt Construction Principles.md, and other knowledge bases.
backups/
@ -432,10 +445,10 @@ graph TB
end
subgraph consume_layer[Execution and Consumption Layer]
artifacts_md --> catalog_coding[i18n/en/prompts/coding_prompts]
artifacts_md --> catalog_system[i18n/en/prompts/system_prompts]
artifacts_md --> catalog_assist[i18n/en/prompts/assistant_prompts]
artifacts_md --> catalog_user[i18n/en/prompts/user_prompts]
artifacts_md --> catalog_coding[i18n/en/prompts/02-coding-prompts]
artifacts_md --> catalog_system[i18n/en/prompts/01-system-prompts]
artifacts_md --> catalog_meta[i18n/en/prompts/00-meta-prompts]
artifacts_md --> catalog_user[i18n/en/prompts/03-user-prompts]
artifacts_md --> docs_repo[i18n/en/documents/*]
artifacts_md --> new_consumer[Reserved: Other Downstream Channels]
catalog_coding --> ai_flow[AI Pair Programming Workflow]

View File

@ -1,123 +1,95 @@
# 📖 Documents
The `i18n/zh/documents/` directory aggregates project process documentation, architectural descriptions, development experience, and best practices, serving as the primary entry point for understanding methodologies and collaboration rules.
> Documentation library for Vibe Coding methodology, guides, and resources
## Directory Structure
---
## 📁 Directory Structure
```
i18n/en/documents/
├── README.md
documents/
├── 00-fundamentals/ # Core concepts & principles
│ ├── Glue Coding.md
│ ├── Language Layer Elements.md
│ ├── Common Pitfalls.md
│ ├── The Way of Programming.md
│ ├── Development Experience.md
│ ├── System Prompt Construction Principles.md
│ ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
│ ├── General Project Architecture Template.md
│ └── Code Organization.md
├── Starting Vibe Coding from Scratch/ # 🚀 Must-read for beginners
├── 01-getting-started/ # Getting started guides
│ ├── 00-Vibe Coding Philosophy.md
│ ├── 01-Network Environment Configuration.md
│ ├── 02-Development Environment Setup.md
│ └── 03-IDE Configuration.md
├── Glue Coding/ # 🧬 Revolutionary Paradigm of Glue Coding
│ └── README.md
├── Methodology and Principles/
│ ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
│ ├── gluecoding.md
│ ├── vibe-coding-experience-collection.md
│ ├── Learning Experience.md
│ ├── Development Experience.md
│ ├── The Way of Programming.md
│ └── System Prompt Construction Principles.md
├── Tutorials and Guides/
├── 02-methodology/ # Methodology & best practices
│ ├── auggie-mcp Configuration Document.md
│ ├── LazyVim Shortcut Cheatsheet.md
│ ├── tmux Shortcut Cheatsheet.md
│ └── How to SSH to Local Computer from Any Location via FRP.md
│ ├── vibe-coding-experience-collection.md
│ └── How to SSH to Local Computer from Any Location via Mobile, Based on FRP Implementation.md
├── Templates and Resources/
│ ├── Code Organization.md
│ ├── Tool Collection.md
│ ├── Recommended Programming Books.md
│ ├── General Project Architecture Template.md
│ └── memory-bank-template/
├── 03-practice/ # Practical examples
│ ├── telegram-dev/
│ ├── polymarket-dev/
│ └── web-app/
├── External Resource Aggregation/ # 🔗 External Links Summary
│ ├── AI Tools and Platforms/
│ ├── GitHub Featured Repositories/
│ ├── Prompt Resources/
│ ├── Development Tools/
│ ├── Tutorials and Courses/
│ └── Communities and Forums/
└── Project Practical Experience/ # 📁 Case Studies
├── fate-engine-dev/
├── polymarket-dev/
├── telegram-dev/
└── ...
└── 04-resources/ # Tools & resources
├── External Resource Aggregation.md
├── Tool Collection.md
└── Recommended Programming Books.md
```
## Document Categories
---
### 🚀 Starting Vibe Coding from Scratch (Beginner's Guide)
## 🗂️ Categories
Completely new? Start here!
### 00-fundamentals
Core concepts and methodology:
- **Glue Coding** - Revolutionary programming paradigm
- **Language Layer Elements** - 12-layer framework
- **Common Pitfalls** - Avoid common mistakes
- **The Way of Programming** - Dao · Fa · Shu philosophy
- **Development Experience** - Best practices
- **System Prompt Construction Principles** - Prompt engineering
* [00-Vibe Coding Philosophy](./Starting%20Vibe%20Coding%20from%20Scratch/00-Vibe%20Coding%20Philosophy.md) - Core Concepts
* [01-Network Environment Configuration](./Starting%20Vibe%20Coding%20from%20Scratch/01-Network%20Environment%20Configuration.md) - Configure network access
* [02-Development Environment Setup](./Starting%20Vibe%20Coding%20from%20Scratch/02-Development%20Environment%20Setup.md) - Set up development environment (Prompt Version)
* [03-IDE Configuration](./Starting%20Vibe%20Coding%20from%20Scratch/03-IDE%20Configuration.md) - Configure VS Code / Cursor / Windsurf
### 01-getting-started
Beginner's guide:
- **00-Vibe Coding Philosophy** - Core concepts
- **01-Network Environment Configuration** - Network setup
- **02-Development Environment Setup** - Dev environment
- **03-IDE Configuration** - VS Code / Cursor setup
### 🧬 Glue Coding
### 02-methodology
Tools and tutorials:
- **auggie-mcp Configuration** - Augment MCP setup
- **LazyVim Shortcut Cheatsheet** - Vim shortcuts
- **tmux Shortcut Cheatsheet** - Terminal multiplexer
- **FRP Remote Development** - Mobile SSH access
**The Holy Grail and Silver Bullet of Software Engineering.** Completely solves Vibe Coding's hallucination, complexity, and barrier issues.
### 03-practice
Real project examples:
- **telegram-dev/** - Telegram bot development
- **polymarket-dev/** - Polymarket data analysis
- **web-app/** - Web application examples
* [Introduction to Glue Coding](./Glue%20Coding/README.md) - Revolutionary Programming Paradigm
### 04-resources
Tools and external resources:
- **External Resource Aggregation** - Curated links
- **Tool Collection** - Recommended tools
- **Recommended Programming Books** - Book list
### Methodologies and Principles
---
Documents on programming philosophy, development principles, and core project guidelines.
## 🔗 Related Resources
* `A Formalization of Recursive Self-Optimizing Generative Systems.md` - Formalization of Recursive Self-Optimizing Systems
* `gluecoding.md` - Glue Coding Theory
* `vibe-coding-experience-collection.md` - Experience Summary
* `Learning Experience.md` - Learning Insights
* `Development Experience.md` - Development Practices
* `The Way of Programming.md` - Programming Philosophy
* `System Prompt Construction Principles.md` - Prompt Engineering
- [Prompts Library](../prompts/)
- [Skills Library](../skills/)
- [Main README](../../../README.md)
### Tutorials and Guides
---
Configuration, usage guides, and operational tutorials for specific tools.
* `auggie-mcp Configuration Document.md` - Augment MCP Configuration
* `LazyVim Shortcut Cheatsheet.md` - LazyVim Shortcuts
* `tmux Shortcut Cheatsheet.md` - tmux Shortcuts
* `How to SSH to Local Computer from Any Location via FRP.md` - Remote Development
### Templates and Resources
Reusable project templates, code structure specifications, and resource lists.
* `Code Organization.md` - Code Organization Standards
* `Tool Collection.md` - Tool Recommendations
* `Recommended Programming Books.md` - Book Recommendations
* `General Project Architecture Template.md` - Project Templates
* `memory-bank-template/` - Memory Bank Template
### 🔗 External Resource Aggregation
Summary of high-quality external resources, continuously updated.
* [External Resource Aggregation](./External%20Resource%20Aggregation/README.md) - General Index
### 📁 Project Practical Experience
Summaries of experience and case studies from actual project development.
* [Project Practical Experience](./Project%20Practical%20Experience/README.md) - General Index
* `fate-engine-dev/` - Fate Engine Development
* `polymarket-dev/` - Polymarket Data Analysis
* `telegram-dev/` - Telegram Bot Development
## Related Resources
- [Prompt Library](../prompts/) - AI Prompt Collection
- [Skill Library](../skills/) - AI Skills
[← Back](../README.md)