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

package/bundled/skills/{claude-code/bdd-assistant/SKILL.md → bdd-assistant/guide.md}

@@ -1,5 +1,5 @@
 ---
-name: bdd-assistant
+scope: partial
 description: |
   Guide developers through Behavior-Driven Development workflow.
   Use when: writing BDD scenarios, using Gherkin syntax, Given-When-Then format, feature files, Three Amigos collaboration.
@@ -8,7 +8,7 @@ description: |
 
 # BDD Assistant
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/bdd-assistant/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/bdd-assistant/SKILL.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2026-01-19
@@ -270,14 +270,14 @@ If no configuration found and context is unclear:
 ## Detailed Guidelines
 
 For complete standards, see:
-- [BDD Core Standard](../../../core/behavior-driven-development.md)
+- [BDD Core Standard](../../core/behavior-driven-development.md)
 - [BDD Workflow Guide](./bdd-workflow.md)
 - [Gherkin Quick Reference](./gherkin-guide.md)
 
 For related standards:
-- [TDD Standards](../../../core/test-driven-development.md)
-- [ATDD Standards](../../../core/acceptance-test-driven-development.md)
-- [Testing Standards](../../../core/testing-standards.md)
+- [TDD Standards](../../core/test-driven-development.md)
+- [ATDD Standards](../../core/acceptance-test-driven-development.md)
+- [Testing Standards](../../core/testing-standards.md)
 
 ---
 
@@ -295,11 +295,11 @@ For related standards:
 
 ## Related Standards
 
-- [Behavior-Driven Development](../../../core/behavior-driven-development.md) - Core BDD standard
-- [Acceptance Test-Driven Development](../../../core/acceptance-test-driven-development.md) - ATDD standard
-- [Test-Driven Development](../../../core/test-driven-development.md) - TDD standard
-- [Spec-Driven Development](../../../core/spec-driven-development.md) - SDD workflow
-- [Testing Standards](../../../core/testing-standards.md) - Testing framework
+- [Behavior-Driven Development](../../core/behavior-driven-development.md) - Core BDD standard
+- [Acceptance Test-Driven Development](../../core/acceptance-test-driven-development.md) - ATDD standard
+- [Test-Driven Development](../../core/test-driven-development.md) - TDD standard
+- [Spec-Driven Development](../../core/spec-driven-development.md) - SDD workflow
+- [Testing Standards](../../core/testing-standards.md) - Testing framework
 - [TDD Assistant](../tdd-assistant/SKILL.md) - TDD skill
 
 ---

package/bundled/skills/changelog-guide/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: changelog
+scope: partial
+description: "[UDS] Generate and maintain CHANGELOG.md entries"
+allowed-tools: Read, Write, Grep, Bash(git log:*)
+disable-model-invocation: true
+---
+
+# Changelog Assistant | 變更日誌助手
+
+Generate and maintain CHANGELOG.md entries following the Keep a Changelog format.
+
+根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。
+
+## Workflow | 工作流程
+
+1. **Analyze git log** - Read commit history since last release using `git log`
+2. **Categorize changes** - Map commits to changelog categories
+3. **Generate entries** - Write user-friendly descriptions for each change
+4. **Update CHANGELOG.md** - Insert entries into the [Unreleased] or versioned section
+
+## Change Categories | 變更分類
+
+| Category | When to Use | 使用時機 | Commit Types |
+|----------|-------------|---------|-------------|
+| **Added** | New features | 新功能 | `feat` |
+| **Changed** | Modifications to existing features | 修改既有功能 | `perf`, `BREAKING CHANGE` |
+| **Deprecated** | Features to be removed | 即將移除的功能 | -- |
+| **Removed** | Removed features | 已移除的功能 | `BREAKING CHANGE` |
+| **Fixed** | Bug fixes | 錯誤修復 | `fix` |
+| **Security** | Security patches | 安全性修補 | `security` |
+
+## Entry Format | 條目格式
+
+```markdown
+## [Unreleased]
+
+### Added
+- Add user dashboard with customizable widgets (#123)
+
+### Changed
+- **BREAKING**: Change API response format from XML to JSON (#789)
+
+### Fixed
+- Fix memory leak when processing large files (#456)
+
+### Security
+- Fix SQL injection vulnerability in search endpoint (CVE-2025-12345)
+```
+
+### Writing Guidelines | 撰寫指南
+
+- Write for **users**, not developers | 為使用者而非開發者撰寫
+- Focus on **impact**, not implementation | 聚焦影響而非實作
+- Include issue/PR references | 附上 issue/PR 編號
+- Mark breaking changes with **BREAKING** prefix | 用 **BREAKING** 標記破壞性變更
+
+## Usage | 使用方式
+
+- `/changelog` - Analyze recent commits and generate changelog entries
+- Also available via `/release changelog [version]`
+
+## Reference | 參考
+
+- Detailed guide: [guide.md](./guide.md)
+- Core standard: [changelog-standards.md](../../core/changelog-standards.md)

