arch-commonlisted

# 架构文档共享配置 > **Version**: 1.1.0 > **Purpose**: 为 arch-search 和 arch-update 提供共享定义 > **Usage**: 被其他架构 Skills 引用，不直接触发 > **Methodology**: 基于 `@standards/core/architecture/` 通用方法论 --- ## 方法论基础 本配置基于以下通用规范（可跨项目复用）： | 规范 | 路径 | 说明 | |------|------|------| | 层级体系 | `@standards/core/architecture/layering-system.md` | L0/L1/L2 定义 | | 文档模板 | `@standards/core/architecture/document-templates.md` | 标准模板格式 | | 验证体系 | `@standards/core/architecture/validation-levels.md` | 三级验证规范 | | 命名规范 | `@standards/core/architecture/naming-conventions.md` | 目录/文件/版本命名 | | 生命周期 | `@standards/core/architecture/lifecycle-management.md` | 文档生命周期 | | AI 指南 | `@standards/core/architecture/ai-integration-guide.md` | AI 集成规范 | 以下为本项目的具体配置和路径定义。 --- ## 三层架构体系 (L0/L1/L2) ### 层级定义 | 层级 | 定义 | 文件数阈值 | 典型位置 | 文档命名 | |------|------|-----------|---------|---------| | **L0** | 端级总体架构 | 整个端 | 端根目录 | `ARCHITECTURE.md` | | **L1** | 主要模块架构 | ≥10个文件 | 一级子目录 | `[模块]_ARCHITECTURE.md` | | **L2** | 功能组件架构 | 5-10个文件 | 二级子目录 | `[组件]_ARCHITECTURE.md` | ### 层级判断流程 ``` 新架构文档需求 ├─ 是否为端根目录？→ 是 → L0级别 └─ 否 → 文件数≥10？ ├─ 是 → L1级别 └─ 否 → 文件数≥5？ ├─ 是 → L2级别 └─ 否 → 归入父文档 ``` ### 创建阈值 - **≥10个文件** → L1级别，创建独立架构文档 - **5-10个文件** → L2级别，创建独立架构文档 - **<5个文件** → 归入父目录文档，不单独创建 --- ## 命名规范 ### 代码目录（大写+下划线） ``` backend/ ├── BACKEND_ARCHITECTURE.md ✅ L0端级架构 ├── llm_provider/ │ └── LLM_PROVIDER_ARCHITECTURE.md ✅ L1/L2模块架构 └── age