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

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

@@ -1,26 +1,29 @@
 ---
-name: forward-derivation
+scope: partial
 description: |
-  Derive BDD scenarios, TDD test skeletons, and ATDD acceptance tests from approved SDD specifications.
+  Derive BDD scenarios and TDD test skeletons from approved SDD specifications.
+  ATDD acceptance test tables are optional output for specialized needs.
   Use when: spec is approved, starting BDD/TDD implementation, generating test structures.
   Keywords: forward derivation, spec to test, BDD generation, TDD skeleton, test derivation, 正向推演, 規格轉測試, 測試生成.
 ---
 
 # Forward Derivation Guide
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/forward-derivation/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/forward-derivation/SKILL.md)
 
-**Version**: 1.0.0
-**Last Updated**: 2026-01-19
+**Version**: 2.0.0
+**Last Updated**: 2026-01-25
 **Applicability**: Claude Code Skills
 
-> **Core Standard**: This skill implements [Forward Derivation Standards](../../../core/forward-derivation-standards.md). For comprehensive methodology documentation accessible by any AI tool, refer to the core standard.
+> **Core Standard**: This skill implements [Forward Derivation Standards](../../core/forward-derivation-standards.md). For comprehensive methodology documentation accessible by any AI tool, refer to the core standard.
 
 ---
 
 ## Purpose
 
-This skill guides you through deriving BDD scenarios, TDD test skeletons, and ATDD acceptance tests from approved SDD specifications, with strict adherence to Anti-Hallucination standards.
+This skill guides you through deriving BDD scenarios and TDD test skeletons from approved SDD specifications, with strict adherence to Anti-Hallucination standards.
+
+> **Note**: ATDD test tables are optional and available via `/derive-atdd`. BDD scenarios already serve as executable acceptance tests, making ATDD tables redundant for most use cases.
 
 Forward Derivation is the symmetrical counterpart to [Reverse Engineering](../reverse-engineer/SKILL.md):
 - **Reverse Engineering**: Code → Specification
