universal-dev-standards

[UDS] Analyze AC-to-test traceability and coverage

[UDS] Create, manage, and track Architecture Decision Records (ADR). Use when: architecture decisions, technology choices, design trade-offs, pattern selection. Keywords: ADR, architecture decision, decision record, trade-off, 架構決策, 決策記錄.

Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. Use when: analyzing code, making recommendations, providing options, or when user asks about confidence/certainty. Keywords: certainty, assumption, inference, evidence, source, 確定性, 推測, 假設, 來源, 證據.

Design AI-friendly architecture with explicit patterns, layered documentation, and semantic boundaries. Use when: structuring projects for AI collaboration, optimizing codebase for AI analysis, setting up AI context. Keywords: architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架構, AI 友善, 上下文.

Create and maintain AI instruction files (CLAUDE.md, .cursorrules, etc.) with proper structure. Use when: creating AI instruction files, separating universal vs project-specific rules, configuring AI tools. Keywords: CLAUDE.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt, 指令檔案, AI 設定.

Guide API design following REST, GraphQL, and gRPC best practices. Use when: designing APIs, reviewing endpoints, API versioning decisions. Keywords: API, REST, GraphQL, gRPC, endpoint, versioning, 介面設計.

[UDS] Guide through Acceptance Test-Driven Development workflow

[UDS] UDS Health & Feedback System | UDS 健康檢查與回饋系統

[UDS] Guide through Behavior-Driven Development workflow

[UDS] Structured AI-assisted brainstorming before spec creation

[UDS] Generate and maintain CHANGELOG.md entries

[UDS] Pre-commit quality gates verification

Guide CI/CD pipeline design, configuration, and optimization. Use when: setting up pipelines, optimizing build times, configuring deployment stages. Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署.

[UDS] Perform systematic code review with checklist

[UDS] Generate commit messages following Conventional Commits standard

[UDS] Guide contract testing strategy for APIs and microservices. Use when: API contracts, microservices, consumer-driven testing, provider verification. Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 合約測試, API 合約.

Guide database design, migration, and query optimization. Use when: schema design, migration planning, query optimization, index strategy. Keywords: database, schema, migration, SQL, index, query, 資料庫, 遷移, 查詢.

Guide reliable deployments without CI/CD platforms (GitHub Actions / GitLab CI). Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure. Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無CI/CD, 部署.

[UDS] Guide for mapping software development phases to UDS commands and features

[UDS] Generate usage documentation from project sources

Guide documentation structure, content requirements, and project documentation best practices. Use when: creating README, documentation, docs folder, project setup, technical docs. Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 說明文件, 技術文件.

[UDS] Guide workflow failure recovery with checkpoints, retries, and rollback

[UDS] Generate E2E test skeletons from BDD scenarios

Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. Use when: defining error codes, creating error handling, designing APIs. Keywords: error code, error handling, error format, API errors, 錯誤碼, 錯誤處理.

[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications

Guide Git branching strategies, branch naming, and merge operations. Use when: creating branches, merging, pull requests, Git workflow questions. Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程.

Guide incident response, root cause analysis, and post-mortem documentation. Use when: production incident, outage response, post-mortem writing, RCA. Keywords: incident, outage, post-mortem, RCA, root cause, 事故, 故障, 根因分析.

Implement structured logging with proper log levels and sensitive data handling. Use when: adding logging, debugging, setting up observability. Keywords: logging, log level, structured logging, observability, 日誌, 記錄, 結構化日誌.

[UDS] Manage development methodology workflow

[UDS] Track development metrics, code quality indicators, and project health

[UDS] Guide code migration, framework upgrades, and technology modernization

Guide observability setup, metrics design, and alerting configuration. Use when: new service instrumentation, SLO definition, alert design, maturity assessment. Keywords: observability, metrics, traces, golden signals, alerting, SLO, 可觀測性, 告警.

Guide pull request creation, review automation, and merge strategies. Use when: creating PRs, automating reviews, configuring merge policies. Keywords: pull request, PR, merge, review, GitHub, GitLab, 合併請求, 審查.

[UDS] Identify repeated processes and build Skills with the right development depth

[UDS] Assess project health, architecture, and risks before adding features

Guide for organizing project directories following language-specific best practices. Use when: creating projects, reorganizing structure, adding modules, setting up builds, deciding file placement. Keywords: project, structure, directory, layout, gitignore, scaffold, 專案結構, 目錄, file placement, utils, helpers, shared, where to put, 檔案歸檔.

AI-assisted safety layer for git push operations with quality gates and collaboration guardrails. Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保護分支, 品質閘門.

[UDS] Guide refactoring decisions and strategy selection

[UDS] Guide release process and changelogs

[UDS] Write user stories and requirements following INVEST criteria

[UDS] Guide structured team retrospectives for Sprint and Release cycles. Use when: sprint end, release post-mortem, iteration review, process improvement. Keywords: retrospective, retro, sprint review, lessons learned, action items, 回顧, 檢討, 持續改善.

[UDS] System archeology — reverse engineer code across Logic, Data, and Runtime dimensions

Guide runbook creation, maintenance, and drill exercises. Use when: writing runbooks, planning drills, auditing runbook coverage, post-incident runbook updates. Keywords: runbook, operations, drill, on-call, procedure, 操作手冊, 演練.

Guide security review and vulnerability assessment following OWASP standards. Use when: security audit, vulnerability check, secure coding review, threat modeling. Keywords: security, OWASP, vulnerability, authentication, authorization, 安全, 漏洞, 認證.

Guide automated security scanning, dependency auditing, and secret detection. Use when: dependency audit, CVE scanning, secret detection, license compliance. Keywords: scan, audit, CVE, dependency, secret, SBOM, vulnerability, 掃描, 漏洞.

Guide SLI selection, SLO setting, and Error Budget management. Use when: defining service quality targets, setting up SLO-based alerting, Error Budget policy. Keywords: SLI, SLO, SLA, Error Budget, burn rate, service level, 服務等級.

[UDS] Create or review specification documents for Spec-Driven Development

[UDS] Guide through Test-Driven Development workflow

[UDS] Analyze test coverage and provide recommendations

Testing pyramid and test writing standards for UT/IT/ST/E2E. Supports ISTQB and Industry Pyramid frameworks. Use when: writing tests, discussing test coverage, test strategy, or test naming. Keywords: test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 測試, 單元, 整合, 端對端.