universal-dev-standards 4.1.0 → 5.0.0-beta.10

package/bundled/core/versioning.md

@@ -5,6 +5,9 @@
 **Version**: 1.2.0
 **Last Updated**: 2025-12-30
 **Applicability**: All software projects with versioned releases
+**Scope**: universal
+**Industry Standards**: Semantic Versioning 2.0.0
+**References**: [semver.org](https://semver.org/)
 
 ---
 
@@ -200,66 +203,24 @@ Next Major Release:
 
 ## Changelog Integration
 
-> **See Also**: For comprehensive CHANGELOG writing guidelines, see [changelog-standards.md](changelog-standards.md).
+> **See Also**: For comprehensive CHANGELOG writing guidelines, format templates, and examples, see [changelog-standards.md](changelog-standards.md).
 
-### CHANGELOG.md Format
+### CHANGELOG.md Quick Reference
 
-```markdown
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/),
-and this project adheres to [Semantic Versioning](https://semver.org/).
-
-## [Unreleased]
-
-### Added
-- New feature X
-- New API endpoint Y
-
-### Changed
-- Updated dependency Z to v3.0
-
-### Deprecated
-- Method A will be removed in v3.0
-
-### Removed
-- Old API endpoint B
-
-### Fixed
-- Bug fix for issue #123
+CHANGELOG files should follow the [Keep a Changelog](https://keepachangelog.com/) format with these categories:
 
-### Security
-- Security vulnerability patch
+| Category | Use For |
+|----------|---------|
+| `Added` | New features |
+| `Changed` | Changes to existing functionality |
+| `Deprecated` | Features to be removed in future |
+| `Removed` | Removed features |
+| `Fixed` | Bug fixes |
+| `Security` | Security vulnerability patches |
 
-## [2.1.0] - 2025-11-12
+**Breaking Changes**: Prefix with `**BREAKING**:` to ensure visibility.
 
-### Added
-- OAuth2 authentication support
-- Email notification system
-
-### Fixed
-- Memory leak in user session cache
-
-## [2.0.0] - 2025-10-01
-
-### Changed
-- **BREAKING**: User API response format
-
-### Removed
-- **BREAKING**: Deprecated v1 endpoints
-
-## [1.5.2] - 2025-09-15
-
-### Fixed
-- Null pointer exception in payment module
-
-[Unreleased]: https://github.com/user/repo/compare/v2.1.0...HEAD
-[2.1.0]: https://github.com/user/repo/compare/v2.0.0...v2.1.0
-[2.0.0]: https://github.com/user/repo/compare/v1.5.2...v2.0.0
-[1.5.2]: https://github.com/user/repo/releases/tag/v1.5.2
-```
+For complete format templates and examples, refer to [changelog-standards.md](changelog-standards.md).
 
 ### Exclusion Rules
 

package/bundled/core/virtual-organization-standards.md

@@ -0,0 +1,85 @@
+# Virtual Organization Standards
+
+> **Language**: English | [繁體中文](../locales/zh-TW/core/virtual-organization-standards.md)
+
+**Version**: 1.0.0
+**Last Updated**: 2026-01-29
+**Applicability**: Project setup and AI tool configuration
+**Scope**: universal
+**Industry Standards**: ISO 12207 §6.2
+**References**: [iso.org](https://www.iso.org/standard/63712.html)
+**ISO 12207 Mapping**: Organizational Project-Enabling Processes (6.2)
+
+---
+
+## Purpose
+
+This standard treats the AI ecosystem as a "Virtual Organization." It defines how to manage AI capabilities (Skills), infrastructure, and quality assurance as organizational assets, ensuring the "Virtual Workforce" is capable and compliant.
+
+---
+
+## 1. Virtual Workforce Management (Human Resources)
+
+In Vibe Coding, "HR Management" translates to managing the capabilities of your AI Agents.
+
+### 1.1 Skill Management
+Skills are the "qualifications" of your virtual employees.
+
+- **Acquisition**: Skills must be explicitly installed (e.g., via `skills/` directory or plugins).
+- **Competency**: Skills must be verified for the specific project context.
+- **Role Definition**: Agents should be assigned "Roles" (collections of Skills) rather than being generic.
+
+| Role | Recommended Skill Set |
+|------|-----------------------|
+| **Architect Agent** | `system-design`, `diagram-generation`, `codebase-analysis` |
+| **Testing Agent** | `test-runner`, `coverage-analyzer`, `mock-generator` |
+| **Refactoring Agent** | `static-analysis`, `code-metrics`, `refactoring-patterns` |
+
+### 1.2 Onboarding (Context Loading)
+"Onboarding" an AI Agent means loading the correct context and configuration.
+- **Project Induction**: Loading `README.md`, architecture docs, and standards.
+- **Rule Alignment**: Loading `core/ai-agreement-standards.md`.
+
+---
+
+## 2. Infrastructure Management (Tooling)
+
+### 2.1 Tool Integration
+The "office environment" for AI Agents consists of:
+- **MCP Servers**: Standardized integration via Model Context Protocol.
+- **API Access**: Secure management of keys and endpoints.
+- **Sandbox**: Isolated environments for code execution (to prevent system damage).
+
+### 2.2 Knowledge Base
+The "corporate library" for AI Agents:
+- **Vector Database**: For large-scale documentation retrieval.
+- **Snippets Library**: Reusable code patterns and templates.
+
+---
+
+## 3. Quality Management System (QMS)
+
+### 3.1 Automated Vibe Checks
+Quality control is shifted left, into the generation process.
+- **Pre-Generation Check**: Does the Agent understand the task?
+- **Post-Generation Check**: Does the code compile? Do tests pass?
+
+### 3.2 Hallucination Monitoring
+Continuous monitoring of "defect rate" (Hallucinations):
+- **Detection**: Using `uds check` and static analysis.
+- **Correction**: Updating Context Contracts to prevent recurrence.
+
+---
+
+## Related Standards
+
+- [Testing Standards](testing-standards.md)
+- [Check-in Standards](checkin-standards.md)
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2026-01-29 | Initial release mapping to ISO 12207 Enabling Processes |

package/bundled/locales/README.md

@@ -26,7 +26,7 @@ locales/
 │   ├── README.md             # Chinese entry point
 │   ├── CHANGELOG.md          # Changelog translation
 │   ├── core/                 # Core standards translations
-│   ├── skills/claude-code/   # Skills translations
+│   ├── skills/   # Skills translations
 │   ├── templates/            # Templates translations
 │   └── adoption/             # Adoption guide translations
 └── zh-CN/                    # Simplified Chinese
@@ -43,7 +43,7 @@ Each translated file includes a YAML front matter with synchronization metadata:
 
 ```yaml
 ---
-source: ../../../core/example.md      # Path to English source
+source: ../../core/example.md      # Path to English source
 source_version: 1.2.0                 # Version of English source
 translation_version: 1.2.0            # Version this translation matches
 last_synced: 2025-12-24               # Last synchronization date
@@ -81,8 +81,8 @@ When using AI tools (Claude Code, Cursor, etc.):
 Example Claude Code skill installation:
 ```bash
 # English (default)
-cp skills/claude-code/commit-standards/SKILL.md ~/.claude/skills/
+cp skills/commit-standards/SKILL.md ~/.claude/skills/
 
 # Traditional Chinese
-cp locales/zh-TW/skills/claude-code/commit-standards/SKILL.md ~/.claude/skills/
+cp locales/zh-TW/skills/commit-standards/SKILL.md ~/.claude/skills/
 ```

package/bundled/locales/zh-CN/CHANGELOG.md

@@ -69,11 +69,11 @@ status: current
 ### 修复
 - **i18n**：为 6 个翻译文件新增缺失的 YAML front matter
   - `docs/CLI-INIT-OPTIONS.md`
-  - `skills/claude-code/commands/bdd.md`
-  - `skills/claude-code/commands/methodology.md`
-  - `skills/claude-code/methodology-system/SKILL.md`
-  - `skills/claude-code/methodology-system/create-methodology.md`
-  - `skills/claude-code/methodology-system/runtime.md`
+  - `skills/commands/bdd.md`
+  - `skills/commands/methodology.md`
+  - `skills/methodology-system/SKILL.md`
+  - `skills/methodology-system/create-methodology.md`
+  - `skills/methodology-system/runtime.md`
 - **文档**：更新稳定版本参考从 3.3.0 至 3.4.2
 
 ## [3.5.0-beta.10] - 2026-01-12
@@ -304,7 +304,7 @@ status: current
   - `/release` - 引导发布流程
   - `/changelog` - 更新 CHANGELOG.md
   - `/requirement` - 撰写用户故事和需求
-  - `/spec` - 创建规格文档
+  - `/sdd` - 创建规格文档
   - `/tdd` - 测试驱动开发工作流程
   - `/docs` - 创建/更新文档
   - `/coverage` - 分析测试覆盖率
@@ -340,7 +340,7 @@ status: current
   - `/release` - 引导发布流程
   - `/changelog` - 更新变更日志
   - `/requirement` - 撰写用户故事
-  - `/spec` - 建立规格文件
+  - `/sdd` - 建立规格文件
   - `/tdd` - TDD 工作流程
   - `/docs` - 文档撰写
   - `/coverage` - 测试覆盖率
@@ -385,9 +385,9 @@ status: current
   - ML 测试边界（模型准确度 vs 数据工程）
   - 遗留系统的 Golden Master 测试
 - **Skills**：为 Claude Code 新增 `tdd-assistant` 技能（第 15 个技能）
-  - `skills/claude-code/tdd-assistant/SKILL.md` - TDD 工作流程指引
-  - `skills/claude-code/tdd-assistant/tdd-workflow.md` - 逐步 TDD 流程
-  - `skills/claude-code/tdd-assistant/language-examples.md` - 6 种语言范例
+  - `skills/tdd-assistant/SKILL.md` - TDD 工作流程指引
+  - `skills/tdd-assistant/tdd-workflow.md` - 逐步 TDD 流程
+  - `skills/tdd-assistant/language-examples.md` - 6 种语言范例
   - 所有 TDD 文件的完整繁体中文翻译
 
 ### 变更
@@ -440,7 +440,7 @@ status: current
 
 ### 新增
 - **Skills**：新增发布流程指南，提供完整的发布流程
-  - 新增 `skills/claude-code/release-standards/release-workflow.md` 包含逐步发布指示
+  - 新增 `skills/release-standards/release-workflow.md` 包含逐步发布指示
   - 涵盖 beta、alpha、rc 和稳定版发布工作流程
   - 包含 npm dist-tag 策略、疑难排解和 AI 助理指南
   - 在 CLAUDE.md 中新增发布流程章节供 AI 助理参考
@@ -495,7 +495,7 @@ status: current
   - 新增 `.claude-plugin/plugin.json` - Plugin manifest 配置
   - 新增 `.claude-plugin/marketplace.json` - Marketplace 分发配置
   - 新增 `.claude-plugin/README.md` - Plugin 文档和维护指南
-  - 更新 `skills/claude-code/README.md` 新增方法 1：Marketplace 安装（推荐）
+  - 更新 `skills/README.md` 新增方法 1：Marketplace 安装（推荐）
 
 ### 优点
 - 用户可以用单一指令安装所有 14 个技能：`/plugin install universal-dev-standards@universal-dev-standards`
@@ -521,7 +521,7 @@ status: current
 - **完整 Windows 支持**：为 Windows 用户提供完整的跨平台兼容性
   - 新增 `.gitattributes` 确保跨平台换行符一致性
   - 新增 `scripts/check-translation-sync.ps1` - 翻译检查器 PowerShell 版本
-  - 新增 `skills/claude-code/install.ps1` - Skills 安装器 PowerShell 版本
+  - 新增 `skills/install.ps1` - Skills 安装器 PowerShell 版本
   - 新增 `scripts/setup-husky.js` - 跨平台 Husky 设定脚本
   - 新增 `docs/WINDOWS-GUIDE.md` - 完整的 Windows 开发指南
 - **5 个新 Claude Code 技能**：技能库从 9 个扩充至 14 个
@@ -576,7 +576,7 @@ status: current
 - **多语言支持**：新增 `locales/` 目录结构用于国际化
 - 新增所有文档的繁体中文 (zh-TW) 翻译（44 个文件）
   - `locales/zh-TW/core/` - 13 个核心规范翻译
-  - `locales/zh-TW/skills/claude-code/` - 25 个 skill 文件翻译
+  - `locales/zh-TW/skills/` - 25 个 skill 文件翻译
   - `locales/zh-TW/adoption/` - 5 个采用指南翻译
   - `locales/zh-TW/README.md` - 完整的中文 README
 - 为所有英文文档新增语言切换器
@@ -588,7 +588,7 @@ status: current
 ### 变更
 - 将双语内容分离到专用语言文件（AI 工具减少约 50% token 消耗）
 - 英文版本现在仅包含英文内容并带有语言切换器
-- 更新 `skills/claude-code/README.md` - 新增静态与动态区块及触发关键字
+- 更新 `skills/README.md` - 新增静态与动态区块及触发关键字
 
 ## [2.2.0] - 2025-12-24
 
@@ -605,17 +605,17 @@ status: current
 
 ### 新增
 - **集成 Skills**：将 `universal-dev-skills` 合并至 `skills/` 目录
-- 新增 `skills/claude-code/` - 所有 Claude Code Skills 现已包含在主仓库中
+- 新增 `skills/` - 所有 Claude Code Skills 现已包含在主仓库中
 - 新增 `skills/_shared/` - 用于多 AI 工具支持的共享模板
 - 为未来 AI 工具新增占位目录：`skills/cursor/`、`skills/windsurf/`、`skills/cline/`、`skills/copilot/`
 
 ### 变更
-- CLI 现在从本地 `skills/claude-code/` 安装技能，而非从远程仓库获取
+- CLI 现在从本地 `skills/` 安装技能，而非从远程仓库获取
 - 更新 `standards-registry.json` 以反映集成的 skills 架构
 
 ### 迁移指南
 - 如果您之前单独使用 `universal-dev-skills`，现在可以使用本仓库中包含的 skills
-- 执行 `cd skills/claude-code && ./install.sh` 从集成位置重新安装 skills
+- 执行 `cd skills && ./install.sh` 从集成位置重新安装 skills
 
 ## [2.0.0] - 2025-12-24
 

package/bundled/locales/zh-CN/CLAUDE.md

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一个语言无关、框架无关的文件化标准框架。它提供：
 
-- **核心规范** (`core/`)：22 个基础开发标准
+- **核心规范** (`core/`)：32 个基础开发标准
 - **AI 技能** (`skills/`)：用于 AI 辅助开发的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用于采用标准的 Node.js CLI
 - **整合** (`integrations/`)：各种 AI 工具的配置
@@ -200,9 +200,9 @@ node cli\bin\uds.js init --help
 
 ```
 universal-dev-standards/
-├── core/                  # 核心规范（22 个档案）
+├── core/                  # 核心规范（32 个档案）
 ├── skills/                # AI 工具技能
-│   └── claude-code/       # Claude Code 技能（23 个技能）
+│   └── claude-code/       # Claude Code 技能（26 个技能）
 ├── cli/                   # Node.js CLI 工具
 │   ├── src/               # 原始码
 │   ├── tests/             # 测试档案

package/bundled/locales/zh-CN/MAINTENANCE.md

@@ -270,7 +270,7 @@ locales/zh-TW/
 ├── ai/
 │   ├── standards/           ← 16 个翻译 AI 标准
 │   └── options/             ← 36 个翻译 AI 选项
-├── skills/claude-code/      ← 翻译技能
+├── skills/      ← 翻译技能
 ├── adoption/                ← 翻译采用指南
 ├── templates/               ← 翻译模板
 ├── README.md
@@ -399,8 +399,8 @@ locales/zh-TW/
    a. 更新 ai/options/{category}/*.ai.yaml
    b. 更新 locales/zh-TW/ai/options/{category}/
 7. 如有技能：
-   a. 更新 skills/claude-code/{skill}/
-   b. 更新 locales/zh-TW/skills/claude-code/{skill}/
+   a. 更新 skills/{skill}/
+   b. 更新 locales/zh-TW/skills/{skill}/
 8. 执行 ./scripts/check-translation-sync.sh zh-TW
 9. 如有重大变更，更新 CHANGELOG.md
 ```
@@ -417,8 +417,8 @@ locales/zh-TW/
    b. 建立 ai/options/{category}/*.ai.yaml
    c. 建立所有语系翻译
 6. 如需技能：
-   a. 建立 skills/claude-code/{skill-name}/
-   b. 建立 locales/zh-TW/skills/claude-code/{skill-name}/
+   a. 建立 skills/{skill-name}/
+   b. 建立 locales/zh-TW/skills/{skill-name}/
 7. 更新：
    - README.md（加入标准列表）
    - STANDARDS-MAPPING.md
@@ -451,10 +451,10 @@ locales/zh-TW/
    若大部分为是 → 建立技能（继续步骤 1）
    若大部分为否 → 改加入 CLAUDE.md（参见静态标准）
 
-1. 建立 skills/claude-code/{skill-name}/
+1. 建立 skills/{skill-name}/
    - SKILL.md（含 YAML frontmatter 的主要技能定义）
    - {topic}.md（选用的支援文件）
-2. 建立 locales/zh-TW/skills/claude-code/{skill-name}/
+2. 建立 locales/zh-TW/skills/{skill-name}/
    - SKILL.md（翻译版本）
 3. 更新 MAINTENANCE.md
    - 在第 4 节新增至技能表格