@@ -43,7 +46,7 @@ Forward Derivation is the symmetrical counterpart to [Reverse Engineering](../re
 │  2️⃣  Derivation (AI Automated)                                 │
 │      ├─ AC → BDD Gherkin scenarios                             │
 │      ├─ AC → TDD test skeletons with TODOs                     │
-│      └─ AC → ATDD acceptance test tables                       │
+│      └─ (Optional) AC → ATDD acceptance test tables            │
 │                                                                 │
 │  3️⃣  Human Review (Required)                                   │
 │      ├─ Verify generated scenarios match AC intent              │
@@ -59,8 +62,8 @@ Forward Derivation is the symmetrical counterpart to [Reverse Engineering](../re
 |---------|-------|--------|---------|
 | `/derive-bdd` | SPEC-XXX.md | .feature | AC → Gherkin scenarios |
 | `/derive-tdd` | SPEC-XXX.md | .test.ts | AC → Test skeletons |
-| `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → Acceptance test tables |
-| `/derive-all` | SPEC-XXX.md | All above | Full derivation pipeline |
+| `/derive-all` | SPEC-XXX.md | .feature + .test.ts | Full derivation pipeline |
+| `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → Acceptance test tables (optional) |
 
 ## Core Principles
 
@@ -73,7 +76,7 @@ Forward Derivation is the symmetrical counterpart to [Reverse Engineering](../re
 Input:  SPEC with N Acceptance Criteria
 Output: Exactly N scenarios (BDD)
         Exactly N test groups (TDD)
-        Exactly N acceptance tests (ATDD)
+        Exactly N acceptance tests (ATDD, if requested)
 
 If output count ≠ input count → VIOLATION
 ```
@@ -90,7 +93,9 @@ Every generated item MUST include traceability:
 Scenario: User login with valid credentials
 ```
 
-### 3. Certainty Labels
+### 3. Derivation Tags (from Unified Tag System)
+
+This skill uses **Derivation Tags** for generating new content from specifications. See [Anti-Hallucination Standards](../../core/anti-hallucination.md#certainty-classification-tags) for the complete tag reference.
 
 | Tag | Use When | Example |
 |-----|----------|---------|
@@ -171,7 +176,12 @@ Scenario: Login shows error for invalid credentials
 | `--lang` | typescript, javascript, python, java, go | typescript |
 | `--framework` | vitest, jest, pytest, junit, go-test | vitest |
 
-### Stage 4: ATDD Derivation
+### Stage 4: ATDD Derivation (Optional)
+
+> **Note**: ATDD test tables are optional. BDD scenarios already serve as executable acceptance tests. Use ATDD tables only when:
+> - Manual testing workflows are required
+> - Stakeholders prefer tabular test documentation
+> - Regulatory compliance requires specific test evidence format
 
 **Input**: Parsed Acceptance Criteria
 **Output**: Acceptance test table document
@@ -264,7 +274,9 @@ describe('SPEC-001: User Authentication', () => {
 });
 ```
 
-### ATDD Acceptance Test Table
+### ATDD Acceptance Test Table (Optional)
+
+> Generated via `/derive-atdd` when ATDD test tables are needed.
 
 ```markdown
 # SPEC-001 Acceptance Tests
@@ -290,9 +302,9 @@ describe('SPEC-001: User Authentication', () => {
 
 ## Integration with Other Skills
 
-### With /spec (Spec-Driven Development)
+### With /sdd (Spec-Driven Development)
 
-1. Complete SPEC using `/spec` workflow
+1. Complete SPEC using `/sdd` workflow
 2. Get SPEC approved through review
 3. Run `/derive-all` to generate test structures
 4. Use generated outputs in BDD/TDD workflows
@@ -319,8 +331,9 @@ Forward Derivation fits in the Integrated Flow methodology:
 spec-review (approved) → forward-derivation → discovery (BDD)
                               │
                               ├─→ .feature files for BDD
-                              ├─→ .test.ts skeletons for TDD
-                              └─→ acceptance.md for ATDD
+                              └─→ .test.ts skeletons for TDD
+
+Optional: /derive-atdd → acceptance.md for manual testing
 ```
 
 ## Complete Derivation Pipeline
@@ -338,11 +351,11 @@ spec-review (approved) → forward-derivation → discovery (BDD)
 │        ├─→ /derive-bdd                                                  │
 │        │    └─→ features/SPEC-XXX.feature                              │
 │        │                                                                │
-│        ├─→ /derive-tdd                                                  │
-│        │    └─→ tests/SPEC-XXX.test.ts                                 │
-│        │                                                                │
-│        └─→ /derive-atdd                                                 │
-│             └─→ acceptance/SPEC-XXX-acceptance.md                      │
+│        └─→ /derive-tdd                                                  │
+│             └─→ tests/SPEC-XXX.test.ts                                 │
+│                                                                         │
+│   Optional: /derive-atdd specs/SPEC-XXX.md                              │
+│        └─→ acceptance/SPEC-XXX-acceptance.md                           │
 │                                                                         │
 │   Human Review                                                          │
 │        │                                                                │
@@ -431,12 +444,12 @@ This skill auto-detects project configuration:
 
 ## Related Standards
 
-- [Forward Derivation Standards](../../../core/forward-derivation-standards.md) - **Core methodology standard (primary reference)**
-- [Reverse Engineering Standards](../../../core/reverse-engineering-standards.md) - Symmetrical counterpart
-- [Spec-Driven Development](../../../core/spec-driven-development.md) - Input specification format
-- [Behavior-Driven Development](../../../core/behavior-driven-development.md) - BDD output format
-- [Test-Driven Development](../../../core/test-driven-development.md) - TDD output usage
-- [Anti-Hallucination Guidelines](../../../core/anti-hallucination.md) - Generation compliance
+- [Forward Derivation Standards](../../core/forward-derivation-standards.md) - **Core methodology standard (primary reference)**
+- [Reverse Engineering Standards](../../core/reverse-engineering-standards.md) - Symmetrical counterpart
+- [Spec-Driven Development](../../core/spec-driven-development.md) - Input specification format
+- [Behavior-Driven Development](../../core/behavior-driven-development.md) - BDD output format
+- [Test-Driven Development](../../core/test-driven-development.md) - TDD output usage
+- [Anti-Hallucination Guidelines](../../core/anti-hallucination.md) - Generation compliance
 
 ---
 
@@ -444,6 +457,8 @@ This skill auto-detects project configuration:
 
 | Version | Date | Changes |
 |---------|------|---------|
+| 2.0.0 | 2026-01-25 | ATDD changed from required to optional output; /derive-all now outputs BDD + TDD only |
+| 1.1.0 | 2026-01-25 | Added: Reference to Unified Tag System |
 | 1.0.0 | 2026-01-19 | Initial release |
 
 ---

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

@@ -1,5 +1,5 @@
 ---
-name: git-workflow-guide
+scope: universal
 description: |
   Guide Git branching strategies, branch naming, and merge operations.
   Use when: creating branches, merging, pull requests, Git workflow questions.
@@ -8,7 +8,7 @@ description: |
 
 # Git Workflow Guide
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/git-workflow-guide/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/git-workflow-guide/SKILL.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-24
@@ -16,6 +16,8 @@ description: |
 
 ---
 
+> **Core Standard**: This skill implements [Git Workflow](../../core/git-workflow.md). For comprehensive methodology documentation, refer to the core standard.
+
 ## Purpose
 
 This skill provides guidance on Git branching strategies, branch naming conventions, and merge operations.
@@ -205,9 +207,9 @@ Example: `feature/oauth-login`, `fix/memory-leak`
 
 ## Related Standards
 
-- [Git Workflow](../../core/git-workflow.md)
-- [Commit Message Guide](../../core/commit-message-guide.md)
-- [Checkin Standards](../../core/checkin-standards.md)
+- [Git Workflow](../../core/git-workflow.md) - Core Git workflow standard
+- [Commit Message Guide](../../core/commit-message-guide.md) - Commit message conventions
+- [Checkin Standards](../../core/checkin-standards.md) - Pre-commit quality gates
 
 ---
 

package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md

@@ -1,6 +1,6 @@
 # Branch Naming Reference
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/git-workflow-guide/branch-naming.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/git-workflow-guide/branch-naming.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-24
@@ -193,7 +193,7 @@ git branch --show-current
 ## Related Standards
 
 - [Git Workflow Strategies](./git-workflow.md)
-- [Git Workflow](../../../core/git-workflow.md)
+- [Git Workflow](../../core/git-workflow.md)
 
 ---
 

package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md

@@ -1,6 +1,6 @@
 # Git Workflow Strategies
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/git-workflow-guide/git-workflow.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/git-workflow-guide/git-workflow.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-24
@@ -292,9 +292,9 @@ git merge --ff-only feature/user-auth
 
 ## Related Standards
 
-- [Git Workflow](../../../core/git-workflow.md)
+- [Git Workflow](../../core/git-workflow.md)
 - [Branch Naming Reference](./branch-naming.md)
-- [Commit Message Guide](../../../core/commit-message-guide.md)
+- [Commit Message Guide](../../core/commit-message-guide.md)
 
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-name: logging-guide
+scope: universal
 description: |
   Implement structured logging with proper log levels and sensitive data handling.
   Use when: adding logging, debugging, setting up observability.
@@ -8,7 +8,7 @@ description: |
 
 # Logging Guide
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/logging-guide/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/logging-guide/SKILL.md)
 
 **Version**: 1.0.0
 **Last Updated**: 2025-12-30
@@ -16,6 +16,8 @@ description: |
 
 ---
 
+> **Core Standard**: This skill implements [Logging Standards](../../core/logging-standards.md). For comprehensive methodology documentation, refer to the core standard.
+
 ## Purpose
 
 This skill helps implement consistent, structured, and actionable application logs across all environments.
@@ -103,7 +105,7 @@ Use `snake_case` and prefix with domain:
 ## Detailed Guidelines
 
 For complete standards, see:
-- [Logging Standards](../../../core/logging-standards.md)
+- [Logging Standards](../../core/logging-standards.md)
 
 ### AI-Optimized Format (Token-Efficient)
 
@@ -260,8 +262,8 @@ Never log: passwords, tokens, credit cards, SSN
 
 ## Related Standards
 
-- [Logging Standards](../../../core/logging-standards.md)
-- [Error Code Standards](../../../core/error-code-standards.md)
+- [Logging Standards](../../core/logging-standards.md)
+- [Error Code Standards](../../core/error-code-standards.md)
 
 ---
 

package/bundled/skills/methodology-system/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: methodology
+scope: partial
+description: "[UDS] Manage development methodology workflow"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[action] [argument]"
+---
+
+# Methodology System | 方法論系統
+
+> [!WARNING]
+> **Experimental Feature / 實驗性功能**
+>
+> This feature is under active development and may change significantly in v4.0.
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+Manage the active development methodology for the current project with two independent systems.
+
+管理當前專案的開發方法論，支援兩個獨立系統。
+
+**Two Independent Systems / 兩個獨立系統：**
+- **System A: SDD** - Spec-Driven Development (AI-era, spec-first)
+- **System B: Double-Loop TDD** - BDD (outer) + TDD (inner) (traditional)
+
+**Optional Input:** ATDD - Acceptance Test-Driven Development (feeds into either system)
+
+## Actions | 動作
+
+| Action | Description | 說明 |
+|--------|-------------|------|
+| *(none)* / `status` | Show current phase and checklist | 顯示當前階段和檢查清單 |
+| `switch <id>` | Switch to different methodology | 切換到不同方法論 |
+| `phase [name]` | Show or change current phase | 顯示或變更當前階段 |
+| `checklist` | Show current phase checklist | 顯示當前階段檢查清單 |
+| `skip` | Skip current phase (with warning) | 跳過當前階段（會有警告） |
+| `list` | List available methodologies | 列出可用方法論 |
+| `create` | Create custom methodology | 建立自訂方法論 |
+
+## Available Methodologies | 可用方法論
+
+| System | ID | Workflow | 工作流程 |
+|--------|-----|---------|---------|
+| A: SDD | `sdd` | /sdd -> Review -> /derive-all -> Implementation | 規格優先 |
+| B: BDD | `bdd` | Discovery -> Formulation -> Automation | 外部迴圈 |
+| B: TDD | `tdd` | Red -> Green -> Refactor | 內部迴圈 |
+| Input | `atdd` | Workshop -> Examples -> Tests | 驗收測試驅動 |
+
+## Usage Examples | 使用範例
+
+```bash
+/methodology                    # Show current status
+/methodology switch sdd         # Switch to Spec-Driven Development
+/methodology phase green        # Move to GREEN phase (TDD)
+/methodology checklist          # Show current phase checklist
+/methodology list               # List all available methodologies
+/methodology skip               # Skip current phase (with warning)
+/methodology create             # Start custom methodology wizard
+```
+
+## Configuration | 配置
+
+Methodology settings are stored in `.standards/manifest.json`:
+
+```json
+{
+  "methodology": {
+    "active": "sdd",
+    "available": ["tdd", "bdd", "sdd", "atdd"]
+  }
+}
+```
+
+## Reference | 參考
+
+- Detailed guide: [guide.md](./guide.md)

package/bundled/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md

@@ -1,6 +1,6 @@
 # Create Custom Methodology Guide
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/methodology-system/create-methodology.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/methodology-system/create-methodology.md)
 
 > [!WARNING]
 > **Experimental Feature / 實驗性功能**

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

@@ -1,5 +1,5 @@
 ---
-name: methodology-system
+scope: partial
 description: |
   Manage and guide developers through active development methodology workflows.
   Use when: TDD, BDD, SDD, ATDD, or custom methodology workflows are needed.
@@ -15,22 +15,55 @@ status: experimental
 
 # Methodology System Skill
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/methodology-system/SKILL.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/methodology-system/SKILL.md)
 
-**Version**: 1.0.0
-**Last Updated**: 2026-01-12
+**Version**: 2.0.0
+**Last Updated**: 2026-01-25
 
 ---
 
 ## Overview
 
-The Methodology System provides a unified framework for managing development methodologies in projects that adopt Universal Development Standards. It supports:
+The Methodology System provides a unified framework for managing development methodologies in projects that adopt Universal Development Standards.
 
-- **TDD** - Test-Driven Development (Red → Green → Refactor)
-- **BDD** - Behavior-Driven Development (Discovery → Formulation → Automation)
-- **SDD** - Spec-Driven Development (Proposal → Review → Implementation → Verification → Archive)
-- **ATDD** - Acceptance Test-Driven Development (Workshop → Distillation → Development → Demo)
-- **Custom** - User-defined methodologies
+### Two Independent Systems
+
+```
+┌────────────────────────────────────────────────────────────────────────────┐
+│                  Two Independent Methodology Systems                         │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                            │
+│  System A: SDD (AI-Era Methodology)                                        │
+│  ─────────────────────────────────────                                     │
+│  /sdd → Review → /derive-all → Implementation → Verification               │
+│  Best for: New projects, AI-assisted development, greenfield features     │
+│                                                                            │
+│  System B: Double-Loop TDD (Traditional)                                   │
+│  ─────────────────────────────────────                                     │
+│  /bdd (Outer Loop) → /tdd (Inner Loop) → Demo                              │
+│  Best for: Legacy systems, manual development, established codebases      │
+│                                                                            │
+│  Optional Input: ATDD Workshop                                             │
+│  ─────────────────────────────────────                                     │
+│  Stakeholder collaboration that feeds into EITHER system                   │
+│                                                                            │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Supported Methodologies
+
+**System A: SDD (Spec-Driven Development)**
+- Proposal → Review → Forward Derivation → Implementation → Verification → Archive
+- AI-native workflow with spec as authoritative source
+
+**System B: Double-Loop TDD**
+- **BDD** (Outer Loop) - Discovery → Formulation → Automation
+- **TDD** (Inner Loop) - Red → Green → Refactor
+
+**Optional Input**
+- **ATDD** - Acceptance Test-Driven Development workshop (feeds into either system)
+
+**Custom** - User-defined methodologies
 
 ---
 
@@ -153,12 +186,12 @@ Methodology configuration is stored in `.standards/manifest.json`:
 
 AI will automatically activate methodology context when these keywords are detected:
 
-| Methodology | Keywords |
-|-------------|----------|
-| TDD | test first, red green refactor, failing test |
-| BDD | given when then, gherkin, cucumber, scenario |
-| SDD | specification, spec first, proposal, acceptance criteria |
-| ATDD | acceptance test, user story, product owner |
+| System | Methodology | Keywords |
+|--------|-------------|----------|
+| A: SDD | SDD | specification, spec first, proposal, derive tests, forward derivation |
+| B: Double-Loop | BDD (outer) | given when then, gherkin, cucumber, scenario, discovery |
+| B: Double-Loop | TDD (inner) | test first, red green refactor, failing test |
+| Input | ATDD | acceptance test, user story, product owner, workshop |
 
 ---
 
@@ -203,6 +236,7 @@ Additional review checks are added based on active methodology:
 
 ## Files
 
+- [integrated-flow.md](./integrated-flow.md) - Complete workflow guide for both systems
 - [runtime.md](./runtime.md) - AI behavior and runtime guide
 - [create-methodology.md](./create-methodology.md) - Custom methodology creation wizard
 
@@ -212,4 +246,5 @@ Additional review checks are added based on active methodology:
 
 | Version | Date | Changes |
 |---------|------|---------|
+| 2.0.0 | 2026-01-25 | Refactor to two independent systems architecture |
 | 1.0.0 | 2026-01-12 | Initial methodology system |