universal-dev-standards 5.3.2 → 5.4.0

package/bundled/ai/standards/workflow-enforcement.ai.yaml

@@ -1,253 +1,47 @@
-# Workflow Enforcement Standards - AI Optimized
-# Source: core/workflow-enforcement.md
+# Workflow Enforcement Standards - DEPRECATED STUB
+# This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
+# Canonical location: dev-autopilot/standards/flow/workflow-enforcement.ai.yaml
+# Migration: XSPEC-086 Phase 2 (2026-04-27)
+#
+# Human-readable standard: core/workflow-enforcement.md (remains in UDS)
+# Deprecation schedule: UDS 5.4.0 deprecated → UDS 6.0.0 removed
 
 id: workflow-enforcement
 meta:
-  version: "1.0.0"
-  updated: "2026-03-19"
+  version: "1.0.1"
+  updated: "2026-04-27"
+  deprecated: true
+  deprecated_since: "5.4.0"
+  removal_version: "6.0.0"
+  canonical_owner: devap
+  canonical_path: "dev-autopilot/standards/flow/workflow-enforcement.ai.yaml"
   source: core/workflow-enforcement.md
-  description: Machine-enforceable workflow gates that prevent phase skipping in development methodologies
-
-enforcement_modes:
-  enforce:
-    description: Block phase transition, show guidance to correct phase
-    behavior: AI refuses to proceed and explains which prerequisite is missing
-    default: true
-
-  suggest:
-    description: Show warning but allow override with user confirmation
-    behavior: AI warns about skipped prerequisites but proceeds if user insists
-
-  off:
-    description: No enforcement checks
-    behavior: AI follows workflow steps without gate checks
-
-config_location: ".uds/config.yaml"
-config_key: "workflow.enforcement_mode"
-
-gates:
-  sdd:
-    description: Spec-Driven Development phase gates
-    phases:
-      - phase: discuss
-        prerequisites: []
-        note: Entry point, no prerequisites
-
-      - phase: create
-        prerequisites:
-          - check: orphan_specs
-            command: "ls docs/specs/SPEC-*.md 2>/dev/null"
-            condition: warn_if_non_terminal_specs_exist
-            on_fail: warn_and_offer_cleanup
-            blocking: false
-
-      - phase: review
-        prerequisites:
-          - check: spec_exists
-            command: "ls docs/specs/SPEC-*.md"
-            condition: at_least_one_spec_exists
-            on_fail: guide_to_create
-            blocking: true
-          - check: spec_status_draft
-            command: "grep -m1 '^status:' docs/specs/SPEC-XXX.md"
-            condition: status_is_draft
-            on_fail: guide_to_create
-            blocking: true
-
-      - phase: approve
-        prerequisites:
-          - check: spec_in_review
-            condition: status_is_review
-            on_fail: guide_to_review
-            blocking: true
-          - check: review_comments_addressed
-            condition: no_unresolved_comments
-            on_fail: guide_to_resolve_comments
-            blocking: true
-
-      - phase: implement
-        prerequisites:
-          - check: spec_exists
-            command: "ls docs/specs/SPEC-*.md"
-            condition: at_least_one_spec_exists
-            on_fail: guide_to_create
-            blocking: true
-          - check: spec_approved
-            condition: status_is_approved
-            on_fail: guide_to_approve
-            blocking: true
-          - check: workflow_state
-            command: "ls .workflow-state/sdd-*.yaml 2>/dev/null"
-            condition: check_for_resumable_state
-            on_fail: start_fresh
-            blocking: false
-
-      - phase: verify
-        prerequisites:
-          - check: implementation_exists
-            condition: spec_has_implementation_commits
-            on_fail: guide_to_implement
-            blocking: true
-          - check: ac_coverage
-            condition: all_ac_have_code_and_tests
-            on_fail: list_incomplete_acs
-            blocking: true
-
-  tdd:
-    description: Test-Driven Development phase gates
-    phases:
-      - phase: red
-        prerequisites:
-          - check: feature_defined
-            condition: user_has_described_behavior
-            on_fail: ask_for_behavior_description
-            blocking: true
-          - check: sdd_spec_if_applicable
-            condition: if_sdd_project_spec_exists_and_approved
-            on_fail: guide_to_sdd
-            blocking: false
-
-      - phase: green
-        prerequisites:
-          - check: failing_test_exists
-            command: "npm test 2>&1 | grep -E 'FAIL|failing'"
-            condition: at_least_one_test_failing
-            on_fail: guide_to_red_phase
-            blocking: true
-
-      - phase: refactor
-        prerequisites:
-          - check: all_tests_passing
-            command: "npm test"
-            condition: zero_test_failures
-            on_fail: guide_to_green_phase
-            blocking: true
-
-  bdd:
-    description: Behavior-Driven Development phase gates
-    phases:
-      - phase: discovery
-        prerequisites:
-          - check: behavior_identified
-            condition: user_has_identified_behavior
-            on_fail: ask_for_behavior
-            blocking: true
-
-      - phase: formulation
-        prerequisites:
-          - check: examples_collected
-            condition: discovery_produced_examples
-            on_fail: guide_to_discovery
-            blocking: true
-
-      - phase: automation
-        prerequisites:
-          - check: feature_file_exists
-            command: "ls tests/features/*.feature 2>/dev/null"
-            condition: at_least_one_feature_file
-            on_fail: guide_to_formulation
-            blocking: true
-          - check: gherkin_format
-            condition: scenarios_use_given_when_then
-            on_fail: fix_scenario_format
-            blocking: true
-
-      - phase: living_docs
-        prerequisites:
-          - check: steps_implemented
-            condition: step_definitions_exist
-            on_fail: guide_to_automation
-            blocking: true
-          - check: scenarios_passing
-            condition: all_scenarios_pass
-            on_fail: fix_failing_scenarios
-            blocking: true
-
-  commit:
-    description: Commit workflow gates
-    phases:
-      - phase: commit
-        prerequisites:
-          - check: staged_changes
-            command: "git diff --cached --stat"
-            condition: has_staged_changes
-            on_fail: guide_to_git_add
-            blocking: true
-          - check: no_merge_conflicts
-            condition: no_conflict_markers_in_staged
-            on_fail: resolve_conflicts
-            blocking: true
-          - check: tests_pass
-            condition: tests_passing_for_feat_fix
-            on_fail: fix_tests
-            blocking: true
-          - check: spec_reference
-            condition: feat_fix_should_reference_spec
-            on_fail: suggest_spec_reference
-            blocking: false
+  description: >
+    DEPRECATED: This standard has moved to DevAP (flow orchestration layer).
+    Install DevAP and load standards/flow/workflow-enforcement.ai.yaml instead.
 
 rules:
-  - id: enforce-phase-order
-    trigger: AI assistant receives a workflow phase command
+  - id: deprecation-notice
+    trigger: any workflow enforcement check
     instruction: >
-      Before executing any workflow phase (SDD, TDD, BDD), check the
-      phase gate prerequisites defined in this standard. If any blocking
-      prerequisite fails, STOP execution, explain what is missing, and
-      guide the user to the correct prerequisite phase. Non-blocking
-      prerequisites generate warnings but allow proceeding.
-    priority: required
+      This standard (workflow-enforcement.ai.yaml) has been migrated to DevAP.
+      For the canonical executable definition, load:
+        dev-autopilot/standards/flow/workflow-enforcement.ai.yaml
 
-  - id: respect-enforcement-mode
-    trigger: checking workflow gates
-    instruction: >
-      Read the project's enforcement mode from .uds/config.yaml
-      (workflow.enforcement_mode). If 'enforce' (default), block on
-      failed prerequisites. If 'suggest', warn but allow override.
-      If 'off', skip all checks.
-    priority: required
+      The human-readable standard remains at:
+        universal-dev-standards/core/workflow-enforcement.md
 
-  - id: guide-dont-block
-    trigger: prerequisite check fails
-    instruction: >
-      When a prerequisite fails, provide actionable guidance:
-      1. Explain WHAT is missing (e.g., "No approved spec found")
-      2. Explain WHY it matters (e.g., "SDD requires approved specs before implementation")
-      3. Show HOW to fix it (e.g., "Run /sdd approve SPEC-XXX.md first")
-      Never just say "blocked" — always provide the path forward.
+      To install DevAP: npm install -g @devap/cli
+      See: https://github.com/AsiaOstrich/dev-autopilot
     priority: required
 
