universal-dev-standards 5.8.0 → 5.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/bundled/ai/language-packs/README.md +55 -0
  2. package/bundled/ai/language-packs/language-pack-php-to-csharp.ai.yaml +83 -0
  3. package/bundled/ai/standards/behavior-snapshot.ai.yaml +122 -18
  4. package/bundled/ai/standards/deployment-standards.ai.yaml +108 -3
  5. package/bundled/ai/standards/feature-discovery-standards.ai.yaml +459 -0
  6. package/bundled/ai/standards/feature-manifest-standard.ai.yaml +23 -20
  7. package/bundled/ai/standards/mock-boundary.ai.yaml +93 -2
  8. package/bundled/ai/standards/multi-environment-e2e-testing.ai.yaml +250 -0
  9. package/bundled/ai/standards/test-completeness-dimensions.ai.yaml +39 -7
  10. package/bundled/ai/standards/verification-evidence.ai.yaml +30 -4
  11. package/bundled/core/adversarial-test.md +3 -0
  12. package/bundled/core/behavior-snapshot.md +1 -1
  13. package/bundled/core/capability-declaration.md +3 -0
  14. package/bundled/core/cd-deployment-strategies.md +3 -0
  15. package/bundled/core/chaos-injection-tests.md +3 -0
  16. package/bundled/core/circuit-breaker.md +3 -0
  17. package/bundled/core/container-security.md +3 -0
  18. package/bundled/core/cost-budget-test.md +3 -0
  19. package/bundled/core/data-migration-testing.md +3 -0
  20. package/bundled/core/disaster-recovery-drill.md +3 -0
  21. package/bundled/core/dual-phase-output.md +3 -0
  22. package/bundled/core/failure-source-taxonomy.md +3 -0
  23. package/bundled/core/feature-manifest-standard.md +1 -1
  24. package/bundled/core/flaky-test-management.md +3 -0
  25. package/bundled/core/full-coverage-testing.md +3 -0
  26. package/bundled/core/health-check-standards.md +3 -0
  27. package/bundled/core/immutability-first.md +3 -0
  28. package/bundled/core/llm-output-validation.md +3 -0
  29. package/bundled/core/no-cicd-deployment.md +3 -0
  30. package/bundled/core/pipeline-security-gates.md +3 -0
  31. package/bundled/core/policy-as-code-testing.md +3 -0
  32. package/bundled/core/prompt-regression.md +3 -0
  33. package/bundled/core/property-based-testing.md +3 -0
  34. package/bundled/core/recovery-recipe-registry.md +3 -0
  35. package/bundled/core/release-quality-manifest.md +3 -0
  36. package/bundled/core/replay-test.md +3 -0
  37. package/bundled/core/retry-standards.md +3 -0
  38. package/bundled/core/rollback-standards.md +3 -0
  39. package/bundled/core/sast-advanced.md +1 -1
  40. package/bundled/core/secure-op.md +3 -0
  41. package/bundled/core/security-decision.md +3 -0
  42. package/bundled/core/server-ops-security.md +3 -0
  43. package/bundled/core/skill-standard-alignment-check.md +3 -0
  44. package/bundled/core/smoke-test.md +3 -0
  45. package/bundled/core/standard-admission-criteria.md +3 -0
  46. package/bundled/core/standard-lifecycle-management.md +3 -0
  47. package/bundled/core/supply-chain-attestation.md +3 -0
  48. package/bundled/core/timeout-standards.md +3 -0
  49. package/bundled/core/token-budget.md +3 -0
  50. package/bundled/locales/zh-CN/CHANGELOG.md +38 -3
  51. package/bundled/locales/zh-CN/CLAUDE.md +1 -1
  52. package/bundled/locales/zh-CN/README.md +3 -3
  53. package/bundled/locales/zh-CN/SECURITY.md +1 -2
  54. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +127 -15
  55. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +141 -25
  56. package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +43 -0
  57. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +35 -0
  58. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +35 -0
  59. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +35 -0
  60. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +24 -0
  61. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +37 -0
  62. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +33 -0
  63. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +34 -0
  64. package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +33 -0
  65. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +19 -0
  66. package/bundled/locales/zh-CN/skills/retrospective-assistant/SKILL.md +38 -0
  67. package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +36 -0
  68. package/bundled/locales/zh-TW/CHANGELOG.md +38 -3
  69. package/bundled/locales/zh-TW/CLAUDE.md +1 -1
  70. package/bundled/locales/zh-TW/README.md +3 -3
  71. package/bundled/locales/zh-TW/SECURITY.md +1 -2
  72. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +127 -15
  73. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +141 -25
  74. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +43 -0
  75. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +35 -0
  76. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +35 -0
  77. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +35 -0
  78. package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +661 -267
  79. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +24 -0
  80. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +37 -0
  81. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +33 -0
  82. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +34 -0
  83. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +33 -0
  84. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -0
  85. package/bundled/locales/zh-TW/skills/retrospective-assistant/SKILL.md +38 -0
  86. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +36 -0
  87. package/bundled/skills/README.md +1 -1
  88. package/bundled/skills/spec-driven-dev/SKILL.md +41 -0
  89. package/package.json +4 -4
  90. package/src/commands/update.js +39 -1
  91. package/src/config/ai-agent-paths.js +8 -0
  92. package/src/i18n/messages.js +3 -0
  93. package/src/utils/integration-generator.js +18 -2
  94. package/standards-registry.json +29 -5
  95. package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +0 -79
