From 5cc87da68a1d029fede550d41ddee8a65b5dc552 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Fri, 19 Dec 2025 02:19:48 +0800 Subject: [PATCH] feat(en): translate missing documents using Gemini CLI MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add Common Pitfalls.md (常见坑汇总) - Add Language Layer Elements.md (语言层要素) - Add External Resource Aggregation.md (外部资源聚合) - Remove empty placeholder directories - Remove duplicate gluecoding.md from zh - Update README files --- .../00-fundamentals/Common Pitfalls.md | 477 ++++++++++++++++ .../Language Layer Elements.md | 520 +++++++++++++++++ i18n/en/documents/00-fundamentals/README.md | 2 + .../03-practice/bot-automation/.gitkeep | 0 .../documents/03-practice/cli-tool/.gitkeep | 0 .../03-practice/data-pipeline/.gitkeep | 0 .../documents/03-practice/game-dev/.gitkeep | 0 .../External Resource Aggregation.md | 523 ++++++++++++++++++ i18n/en/documents/04-resources/README.md | 325 +---------- .../memory-bank-template/.gitkeep | 0 i18n/zh/documents/00-基础指南/gluecoding.md | 162 ------ 11 files changed, 1528 insertions(+), 481 deletions(-) create mode 100644 i18n/en/documents/00-fundamentals/Common Pitfalls.md create mode 100644 i18n/en/documents/00-fundamentals/Language Layer Elements.md delete mode 100644 i18n/en/documents/03-practice/bot-automation/.gitkeep delete mode 100644 i18n/en/documents/03-practice/cli-tool/.gitkeep delete mode 100644 i18n/en/documents/03-practice/data-pipeline/.gitkeep delete mode 100644 i18n/en/documents/03-practice/game-dev/.gitkeep create mode 100644 i18n/en/documents/04-resources/External Resource Aggregation.md delete mode 100644 i18n/en/documents/04-resources/memory-bank-template/.gitkeep delete mode 100644 i18n/zh/documents/00-基础指南/gluecoding.md diff --git a/i18n/en/documents/00-fundamentals/Common Pitfalls.md b/i18n/en/documents/00-fundamentals/Common Pitfalls.md new file mode 100644 index 0000000..e35bebb --- /dev/null +++ b/i18n/en/documents/00-fundamentals/Common Pitfalls.md @@ -0,0 +1,477 @@ +# 🕳️ Common Pitfalls Summary + +> Common issues and solutions during the Vibe Coding process + +--- + +
+🤖 AI Chat Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| AI generated code doesn't run | Insufficient context | Provide full error messages, describe the runtime environment | +| AI repeatedly modifies the same issue | Stuck in a loop | Describe with a different approach, or start a new conversation | +| AI hallucinating, fabricating non-existent APIs | Outdated model knowledge | Provide official documentation links for AI reference | +| Code becomes messy with changes | Lack of planning | Let AI propose a plan first, then write code after confirmation | +| AI doesn't understand my requirements | Vague description | Explain with concrete examples, provide input and output samples | +| AI forgets previous conversations | Context loss | Re-provide key information, or use a memory bank | +| AI modifies unintended code | Unclear instructions | Explicitly state "only modify xxx, do not touch other files" | +| AI generated code style is inconsistent | No style guide | Provide a code style guide or sample code | + +
+ +--- + +
+🐍 Python Virtual Environment Related + +### Why use a virtual environment? + +- Avoid dependency conflicts between different projects +- Keep the system Python clean +- Easy to reproduce and deploy + +### Creating and using .venv + +```bash +# Create virtual environment +python -m venv .venv + +# Activate virtual environment +# Windows +.venv\Scripts\activate +# macOS/Linux +source .venv/bin/activate + +# Install dependencies +pip install -r requirements.txt + +# Deactivate virtual environment +deactivate +``` + +### Common Issues + +| Issue | Reason | Solution | +|:---|:---|:---| +| Cannot configure environment at all | Global pollution | Delete and restart, use `.venv` for virtual environment isolation | +| `python` command not found | Virtual environment not activated | Run `source .venv/bin/activate` first | +| Package installed but import error | Installed globally | Confirm virtual environment is activated before `pip install` | +| Dependency conflicts in different projects | Sharing global environment | Create a separate `.venv` for each project | +| VS Code uses wrong Python | Interpreter not selected correctly | Ctrl+Shift+P → "Python: Select Interpreter" → Select .venv | +| pip version too old | Virtual environment defaults to old version | `pip install --upgrade pip` | +| requirements.txt missing dependencies | Not exported | `pip freeze > requirements.txt` | + +### One-click environment reset + +Environment completely messed up? Delete and restart: + +```bash +# Delete old environment +rm -rf .venv + +# Recreate +python -m venv .venv +source .venv/bin/activate +pip install -r requirements.txt +``` + +
+ +--- + +
+📦 Node.js Environment Related + +### Common Issues + +| Issue | Reason | Solution | +|:---|:---|:---| +| Node version mismatch | Project requires specific version | Use nvm to manage multiple versions: `nvm install 18` | +| `npm install` error | Network/Permission issues | Change registry, clear cache, delete `node_modules` and reinstall | +| Global package not found | PATH not configured | Add `npm config get prefix` to PATH | +| package-lock conflict | Collaborative work | Use `npm ci` instead of `npm install` consistently | +| `node_modules` too large | Normal phenomenon | Add to `.gitignore`, do not commit | + +### Common Commands + +```bash +# Change to Taobao registry +npm config set registry https://registry.npmmirror.com + +# Clear cache +npm cache clean --force + +# Delete and reinstall +rm -rf node_modules package-lock.json +npm install + +# Use nvm to switch Node version +nvm use 18 +``` + +
+ +--- + +
+🔧 Environment Configuration Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Command not found | Environment variables not configured | Check PATH, restart terminal | +| Port occupied | Not properly shut down last time | `lsof -i :port_number` or `netstat -ano \| findstr :port_number` | +| Insufficient permissions | Linux/Mac permissions | `chmod +x` or `sudo` | +| Environment variables not taking effect | Not sourced | `source ~/.bashrc` or restart terminal | +| .env file not taking effect | Not loaded | Use `python-dotenv` or `dotenv` package | +| Windows path issues | Backslashes | Use `/` or `\\` or `Path` library | + +
+ +--- + +
+🌐 Network Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| GitHub access slow/timeout | Network restrictions | Configure proxy, refer to [Network Environment Configuration](../从零开始vibecoding/01-网络环境配置.md) | +| API call failed | Network/Key issue | Check proxy, API Key validity | +| Terminal not using proxy | Incomplete proxy configuration | Set environment variables (see below) | +| SSL certificate error | Proxy/Time issue | Check system time, or temporarily disable SSL verification | +| pip/npm download slow | Source is abroad | Change to domestic mirror source | +| git clone timeout | Network restrictions | Configure git proxy or use SSH | + +### Terminal Proxy Configuration + +```bash +# Temporary setting (effective in current terminal) +export http_proxy=http://127.0.0.1:7890 +export https_proxy=http://127.0.0.1:7890 + +# Permanent setting (add to ~/.bashrc or ~/.zshrc) +echo 'export http_proxy=http://127.0.0.1:7890' >> ~/.bashrc +echo 'export https_proxy=http://127.0.0.1:7890' >> ~/.bashrc +source ~/.bashrc + +# Git Proxy +git config --global http.proxy http://127.0.0.1:7890 +git config --global https.proxy http://127.0.0.1:7890 +``` + +
+ +--- + +
+📝 Code Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Code file too large, AI cannot process | Exceeds context | Split files, only provide relevant parts to AI | +| Code changes not taking effect | Cache/Not saved | Clear cache, confirm save, restart service | +| Merge conflicts | Git conflicts | Let AI help resolve: paste conflict content | +| Dependency version conflicts | Incompatible versions | Specify version numbers, or isolate with virtual environments | +| Chinese garbled characters | Encoding issue | Consistently use UTF-8, add `# -*- coding: utf-8 -*-` at file beginning | +| Hot update not taking effect | Watch issue | Check if file is within watch scope | + +
+ +--- + +
+🎯 Claude Code / Cursor Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Claude Code cannot connect | Network/Authentication | Check proxy, re-run `claude login` | +| Cursor completion is slow | Network latency | Check proxy configuration | +| Quota exhausted | Limited free quota | Change account or upgrade to paid | +| Rules file not taking effect | Path/Format error | Check `.cursorrules` or `CLAUDE.md` location | +| AI cannot read project files | Workspace issue | Confirm opened in correct directory, check .gitignore | +| Generated code in wrong location | Cursor position | Place cursor at correct position before generating | + +
+ +--- + +
+🚀 Deployment Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Runs locally, fails on deployment | Environment differences | Check Node/Python versions, environment variables | +| Build timeout | Project too large | Optimize dependencies, increase build time limit | +| Environment variables not taking effect | Not configured | Set environment variables on the deployment platform | +| CORS cross-origin error | Backend not configured | Add CORS middleware | +| Static files 404 | Path issue | Check build output directory configuration | +| Insufficient memory | Free tier limitations | Optimize code or upgrade plan | + +
+ +--- + +
+🗄️ Database Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Connection refused | Service not started | Start database service | +| Authentication failed | Incorrect password | Check username/password, reset password | +| Table does not exist | Not migrated | Run migration | +| Data loss | Not persistent | Docker add volume, or use cloud database | +| Too many connections | Connections not closed | Use connection pool, close connections promptly | + +
+ +--- + +
+🐳 Docker Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Image pull failed | Network issue | Configure image accelerator | +| Container failed to start | Port conflict/Configuration error | Check logs `docker logs container_name` | +| File changes not taking effect | Volume not mounted | Add `-v` parameter to mount directory | +| Insufficient disk space | Too many images | `docker system prune` to clean up | + +
+ +--- + +
+🧠 Large Model Usage Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Token limit exceeded | Input too long | Simplify context, only provide essential information | +| Response truncated | Output token limit | Ask AI to output in segments, or say "continue" | +| Large differences in model results | Different model characteristics | Select model based on task: Claude for code, GPT for general use | +| Temperature parameter effect | Temperature setting | Use low temperature (0-0.3) for code generation, high for creativity | +| System prompt ignored | Prompt too long/conflicting | Simplify system prompt, put important parts first | +| JSON output format error | Model instability | Use JSON mode, or ask AI to only output code blocks | +| Multi-turn conversation quality degrades | Context pollution | Periodically start new conversations, keep context clean | +| API call error 429 | Rate limit | Add delay and retry, or upgrade API plan | +| Streaming output garbled | Encoding/Parsing issue | Check SSE parsing, ensure UTF-8 | + +
+ +--- + +
+🏗️ Software Architecture Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Code becomes messy with changes | No architectural design | Draw architecture diagram first, then write code | +| Changing one place breaks many others | Tight coupling | Split modules, define clear interfaces | +| Don't know where to put code | Confused directory structure | Refer to [General Project Architecture Template](../模板与资源/通用项目架构模板.md) | +| Too much duplicate code | Lack of abstraction | Extract common functions/components | +| State management chaotic | Global state abuse | Use state management library, unidirectional data flow | +| Configuration scattered | No unified management | Centralize into config files or environment variables | +| Difficult to test | Too many dependencies | Dependency injection, mock external services | + +
+ +--- + +
+🔄 Git Version Control Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Committed unintended files | .gitignore not configured | Add to .gitignore, `git rm --cached` | +| Committed sensitive information | Not checked | Use git-filter-branch to clean history, change key | +| Cannot resolve merge conflicts | Unfamiliar with Git | Use VS Code conflict resolution tool, or ask AI for help | +| Commit message written incorrectly | Accidental | `git commit --amend` to modify | +| Want to undo last commit | Committed wrongly | `git reset --soft HEAD~1` | +| Too many messy branches | No standardization | Use Git Flow or trunk-based | +| Push rejected | New commits on remote | `pull --rebase` first, then push | + +### Common Git Commands + +```bash +# Undo changes in working directory +git checkout -- filename + +# Undo changes in staging area +git reset HEAD filename + +# Undo last commit (keep changes) +git reset --soft HEAD~1 + +# View commit history +git log --oneline -10 + +# Stash current changes +git stash +git stash pop +``` + +
+ +--- + +
+🧪 Testing Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Don't know what to test | Lack of testing mindset | Test edge cases, exceptions, core logic | +| Tests are too slow | Test granularity too large | Write more unit tests, fewer E2E | +| Tests are unstable | Depends on external services | Mock external dependencies | +| Tests pass but bugs appear in production | Incomplete coverage | Add edge case tests, check with coverage | +| Changing code requires changing tests | Tests coupled to implementation | Test behavior, not implementation | +| AI generated tests are useless | Only tests happy path | Ask AI to supplement edge case and exception tests | + +
+ +--- + +
+⚡ Performance Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Page loads slowly | Resources too large | Compression, lazy loading, CDN | +| API response slow | Queries not optimized | Add indexes, caching, pagination | +| Memory leak | Resources not cleaned up | Check event listeners, timers, closures | +| High CPU usage | Infinite loop/Redundant computation | Use profiler to locate hotspots | +| Database queries slow | N+1 issue | Use JOIN or batch queries | +| Frontend lagging | Too many re-renders | React.memo, useMemo, virtualized lists | + +
+ +--- + +
+🔐 Security Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| API Key leaked | Committed to Git | Use environment variables, add to .gitignore | +| SQL Injection | SQL concatenation | Use parameterized queries/ORM | +| XSS Attack | User input not escaped | Escape HTML, use CSP | +| CSRF Attack | No token verification | Add CSRF token | +| Password stored in plaintext | Lack of security awareness | Use bcrypt or other hashing algorithms | +| Sensitive information in logs | Printed unintended data | Anonymize, disable debug in production | + +
+ +--- + +
+📱 Frontend Development Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Styles not taking effect | Priority/Cache | Check selector priority, clear cache | +| Mobile adaptation issues | Not responsive | Use rem/vw, media queries | +| White screen | JS error | Check console, add error boundaries | +| State not synchronized | Asynchronous issues | Use useEffect dependencies, or state management library | +| Component not updating | Reference not changed | Return new object/array, do not modify directly | +| Build size too large | Not optimized | On-demand import, code splitting, tree shaking | +| Cross-origin issues | Browser security policy | Backend configure CORS, or use proxy | + +
+ +--- + +
+🖥️ Backend Development Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| API returns slowly | Synchronous blocking | Use async, put time-consuming tasks in queue | +| Concurrency issues | Race conditions | Add locks, use transactions, optimistic locking | +| Service crashed undetected | No monitoring | Add health checks, alerts | +| Logs cannot find issues | Incomplete logs | Add request_id, structured logging | +| Configure different environments | Hardcoding | Use environment variables to distinguish dev/prod | +| OOM crash | Memory leak/Too much data | Pagination, streaming, check for leaks | + +
+ +--- + +
+🔌 API Design Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| API naming chaotic | No standardization | Follow RESTful, use HTTP verbs for actions | +| Return format inconsistent | No agreement | Unify response structure `{code, data, message}` | +| Version upgrade difficult | No version control | Add version number to URL `/api/v1/` | +| Documentation and implementation inconsistent | Manual maintenance | Use Swagger/OpenAPI for auto-generation | +| Error messages unclear | Only returns 500 | Refine error codes, return useful information | +| Pagination parameters inconsistent | Each written differently | Unify `page/size` or `offset/limit` | + +
+ +--- + +
+📊 Data Processing Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Data format incorrect | Type conversion issues | Perform type validation and conversion | +| Timezone issues | Timezones not unified | Store UTC, convert to local time for display | +| Precision loss | Floating point issues | Use integers (cents) for monetary values, or Decimal | +| Large file processing OOM | Loaded all at once | Stream processing, chunked reading | +| Encoding issues | Not UTF-8 | Consistently use UTF-8, specify encoding when reading files | +| Null value handling | null/undefined | Perform null checks, provide default values | + +
+ +--- + +
+🤝 Collaboration Related + +| Issue | Reason | Solution | +|:---|:---|:---| +| Code style inconsistent | No standardization | Use ESLint/Prettier/Black, unify configuration | +| PR too large, difficult to review | Too many changes | Commit in small steps, one PR per feature | +| Documentation outdated | No one maintains | Update code and documentation together, CI checks | +| Don't know who is responsible | No owner | Use CODEOWNERS file | +| Reinventing the wheel | Unaware of existing solutions | Establish internal component library/documentation | + +
+ +1. **Check error messages** - Copy the full error to AI +2. **Minimum reproduction** - Find the simplest code that reproduces the issue +3. **Bisection method** - Comment out half the code to narrow down the problem scope +4. **Change environment** - Try different browsers/terminals/devices +5. **Restart magic** - Restart service/editor/computer +6. **Delete and restart** - If the environment is messed up, delete and recreate the virtual environment + +--- + +## 🔥 Ultimate Solution + +Still can't figure it out? Try this prompt: + +``` +I've encountered an issue and have tried many methods without success. + +Error message: +[Paste full error] + +My environment: +- Operating system: +- Python/Node version: +- Relevant dependency versions: + +I have tried: +1. xxx +2. xxx + +Please help me analyze the possible causes and provide solutions. +``` + +--- + +## 📝 Contribution + +Found a new pitfall? Welcome PR contributions! diff --git a/i18n/en/documents/00-fundamentals/Language Layer Elements.md b/i18n/en/documents/00-fundamentals/Language Layer Elements.md new file mode 100644 index 0000000..fb78cca --- /dev/null +++ b/i18n/en/documents/00-fundamentals/Language Layer Elements.md @@ -0,0 +1,520 @@ +# To understand 100% of the code, you must master the complete list of "language-level elements" + +--- + +# I. First, correct a key misconception + +❌ Misconception: + +> Don't understand code = Don't understand syntax + +✅ Truth: + +> Don't understand code = **Don't understand a certain layer of its model** + +--- + +# II. Understanding 100% of the code = Mastering 8 Levels + +--- + +## 🧠 L1: Basic Control Syntax (Lowest Threshold) + +This layer you already know: + +```text +Variables +if / else +for / while +Functions / return +``` + +👉 Can only understand **tutorial code** + +--- + +## 🧠 L2: Data and Memory Model (Very Critical) + +You must understand: + +```text +Value vs Reference +Stack vs Heap +Copy vs Share +Pointer / Reference +Mutable / Immutable +``` + +Example you need to "instantly understand": + +```c +int *p = &a; +``` + +```python +a = b +``` + +👉 This is the **root cause of the differences in C / C++ / Rust / Python** + +--- + +## 🧠 L3: Type System (Major Part) + +You need to know: + +```text +Static Typing / Dynamic Typing +Type Inference +Generics / Templates +Type Constraints +Null / Option +``` + +For example, you need to see at a glance: + +```rust +fn foo(x: T) -> Option +``` + +--- + +## 🧠 L4: Execution Model (Where 99% of Newcomers Get Stuck) + +You must understand: + +```text +Synchronous vs Asynchronous +Blocking vs Non-blocking +Threads vs Coroutines +Event Loop +Memory Visibility +``` + +Example: + +```js +await fetch() +``` + +You need to know **when it executes and who is waiting for whom**. + +--- + +## 🧠 L5: Error Handling and Boundary Syntax + +```text +Exceptions vs Return Values +panic / throw +RAII +defer / finally +``` + +You need to know: + +```go +defer f() +``` + +**When it executes, and if it's guaranteed to execute**. + +--- + +## 🧠 L6: Meta-Syntax (Making Code "Look Less Like Code") + +This is the root cause why many "don't understand": + +```text +Macros +Decorators +Annotations +Reflection +Code Generation +``` + +Example: + +```python + @cache +def f(): ... +``` + +👉 You need to know **what code it's rewriting** + +--- + +## 🧠 L7: Language Paradigms (Determines Thinking) + +```text +Object-Oriented (OOP) +Functional (FP) +Procedural +Declarative +``` + +Example: + +```haskell +map (+1) xs +``` + +You need to know this is **transforming a collection, not looping**. + +--- + +## 🧠 L8: Domain Syntax & Ecosystem Conventions (The Last 1%) + +```text +SQL +Regex +Shell +DSL (e.g., Pine Script) +Framework Conventions +``` + +Example: + +```sql +SELECT * FROM t WHERE id IN (...) +``` + +--- + +# III. The True "100% Understanding" Formula + +```text +100% Understanding Code = +Syntax ++ Type Model ++ Memory Model ++ Execution Model ++ Language Paradigm ++ Framework Conventions ++ Domain Knowledge +``` + +❗**Syntax accounts for less than 30%** + +--- + +# IV. Where will you get stuck? (Realistic Assessment) + +| Symptom of being stuck | Actual missing | +|:---|:---| +| "Can't understand this line of code" | L2 / L3 | +| "Why is the result like this?" | L4 | +| "Where did the function go?" | L6 | +| "The style is completely different" | L7 | +| "This isn't programming, is it?" | L8 | + +--- + +# V. Your True Engineering-Level Goal + +🎯 **Not "memorizing syntax"** +🎯 But being able to: + +> "I don't know this language, but I know what it's doing." + +This is the **true meaning of 100%**. + +--- + +# VI. Engineering Addendum: L9–L12 (From "Understanding" to "Architecture") + +> 🔥 Upgrade "understanding" to being able to **predict**, **refactor**, and **migrate** code + +--- + +## 🧠 L9: Time Dimension Model (90% of people completely unaware) + +You not only need to know **how** the code runs, but also: + +```text +「When」 it runs +「How long」 it runs +「If」 it runs repeatedly +「If」 it runs with a delay +``` + +### You must be able to judge at a glance: + +```python + @lru_cache +def f(x): ... +``` + +* Is **one calculation, multiple reuses** +* Or **re-executes every time** + +```js +setTimeout(fn, 0) +``` + +* ❌ Not executed immediately +* ✅ Is **after the current call stack is cleared** + +👉 This is the root cause of **performance / bugs / race conditions / repeated execution** + +--- + +## 🧠 L10: Resource Model (CPU / IO / Memory / Network) + +Many people think: + +> "Code is just logic" + +❌ Wrong +**Code = Language for scheduling resources** + +You must be able to distinguish: + +```text +CPU-bound +IO-bound +Memory-bound +Network-blocking +``` + +### Example + +```python +for x in data: + process(x) +``` + +What you should ask is not "is the syntax correct?", but: + +* Where is `data`? (Memory / Disk / Network) +* Is `process` computing or waiting? +* Can it be parallelized? +* Can it be batched? + +👉 This is the **starting point for performance optimization, concurrency models, and system design** + +--- + +## 🧠 L11: Implicit Contracts & Non-Syntax Rules (Engineering Truths) + +This is what **99% of tutorials won't write**, but you'll encounter daily in real projects. + +### You must identify these "non-code rules": + +```text +Whether the function is allowed to return None +Whether panic is allowed +Whether blocking is allowed +Whether it's thread-safe +Whether it's reentrant +Whether it's re-callable +``` + +### Example + +```go +http.HandleFunc("/", handler) +``` + +Implicit contracts include: + +* handler **must not block for too long** +* handler **may be called concurrently** +* handler **must not panic** + +👉 This layer determines if you can **"make it run"** or **"deploy it"** + +--- + +## 🧠 L12: Code Intent Layer (Top-Tier Capability) + +This is the **architect / language designer level**. + +What you need to achieve is not: + +> "What is this code doing?" + +But: + +> "**Why did the author write it this way?**" + +You need to be able to identify: + +```text +Is it preventing bugs? +Is it preventing misuse? +Is it trading performance for readability? +Is it leaving hooks for future extensions? +``` + +### Example + +```rust +fn foo(x: Option) -> Result +``` + +You need to read: + +* The author is **forcing callers to consider failure paths** +* The author is **rejecting implicit nulls** +* The author is **compressing the error space** + +👉 This is **code review / architecture design / API design capability** + +--- + +# VII. Ultimate Complete Edition: Total Table of 12 "Language-Level Elements" + +| Level | Name | Determines if you can… | +|:---|:---|:---| +| L1 | Control Syntax | Write runnable code | +| L2 | Memory Model | Avoid implicit bugs | +| L3 | Type System | Understand code without comments | +| L4 | Execution Model | Avoid async / concurrency pitfalls | +| L5 | Error Model | Avoid resource leaks / crashes | +| L6 | Meta-Syntax | Understand "code that doesn't look like code" | +| L7 | Paradigm | Understand different styles | +| L8 | Domain & Ecosystem | Understand real projects | +| L9 | Time Model | Control performance and timing | +| L10 | Resource Model | Write high-performance systems | +| L11 | Implicit Contract | Write production-ready code | +| L12 | Design Intent | Become an architect | + +--- + +# VIII. Counter-Intuitive but True Conclusion + +> ❗**A true "language master"** +> +> Doesn't just memorize a lot of language syntax +> +> But: +> +> 👉 **For the same piece of code, they see 6 more layers of meaning than others** + +--- + +# IX. Engineering-Level Self-Test (Very Accurate) + +When you see an unfamiliar piece of code, ask yourself: + +1. Do I know where its data is? (L2 / L10) +2. Do I know when it executes? (L4 / L9) +3. Do I know what happens if it fails? (L5 / L11) +4. Do I know what the author is trying to prevent? (L12) + +✅ **All YES = Truly 100% Understood** + +--- + +# X. Recommended Learning Resources for Each Level + +| Level | Recommended Resources | +|:---|:---| +| L1 Control Syntax | Official tutorials for any language | +| L2 Memory Model | "Computer Systems: A Programmer's Perspective" (CSAPP) | +| L3 Type System | "Types and Programming Languages" | +| L4 Execution Model | "JavaScript Asynchronous Programming", Rust async book | +| L5 Error Model | Go/Rust official error handling guides | +| L6 Meta-Syntax | Python decorator source code, Rust macro mini-book | +| L7 Paradigm | "Functional Programming Thinking", Haskell introduction | +| L8 Domain Ecosystem | Framework official documentation + source code | +| L9 Time Model | Practical performance analysis tools (perf, py-spy) | +| L10 Resource Model | "Systems Performance: Enterprise and the Cloud" | +| L11 Implicit Contract | Read CONTRIBUTING.md of well-known open-source projects | +| L12 Design Intent | Participate in Code Review, read RFC/design documents | + +--- + +# XI. Common Language Level Comparison Table + +| Level | Python | Rust | Go | JavaScript | +|:---|:---|:---|:---|:---| +| L2 Memory | Reference-based, GC | Ownership + Borrowing | Value/Pointer, GC | Reference-based, GC | +| L3 Type | Dynamic, type hints | Static, strong typing | Static, concise | Dynamic, TS optional | +| L4 Execution | asyncio/GIL | tokio/async | goroutine/channel | event loop | +| L5 Error | try/except | Result/Option | error return values | try/catch/Promise | +| L6 Meta-Syntax | Decorators/metaclass | Macros | go generate | Proxy/Reflect | +| L7 Paradigm | Multi-paradigm | Multi-paradigm, leaning FP | Procedural + Interfaces | Multi-paradigm | +| L9 Time | GIL limits parallelism | Zero-cost async | Preemptive scheduling | Single-threaded event loop | +| L10 Resource | CPU limited by GIL | Zero-cost abstractions | Lightweight goroutines | IO-bound friendly | + +--- + +# XII. Practical Code Onion Peeling Example + +Taking a FastAPI route as an example, layer-by-layer analysis: + +```python + @app.get("/users/{user_id}") +async def get_user(user_id: int, db: Session = Depends(get_db)): + user = await db.execute(select(User).where(User.id == user_id)) + if not user: + raise HTTPException(status_code=404) + return user +``` + +| Level | What you should see | +|:---|:---| +| L1 | Function definition, if, return | +| L2 | `user` is a reference, `db` is a shared connection | +| L3 | `user_id: int` type constraint, automatic validation | +| L4 | `async/await` non-blocking, does not occupy a thread | +| L5 | `HTTPException` interrupts request, framework catches | +| L6 | ` @app.get` decorator registers route, `Depends` dependency injection | +| L7 | Declarative routing, functional processing | +| L8 | FastAPI conventions, SQLAlchemy ORM | +| L9 | Each request is an independent coroutine, `await` yields control | +| L10 | IO-bound (database query), suitable for async | +| L11 | `db` must be thread-safe, cannot share state across requests | +| L12 | The author uses type hints + DI to enforce norms, preventing raw SQL and hardcoding | + +--- + +# XIII. Training Path from L1→L12 + +## Phase One: Foundation Layer (L1-L3) +- **Method** : LeetCode + Type gymnastics +- **Goal** : Syntax proficiency, type intuition +- **Practice** : + - LeetCode 100 problems (any language) + - TypeScript type gymnastics + - Rust lifetime exercises + +## Phase Two: Execution Layer (L4-L6) +- **Method** : Read asynchronous framework source code +- **Goal** : Understand runtime behavior +- **Practice** : + - Hand-write a simple Promise + - Read asyncio source code + - Write a Python decorator library + +## Phase Three: Paradigm Layer (L7-L9) +- **Method** : Rewrite the same project in multiple languages +- **Goal** : Understand design tradeoffs +- **Practice** : + - Implement the same CLI tool using Python/Go/Rust + - Compare the performance and code volume of the three implementations + - Analyze the differences in time models across languages + +## Phase Four: Architecture Layer (L10-L12) +- **Method** : Participate in open-source Code Review +- **Goal** : Understand design intent +- **Practice** : + - Submit PRs to well-known projects and receive reviews + - Read RFC/design documents for 3 projects + - Write an API design document and have others review it + +--- + +# XIV. Ultimate Test: Which layer have you reached? + +| Capability | Layer | +|:---|:---| +| Can write runnable code | L1-L3 | +| Can debug async/concurrent bugs | L4-L6 | +| Can quickly pick up new languages | L7-L8 | +| Can perform performance optimization | L9-L10 | +| Can write production-grade code | L11 | +| Can design API/architecture | L12 | + +> 🎯 **The goal is not "to learn all 12 layers", but "to know which layer you're stuck on when you encounter a problem"** diff --git a/i18n/en/documents/00-fundamentals/README.md b/i18n/en/documents/00-fundamentals/README.md index 1666ee7..dec9ff7 100644 --- a/i18n/en/documents/00-fundamentals/README.md +++ b/i18n/en/documents/00-fundamentals/README.md @@ -11,3 +11,5 @@ Core concepts and methodology for Vibe Coding. - [The Way of Programming](./The%20Way%20of%20Programming.md) - [Code Organization](./Code%20Organization.md) - [General Project Architecture Template](./General%20Project%20Architecture%20Template.md) +- [Common Pitfalls](./Common%20Pitfalls.md) - Common issues and solutions +- [Language Layer Elements](./Language%20Layer%20Elements.md) - 12-level code understanding framework diff --git a/i18n/en/documents/03-practice/bot-automation/.gitkeep b/i18n/en/documents/03-practice/bot-automation/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/en/documents/03-practice/cli-tool/.gitkeep b/i18n/en/documents/03-practice/cli-tool/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/en/documents/03-practice/data-pipeline/.gitkeep b/i18n/en/documents/03-practice/data-pipeline/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/en/documents/03-practice/game-dev/.gitkeep b/i18n/en/documents/03-practice/game-dev/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/en/documents/04-resources/External Resource Aggregation.md b/i18n/en/documents/04-resources/External Resource Aggregation.md new file mode 100644 index 0000000..264377a --- /dev/null +++ b/i18n/en/documents/04-resources/External Resource Aggregation.md @@ -0,0 +1,523 @@ +# 🔗 External Resource Aggregation + +> Summary of high-quality external resources related to Vibe Coding +> +> Last updated: 2025-12-18 + +--- + +
+🎙️ Quality Bloggers + +### 𝕏 (Twitter) Bloggers + +| Blogger | Link | Description | +|:---|:---|:---| +| @shao__meng | [x.com/shao__meng](https://x.com/shao__meng) | | +| @0XBard_thomas | [x.com/0XBard_thomas](https://x.com/0XBard_thomas) | | +| @Pluvio9yte | [x.com/Pluvio9yte](https://x.com/Pluvio9yte) | | +| @xDinoDeer | [x.com/xDinoDeer](https://x.com/xDinoDeer) | | +| @geekbb | [x.com/geekbb](https://x.com/geekbb) | | +| @GitHub_Daily | [x.com/GitHub_Daily](https://x.com/GitHub_Daily) | | +| @BiteyeCN | [x.com/BiteyeCN](https://x.com/BiteyeCN) | | +| @CryptoJHK | [x.com/CryptoJHK](https://x.com/CryptoJHK) | | +| @rohanpaul_ai | [x.com/rohanpaul_ai](https://x.com/rohanpaul_ai) | | +| @DataChaz | [x.com/DataChaz](https://x.com/DataChaz) | | + +### 📺 YouTube Bloggers + +| Blogger | Link | Description | +|:---|:---|:---| +| Best Partners | [youtube.com/ @bestpartners](https://www.youtube.com/ @bestpartners) | | +| 王路飞 | [youtube.com/ @王路飞](https://www.youtube.com/ @%E7%8E%8B%E8%B7%AF%E9%A3%9E) | | +| 即刻风 | [youtube.com/ @jidifeng](https://www.youtube.com/ @jidifeng) | | +| 3Blue1Brown | [youtube.com/ @3blue1brown](https://www.youtube.com/ @3blue1brown) | Math visualization | +| Andrej Karpathy | [youtube.com/andrejkarpathy](https://www.youtube.com/andrejkarpathy) | AI/Deep Learning | + +### 📱 WeChat Video Accounts + +| Blogger | Description | +|:---|:---| +| 美国的牛粪博士 | | + +### 🎵 Douyin + +| Blogger | Description | +|:---|:---| + +
+ +--- + +
+🤖 AI Tools and Platforms + +### 💬 AI Chat Platforms + +#### Tier 1 (Recommended) + +| Platform | Model | Features | +|:---|:---|:---| +| [Claude](https://claude.ai/) | Claude Opus 4.5 | Strong coding capabilities, supports Artifacts | +| [ChatGPT](https://chatgpt.com/) | GPT-5.1 | Strong comprehensive capabilities, supports Codex | +| [Gemini](https://gemini.google.com/) | Gemini 3.0 Pro | Large free quota, supports long context | + +#### Domestic Platforms + +| Platform | Model | Features | +|:---|:---|:---| +| [Kimi](https://kimi.moonshot.cn/) | Kimi K2 | Strong long-text processing | +| [Tongyi Qianwen](https://tongyi.aliyun.com/) | Qwen | Developed by Alibaba, free | +| [Zhipu Qingyan](https://chatglm.cn/) | GLM-4 | Developed by Zhipu AI | +| [Doubao](https://www.doubao.com/) | Doubao | Developed by ByteDance | + +### 🖥️ AI Programming IDEs + +| Tool | Link | Description | +|:---|:---|:---| +| Cursor | [cursor.com](https://cursor.com/) | AI-native editor, based on VS Code | +| Windsurf | [windsurf.com](https://windsurf.com/) | From Codeium | +| Kiro | [kiro.dev](https://kiro.dev/) | From AWS, free Claude Opus | +| Zed | [zed.dev](https://zed.dev/) | High-performance editor, supports AI | + +### ⌨️ AI CLI Tools + +| Tool | Command | Description | +|:---|:---|:---| +| Claude Code | `claude` | Anthropic official CLI | +| Codex CLI | `codex` | OpenAI official CLI | +| Gemini CLI | `gemini` | Google official CLI, 1000 free uses/day | +| Aider | `aider` | Open-source AI pair programming, Git integration | +| OpenCode | `opencode` | Open-source terminal AI assistant, written in Go | +| Cline CLI | `cline` | VS Code extension companion CLI | + +### 🤖 AI Agent Platforms + +| Tool | Link | Description | +|:---|:---|:---| +| Devin | [devin.ai](https://devin.ai/) | Autonomous AI software engineer, $20/month | +| Replit Agent | [replit.com](https://replit.com/) | End-to-end application building Agent | +| v0 by Vercel | [v0.dev](https://v0.dev/) | AI UI generation, React + Tailwind | +| Bolt.new | [bolt.new](https://bolt.new/) | In-browser full-stack application building | +| Lovable | [lovable.dev](https://lovable.dev/) | Formerly GPT Engineer, natural language app building | + +### 🆓 Free Resources + +#### Completely Free + +| Resource | Link | Description | +|:---|:---|:---| +| AI Studio | [aistudio.google.com](https://aistudio.google.com/) | Google free Gemini | +| Gemini CLI | [geminicli.com](https://geminicli.com/) | Free command line access | +| antigravity | [antigravity.google](https://antigravity.google/) | Google free AI service | +| Qwen CLI | [qwenlm.github.io](https://qwenlm.github.io/qwen-code-docs/zh/cli/) | Alibaba free CLI | + +#### With Free Quotas + +| Resource | Link | Description | +|:---|:---|:---| +| Kiro | [kiro.dev](https://kiro.dev/) | Free Claude Opus 4.5 | +| Windsurf | [windsurf.com](https://windsurf.com/) | Free quota for new users | +| GitHub Copilot | [github.com/copilot](https://github.com/copilot) | Free for students/open source | +| Codeium | [codeium.com](https://codeium.com/) | Free AI code completion | +| Tabnine | [tabnine.com](https://www.tabnine.com/) | Free basic version | +| Continue | [continue.dev](https://continue.dev/) | Open-source AI code assistant | +| Bito | [bito.ai](https://bito.ai/) | Free AI code assistant | + +### 🎨 AI Generation Tools + +| Type | Tool | Link | +|:---|:---|:---| +| Image | Midjourney | [midjourney.com](https://midjourney.com/) | +| Image | DALL-E 3 | [ChatGPT](https://chatgpt.com/) | +| Image | Ideogram | [ideogram.ai](https://ideogram.ai/) | +| Image | Leonardo AI | [leonardo.ai](https://leonardo.ai/) | +| Music | Suno | [suno.ai](https://suno.ai/) | +| Music | Udio | [udio.com](https://www.udio.com/) | +| Sound Effects | ElevenLabs | [elevenlabs.io](https://elevenlabs.io/) | +| Video | Sora | [sora.com](https://sora.com/) | +| Video | Runway | [runwayml.com](https://runwayml.com/) | +| Video | Kling | [klingai.com](https://klingai.com/) | +| 3D | Meshy | [meshy.ai](https://www.meshy.ai/) | + +
+ +--- + +
+📝 Prompt Resources + +### Prompt Libraries + +| Resource | Link | Description | +|:---|:---|:---| +| Online Prompt Table | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1) | Recommended | +| Meta Prompt Library | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220) | | +| System Prompts Repository | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | | +| Awesome ChatGPT Prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | | + +### Prompt Tools + +| Tool | Link | Description | +|:---|:---|:---| +| Skills Maker | [GitHub](https://github.com/yusufkaraaslan/Skill_Seekers) | Generates customized Skills | +| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | Structured prompt framework | + +### Prompt Tutorials + +| Tutorial | Link | Description | +|:---|:---|:---| +| Prompt Engineering Guide | [promptingguide.ai](https://www.promptingguide.ai/zh) | Chinese version | +| Learn Prompting | [learnprompting.org](https://learnprompting.org/zh-Hans/) | Chinese version | +| OpenAI Prompt Engineering | [platform.openai.com](https://platform.openai.com/docs/guides/prompt-engineering) | Official | +| Anthropic Prompt Engineering | [docs.anthropic.com](https://docs.anthropic.com/claude/docs/prompt-engineering) | Official | +| State-Of-The-Art Prompting | [Google Docs](https://docs.google.com/document/d/11tBoylc5Pvy8wDp9_i2UaAfDi8x02iMNg9mhCNv65cU/) | YC top tips | +| Vibe Coding 101 | [Google Drive](https://drive.google.com/file/d/1OMiqUviji4aI56E14PLaGVJsbjhOP1L1/view) | Beginner's Guide | + +
+ +--- + +
+👥 Communities and Forums + +### Telegram + +| Community | Link | Description | +|:---|:---|:---| +| Vibe Coding Exchange Group | [t.me/glue_coding](https://t.me/glue_coding) | | +| Vibe Coding Channel | [t.me/tradecat_ai_channel](https://t.me/tradecat_ai_channel) | | + +### Discord + +| Community | Link | Description | +|:---|:---|:---| +| Cursor Discord | [discord.gg/cursor](https://discord.gg/cursor) | | +| Anthropic Discord | [discord.gg/anthropic](https://discord.gg/anthropic) | | +| Cline Discord | [discord.gg/cline](https://discord.gg/cline) | | +| Aider Discord | [discord.gg/aider](https://discord.gg/Tv2uQnR88V) | | +| Windsurf Discord | [discord.gg/codeium](https://discord.gg/codeium) | | + +### Reddit + +| Community | Link | Description | +|:---|:---|:---| +| r/ChatGPT | [reddit.com/r/ChatGPT](https://www.reddit.com/r/ChatGPT/) | ChatGPT Community | +| r/ClaudeAI | [reddit.com/r/ClaudeAI](https://www.reddit.com/r/ClaudeAI/) | Claude Community | +| r/Bard | [reddit.com/r/Bard](https://www.reddit.com/r/Bard/) | Gemini Community | +| r/PromptEngineering | [reddit.com/r/PromptEngineering](https://www.reddit.com/r/PromptEngineering/) | Prompt Engineering | +| r/ChatGPTPromptGenius | [reddit.com/r/ChatGPTPromptGenius](https://www.reddit.com/r/ChatGPTPromptGenius/) | Prompt Sharing | +| r/LocalLLaMA | [reddit.com/r/LocalLLaMA](https://www.reddit.com/r/LocalLLaMA/) | Local LLM | + +### X (Twitter) + +| Community | Link | Description | +|:---|:---|:---| +| Vibe Coding Community | [x.com/communities](https://x.com/i/communities/1993849457210011871) | | +| Community Dry Goods Aggregation Page | [x.com/vibeverything](https://x.com/vibeverything/status/1999796188053438687) | | + +
+ +--- + +
+🐙 GitHub Featured Repositories + +### CLI Tools + +| Repository | Link | Description | +|:---|:---|:---| +| claude-code | [GitHub](https://github.com/anthropics/claude-code) | Anthropic official CLI | +| aider | [GitHub](https://github.com/paul-gauthier/aider) | AI pair programming tool | +| gpt-engineer | [GitHub](https://github.com/gpt-engineer-org/gpt-engineer) | Natural language code generation | +| open-interpreter | [GitHub](https://github.com/OpenInterpreter/open-interpreter) | Local code interpreter | +| continue | [GitHub](https://github.com/continuedev/continue) | Open-source AI code assistant | +| spec-kit | [GitHub](https://github.com/github/spec-kit) | GitHub official Spec-Driven development toolkit | +| opencode | [GitHub](https://github.com/opencode-ai/opencode) | Open-source terminal AI assistant, written in Go | +| oh-my-opencode | [GitHub](https://github.com/code-yeongyu/oh-my-opencode) | OpenCode configuration and plugins | +| cline | [GitHub](https://github.com/cline/cline) | VS Code autonomous programming Agent | +| gemini-cli | [GitHub](https://github.com/google-gemini/gemini-cli) | Google official CLI | + +### IDE Plugins + +| Repository | Link | Description | +|:---|:---|:---| +| copilot.vim | [GitHub](https://github.com/github/copilot.vim) | GitHub Copilot Vim plugin | +| codeium | [GitHub](https://github.com/Exafunction/codeium.vim) | Free AI code completion | +| avante.nvim | [GitHub](https://github.com/yetone/avante.nvim) | Neovim AI assistant plugin | +| codecompanion.nvim | [GitHub](https://github.com/olimorris/codecompanion.nvim) | Neovim AI programming companion | + +### Prompt Engineering + +| Repository | Link | Description | +|:---|:---|:---| +| awesome-chatgpt-prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | ChatGPT prompt collection | +| awesome-chatgpt-prompts-zh | [GitHub](https://github.com/PlexPt/awesome-chatgpt-prompts-zh) | Chinese prompts | +| system-prompts-and-models-of-ai-tools | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | AI tool system prompts | +| claude-code-system-prompts | [GitHub](https://github.com/Piebald-AI/claude-code-system-prompts) | Claude Code system prompts | +| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | Structured prompt framework | + +### Agent Frameworks + +| Repository | Link | Description | +|:---|:---|:---| +| langchain | [GitHub](https://github.com/langchain-ai/langchain) | LLM application development framework | +| autogen | [GitHub](https://github.com/microsoft/autogen) | Multi-Agent conversation framework | +| crewai | [GitHub](https://github.com/joaomdmoura/crewAI) | AI Agent collaboration framework | +| dspy | [GitHub](https://github.com/stanfordnlp/dspy) | Programmatic LLM framework | +| MCAF | [mcaf.managed-code.com](https://mcaf.managed-code.com/) | AI programming framework, defines AGENTS.md specification | +| smolagents | [GitHub](https://github.com/huggingface/smolagents) | HuggingFace lightweight Agent framework | +| pydantic-ai | [GitHub](https://github.com/pydantic/pydantic-ai) | Type-safe AI Agent framework | +| browser-use | [GitHub](https://github.com/browser-use/browser-use) | AI browser automation | + +### Learning Resources + +| Repository | Link | Description | +|:---|:---|:---| +| prompt-engineering-guide | [GitHub](https://github.com/dair-ai/Prompt-Engineering-Guide) | Prompt Engineering Guide | +| generative-ai-for-beginners | [GitHub](https://github.com/microsoft/generative-ai-for-beginners) | Microsoft Generative AI tutorial | +| llm-course | [GitHub](https://github.com/mlabonne/llm-course) | LLM learning roadmap | +| ai-engineering | [GitHub](https://github.com/chiphuyen/aie-book) | AI Engineering practice | +| awesome-llm | [GitHub](https://github.com/Hannibal046/Awesome-LLM) | LLM resource compilation | +| vibe-vibe | [GitHub](https://github.com/datawhalechina/vibe-vibe) | Datawhale Vibe Coding tutorial | +| AI 编程最佳实践 | [GitHub](https://github.com/ninehills/blog/issues/97) | ninehills AI programming experience | + +### Utility Tools + +| Repository | Link | Description | +|:---|:---|:---| +| ollama | [GitHub](https://github.com/ollama/ollama) | Runs local LLMs | +| localai | [GitHub](https://github.com/mudler/LocalAI) | Local AI API | +| text-generation-webui | [GitHub](https://github.com/oobabooga/text-generation-webui) | Text Generation WebUI | +| lmstudio | [lmstudio.ai](https://lmstudio.ai/) | Local model GUI tool | +| jan | [GitHub](https://github.com/janhq/jan) | Open-source local AI assistant | +| repomix | [GitHub](https://github.com/yamadashy/repomix) | Packages codebases for AI context | +| gitingest | [GitHub](https://github.com/cyclotruc/gitingest) | Converts Git repositories to AI-friendly format | + +
+ +--- + +
+🔧 Development Tools + +### IDEs & Editors + +| Tool | Link | Description | +|:---|:---|:---| +| VS Code | [code.visualstudio.com](https://code.visualstudio.com/) | Mainstream editor | +| Cursor | [cursor.com](https://cursor.com/) | AI-native editor, based on VS Code | +| Windsurf | [windsurf.com](https://windsurf.com/) | Codeium AI IDE | +| Neovim | [neovim.io](https://neovim.io/) | Keyboard-centric preference | +| LazyVim | [lazyvim.org](https://www.lazyvim.org/) | Neovim configuration framework | +| Zed | [zed.dev](https://zed.dev/) | High-performance editor, supports AI | +| Void | [voideditor.com](https://voideditor.com/) | Open-source AI code editor | +| PearAI | [trypear.ai](https://trypear.ai/) | Open-source AI IDE | + +### Terminal Tools + +| Tool | Link | Description | +|:---|:---|:---| +| Warp | [warp.dev](https://www.warp.dev/) | AI terminal | +| tmux | [GitHub](https://github.com/tmux/tmux) | Terminal multiplexer | +| zsh | [ohmyz.sh](https://ohmyz.sh/) | Shell enhancement | + +### Web Frameworks + +| Tool | Link | Description | +|:---|:---|:---| +| Django | [djangoproject.com](https://www.djangoproject.com/) | Python full-stack Web framework | + +### Database Tools + +| Tool | Link | Description | +|:---|:---|:---| +| DBeaver | [dbeaver.io](https://dbeaver.io/) | Universal database client | +| TablePlus | [tableplus.com](https://tableplus.com/) | Modern database GUI | + +### Visualization Tools + +| Tool | Link | Description | +|:---|:---|:---| +| Mermaid | [mermaid.js.org](https://mermaid.js.org/) | Text to diagrams | +| Excalidraw | [excalidraw.com](https://excalidraw.com/) | Hand-drawn style diagrams | +| NotebookLM | [notebooklm.google.com](https://notebooklm.google.com/) | AI note-taking tool | + +
+ +--- + +
+📖 Tutorials & Courses + +### Official Documentation + +| Document | Link | Description | +|:---|:---|:---| +| Claude Documentation | [docs.anthropic.com](https://docs.anthropic.com/) | Anthropic Official | +| OpenAI Documentation | [platform.openai.com](https://platform.openai.com/docs/) | OpenAI Official | +| Gemini Documentation | [ai.google.dev](https://ai.google.dev/docs) | Google Official | + +### Community Tutorials + +| Tutorial | Link | Description | +|:---|:---|:---| +| Erge's Java Advanced Path | [javabetter.cn](https://javabetter.cn/) | Development tool configuration tutorial | +| Super Individual Resource List | [x.com/BiteyeCN](https://x.com/BiteyeCN/status/2000856243645157387) | | + +
+ +--- + +
+🌐 Network Configuration + +### Proxy Clients + +| Tool | Link | Description | +|:---|:---|:---| +| FlClash | [GitHub](https://github.com/chen08209/FlClash/releases) | Cross-platform proxy client | + +### Network Services + +| Service | Link | Description | +|:---|:---|:---| +| Airport Service | [链接](https://xn--9kqz23b19z.com/#/register?code=35BcnKzl) | Approximately 6 CNY/month and up | + +
+ +--- + +
+💳 Payment Tools + +### Virtual Cards + +| Service | Link | Description | +|:---|:---|:---| +| Bybit Virtual Card | [bybit.com/cards](https://www.bybit.com/cards/?ref=YDGAVPN&source=applet_invite) | Used for international payments like cloud services registration | + +
+ +--- + +
+📏 Rules/Rule Files + +### AI Programming Rules + +| Repository | Link | Description | +|:---|:---|:---| +| awesome-cursorrules | [GitHub](https://github.com/PatrickJS/awesome-cursorrules) | Cursor Rules collection | +| cursor.directory | [cursor.directory](https://cursor.directory/) | Cursor Rules online directory | +| dotcursorrules | [GitHub](https://github.com/pontusab/dotcursorrules) | .cursorrules template | +| claude-code-system-prompts | [GitHub](https://github.com/Piebald-AI/claude-code-system-prompts) | Claude Code system prompts | + +
+ +--- + +
+📦 Templates/Scaffolding + +### Project Templates + +| Repository | Link | Description | +|:---|:---|:---| +| create-t3-app | [GitHub](https://github.com/t3-oss/create-t3-app) | Full-stack TypeScript scaffolding | +| create-next-app | [nextjs.org](https://nextjs.org/docs/app/api-reference/cli/create-next-app) | Next.js official scaffolding | +| vite | [GitHub](https://github.com/vitejs/vite) | Modern frontend build tool | +| fastapi-template | [GitHub](https://github.com/tiangolo/full-stack-fastapi-template) | FastAPI full-stack template | +| shadcn/ui | [ui.shadcn.com](https://ui.shadcn.com/) | React UI component library | + +
+ +--- + +
+📚 Documentation/Knowledge Base Tools + +### RAG Related + +| Tool | Link | Description | +|:---|:---|:---| +| RAGFlow | [GitHub](https://github.com/infiniflow/ragflow) | Open-source RAG engine | +| Dify | [GitHub](https://github.com/langgenius/dify) | LLM application development platform | +| AnythingLLM | [GitHub](https://github.com/Mintplex-Labs/anything-llm) | Private document AI assistant | +| Quivr | [GitHub](https://github.com/QuivrHQ/quivr) | Personal knowledge base AI | +| PrivateGPT | [GitHub](https://github.com/zylon-ai/private-gpt) | Private document Q&A | + +### Documentation Tools + +| Tool | Link | Description | +|:---|:---|:---| +| Docusaurus | [docusaurus.io](https://docusaurus.io/) | Meta open-source documentation framework | +| VitePress | [vitepress.dev](https://vitepress.dev/) | Vue-powered static site | +| Mintlify | [mintlify.com](https://mintlify.com/) | AI document generation | +| Zread | [zread.ai](https://zread.ai/) | AI repository reading tool | + +
+ +--- + +
+✅ Code Quality/Testing + +### AI Code Review + +| Tool | Link | Description | +|:---|:---|:---| +| | | To be supplemented | + +
+ +--- + +
+🚀 Deployment/DevOps + +### One-Click Deployment + +| Platform | Link | Description | +|:---|:---|:---| +| | | To be supplemented | + +
+ +--- + +
+🎯 Specific Domains + +### Web3/Blockchain + +| Tool | Link | Description | +|:---|:---|:---| +| | | To be supplemented | + +### Data Science/ML + +| Tool | Link | Description | +|:---|:---|:---| +| | | To be supplemented | + +
+ +--- + +
+🇨🇳 Chinese Resource Zone + +### Domestic Mirrors/Accelerators + +| Resource | Link | Description | +|:---|:---|:---| +| | | To be supplemented | + +
+ +--- + +## 📝 Contribution + +Found good resources? Welcome PRs to supplement! diff --git a/i18n/en/documents/04-resources/README.md b/i18n/en/documents/04-resources/README.md index da2d75e..06c4aec 100644 --- a/i18n/en/documents/04-resources/README.md +++ b/i18n/en/documents/04-resources/README.md @@ -1,322 +1,9 @@ -# 🔗 External Resource Aggregation +# 04-Resources -> A collection of high-quality external resources related to Vibe Coding +Templates, tools, and external resources. ---- +## Contents -
-🎙️ Quality Bloggers/Influencers - -### 𝕏 (Twitter) Influencers - -| Influencer | Link | Description | -|:---|:---|:---| -| @shao__meng | [x.com/shao__meng](https://x.com/shao__meng) | | -| @0XBard_thomas | [x.com/0XBard_thomas](https://x.com/0XBard_thomas) | | -| @Pluvio9yte | [x.com/Pluvio9yte](https://x.com/Pluvio9yte) | | -| @xDinoDeer | [x.com/xDinoDeer](https://x.com/xDinoDeer) | | -| @geekbb | [x.com/geekbb](https://x.com/geekbb) | | -| @GitHub_Daily | [x.com/GitHub_Daily](https://x.com/GitHub_Daily) | | -| @BiteyeCN | [x.com/BiteyeCN](https://x.com/BiteyeCN) | | -| @CryptoJHK | [x.com/CryptoJHK](https://x.com/CryptoJHK) | | -| @rohanpaul_ai | [x.com/rohanpaul_ai](https://x.com/rohanpaul_ai) | | -| @DataChaz | [x.com/DataChaz](https://x.com/DataChaz) | | - -### 📺 YouTube Influencers - -| Influencer | Link | Description | -|:---|:---|:---| -| Best Partners | [youtube.com/@bestpartners](https://www.youtube.com/@bestpartners) | | -| 王路飞 | [youtube.com/@王路飞](https://www.youtube.com/@%E7%8E%8B%E8%B7%AF%E9%A3%9E) | | -| 即刻风 | [youtube.com/@jidifeng](https://www.youtube.com/@jidifeng) | | -| 3Blue1Brown | [youtube.com/@3blue1brown](https://www.youtube.com/@3blue1brown) | Math visualization | -| Andrej Karpathy | [youtube.com/andrejkarpathy](https://www.youtube.com/andrejkarpathy) | AI/Deep Learning | - -### 📱 WeChat Video Accounts - -| Influencer | Description | -|:---|:---| -| 美国的牛粪博士 | | - -### 🎵 Douyin (TikTok) - -| Influencer | Description | -|:---|:---| - -
- ---- - -
-🤖 AI Tools and Platforms - -### 💬 AI Chat Platforms - -#### Tier 1 (Recommended) - -| Platform | Model | Features | -|:---|:---|:---| -| [Claude](https://claude.ai/) | Claude Opus 4.5 | Strong code capabilities, supports Artifacts | -| [ChatGPT](https://chatgpt.com/) | GPT-5.1 | Strong overall capabilities, supports Codex | -| [Gemini](https://gemini.google.com/) | Gemini 3.0 Pro | Large free tier, supports long context | - -#### Domestic Platforms - -| Platform | Model | Features | -|:---|:---|:---| -| [Kimi](https://kimi.moonshot.cn/) | Kimi K2 | Strong long-text processing | -| [Tongyi Qianwen](https://tongyi.aliyun.com/) | Qwen | From Alibaba, free | -| [Zhipu Qingyan](https://chatglm.cn/) | GLM-4 | From Zhipu AI | -| [Doubao](https://www.doubao.com/) | Doubao | From ByteDance | - -### 🖥️ AI Programming IDEs - -| Tool | Link | Description | -|:---|:---|:---| -| Cursor | [cursor.com](https://cursor.com/) | AI-native editor, based on VS Code | -| Windsurf | [windsurf.com](https://windsurf.com/) | From Codeium | -| Kiro | [kiro.dev](https://kiro.dev/) | From AWS, free Claude Opus | -| Zed | [zed.dev](https://zed.dev/) | High-performance editor, supports AI | - -### ⌨️ AI CLI Tools - -| Tool | Command | Description | -|:---|:---|:---| -| Claude Code | `claude` | Anthropic official CLI | -| Codex CLI | `codex` | OpenAI official CLI | -| Gemini CLI | `gemini` | Google official CLI, free | -| Aider | `aider` | Open-source AI pair programming | - -### 🆓 Free Resources - -#### Completely Free - -| Resource | Link | Description | -|:---|:---|:---| -| AI Studio | [aistudio.google.com](https://aistudio.google.com/) | Google free Gemini | -| Gemini CLI | [geminicli.com](https://geminicli.com/) | Free command-line access | -| antigravity | [antigravity.google](https://antigravity.google/) | Google free AI service | -| Qwen CLI | [qwenlm.github.io](https://qwenlm.github.io/qwen-code-docs/zh/cli/) | Alibaba free CLI | - -#### With Free Tier - -| Resource | Link | Description | -|:---|:---|:---| -| Kiro | [kiro.dev](https://kiro.dev/) | Free Claude Opus 4.5 | -| Windsurf | [windsurf.com](https://windsurf.com/) | Free tier for new users | -| GitHub Copilot | [github.com/copilot](https://github.com/copilot) | Free for students/open source | - -### 🎨 AI Generation Tools - -| Type | Tool | Link | -|:---|:---|:---| -| Image | Midjourney | [midjourney.com](https://midjourney.com/) | -| Image | DALL-E 3 | [ChatGPT](https://chatgpt.com/) | -| Music | Suno | [suno.ai](https://suno.ai/) | -| Sound | ElevenLabs | [elevenlabs.io](https://elevenlabs.io/) | -| Video | Sora | [sora.com](https://sora.com/) | - -
- ---- - -
-👥 Communities and Forums - -### Telegram - -| Community | Link | Description | -|:---|:---|:---| -| Vibe Coding Discussion Group | [t.me/glue_coding](https://t.me/glue_coding) | | -| Vibe Coding Channel | [t.me/tradecat_ai_channel](https://t.me/tradecat_ai_channel) | | - -### Discord - -| Community | Link | Description | -|:---|:---|:---| -| Cursor Discord | [discord.gg/cursor](https://discord.gg/cursor) | | -| Anthropic Discord | [discord.gg/anthropic](https://discord.gg/anthropic) | | - -### X (Twitter) - -| Community | Link | Description | -|:---|:---|:---| -| Vibe Coding Community | [x.com/communities](https://x.com/i/communities/1993849457210011871) | | -| Community Content Aggregation | [x.com/vibeverything](https://x.com/vibeverything/status/1999796188053438687) | | - -
- ---- - -
-📝 Prompt Resources - -### Prompt Libraries - -| Resource | Link | Description | -|:---|:---|:---| -| Online Prompt Table | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1) | Recommended | -| Meta Prompt Library | [Google Sheets](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220) | | -| System Prompts Repository | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | | -| Awesome ChatGPT Prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | | - -### Prompt Tools - -| Tool | Link | Description | -|:---|:---|:---| -| Skills Maker | [GitHub](https://github.com/yusufkaraaslan/Skill_Seekers) | Generates customized Skills | -| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | Structured prompt framework | - -### Prompt Tutorials - -| Tutorial | Link | Description | -|:---|:---|:---| -| Prompt Engineering Guide | [promptingguide.ai](https://www.promptingguide.ai/zh) | Chinese version | -| Learn Prompting | [learnprompting.org](https://learnprompting.org/zh-Hans/) | Chinese version | -| OpenAI Prompt Engineering | [platform.openai.com](https://platform.openai.com/docs/guides/prompt-engineering) | Official | -| Anthropic Prompt Engineering | [docs.anthropic.com](https://docs.anthropic.com/claude/docs/prompt-engineering) | Official | -| State-Of-The-Art Prompting | [Google Docs](https://docs.google.com/document/d/11tBoylc5Pvy8wDp9_i2UaAfDi8x02iMNg9mhCNv65cU/) | YC Top Tips | -| Vibe Coding 101 | [Google Drive](https://drive.google.com/file/d/1OMiqUviji4aI56E14PLaGVJsbjhOP1L1/view) | Beginner's Guide | - -
- ---- - -
-🐙 GitHub Featured Repositories - -### CLI Tools - -| Repository | Link | Description | -|:---|:---|:---| -| claude-code | [GitHub](https://github.com/anthropics/claude-code) | Anthropic official CLI | -| aider | [GitHub](https://github.com/paul-gauthier/aider) | AI pair programming tool | -| gpt-engineer | [GitHub](https://github.com/gpt-engineer-org/gpt-engineer) | Natural language code generation | -| open-interpreter | [GitHub](https://github.com/OpenInterpreter/open-interpreter) | Local code interpreter | -| continue | [GitHub](https://github.com/continuedev/continue) | Open-source AI code assistant | -| spec-kit | [GitHub](https://github.com/github/spec-kit) | GitHub official Spec-Driven development toolkit | - -### IDE Plugins - -| Repository | Link | Description | -|:---|:---|:---| -| copilot.vim | [GitHub](https://github.com/github/copilot.vim) | GitHub Copilot Vim plugin | -| codeium | [GitHub](https://github.com/Exafunction/codeium.vim) | Free AI code completion | - -### Prompt Engineering - -| Repository | Link | Description | -|:---|:---|:---| -| awesome-chatgpt-prompts | [GitHub](https://github.com/f/awesome-chatgpt-prompts) | ChatGPT prompt collection | -| awesome-chatgpt-prompts-zh | [GitHub](https://github.com/PlexPt/awesome-chatgpt-prompts-zh) | Chinese prompts | -| system-prompts-and-models-of-ai-tools | [GitHub](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | AI tool system prompts | -| LangGPT | [GitHub](https://github.com/langgptai/LangGPT) | Structured prompt framework | - -### Agent Frameworks - -| Repository | Link | Description | -|:---|:---|:---| -| langchain | [GitHub](https://github.com/langchain-ai/langchain) | LLM application development framework | -| autogen | [GitHub](https://github.com/microsoft/autogen) | Multi-Agent conversation framework | -| crewai | [GitHub](https://github.com/joaomdmoura/crewAI) | AI Agent collaboration framework | -| dspy | [GitHub](https://github.com/stanfordnlp/dspy) | Programmatic LLM framework | -| MCAF | [mcaf.managed-code.com](https://mcaf.managed-code.com/) | AI programming framework, defines AGENTS.md specification | - -### MCP Related - -| Repository | Link | Description | -|:---|:---|:---| -| mcp-servers | [GitHub](https://github.com/modelcontextprotocol/servers) | MCP server collection | -| awesome-mcp-servers | [GitHub](https://github.com/punkpeye/awesome-mcp-servers) | MCP resource aggregation | - -### Learning Resources - -| Repository | Link | Description | -|:---|:---|:---| -| prompt-engineering-guide | [GitHub](https://github.com/dair-ai/Prompt-Engineering-Guide) | Prompt engineering guide | -| generative-ai-for-beginners | [GitHub](https://github.com/microsoft/generative-ai-for-beginners) | Microsoft Generative AI tutorial | -| llm-course | [GitHub](https://github.com/mlabonne/llm-course) | LLM learning roadmap | - -### Utilities - -| Repository | Link | Description | -|:---|:---|:---| -| ollama | [GitHub](https://github.com/ollama/ollama) | Local large model runner | -| localai | [GitHub](https://github.com/mudler/LocalAI) | Local AI API | -| text-generation-webui | [GitHub](https://github.com/oobabooga/text-generation-webui) | Text generation WebUI | - -
- ---- - -
-🔧 Development Tools - -### IDEs & Editors - -| Tool | Link | Description | -|:---|:---|:---| -| VS Code | [code.visualstudio.com](https://code.visualstudio.com/) | Mainstream editor | -| Cursor | [cursor.com](https://cursor.com/) | AI-native editor | -| Neovim | [neovim.io](https://neovim.io/) | Keyboard-centric choice | -| LazyVim | [lazyvim.org](https://www.lazyvim.org/) | Neovim configuration framework | -| Zed | [zed.dev](https://zed.dev/) | High-performance editor | - -### Terminal Tools - -| Tool | Link | Description | -|:---|:---|:---| -| Warp | [warp.dev](https://www.warp.dev/) | AI Terminal | -| tmux | [GitHub](https://github.com/tmux/tmux) | Terminal multiplexer | -| zsh | [ohmyz.sh](https://ohmyz.sh/) | Shell enhancement | - -### Web Frameworks - -| Tool | Link | Description | -|:---|:---|:---| -| Django | [djangoproject.com](https://www.djangoproject.com/) | Python full-stack Web framework | - -### Database Tools - -| Tool | Link | Description | -|:---|:---|:---| -| DBeaver | [dbeaver.io](https://dbeaver.io/) | Universal database client | -| TablePlus | [tableplus.com](https://tableplus.com/) | Modern database GUI | - -### Visualization Tools - -| Tool | Link | Description | -|:---|:---|:---| -| Mermaid | [mermaid.js.org](https://mermaid.js.org/) | Text to diagram | -| Excalidraw | [excalidraw.com](https://excalidraw.com/) | Hand-drawn style diagrams | -| NotebookLM | [notebooklm.google.com](https://notebooklm.google.com/) | AI note-taking tool | - -
- ---- - -
-📖 Tutorials and Courses - -### Official Documentation - -| Document | Link | Description | -|:---|:---|:---| -| Claude Documentation | [docs.anthropic.com](https://docs.anthropic.com/) | Anthropic official | -| OpenAI Documentation | [platform.openai.com](https://platform.openai.com/docs/) | OpenAI official | -| Gemini Documentation | [ai.google.dev](https://ai.google.dev/docs) | Google official | - -### Community Tutorials - -| Tutorial | Link | Description | -|:---|:---|:---| -| Erge's Java Advanced Path | [javabetter.cn](https://javabetter.cn/) | Development tool configuration tutorials | -| Super Individual Resource List | [x.com/BiteyeCN](https://x.com/BiteyeCN/status/2000856243645157387) | | - -
- ---- - -## 📝 Contribution - -Found good resources? Welcome PRs to supplement! +- [Tool Collection](./Tool%20Collection.md) - AI tools and development utilities +- [Recommended Programming Books](./Recommended%20Programming%20Books.md) +- [External Resource Aggregation](./External%20Resource%20Aggregation.md) - Curated external resources diff --git a/i18n/en/documents/04-resources/memory-bank-template/.gitkeep b/i18n/en/documents/04-resources/memory-bank-template/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/i18n/zh/documents/00-基础指南/gluecoding.md b/i18n/zh/documents/00-基础指南/gluecoding.md deleted file mode 100644 index cec78dd..0000000 --- a/i18n/zh/documents/00-基础指南/gluecoding.md +++ /dev/null @@ -1,162 +0,0 @@ -# Glue Coding (glue coding) Methodology - -## **1. Definition of Glue Coding** - -**Glue coding** is a new way of building software whose core idea is: - -> **Almost entirely reuse mature open-source components, and combine them into a complete system with a minimal amount of “glue code.”** - -It emphasizes “connecting” rather than “creating,” and is especially efficient in the AI era. - -## **2. Background** - -Traditional software engineering often requires developers to: - -* Design the architecture -* Write the logic themselves -* Manually handle various details -* Repeatedly reinvent the wheel - -This leads to high development costs, long cycles, and low success rates. - -The current ecosystem has fundamentally changed: - -* There are thousands of mature open-source libraries on GitHub -* Frameworks cover various scenarios (Web, AI, distributed systems, model inference…) -* GPT / Grok can help search, analyze, and combine these projects - -In this environment, writing code from scratch is no longer the most efficient way. - -Thus, “glue coding” becomes a new paradigm. - -## **3. Core Principles of Glue Coding** - -### **3.1 Don’t write what you don’t have to, and write as little as possible when you must** - -Any functionality with a mature existing implementation should not be reinvented. - -### **3.2 Copy-and-use whenever possible** - -Directly copying and using community-verified code is part of normal engineering practices, not laziness. - -### **3.3 Stand on the shoulders of giants, don’t try to become a giant** - -Leverage existing frameworks instead of trying to write another “better wheel” yourself. - -### **3.4 Do not modify upstream repository code** - -All open-source libraries should be kept immutable as much as possible and used as black boxes. - -### **3.5 The less custom code the better** - -The code you write should only be responsible for: - -* Composition -* Invocation -* Encapsulation -* Adaptation - -This is the so-called **glue layer**. - -## **4. Standard Process of Glue Coding** - -### **4.1 Clarify requirements** - -Break the system features to be implemented into individual requirement points. - -### **4.2 Use GPT/Grok to decompose requirements** - -Have AI refine requirements into reusable modules, capability points, and corresponding subtasks. - -### **4.3 Search for existing open-source implementations** - -Use GPT’s online capabilities (e.g., Grok): - -* Search GitHub repositories corresponding to each sub-requirement -* Check whether reusable components exist -* Compare quality, implementation approach, licenses, etc. - -### **4.4 Download and organize repositories** - -Pull the selected repositories locally and organize them. - -### **4.5 Organize according to the architecture** - -Place these repositories into the project structure, for example: - -``` -/services -/libs -/third_party -/glue -``` - -And emphasize: **Open-source repositories are third-party dependencies and must not be modified.** - -### **4.6 Write the glue layer code** - -The roles of the glue code include: - -* Encapsulating interfaces -* Unifying inputs and outputs -* Connecting different components -* Implementing minimal business logic - -The final system is assembled from multiple mature modules. - -## **5. Value of Glue Coding** - -### **5.1 Extremely high success rate** - -Because community-validated mature code is used. - -### **5.2 Very fast development** - -A large amount of functionality can be reused directly. - -### **5.3 Reduced costs** - -Time, maintenance, and learning costs are greatly reduced. - -### **5.4 More stable systems** - -Depend on mature frameworks rather than individual implementations. - -### **5.5 Easy to extend** - -Capabilities can be upgraded easily by replacing components. - -### **5.6 Highly compatible with AI** - -GPT can assist with searching, decomposing, and integrating — a natural enhancer for glue engineering. - -## **6. Glue Coding vs Traditional Development** - -| Item | Traditional Development | Glue Coding | -| ---------------------------- | ----------------------- | --------------------- | -| How features are implemented | Write yourself | Reuse open source | -| Workload | Large | Much smaller | -| Success rate | Uncertain | High | -| Speed | Slow | Extremely fast | -| Error rate | Prone to pitfalls | Uses mature solutions | -| Focus | “Invent wheels” | “Combine wheels” | - -## **7. Typical Application Scenarios for Glue Coding** - -* Rapid prototyping -* Small teams building large systems -* AI applications / model inference platforms -* Data processing pipelines -* Internal tool development -* System integration - -## **8. Future: Glue Engineering Will Become the New Mainstream Programming Approach** - -As AI capabilities continue to strengthen, future developers will no longer need to write large amounts of code themselves, but will instead: - -* Find wheels -* Combine wheels -* Intelligently connect components -* Build complex systems at very low cost - -Glue coding will become the new standard of software productivity.