-  - id: resume-existing-workflow
-    trigger: workflow command invoked with existing state
-    instruction: >
-      Before starting a fresh workflow, check .workflow-state/ for
-      existing state files. If an active workflow exists for the same
-      spec or feature, offer to resume instead of starting fresh.
-    priority: required
-
-  - id: feat-commit-spec-suggestion
-    trigger: committing a feat or fix type change
+  - id: enforce-phase-order
+    trigger: AI assistant receives a workflow phase command
     instruction: >
-      When generating a feat or fix commit message, check if active
-      specs exist in docs/specs/. If yes, suggest adding Refs: SPEC-XXX
-      to the commit footer. If no specs exist and the change is
-      significant (>3 files changed or new API), suggest creating a
-      spec via /sdd. This is advisory, not blocking.
-    priority: recommended
-
-quick_reference:
-  enforcement_modes:
-    columns: [Mode, Behavior, Config Value]
-    rows:
-      - [Enforce, "Block + Guide", "enforce"]
-      - [Suggest, "Warn + Allow", "suggest"]
-      - [Off, "No checks", "off"]
+      DEPRECATED — load dev-autopilot/standards/flow/workflow-enforcement.ai.yaml
+      for the current executable gate definitions.
 
-  phase_gates:
-    columns: [Workflow, Phase, Key Prerequisite]
-    rows:
-      - [SDD, implement, "Spec must be Approved"]
-      - [SDD, verify, "All ACs must have code + tests"]
-      - [TDD, green, "At least one failing test"]
-      - [TDD, refactor, "All tests passing"]
-      - [BDD, automation, ".feature file must exist"]
-      - [Commit, feat/fix, "Suggest spec reference"]
+      Minimal fallback: Before executing any workflow phase, check that
+      prerequisites for the phase are met. If not, stop and guide the user
+      to the correct prerequisite phase.
+    priority: required

package/bundled/ai/standards/workflow-state-protocol.ai.yaml

@@ -1,121 +1,45 @@
-# Workflow State Protocol - AI Optimized
-# Source: core/workflow-state-protocol.md
+# Workflow State Protocol - DEPRECATED STUB
+# This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
+# Canonical location: dev-autopilot/standards/flow/workflow-state-protocol.ai.yaml
+# Migration: XSPEC-086 Phase 2 (2026-04-27)
+#
+# Human-readable standard: core/workflow-state-protocol.md (remains in UDS)
+# Deprecation schedule: UDS 5.4.0 deprecated → UDS 6.0.0 removed
 
 id: workflow-state-protocol
 meta:
-  version: "1.0.0"
-  updated: "2026-03-17"
+  version: "1.0.1"
+  updated: "2026-04-27"
+  deprecated: true
+  deprecated_since: "5.4.0"
+  removal_version: "6.0.0"
+  canonical_owner: devap
+  canonical_path: "dev-autopilot/standards/flow/workflow-state-protocol.ai.yaml"
   source: core/workflow-state-protocol.md