@@ -1,15 +1,7 @@
1
- ---
2
- source: ../../../docs/FEATURE-REFERENCE.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-22
6
- status: current
7
- ---
8
-
9
1
  # UDS 功能參考手冊
10
2
 
11
3
  > Universal Development Standards - 完整功能文件
12
- > Auto-generated | Last updated: 2026-03-24
4
+ > Auto-generated | Last updated: 2026-05-14
13
5
 
14
6
  **Language**: [English](../../../docs/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
15
7
 
@@ -18,14 +10,14 @@ status: current
18
10
  ## 目錄
19
11
 
20
12
  1. [CLI 指令](#cli-commands) (9)
21
- 2. [斜線命令](#slash-commands) (45)
22
- 3. [技能](#skills) (40)
13
+ 2. [斜線命令](#slash-commands) (49)
14
+ 3. [技能](#skills) (54)
23
15
  4. [代理](#agents) (5)
24
16
  5. [工作流程](#workflows) (5)
25
- 6. [核心規範](#core-standards) (48)
26
- 7. [腳本](#scripts) (41)
17
+ 6. [核心規範](#core-standards) (125)
18
+ 7. [腳本](#scripts) (55)
27
19
 
28
- **Total Features: 182**
20
+ **Total Features: 302**
29
21
 
30
22
  ---
31
23
 
@@ -60,8 +52,11 @@ status: current
60
52
  | `--content-mode` | Content mode for integration files (minimal, index, full) [default: index] |
61
53
  | `--agents-md` | Generate AGENTS.md universal summary |
62
54
  | `--no-agents-md` | Skip AGENTS.md generation |
55
+ | `--with-hooks` | Install enforcement hooks (commit-msg, security, logging) |
56
+ | `--content-layout` | Content layout (flat, layered) [default: flat] |
63
57
  | `-y, --yes` | Use defaults, skip interactive prompts |
64
58
  | `-E, --experimental` | Enable experimental features (methodology) |
59
+ | `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
65
60
 
66
61
  ### `uds configure`
67
62
 
@@ -93,6 +88,7 @@ status: current
93
88
  | `--ci` | CI mode: disable interactive prompts and set exit code on issues |
94
89
  | `--migrate` | Migrate legacy manifest to hash-based tracking |
95
90
  | `--offline` | Skip npm registry check for CLI updates |
91
+ | `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
96
92
 
97
93
  ### `uds update`
98
94
 
@@ -159,15 +155,19 @@ status: current
159
155
  | Command | 說明 |
160
156
  |---------|-------------|
161
157
  | `/ac-coverage` | "[UDS] Generate AC-to-test traceability matrix and coverage report" |
158
+ | `/api-design` | "[UDS] Guide API design following REST, GraphQL and gRPC best practices" |
162
159
  | `/atdd` | [UDS] Guide through Acceptance Test-Driven Development workflow |
160
+ | `/audit` | "[UDS] UDS health check and feedback system, diagnose installation integrity and detect development patterns" |
163
161
  | `/bdd` | [UDS] Guide through Behavior-Driven Development workflow |
164
162
  | `/brainstorm` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
165
163
  | `/changelog` | "[UDS] Generate and maintain CHANGELOG.md entries" |
166
164
  | `/check` | [UDS] Verify standards adoption status |
167
165
  | `/checkin` | "[UDS] Pre-commit quality gates verification" |
166
+ | `/ci-cd` | "[UDS] Guide CI/CD pipeline design, configuration and optimization" |
168
167
  | `/commit` | [UDS] Generate commit messages following Conventional Commits standard |
169
168
  | `/config` | [UDS] Configure project development standards |
170
169
  | `/coverage` | [UDS] Analyze test coverage and provide recommendations |
170
+ | `/database` | "[UDS] Guide database design, migration planning and query optimization" |
171
171
  | `/derive-all` | [UDS] Derive all test structures (BDD, TDD, ATDD) from SDD specification |
172
172
  | `/derive-atdd` | [UDS] Derive ATDD acceptance tests from SDD specification |
173
173
  | `/derive-bdd` | [UDS] Derive BDD Gherkin scenarios from SDD specification |
@@ -177,9 +177,16 @@ status: current
177
177
  | `/discover` | "[UDS] Assess project health, architecture, and risks before adding features" |
178
178
  | `/docgen` | "[UDS] Generate usage documentation from project sources" |
179
179
  | `/docs` | [UDS] Manage, guide, and generate documentation. |
180
+ | `/durable` | "[UDS] Guide workflow failure recovery with checkpoints, retries and rollback strategies" |
181
+ | `/e2e` | [UDS] Generate E2E test skeletons from BDD scenarios with framework detection |
180
182
  | `/guide` | [UDS] Access Universal Development Standards guides and references. |
183
+ | `/incident` | "[UDS] Guide incident response, root cause analysis and post-mortem documentation" |
181
184
  | `/init` | [UDS] Initialize development standards in current project |
182
185
  | `/methodology` | [UDS] Manage development methodology workflow |
186
+ | `/metrics` | "[UDS] Track development metrics, code quality indicators and project health" |
187
+ | `/migrate` | "[UDS] Guide code migration, framework upgrades and technology modernization" |
188
+ | `/observability` | "[UDS] Guide observability setup, metrics design, alerting, and maturity assessment" |
189
+ | `/pr` | "[UDS] Guide Pull Request creation, review automation and merge strategies" |
183
190
  | `/refactor` | [UDS] Guide refactoring decisions and strategy selection |
184
191
  | `/release` | [UDS] Manage release process and changelogs. |
185
192
  | `/requirement` | [UDS] Write user stories and requirements following INVEST criteria |
@@ -188,8 +195,12 @@ status: current
188
195
  | `/reverse-tdd` | [UDS] Analyze BDD-TDD coverage gaps |
189
196
  | `/reverse` | [UDS] Reverse engineer code to Specs, BDD, or TDD coverage. |
190
197
  | `/review` | [UDS] Perform systematic code review with checklist |
198
+ | `/runbook` | "[UDS] Guide runbook creation, maintenance, drills, and coverage reporting" |
199
+ | `/scan` | "[UDS] Guide automated security scanning, dependency auditing and secret detection" |
191
200
  | `/sdd-retro` | [UDS] Create retroactive specs for untracked feat/fix commits |
192
201
  | `/sdd` | [UDS] Create or review specification documents for Spec-Driven Development |
202
+ | `/security` | "[UDS] Guide security review and vulnerability assessment following OWASP standards" |
203
+ | `/slo` | "[UDS] Guide SLI selection, SLO setting, and Error Budget management" |
193
204
  | `/tdd` | [UDS] Guide through Test-Driven Development workflow |
194
205
  | `/update` | [UDS] Update development standards to latest version |
195
206
 
@@ -199,10 +210,11 @@ status: current
199
210
 
200
211
  | Skill | 說明 |
201
212
  |-------|-------------|
202
- | `ac-coverage-assistant` | "[UDS] Analyze AC-to-test traceability and coverage" |
213
+ | `ac-coverage` | "[UDS] Analyze AC-to-test traceability and coverage" |
214
+ | `adr-assistant` | [UDS] Create, manage, and track Architecture Decision Records (ADR). |
203
215
  | `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. |
204
216
  | `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, layered documentation, and semantic boundaries. |
205
- | `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, .cursorrules, etc.) with proper structure. |
217
+ | `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/, etc.) with proper structure. |
206
218
  | `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best practices. |
207
219
  | `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development workflow" |
208
220
  | `audit-assistant` | "[UDS] UDS Health & Feedback System \| UDS 健康檢查與回饋系統" |
@@ -213,29 +225,42 @@ status: current
213
225
  | `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization. |
214
226
  | `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
215
227
  | `commit-standards` | "[UDS] Generate commit messages following Conventional Commits standard" |
228
+ | `contract-test-assistant` | [UDS] Guide contract testing strategy for APIs and microservices. |
216
229
  | `database-assistant` | Guide database design, migration, and query optimization. |
230
+ | `deploy-assistant` | Guide reliable deployments without CI/CD platforms (GitHub Actions / GitLab CI). |
231
+ | `dev-methodology` | "[UDS] Manage development methodology workflow" |
217
232
  | `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS commands and features" |
218
233
  | `docs-generator` | "[UDS] Generate usage documentation from project sources" |
219
234
  | `documentation-guide` | Guide documentation structure, content requirements, and project documentation best practices. |
220
235
  | `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, retries, and rollback" |
236
+ | `e2e-assistant` | "[UDS] Generate E2E test skeletons from BDD scenarios" |
221
237
  | `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. |
222
- | `forward-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications" |
223
238
  | `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge operations. |
224
239
  | `incident-response-assistant` | Guide incident response, root cause analysis, and post-mortem documentation. |
240
+ | `journey-test-assistant` | "[UDS] 從專案描述生成連貫使用者旅程測試計畫(TESTPLAN)與 E2E 骨架" |
225
241
  | `logging-guide` | Implement structured logging with proper log levels and sensitive data handling. |
226
- | `methodology-system` | "[UDS] Manage development methodology workflow" |
227
242
  | `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, and project health" |
228
243
  | `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technology modernization" |
244
+ | `observability-assistant` | Guide observability setup, metrics design, and alerting configuration. |
245
+ | `orchestrate` | Orchestrate multi-task execution plans using Claude's native Agent tool (DAG-based, no external engine). |
246
+ | `plan` | Generate plan.json from Spec documents, OpenSpec changes, or free-text requirements. |
229
247
  | `pr-automation-assistant` | Guide pull request creation, review automation, and merge strategies. |
230
248
  | `project-discovery` | "[UDS] Assess project health, architecture, and risks before adding features" |
231
249
  | `project-structure-guide` | Guide for organizing project directories following language-specific best practices. |
250
+ | `push` | AI-assisted safety layer for git push operations with quality gates and collaboration guardrails. |
232
251
  | `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
233
252
  | `release-standards` | "[UDS] Guide release process and changelogs" |
234
253
  | `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST criteria" |
254
+ | `retrospective-assistant` | [UDS] Guide structured team retrospectives for Sprint and Release cycles. |
235
255
  | `reverse-engineer` | "[UDS] System archeology — reverse engineer code across Logic, Data, and Runtime dimensions" |
256
+ | `runbook-assistant` | Guide runbook creation, maintenance, and drill exercises. |
236
257
  | `security-assistant` | Guide security review and vulnerability assessment following OWASP standards. |
237
258
  | `security-scan-assistant` | Guide automated security scanning, dependency auditing, and secret detection. |
259
+ | `skill-builder` | "[UDS] Identify repeated processes and build Skills with the right development depth" |
260
+ | `slo-assistant` | Guide SLI selection, SLO setting, and Error Budget management. |
261
+ | `spec-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications" |
238
262
  | `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Driven Development" |
263
+ | `sweep` | Scan codebase for debug artifacts and code quality issues; optionally auto-fix safe patterns. |
239
264
  | `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
240
265
  | `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
241
266
  | `testing-guide` | Testing pyramid and test writing standards for UT/IT/ST/E2E. |
@@ -273,46 +298,123 @@ status: current
273
298
  | `acceptance-criteria-traceability` | - | |
274
299
  | `acceptance-test-driven-development` | 1.1.0 | |
275
300
  | `accessibility-standards` | 1.0.0 | This standard defines comprehensive guidelines for creating accessible software |
301
+ | `adr-standards` | 1.0.0 | Architecture Decision Records capture the context, options, and rationale behind |
302
+ | `adversarial-test` | - | |
303
+ | `agent-behavior-discipline` | 1.0.0 | This standard defines four behavioral disciplines for AI agents that elevate per |
304
+ | `agent-communication-protocol` | 1.0.0 | Define a unified communication protocol for AI agents across the AsiaOstrich pro |
276
305
  | `agent-dispatch` | 1.0.0 | Define standards for dispatching AI sub-agents in parallel, coordinating their w |
277
306
  | `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
307
+ | `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
278
308
  | `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
279
309
  | `ai-instruction-standards` | 1.0.0 | This standard defines best practices for creating and maintaining AI instruction |
280
- | `anti-hallucination` | 1.5.0 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
310
+ | `ai-response-navigation` | 1.0.0 | This standard defines navigation behavior for AI responses: every substantive AI |
311
+ | `alerting-standards` | 1.0.0 | |
312
+ | `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
313
+ | `anti-sycophancy-prompting` | 1.0.0 | This standard defines techniques and rules for designing prompts that elicit gen |
281
314
  | `api-design-standards` | 1.0.0 | This standard defines comprehensive guidelines for designing, building, and main |
282
315
  | `behavior-driven-development` | 1.1.0 | |
316
+ | `behavior-snapshot` | - | |
283
317
  | `branch-completion` | 1.0.0 | Define a standardized workflow for completing development branches, including pr |
318
+ | `browser-compatibility-standards` | 1.0.0 | This standard defines supported browser and device matrices, testing automation |
319
+ | `capability-declaration` | - | |
320
+ | `cd-deployment-strategies` | - | |
284
321
  | `change-batching-standards` | - | |
285
322
  | `changelog-standards` | 1.0.2 | This standard defines how to write and maintain a CHANGELOG.md file to communica |
286
- | `checkin-standards` | 1.5.0 | This standard defines quality gates that MUST be passed before committing code t |
323
+ | `chaos-engineering-standards` | 1.0.0 | |
324
+ | `chaos-injection-tests` | - | |
325
+ | `checkin-standards` | 1.6.0 | This standard defines quality gates that MUST be passed before committing code t |
326
+ | `circuit-breaker` | - | |
287
327
  | `code-review-checklist` | 1.3.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
288
328
  | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
329
+ | `container-security` | - | |
330
+ | `containerization-standards` | 1.0.0 | |
289
331
  | `context-aware-loading` | 1.0.0 | This standard defines a protocol for AI tools to selectively load development st |
332
+ | `contract-testing-standards` | 1.0.0 | Contract testing verifies that a provider (API server) and its consumers (client |
333
+ | `cost-budget-test` | - | |
334
+ | `cross-flow-regression` | 1.0.0 | This standard defines cross-flow regression testing — verifying that changes to |
335
+ | `data-migration-testing` | - | |
290
336
  | `database-standards` | 1.0.0 | This standard defines guidelines for database design, querying, migration, and o |
291
337
  | `deployment-standards` | 1.0.0 | This standard defines guidelines for safely deploying software to production, co |
338
+ | `deprecation-standards` | 1.0.0 | |
339
+ | `design-document-standards` | 1.0.0 | |
292
340
  | `developer-memory` | 1.0.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
341
+ | `disaster-recovery-drill` | - | |
342
+ | `documentation-lifecycle` | 1.0.0 | This standard defines **when** to update documentation, **when** to check it, an |
293
343
  | `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
294
344
  | `documentation-writing-standards` | 1.2.0 | This standard defines documentation requirements based on project types and prov |
345
+ | `dual-phase-output` | - | |
346
+ | `environment-standards` | 1.0.0 | |
295
347
  | `error-code-standards` | 1.2.0 | |
348
+ | `estimation-standards` | 1.0.0 | |
349
+ | `execution-history` | 1.0.0 | |
350
+ | `failure-source-taxonomy` | - | |
351
+ | `feature-flag-standards` | 1.0.0 | |
352
+ | `feature-manifest-standard` | - | |
353
+ | `flaky-test-management` | - | |
354
+ | `flow-based-testing` | 1.3.0 | This document defines a systematic methodology for testing multi-step processes. |
296
355
  | `forward-derivation-standards` | 1.2.0 | This standard defines the principles and workflows for Forward Derivation—automa |
356
+ | `frontend-design-standards` | 1.0.0 | This standard defines a machine-readable frontend design specification format (D |
357
+ | `full-coverage-testing` | - | |
297
358
  | `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
298
359
  | `git-worktree` | 1.0.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
360
+ | `governance-layer` | 1.0.0 | A governance layer provides a shared anchor for all agents and roles in a projec |
361
+ | `health-check-standards` | - | |
362
+ | `immutability-first` | - | |
363
+ | `knowledge-transfer-standards` | 1.0.0 | |
364
+ | `llm-output-validation` | - | |
299
365
  | `logging-standards` | 1.2.0 | |
366
+ | `mock-boundary` | 1.0.0 | This document defines rules for what can and cannot be mocked in tests. Its goal |
300
367
  | `model-selection` | 1.0.0 | Define a cost-effective strategy for selecting AI model tiers based on task comp |
368
+ | `mutation-testing` | 1.0.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
369
+ | `no-cicd-deployment` | - | |
370
+ | `observability-standards` | 1.0.0 | |
371
+ | `packaging-standards` | 1.0.0 | This standard defines a Recipe-based packaging framework that enables user proje |
301
372
  | `performance-standards` | 1.1.0 | This standard defines comprehensive guidelines for software performance engineer |
302
373
  | `pipeline-integration-standards` | - | |
374
+ | `pipeline-security-gates` | - | |
375
+ | `policy-as-code-testing` | - | |
376
+ | `postmortem-standards` | 1.0.0 | |
377
+ | `privacy-standards` | 1.0.0 | |
303
378
  | `project-context-memory` | 1.1.0 | This standard defines a structured system for capturing, retrieving, and enforci |
304
379
  | `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
380
+ | `prompt-regression` | - | |
381
+ | `property-based-testing` | - | |
382
+ | `recovery-recipe-registry` | - | |
305
383
  | `refactoring-standards` | 2.1.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
384
+ | `release-quality-manifest` | - | |
385
+ | `release-readiness-gate` | 1.0.0 | This standard defines a **single, aggregated Release Readiness Gate** that unifi |
386
+ | `replay-test` | - | |
306
387
  | `requirement-engineering` | 1.0.0 | |
388
+ | `retrospective-standards` | 1.0.0 | Retrospectives are structured team reflections that identify what worked well, w |
389
+ | `retry-standards` | - | |
307
390
  | `reverse-engineering-standards` | 1.0.0 | This standard defines the principles, workflows, and best practices for reverse |
391
+ | `rollback-standards` | - | |
392
+ | `runbook-standards` | 1.0.0 | |
393
+ | `sast-advanced` | 1.0.0 | This standard defines Advanced Static Application Security Testing (SAST) practi |
394
+ | `secure-op` | - | |
395
+ | `security-decision` | - | |
308
396
  | `security-standards` | 1.1.0 | This standard defines comprehensive security guidelines for software development |
309
- | `spec-driven-development` | 2.1.0 | |
397
+ | `security-testing` | 1.0.0 | This document defines the security testing methodology for software projects. It |
398
+ | `server-ops-security` | - | |
399
+ | `skill-standard-alignment-check` | - | |
400
+ | `slo-standards` | 1.0.0 | |
401
+ | `smoke-test` | - | |
402
+ | `spec-driven-development` | 2.2.0 | |
403
+ | `standard-admission-criteria` | - | |
404
+ | `standard-lifecycle-management` | - | |
310
405
  | `structured-task-definition` | 1.0.0 | |
406
+ | `supply-chain-attestation` | - | |
407
+ | `supply-chain-security-standards` | 1.0.0 | |
311
408
  | `systematic-debugging` | 1.0.0 | Define a structured, four-phase debugging workflow that prevents the common anti |
409
+ | `tech-debt-standards` | 1.0.0 | |
312
410
  | `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
411
+ | `test-data-standards` | 1.0.0 | |
313
412
  | `test-driven-development` | 1.2.0 | |
314
- | `test-governance` | - | |
315
- | `testing-standards` | 3.0.0 | This standard defines actionable testing rules and conventions for AI agents and |
413
+ | `test-governance` | 1.1.0 | |
414
+ | `testing-standards` | 3.2.0 | This standard defines actionable testing rules and conventions for AI agents and |
415
+ | `timeout-standards` | - | |
416
+ | `token-budget` | - | |
417
+ | `translation-lifecycle-standards` | 1.0.0 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
316
418
  | `verification-evidence` | 1.0.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
317
419
  | `versioning` | 1.2.0 | This standard defines how to version software releases using Semantic Versioning |
318
420
  | `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
@@ -326,19 +428,29 @@ status: current
326
428
  | Script | 說明 |
327
429
  |--------|-------------|
328
430
  | `add-industry-standards-metadata.mjs` | Add industry standards metadata to core/ |
431
+ | `aggregate-effectiveness.mjs` | Aggregate Standards Effectiveness Reports |
432
+ | `analyze-hook-stats.mjs` | Hook Statistics Analyzer (SPEC-SELFDIAG-001 REQ-7, AC-11) |
433
+ | `bump-version.mjs` | Build a platform-aware shell command for a .sh script. |
434
+ | `bump-version.sh` | DEPRECATED: Use 'node scripts/bump-version.mjs <version>' instead (cross-platform). |
329
435
  | `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
330
436
  | `check-ai-agent-sync.sh` | AI Agent Sync Checker |
437
+ | `check-ai-behavior-sync.sh` | DEPRECATED: Use 'npx tsx scripts/check-ai-behavior-sync.ts' instead (cross-platform). |
331
438
  | `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
332
439
  | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
333
440
  | `check-commands-sync.ps1` | Check Commands Sync |
334
441
  | `check-commands-sync.sh` | Commands Sync Checker |
335
- | `check-commit-spec-reference.sh` | Commit-msg Spec Reference Suggestion WARNING ONLY (non-blocking) |
442
+ | `check-commit-spec-reference.sh` | DEPRECATED: Use 'npx tsx scripts/check-commit-spec-reference.ts' instead (cross-platform). |
336
443
  | `check-docs-integrity.ps1` | Check Docs Integrity |
337
444
  | `check-docs-integrity.sh` | Documentation Integrity Checker |
338
445
  | `check-docs-sync.ps1` | Check Docs Sync |
339
446
  | `check-docs-sync.sh` | Documentation Sync Checker |
447
+ | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
448
+ | `check-flow-gate-report.sh` | DEPRECATED: Use 'npx tsx scripts/check-flow-gate-report.ts' instead (cross-platform). |
449
+ | `check-integration-commands-sync.sh` | DEPRECATED: Use 'npx tsx scripts/check-integration-commands-sync.ts' instead (cross-platform). |
340
450
  | `check-orphan-specs.ps1` | Check Orphan Specs |
341
451
  | `check-orphan-specs.sh` | Orphan Spec Detection Script |
452
+ | `check-registry-completeness.sh` | DEPRECATED: Use 'npx tsx scripts/check-registry-completeness.ts' instead (cross-platform). |
453
+ | `check-release-readiness-signoff.sh` | DEPRECATED: Use 'npx tsx scripts/check-release-readiness-signoff.ts' instead (cross-platform). |
342
454
  | `check-scope-sync.ps1` | Check Scope Sync |
343
455
  | `check-scope-sync.sh` | Scope Consistency Check Script |
344
456
  | `check-skill-next-steps-sync.ps1` | Check Skill Next Steps Sync |
@@ -355,11 +467,15 @@ status: current
355
467
  | `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
356
468
  | `check-version-sync.ps1` | Check Version Sync |
357
469
  | `check-version-sync.sh` | Version Sync Checker |
358
- | `check-workflow-compliance.sh` | Workflow Compliance Check WARNING ONLY (non-blocking) |
470
+ | `check-workflow-compliance.sh` | DEPRECATED: Use 'npx tsx scripts/check-workflow-compliance.ts' instead (cross-platform). |
359
471
  | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
360
472
  | `fix-manifest-paths.ps1` | Fix Manifest Paths |
361
473
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
362
474
  | `generate-docs.mjs` | Generate Docs |
475
+ | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
476
+ | `install-hooks.mjs` | Install Hooks |
477
+ | `install-hooks.sh` | DEPRECATED: Use 'node scripts/install-hooks.mjs' instead (cross-platform). |
478
+ | `pre-commit.mjs` | Build a platform-aware shell command for a .sh script. |
363
479
  | `pre-release-check.ps1` | Pre Release Check |
364
480
  | `pre-release-check.sh` | Pre-release Check Script |
365
481
  | `pre-release.ps1` | Pre-Release Preparation Script for Universal Development Standards |
@@ -152,3 +152,46 @@ docs/adr/
152
152
 
153
153
  - 核心規範:[adr-standards.md](../../../../core/adr-standards.md)
154
154
  - 詳細指南:[guide.md](./guide.md)
155
+
156
+
157
+ ## Next Steps Guidance | 下一步引導
158
+
159
+ After `/adr` completes, the AI assistant should suggest:
160
+
161
+ > **ADR created. Suggested next steps:**
162
+ > - Execute `/sdd` to create a spec if the decision requires implementation
163
+ > - Execute `/commit` to commit the ADR file
164
+ > - Update related SPECs to reference this ADR
165
+ > - Share with team for review if status is `Proposed`
166
+
167
+ > **ADR 已建立。建議下一步:**
168
+ > - 執行 `/sdd` 建立規格(若決策需要實作)
169
+ > - 執行 `/commit` 提交 ADR 檔案
170
+ > - 更新相關規格以引用此 ADR
171
+ > - 若狀態為 `Proposed`,分享給團隊審查
172
+
173
+ ## AI Agent Behavior | AI 代理行為
174
+
175
+ When the user invokes `/adr`, the AI assistant MUST:
176
+
177
+ 1. **Check existing ADRs** — Search `docs/adr/` to determine next ADR number
178
+ 2. **Guide interactively** — Ask about context, drivers, and options step by step
179
+ 3. **Generate the file** — Write ADR to `docs/adr/ADR-NNN-title.md`
180
+ 4. **Suggest links** — Identify related SPECs or ADRs to cross-reference
181
+ 5. **Offer next steps** — Show the Next Steps Guidance above
182
+
183
+ When the user invokes `/adr list`:
184
+ 1. Scan `docs/adr/` directory
185
+ 2. Parse status from each ADR file
186
+ 3. Display as a table: Number, Title, Status, Date
187
+
188
+ When the user invokes `/adr supersede [ADR-NNN]`:
189
+ 1. Read the existing ADR
190
+ 2. Guide creation of a new ADR
191
+ 3. Update old ADR status to `Superseded by ADR-NNN`
192
+ 4. Add `Supersedes ADR-NNN` to new ADR
193
+
194
+ ## Reference | 參考
195
+
196
+ - Core Standard: [adr-standards.md](../../core/adr-standards.md)
197
+ - Detailed Guide: [guide.md](./guide.md)
@@ -174,3 +174,38 @@ This project uses **English** certainty tags.
174
174
  此技能依據 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
175
175
 
176
176
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
177
+
178
+
179
+ ## Next Steps Guidance | 下一步引導
180
+
181
+ After `/ai-collaboration` completes, the AI assistant should suggest:
182
+
183
+ > **AI 協作行為規範已掌握。建議下一步 / AI collaboration behavior standards understood. Suggested next steps:**
184
+ > - 執行 `/ai-instructions` 建立或更新 CLAUDE.md 等 AI 指令檔案 ⭐ **Recommended / 推薦** — 將協作標準寫入專案配置 / Write collaboration standards into project configuration
185
+ > - 執行 `/ai-friendly-architecture` 設計 AI 友善架構 — 從長期架構層面優化 AI 協作 / Optimize AI collaboration at the architecture level
186
+ > - 執行 `/review` 運用確定性標籤進行程式碼審查 — 實踐基於證據的分析 / Practice evidence-based analysis
187
+
188
+ ---
189
+
190
+ ## Related Standards
191
+
192
+ - [Anti-Hallucination Standards](../../core/anti-hallucination.md)
193
+ - [Code Review Checklist](../../core/code-review-checklist.md)
194
+ - [Testing Standards](../../core/testing-standards.md)
195
+
196
+ ---
197
+
198
+ ## Version History
199
+
200
+ | Version | Date | Changes |
201
+ |---------|------|---------|
202
+ | 1.1.0 | 2026-01-25 | Added: Unified Tag System with Certainty and Derivation tag categories |
203
+ | 1.0.0 | 2025-12-24 | Added: Standard sections (Purpose, Related Standards, Version History, License) |
204
+
205
+ ---
206
+
207
+ ## License
208
+
209
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
210
+
211
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -217,3 +217,38 @@ documentation:
217
217
  本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
218
218
 
219
219
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
220
+
221
+
222
+ ## Next Steps Guidance | 下一步引導
223
+
224
+ After `/ai-friendly-architecture` completes, the AI assistant should suggest:
225
+
226
+ > **AI 友善架構指南已掌握。建議下一步 / AI-friendly architecture guide understood. Suggested next steps:**
227
+ > - 執行 `/sdd` 將 AI 友善架構設計納入正式規格 ⭐ **Recommended / 推薦** — 確保架構決策有規格追蹤 / Ensure architecture decisions are tracked in specs
228
+ > - 建立 `.ai-context.yaml` 和 `QUICK-REF.md` — 立即實作 AI 友善結構 / Implement AI-friendly structure immediately
229
+ > - 執行 `/ai-instructions` 更新 CLAUDE.md 以反映架構配置 — 讓 AI 指令檔案與架構保持同步 / Keep AI instruction files in sync with architecture
230
+
231
+ ---
232
+
233
+ ## Related Standards
234
+
235
+ - [AI-Friendly Architecture](../../core/ai-friendly-architecture.md) - Core architecture standard
236
+ - [Project Structure](../../core/project-structure.md) - Directory organization
237
+ - [Documentation Structure](../../core/documentation-structure.md) - Documentation layering
238
+ - [Anti-Hallucination](../../core/anti-hallucination.md) - AI accuracy standards
239
+
240
+ ---
241
+
242
+ ## Version History
243
+
244
+ | Version | Date | Changes |
245
+ |---------|------|---------|
246
+ | 1.0.0 | 2026-01-25 | Initial release |
247
+
248
+ ---
249
+
250
+ ## License
251
+
252
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
253
+
254
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -314,3 +314,38 @@ project/
314
314
  本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
315
315
 
316
316
  **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
317
+
318
+
319
+ ## Next Steps Guidance
320
+
321
+ After `/ai-instructions` completes, suggest:
322
+
323
+ > - Create or update project's `CLAUDE.md` / `AGENTS.md` ⭐ **Recommended** — Apply standards immediately
324
+ > - Run `/ai-friendly-architecture` to optimize AI collaboration at the architecture level
325
+ > - Run `/ai-collaboration` to review AI behavior guidelines
326
+
327
+ ---
328
+
329
+ ## Related Standards
330
+
331
+ - [AI Instruction File Standards](../../core/ai-instruction-standards.md) - Core standard
332
+ - [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Writing guidelines
333
+ - [Anti-Hallucination Guidelines](../../core/anti-hallucination.md) - AI accuracy rules
334
+ - [AI-Friendly Architecture](../../core/ai-friendly-architecture.md) - Context optimization
335
+
336
+ ---
337
+
338
+ ## Version History
339
+
340
+ | Version | Date | Changes |
341
+ |---------|------|---------|
342
+ | 2.0.0 | 2026-04-28 | Add Gemini CLI, OpenAI Codex CLI; update Cursor (MDC format, deprecated .cursorrules); update OpenCode (AGENTS.md primary); update Copilot (multiple file types); update Windsurf (Workflows); add AGENTS.md cross-tool standard section |
343
+ | 1.0.0 | 2026-01-25 | Initial release |
344
+
345
+ ---
346
+
347
+ ## License
348
+
349
+ This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
350
+
351
+ **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)