package/bundled/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md}

@@ -1,5 +1,5 @@
 ---
-name: changelog-guide
+scope: partial
 description: |
   Write and maintain CHANGELOG.md following Keep a Changelog format.
   Use when: creating changelog entries, preparing releases, documenting changes.
@@ -8,7 +8,7 @@ description: |
 
 # Changelog Guide
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/changelog-guide/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/changelog-guide/SKILL.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-30
@@ -16,6 +16,8 @@ description: |
 
 ---
 
+> **Core Standard**: This skill implements [Changelog Standards](../../core/changelog-standards.md). For comprehensive methodology documentation, refer to the core standard.
+
 ## Purpose
 
 This skill helps write and maintain CHANGELOG.md files following the Keep a Changelog format, ensuring clear communication of changes to users.
@@ -101,7 +103,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 ## Detailed Guidelines
 
 For complete standards, see:
-- [Changelog Standards](../../../core/changelog-standards.md)
+- [Changelog Standards](../../core/changelog-standards.md)
 
 ### AI-Optimized Format (Token-Efficient)
 
@@ -210,9 +212,9 @@ If no CHANGELOG.md exists:
 
 ## Related Standards
 
-- [Changelog Standards](../../../core/changelog-standards.md)
-- [Versioning Standard](../../../core/versioning.md)
-- [Commit Message Guide](../../../core/commit-message-guide.md)
+- [Changelog Standards](../../core/changelog-standards.md)
+- [Versioning Standard](../../core/versioning.md)
+- [Commit Message Guide](../../core/commit-message-guide.md)
 - [Release Standards Skill](../release-standards/SKILL.md)
 
 ---

package/bundled/skills/checkin-assistant/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: checkin
+scope: partial
+description: "[UDS] Pre-commit quality gates verification"
+allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git status:*), Bash(npm test:*), Bash(npm run lint:*)
+disable-model-invocation: true
+---
+
+# Check-in Assistant | 簽入助手
+
+Verify pre-commit quality gates before committing code to ensure codebase stability.
+
+在提交程式碼前驗證品質關卡，確保程式碼庫的穩定性。
+
+## Workflow | 工作流程
+
+1. **Check git status** - Run `git status` and `git diff` to understand pending changes
+2. **Run tests** - Execute `npm test` (or project test command) to verify all tests pass
+3. **Run linting** - Execute `npm run lint` to check code style compliance
+4. **Verify quality gates** - Check each gate against the checklist below
+5. **Report results** - Present pass/fail summary and recommend next steps
+
+## Quality Gates | 品質關卡
+
+| Gate | Check | 檢查項目 |
+|------|-------|---------|
+| **Build** | Code compiles with zero errors | 編譯零錯誤 |
+| **Tests** | All existing tests pass (100%) | 所有測試通過 |
+| **Coverage** | Test coverage not decreased | 覆蓋率未下降 |
+| **Code Quality** | Follows coding standards, no code smells | 符合編碼規範 |
+| **Security** | No hardcoded secrets or vulnerabilities | 無硬編碼密鑰 |
+| **Documentation** | API docs and CHANGELOG updated if needed | 文件已更新 |
+| **Workflow** | Branch naming and commit message correct | 分支和提交格式正確 |
+
+## Never Commit When | 禁止提交的情況
+
+- Build has errors | 建置有錯誤
+- Tests are failing | 測試失敗
+- Feature is incomplete and would break functionality | 功能不完整會破壞現有功能
+- Contains WIP/TODO in critical logic | 關鍵邏輯中有 WIP/TODO
+- Contains debugging code (console.log, print) | 包含除錯程式碼
+- Contains commented-out code blocks | 包含被註解的程式碼區塊
+
+## Usage | 使用方式
+
+- `/checkin` - Run full quality gate verification on current changes
+- After verification, proceed with `/commit` to create the commit message
+
+## Reference | 參考
+
+- Detailed guide: [guide.md](./guide.md)
+- Core standard: [checkin-standards.md](../../core/checkin-standards.md)

