From c0d6f7e3b1de31661acc0d8dcc99470baabbc7fc Mon Sep 17 00:00:00 2001
From: tukuaiai <tukuaiai@gmail.com>
Date: Sat, 13 Dec 2025 10:35:23 +0800
Subject: [PATCH] feat: Add CLAUDE.md and update README.md directory structure

- Add CLAUDE.md to the root directory.
- Update README.md's directory overview to include CLAUDE.md.
---
 CLAUDE.md | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md |  1 +
 2 files changed, 85 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..546f96c
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,84 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This is the **Vibe Coding CN** repository - a comprehensive guide and toolset for AI-assisted programming workflows. The project focuses on:
+- Systematic prompt engineering for AI coding assistants
+- Excel ↔ Markdown conversion tools for prompt management
+- Documentation and best practices for vibe coding methodology
+
+## Key Commands
+
+### Prompt Library Management
+```bash
+# Convert Excel prompts to Markdown documentation
+cd prompts/prompts-library
+python3 main.py
+
+# Non-interactive conversion
+python3 main.py --select "prompt_excel/prompt.xlsx"
+python3 main.py --select "prompt_docs/prompt_docs_2025_1213_080256"
+```
+
+### Development & Maintenance
+```bash
+# Lint markdown files
+make lint
+
+# Backup project (respects .gitignore)
+bash backups/一键备份.sh
+# or directly
+python3 backups/快速备份.py
+
+# Install dependencies for prompt library
+cd prompts/prompts-library
+pip install -r requirements.txt
+```
+
+## Architecture & Structure
+
+### Core Directories
+- **`prompts/`** - All AI prompts organized by type
+  - `coding_prompts/` - Development workflow prompts
+  - `system_prompts/` - AI behavior configuration (CLAUDE.md variants 1-10)
+  - `prompts-library/` - Excel↔Markdown conversion tool
+  - `user_prompts/` - User-contributed prompts
+
+- **`documents/`** - Knowledge base and methodology docs
+  - Contains development principles, architecture templates, and experience summaries
+
+- **`libs/`** - Modular code libraries (Python-based)
+  - `common/` - Shared utilities and models
+  - `database/` - Database integration modules
+  - `external/` - Third-party integrations
+
+- **`backups/`** - Project backup utilities
+  - Automated backup with .gitignore compliance
+
+### Key Technical Details
+
+1. **Prompt Organization**: Prompts use `(r,c)_` prefix notation for categorization (row,column matrix system)
+
+2. **Conversion Tool**: The prompts-library uses pandas + openpyxl for Excel operations, supports bidirectional conversion with rich CLI interface
+
+3. **System Prompts**: Multiple CLAUDE.md variants (1-10) represent different AI behavior configurations, with version 10 being the latest comprehensive version incorporating augment context engine requirements
+
+4. **Documentation Standards**: All user-facing documentation in Chinese, code/structure in English
+
+## Development Workflow
+
+When modifying this repository:
+1. Follow the existing prompt categorization system
+2. Update both Excel and Markdown versions when modifying prompts
+3. Use the conversion tool to maintain consistency
+4. Run backups before major changes
+5. Follow the Chinese(文档)/English(代码) language separation
+
+## Important Notes
+
+- This is a documentation and tooling repository, not a runtime application
+- The Makefile commands are mostly placeholders - actual functionality is in Python scripts
+- Prompt management is the core functionality - always use the conversion tools to maintain consistency
+- The repository serves as a knowledge base for vibe coding best practices
\ No newline at end of file
diff --git a/README.md b/README.md
index 7d59c4d..4db806a 100644
--- a/README.md
+++ b/README.md
@@ -105,6 +105,7 @@
 ├── README.md                    # 项目主文档，包含项目概览、使用指南、资源链接等。
 ├── .gitignore                   # Git 忽略文件。
 ├── AGENTS.md                    # AI 代理相关的文档或配置。
+├── CLAUDE.md                    # AI 助手的核心行为准则或配置。
 │
 ├── documents/                   # 存放各类说明文档、经验总结和配置详细说明。
 │   ├── auggie-mcp配置文档.md      # Augment 上下文引擎配置文档。