-  description: Protocol for persisting and restoring workflow state across AI sessions
-
-principles:
-  state_persistence:
-    rule: Multi-phase workflows must save state at phase transitions
-    rationale: Enables resumption after session boundaries without state loss
-
-  event_sourcing:
-    rule: Important decisions and transitions are logged in append-only event log
-    rationale: Provides audit trail and enables understanding of workflow history
-
-  session_independence:
-    rule: Each AI session should be able to resume any workflow from saved state
-    rationale: Context window limits make single-session completion unreliable
-
-state_file:
-  location: ".workflow-state/{workflow}-{id}.yaml"
-  required_fields:
-    - workflow      # Workflow type (sdd, feature-dev, etc.)
-    - spec_id       # Spec or task identifier
-    - current_phase # Active phase ID
-    - status        # in-progress | paused | blocked | completed | abandoned
-    - updated       # Last update timestamp (ISO 8601)
-    - phases_completed  # Ordered list of completed phase IDs
-  optional_fields:
-    - title
-    - iteration_count
-    - created
-    - artifacts
-    - progress_summary
-    - completed_steps
-    - next_steps
-    - open_questions
-    - decisions
-
-event_log:
-  location: ".workflow-state/{workflow}-{id}.log.yaml"
-  format: append-only YAML list
-  event_types:
-    - phase_enter    # Workflow enters a new phase
-    - phase_exit     # Workflow exits a phase
-    - checkpoint     # Notable milestone
-    - decision       # Important decision made
-    - error          # Error or failure
-    - interruption   # Workflow paused (HITL or context limit)
-    - resumption     # Workflow resumed from saved state
-  required_event_fields:
-    - timestamp
-    - event_type
-    - phase
-    - summary
+  description: >
+    DEPRECATED: This standard has moved to DevAP (flow orchestration layer).
+    Install DevAP and load standards/flow/workflow-state-protocol.ai.yaml instead.
 
 rules:
-  - id: state-save-on-phase-transition
-    trigger: workflow phase changes
+  - id: deprecation-notice
+    trigger: any workflow state operation
     instruction: >
-      When a workflow transitions between phases, update the state file
-      with new current_phase, add the completed phase to phases_completed,
-      and update the timestamp. Also append a phase_exit and phase_enter
-      event to the event log.
+      This standard (workflow-state-protocol.ai.yaml) has been migrated to DevAP.
+      For the canonical executable definition, load:
+        dev-autopilot/standards/flow/workflow-state-protocol.ai.yaml
+
+      The human-readable standard remains at:
+        universal-dev-standards/core/workflow-state-protocol.md
+
+      To install DevAP: npm install -g @devap/cli
     priority: required
 
   - id: state-load-on-resume
     trigger: session start or workflow command invocation
     instruction: >
-      At session start, check .workflow-state/ for any files with
-      status 'in-progress' or 'paused'. If found, inform the user
-      of active workflows and offer to resume. When a workflow command
-      is invoked (e.g., /sdd implement SPEC-042), check for existing
-      state before starting fresh.
-    priority: required
+      DEPRECATED — load dev-autopilot/standards/flow/workflow-state-protocol.ai.yaml
+      for the current executable state protocol.
 
-  - id: state-save-on-session-end
-    trigger: AI session ending with active workflow
-    instruction: >
-      Before ending a session during an active workflow, save current
-      progress to the state file. Update progress_summary, next_steps,
-      and open_questions to enable seamless resumption.
+      Minimal fallback: At session start, check .workflow-state/ for active workflows
+      and offer to resume if found.
     priority: required
-
-  - id: event-log-on-decision
-    trigger: important design or scope decision made
-    instruction: >
-      When a significant decision is made during a workflow (design choice,
-      scope change, technology selection), append a 'decision' event to the
-      event log with the decision summary and reasoning.
-    priority: recommended
-
-  - id: state-staleness-warning
-    trigger: loading state file older than 7 days
-    instruction: >
-      If a state file's 'updated' timestamp is more than 7 days old,
-      warn the user that the workflow state may be stale and suggest
-      reviewing it before continuing.
-    priority: recommended
-
-  - id: gitignore-workflow-state
-    trigger: creating .workflow-state/ directory
-    instruction: >
-      Recommend adding .workflow-state/ to .gitignore as workflow state
-      is session-specific. Exception: teams sharing state across developers
-      may version-control it but should clean up completed workflows.
-    priority: recommended
-
-quick_reference:
-  state_lifecycle:
-    columns: [Event, Action]
-    rows:
-      - [Phase transition, Update state file + append event log]
-      - [Important decision, Record in state decisions + event log]
-      - [Session ending, Save progress_summary and next_steps]
-      - [Session starting, Check .workflow-state/ for active workflows]
-      - [Workflow complete, Set status to completed]

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