package/bundled/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md}

@@ -1,5 +1,5 @@
 ---
-name: checkin-assistant
+scope: partial
 description: |
   Guide pre-commit quality gates and check-in workflow.
   Use when: committing code, preparing commits, quality gate verification.
@@ -8,7 +8,7 @@ description: |
 
 # Checkin Assistant
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/checkin-assistant/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/checkin-assistant/SKILL.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2026-01-12
@@ -373,15 +373,15 @@ npm run lint
 ## Detailed Guidelines
 
 For complete standards, see:
-- [Checkin Standards](../../../core/checkin-standards.md)
+- [Checkin Standards](../../core/checkin-standards.md)
 
 ---
 
 ## Related Standards
 
-- [Checkin Standards](../../../core/checkin-standards.md) - Core standard
-- [Commit Message Guide](../../../core/commit-message-guide.md) - Message format
-- [Code Review Checklist](../../../core/code-review-checklist.md) - PR review
+- [Checkin Standards](../../core/checkin-standards.md) - Core standard
+- [Commit Message Guide](../../core/commit-message-guide.md) - Message format
+- [Code Review Checklist](../../core/code-review-checklist.md) - PR review
 - [Code Review Assistant](../code-review-assistant/SKILL.md) - Review skill
 - [Commit Standards Skill](../commit-standards/SKILL.md) - Commit message skill
 

package/bundled/skills/code-review-assistant/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: review
+scope: universal
+description: "[UDS] Perform systematic code review with checklist"
+allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*)
+argument-hint: "[file path or branch | 檔案路徑或分支名稱]"
+disable-model-invocation: true
+---
+
+# Code Review Assistant | 程式碼審查助手
+
+Perform systematic code review using standardized checklists and comment prefixes.
+
+執行系統性的程式碼審查，使用標準化的檢查清單和評論前綴。
+
+## Workflow | 工作流程
+
+1. **Identify changes** - Get diff of files to review via `git diff` or `git show`
+2. **Apply checklist** - Check each review category systematically
+3. **Generate report** - Output findings with standard comment prefixes
+4. **Summarize** - Provide overall assessment and recommended actions
+
+## Review Categories | 審查類別
+
+1. **Functionality** - Does it work correctly? | 功能是否正確？
+2. **Design** - Is the architecture appropriate? | 架構是否合適？
+3. **Quality** - Is the code clean and maintainable? | 程式碼是否乾淨可維護？
+4. **Readability** - Is it easy to understand? | 是否容易理解？
+5. **Tests** - Is there adequate test coverage? | 測試覆蓋是否足夠？
+6. **Security** - Are there any vulnerabilities? | 是否有安全漏洞？
+7. **Performance** - Is it efficient? | 是否有效率？
+8. **Error Handling** - Are errors handled properly? | 錯誤處理是否妥當？
+
+## Comment Prefixes | 評論前綴
+
+| Prefix | Meaning | Action | 動作 |
+|--------|---------|--------|------|
+| **BLOCKING** | Must fix before merge | Required | 必須修復 |
+| **IMPORTANT** | Should fix | Recommended | 建議修復 |
+| **SUGGESTION** | Nice-to-have | Optional | 可選改善 |
+| **QUESTION** | Need clarification | Discuss | 需要討論 |
+| **NOTE** | Informational | FYI | 僅供參考 |
+
+## Usage | 使用方式
+
+- `/review` - Review all changes in current branch
+- `/review src/auth.js` - Review specific file
+- `/review feature/login` - Review specific branch
+
+## Reference | 參考
+
+- Detailed guide: [guide.md](./guide.md)
+- Core standard: [code-review-checklist.md](../../core/code-review-checklist.md)

package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md

@@ -1,6 +1,6 @@
 # Pre-Commit Checklist
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/code-review-assistant/checkin-checklist.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/code-review-assistant/checkin-checklist.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-24
@@ -228,9 +228,9 @@ git commit -m "feat(module-c): add export feature"
 
 ## Related Standards
 
-- [Checkin Standards](../../../core/checkin-standards.md)
+- [Checkin Standards](../../core/checkin-standards.md)
 - [Code Review Checklist](./review-checklist.md)
-- [Commit Message Guide](../../../core/commit-message-guide.md)
+- [Commit Message Guide](../../core/commit-message-guide.md)
 
 ---
 

package/bundled/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md}

@@ -1,5 +1,5 @@
 ---
-name: code-review-assistant
+scope: universal
 description: |
   Systematic code review checklist and pre-commit quality gates for PRs.
   Use when: reviewing pull requests, checking code quality, before committing code.
@@ -8,7 +8,7 @@ description: |
 
 # Code Review Assistant
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/code-review-assistant/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/code-review-assistant/SKILL.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-24
@@ -16,6 +16,8 @@ description: |
 
 ---
 
+> **Core Standard**: This skill implements [Code Review Checklist](../../core/code-review-checklist.md). For comprehensive methodology documentation, refer to the core standard.
+
 ## Purpose
 
 This skill provides systematic checklists for code review and pre-commit verification.
@@ -199,9 +201,9 @@ BLOCKING, IMPORTANT, SUGGESTION, QUESTION, NOTE
 
 ## Related Standards
 
-- [Code Review Checklist](../../core/code-review-checklist.md)
-- [Checkin Standards](../../core/checkin-standards.md)
-- [Testing Standards](../../core/testing-standards.md)
+- [Code Review Checklist](../../core/code-review-checklist.md) - Core code review standard
+- [Checkin Standards](../../core/checkin-standards.md) - Pre-commit quality gates
+- [Testing Standards](../../core/testing-standards.md) - Testing requirements
 
 ---
 

package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md

@@ -1,6 +1,6 @@
 # Code Review Checklist
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/code-review-assistant/review-checklist.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/code-review-assistant/review-checklist.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-24
@@ -217,8 +217,8 @@ This document provides a comprehensive checklist for code review to ensure code
 
 ## Related Standards
 
-- [Code Review Checklist](../../../core/code-review-checklist.md)
-- [Checkin Standards](../../../core/checkin-standards.md)
+- [Code Review Checklist](../../core/code-review-checklist.md)
+- [Checkin Standards](../../core/checkin-standards.md)
 - [Pre-Commit Checklist](./checkin-checklist.md)
 
 ---

package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md