@@ -1,7 +1,7 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.3.2
-translation_version: 5.3.2
+source_version: 5.4.0
+translation_version: 5.4.0
 last_synced: 2026-04-27
 status: current
 ---

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

@@ -14,7 +14,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 5.3.2 | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.4.0 | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 

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

@@ -1,7 +1,7 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.3.2
-translation_version: 5.3.2
+source_version: 5.4.0
+translation_version: 5.4.0
 last_synced: 2026-04-27
 status: current
 ---

package/bundled/locales/zh-TW/README.md

@@ -14,7 +14,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.3.2 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.4.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "lastUpdated": "2026-04-16",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -58,14 +58,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "5.3.2"
+      "version": "5.4.0"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
-      "version": "5.3.2",
+      "version": "5.4.0",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
@@ -1007,7 +1007,12 @@
       },
       "category": "reference",
       "skillName": null,
-      "description": "Protocol for persisting and restoring workflow state across AI sessions"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/flow/workflow-state-protocol.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Workflow state persistence protocol — see dev-autopilot/standards/flow/workflow-state-protocol.ai.yaml"
     },
     {
       "id": "workflow-enforcement",
@@ -1019,7 +1024,12 @@
       },
       "category": "reference",
       "skillName": null,
-      "description": "Machine-enforceable workflow gates that prevent phase skipping in SDD/TDD/BDD methodologies"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/flow/workflow-enforcement.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Machine-enforceable workflow gates — see dev-autopilot/standards/flow/workflow-enforcement.ai.yaml"
     },
     {
       "id": "testing",
@@ -1367,7 +1377,12 @@
       },
       "category": "reference",
       "skillName": null,
-      "description": "Structured system for persisting agent execution artifacts with L1/L2/L3 tiered access model"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/orchestration/execution-history.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Execution history L1/L2/L3 protocol — see dev-autopilot/standards/orchestration/execution-history.ai.yaml"
     },
     {
       "id": "project-context-memory",
@@ -1554,7 +1569,12 @@
       },
       "category": "reference",
       "skillName": null,
-      "description": "Configuration contract, stage model, and context classification for automated development pipelines"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/flow/pipeline-integration-standards.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Pipeline 6-stage model — see dev-autopilot/standards/flow/pipeline-integration-standards.ai.yaml"
     },
     {
       "id": "acceptance-criteria-traceability",
@@ -1578,7 +1598,12 @@
       },
       "category": "reference",
       "skillName": null,
-      "description": "Pending changes state machine, threshold strategies, and atomicity guarantees for batch commits"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/flow/change-batching-standards.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Change batching state machine — see dev-autopilot/standards/flow/change-batching-standards.ai.yaml"
     },
     {
       "id": "migration-template",
@@ -1612,7 +1637,12 @@
       },
       "category": "skill",
       "skillName": null,
-      "description": "Sub-agent dispatch, parallel coordination, and status protocol (DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED)"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/orchestration/agent-dispatch.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Agent dispatch protocol — see dev-autopilot/standards/orchestration/agent-dispatch.ai.yaml"
     },
     {
       "id": "agent-communication-protocol",
@@ -1624,7 +1654,12 @@
       },
       "category": "skill",
       "skillName": null,
-      "description": "Unified status codes, envelope protocol, structured handoff, and versioning for cross-project agent communication"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/orchestration/agent-communication-protocol.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Agent envelope/handoff protocol — see dev-autopilot/standards/orchestration/agent-communication-protocol.ai.yaml"
     },
     {
       "id": "model-selection",
@@ -1660,7 +1695,12 @@
       },
       "category": "reference",
       "skillName": null,
-      "description": "Branch completion workflow with 4 options (merge/PR/keep/discard) and prerequisite checks"
+      "deprecated": true,
+      "deprecatedSince": "5.4.0",
+      "removalVersion": "6.0.0",
+      "canonicalOwner": "devap",
+      "canonicalPath": "dev-autopilot/standards/flow/branch-completion.ai.yaml",
+      "description": "DEPRECATED: Migrated to DevAP per DEC-049. Branch completion workflow — see dev-autopilot/standards/flow/branch-completion.ai.yaml"
     },
     {
       "id": "verification-evidence",