@@ -0,0 +1,290 @@
+# Command Family Overview | 指令家族總覽
+
+**Version**: 1.0.0
+**Last Updated**: 2026-01-25
+
+---
+
+## Overview | 總覽
+
+This document provides a comprehensive guide to the development methodology commands in Universal Development Standards. These commands support two independent methodology systems and an optional collaborative input method.
+
+本文件提供 Universal Development Standards 開發方法論指令的完整指南。這些指令支援兩個獨立的方法論系統和一個可選的協作輸入方法。
+
+---
+
+## Command Architecture | 指令架構
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           Command Family Overview                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  System A: SDD (AI-Era Methodology)                                         │
+│  ────────────────────────────────────                                       │
+│  /sdd          → Create specification proposal                             │
+│  /derive-all    → Generate BDD + TDD from spec (Forward Derivation)         │
+│  /derive-bdd    → Generate BDD scenarios only                               │
+│  /derive-tdd    → Generate TDD skeletons only                               │
+│                                                                             │
+│  System B: Double-Loop TDD (Traditional)                                    │
+│  ────────────────────────────────────                                       │
+│  /bdd           → Start BDD outer loop (Discovery → Formulation)            │
+│  /tdd           → Start TDD inner loop (Red → Green → Refactor)             │
+│                                                                             │
+│  Optional Input (可選輸入)                                                   │
+│  ────────────────────────────────────                                       │
+│  /atdd          → Start ATDD Workshop (Three Amigos collaboration)          │
+│  /derive-atdd   → Generate ATDD tables (optional output)                    │
+│                                                                             │
+│  Utility (工具)                                                              │
+│  ────────────────────────────────────                                       │
+│  /methodology   → Show/switch current methodology                           │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Command Selection by Scenario | 依情境選擇指令
+
+| Scenario / 情境 | Recommended Commands / 推薦指令 |
+|-----------------|-------------------------------|
+| New project with AI assistance | `/sdd` → `/derive-all` → Implement |
+| Greenfield feature development | `/sdd` → `/derive-all` → Implement |
+| Legacy system modification | `/bdd` → `/tdd` cycles |
+| Complex business logic | `/bdd discovery` → `/tdd` |
+| Multiple stakeholders need alignment | `/atdd` → then `/sdd` or `/bdd` |
+| Quick prototype | `/tdd` only |
+| API-first development | `/sdd` → `/derive-all` |
+| Check methodology status | `/methodology` |
+
+---
+
+## System A: SDD Commands | 系統 A：SDD 指令
+
+SDD (Spec-Driven Development) is optimized for AI-assisted development workflows.
+
+SDD（規格驅動開發）針對 AI 輔助開發工作流程進行了優化。
+
+### Command Details | 指令詳細
+
+| Command | Purpose / 用途 | Input / 輸入 | Output / 輸出 |
+|---------|----------------|--------------|---------------|
+| `/sdd` | Create specification proposal | Requirements description | `SPEC-XXX.md` |
+| `/sdd review` | Review specification | SPEC file | Review comments |
+| `/derive-all` | Full forward derivation | SPEC file | `.feature` + `.test.ts` |
+| `/derive-bdd` | BDD derivation only | SPEC file | `.feature` |
+| `/derive-tdd` | TDD derivation only | SPEC file | `.test.ts` |
+
+### Typical SDD Workflow | 典型 SDD 工作流程
+
+```bash
+# Step 1: Create specification
+/sdd user-authentication
+
+# Step 2: Review and approve
+/sdd review specs/SPEC-001.md
+
+# Step 3: Derive test structures
+/derive-all specs/SPEC-001.md
+
+# Step 4: Implement (with AI assistance or TDD cycles)
+# Fill in [TODO] sections, implement step definitions
+```
+
+---
+
+## System B: Double-Loop TDD Commands | 系統 B：雙迴圈 TDD 指令
+
+Double-Loop TDD combines BDD (outer loop) with TDD (inner loop) for behavior-driven development.
+
+雙迴圈 TDD 將 BDD（外層迴圈）與 TDD（內層迴圈）結合，實現行為驅動開發。
+
+### Command Details | 指令詳細
+
+| Command | Purpose / 用途 | Phase / 階段 |
+|---------|----------------|--------------|
+| `/bdd` | Start BDD workflow | Discovery → Formulation → Automation |
+| `/bdd discovery` | Discovery phase only | Example Mapping with Three Amigos |
+| `/bdd formulation` | Formulation phase only | Write Gherkin scenarios |
+| `/tdd` | Start TDD workflow | Red → Green → Refactor |
+| `/tdd red` | Enter Red phase | Write failing test |
+| `/tdd green` | Enter Green phase | Implement minimum code |
+| `/tdd refactor` | Enter Refactor phase | Improve code quality |
+
+### Typical Double-Loop TDD Workflow | 典型雙迴圈 TDD 工作流程
+
+```bash
+# Step 1: (Optional) ATDD Workshop for stakeholder alignment
+/atdd
+
+# Step 2: BDD Discovery - understand behavior
+/bdd discovery
+
+# Step 3: BDD Formulation - write Gherkin
+/bdd formulation
+
+# Step 4: TDD cycles for implementation
+/tdd red
+/tdd green
+/tdd refactor
+# Repeat for each scenario step
+```
+
+---
+
+## Optional: ATDD Commands | 可選：ATDD 指令
+
+ATDD (Acceptance Test-Driven Development) provides collaborative input methods. It is NOT a mandatory step in either system.
+
+ATDD（驗收測試驅動開發）提供協作輸入方法。它**不是**任一系統的必要步驟。
+
+### When to Use ATDD | 何時使用 ATDD
+
+| Situation / 情境 | Use ATDD? |
+|------------------|-----------|
+| Multiple stakeholders with differing views | ✅ Yes |
+| Complex business rules | ✅ Yes |
+| New domain for the team | ✅ Yes |
+| Solo developer with clear requirements | ❌ No |
+| Technical refactoring | ❌ No |
+| Bug fixes | ❌ No |
+
+### ATDD Commands | ATDD 指令
+
+| Command | Purpose / 用途 | Output / 輸出 |
+|---------|----------------|---------------|
+| `/atdd` | Start ATDD Workshop | User Story + AC + Out of Scope |
+| `/derive-atdd` | Generate ATDD tables (optional) | `acceptance.md` |
+
+> **Note**: BDD scenarios already serve as executable acceptance tests. `/derive-atdd` is only needed for specialized manual testing workflows.
+>
+> **注意**：BDD 場景已是可執行的驗收測試。`/derive-atdd` 僅在需要特殊手動測試工作流程時使用。
+
+---
+
+## Utility Commands | 工具指令
+
+| Command | Purpose / 用途 |
+|---------|----------------|
+| `/methodology` | Show current active methodology |
+| `/methodology sdd` | Switch to SDD workflow |
+| `/methodology double-loop` | Switch to Double-Loop TDD workflow |
+
+---
+
+## Workflow Examples | 工作流程範例
+
+### Example 1: SDD Complete Flow | 範例 1：SDD 完整流程
+
+Best for: New features, AI-assisted development, greenfield projects
+
+適用於：新功能、AI 輔助開發、全新專案
+
+```bash
+# Create and review specification
+/sdd user-authentication
+/sdd review specs/SPEC-001.md
+
+# Generate all test structures
+/derive-all specs/SPEC-001.md
+
+# Output:
+# - features/SPEC-001.feature (BDD scenarios)
+# - tests/SPEC-001.test.ts (TDD skeletons)
+# - DERIVATION-REPORT.md (summary)
+
+# Implementation: Fill [TODO], implement code
+```
+
+### Example 2: Double-Loop TDD Flow | 範例 2：雙迴圈 TDD 流程
+
+Best for: Legacy systems, complex business logic, team collaboration
+
+適用於：遺留系統、複雜業務邏輯、團隊協作
+
+```bash
+# Optional: ATDD Workshop for alignment
+/atdd
+
+# BDD Outer Loop
+/bdd discovery    # Example Mapping session
+/bdd formulation  # Write Gherkin scenarios
+
+# For each scenario step:
+/tdd red       # Write failing test
+/tdd green     # Implement minimum code
+/tdd refactor  # Improve quality
+
+# Repeat TDD inner loop until scenario passes
+```
+
+### Example 3: Hybrid Flow | 範例 3：混合流程
+
+Best for: When you need spec clarity + TDD discipline
+
+適用於：需要規格清晰度 + TDD 紀律時
+
+```bash
+# Start with SDD for specification
+/sdd feature-x
+/derive-all specs/SPEC-001.md
+
+# Use TDD for complex implementation logic
+/tdd red → /tdd green → /tdd refactor
+
+# BDD scenarios serve as acceptance criteria
+```
+
+---
+
+## Quick Reference Card | 快速參考卡
+
+### Most Common Commands | 最常用指令
+
+| Goal / 目標 | Command / 指令 |
+|-------------|----------------|
+| Start new feature with spec | `/sdd <feature-name>` |
+| Generate tests from spec | `/derive-all <spec-file>` |
+| Start BDD workflow | `/bdd` |
+| Start TDD cycle | `/tdd` |
+| Check methodology status | `/methodology` |
+
+### Decision Tree | 決策樹
+
+```
+Is this a new feature with clear requirements?
+├─ Yes → Use /sdd + /derive-all (System A: SDD)
+└─ No
+   ├─ Is this legacy code modification?
+   │  └─ Yes → Use /bdd + /tdd (System B: Double-Loop)
+   ├─ Need stakeholder alignment?
+   │  └─ Yes → Start with /atdd, then choose system
+   └─ Quick prototype?
+      └─ Yes → Use /tdd only
+```
+
+---
+
+## Related Documentation | 相關文件
+
+- [Forward Derivation SKILL](../forward-derivation/SKILL.md) - Detailed derivation workflow
+- [Integrated Flow Guide](../methodology-system/integrated-flow.md) - Complete methodology integration
+- [Individual Command Files](./README.md) - All command references
+
+---
+
+## Version History | 版本歷史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2026-01-25 | Initial release - Two independent systems architecture |
+
+---
+
+## License | 授權
+
+This document is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)