universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.11
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.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +157 -17
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -2
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +159 -48
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +11 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +113 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +236 -27
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +220 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
> **Language**: English | [繁體中文](../locales/zh-TW/core/ai-response-navigation.md) | [简体中文](../locales/zh-CN/core/ai-response-navigation.md)
|
|
4
4
|
|
|
5
|
-
**Version**: 1.
|
|
6
|
-
**Last Updated**: 2026-
|
|
5
|
+
**Version**: 1.4.0
|
|
6
|
+
**Last Updated**: 2026-10-05
|
|
7
7
|
**Applicability**: All projects using AI-assisted development
|
|
8
8
|
**Scope**: universal
|
|
9
9
|
**Industry Standards**: None (Emerging AI tool practice)
|
|
@@ -19,12 +19,15 @@ This standard defines navigation behavior for AI responses: every substantive AI
|
|
|
19
19
|
|
|
20
20
|
**Solution**: A standard "Navigation Footer" appended to every substantive AI response, with contextual templates, recommendation marking, and adaptive option quantities.
|
|
21
21
|
|
|
22
|
-
**Scope note (v1.2.0, extended in 1.3.0)**: Rules 1–6 govern what comes *after* the answer.
|
|
23
|
-
Rules 7–
|
|
24
|
-
across turns (R8), no preamble (R9), plain language as the subject (R10),
|
|
25
|
-
option rather than only the recommended one (R11)
|
|
26
|
-
|
|
27
|
-
|
|
22
|
+
**Scope note (v1.2.0, extended in 1.3.0 and 1.4.0)**: Rules 1–6 govern what comes *after* the answer.
|
|
23
|
+
Rules 7–12 govern the answer itself: lead with the finding (R7), restate state
|
|
24
|
+
across turns (R8), no preamble (R9), plain language as the subject (R10), a trade-off on every
|
|
25
|
+
option rather than only the recommended one (R11), and controlled language (R12). Rules 7–11 are
|
|
26
|
+
**optional**. **Rule 12 is the one exception, and only in part**: its clause that a simplified text
|
|
27
|
+
must keep the writer's hedges is **required**; the rest of R12 is optional. They exist because a
|
|
28
|
+
response can satisfy every one of Rules 1–6 while burying its conclusion, stating it in vocabulary
|
|
29
|
+
only its author holds, listing options the reader still has to compare themselves, or being made
|
|
30
|
+
easy to read by being made more certain than the evidence.
|
|
28
31
|
|
|
29
32
|
---
|
|
30
33
|
|
|
@@ -104,11 +107,14 @@ Tier names are **vendor-neutral**. Each tool or platform maps these tiers to its
|
|
|
104
107
|
|
|
105
108
|
---
|
|
106
109
|
|
|
107
|
-
## The Answer Before the Navigation (Rules 7–
|
|
110
|
+
## The Answer Before the Navigation (Rules 7–12)
|
|
108
111
|
|
|
109
112
|
> **R7–R9 borrowed from**: [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd) (MIT), 3 of its 10 rules.
|
|
110
113
|
> **R10–R11 added in 1.3.0** from a different source — a user telling the author, twice in one session,
|
|
111
114
|
> that a correct and complete answer was unreadable. R7–R9 had already shipped and were being followed.
|
|
115
|
+
> **R12 added in 1.4.0** from a third source: a public suggestion to ask an LLM to write at "about
|
|
116
|
+
> 80% of the way to" ASD-STE100, a controlled-English standard for technical documentation. Only its
|
|
117
|
+
> principles are taken; its English dictionary and tense rules are not (see Rule 12).
|
|
112
118
|
> The other 7 were dropped: 2 are already covered by Rules 1–2 above, and 5 either conflict with
|
|
113
119
|
> this standard (its "no recap / no closers" contradicts Rule 1's Navigation Footer; its
|
|
114
120
|
> "cap lists at 5" would truncate evidence tables and traversal denominators) or duplicate
|
|
@@ -119,10 +125,12 @@ itself — a response could bury its conclusion under a wall of evidence and sti
|
|
|
119
125
|
in this standard by appending a correct Navigation Footer. A reader who cannot find the answer is
|
|
120
126
|
not helped by being told what to do next.
|
|
121
127
|
|
|
122
|
-
**
|
|
128
|
+
**Rules 7–11 are optional**, in the same sense as Rule 6: adopting projects are not required
|
|
123
129
|
to enable them, and existing skills need no retroactive update. A project MAY promote any of them to
|
|
124
|
-
required in its own configuration.
|
|
125
|
-
|
|
130
|
+
required in its own configuration. **Rule 12 has one required clause** (12.1) and an optional rest
|
|
131
|
+
(12.2); the split is argued inside the rule. What is *not* optional anywhere is that every rule has
|
|
132
|
+
a precise trigger — a rule phrased so loosely that it never fires is indistinguishable from not
|
|
133
|
+
having the rule.
|
|
126
134
|
|
|
127
135
|
### Rule 7: Lead With the Finding, Not the Process (Optional)
|
|
128
136
|
|
|
@@ -187,6 +195,11 @@ It governs which of the two is the subject of the sentence.
|
|
|
187
195
|
response can lead with its finding and still state that finding in vocabulary only its author
|
|
188
196
|
holds. Both failures leave the reader unable to act; they are different failures.
|
|
189
197
|
|
|
198
|
+
**Plain wording must not buy its plainness with certainty.** Putting an explanation in the
|
|
199
|
+
reader's words is a rewrite, and a rewrite is exactly where "might" quietly becomes "is". When R10
|
|
200
|
+
is applied to a claim the writer had hedged, [Rule 12](#rule-12-controlled-language-partly-required)
|
|
201
|
+
clause 12.1 (required) governs: the hedge stays.
|
|
202
|
+
|
|
190
203
|
### Rule 11: Every Option Carries Its Own Trade-off (Optional)
|
|
191
204
|
|
|
192
205
|
**Trigger**: a response that asks the reader to choose between two or more courses of action.
|
|
@@ -214,6 +227,107 @@ worth stating, say so explicitly rather than leaving the column empty — an emp
|
|
|
214
227
|
**Composes with Rule 4**: the option count stays bounded (1–5). Trade-offs make each option
|
|
215
228
|
costlier to read, so this rule makes Rule 4's cap matter more, not less.
|
|
216
229
|
|
|
230
|
+
### Rule 12: Controlled Language (Partly Required)
|
|
231
|
+
|
|
232
|
+
**Trigger**: writing, rewriting, shortening, simplifying or translating text for a reader who is
|
|
233
|
+
not its author — typically a non-specialist who has to judge or approve something from it.
|
|
234
|
+
|
|
235
|
+
Controlled languages (writing rules that trade variety for predictability) make text easier to
|
|
236
|
+
read. They have a known way of failing: the easiest sentence to read is a confident one, so
|
|
237
|
+
"simplification" drifts toward certainty. This rule takes the principles of controlled writing and
|
|
238
|
+
puts a hard stop on that drift.
|
|
239
|
+
|
|
240
|
+
#### 12.1 A simplified text keeps its hedges (Required)
|
|
241
|
+
|
|
242
|
+
A hedge is a word that tells the reader how far to trust a claim: *might, could, probably,
|
|
243
|
+
appears to, not yet confirmed* — 可能、推斷、大概、尚未確認. It is information, not padding.
|
|
244
|
+
|
|
245
|
+
When you shorten, simplify, rewrite or translate:
|
|
246
|
+
|
|
247
|
+
- **Do not turn an uncertain claim into a certain one.** If the source says "might", the result
|
|
248
|
+
says "might" (or the equivalent in the language of the result).
|
|
249
|
+
- **Do not drop the hedge to save words.** A shorter sentence is the goal; a more certain one is
|
|
250
|
+
not allowed.
|
|
251
|
+
- **Do not add facts the source did not state** — an invented cause or an invented "confirmed" is
|
|
252
|
+
the same failure in another form.
|
|
253
|
+
- A hedge may go only when the claim has since been verified, and then the verification (what was
|
|
254
|
+
checked, with what result) takes its place. Deleting the hedge alone is not verification.
|
|
255
|
+
|
|
256
|
+
**Why this one is required and the rest are not**: it is the only part whose failure misleads the
|
|
257
|
+
reader about what is true, rather than only making the text harder to read. It also needs no
|
|
258
|
+
calibration — the check is a comparison of the text before and after, which a person or a model
|
|
259
|
+
can do in any language — whereas every threshold below depends on language and audience.
|
|
260
|
+
|
|
261
|
+
#### 12.2 Plain-writing principles (Optional)
|
|
262
|
+
|
|
263
|
+
Apply these when the reader is a non-specialist. They are language-neutral: each is stated in the
|
|
264
|
+
unit the language itself uses, with no word list.
|
|
265
|
+
|
|
266
|
+
| Principle | What it asks for |
|
|
267
|
+
|-----------|------------------|
|
|
268
|
+
| **Short sentences, counted in the language's own unit** | One idea per sentence. As a *starting range*, not a limit: roughly 15–25 words in English, roughly 25–40 characters in Chinese. A sentence far beyond the range is a signal to split it, not a defect to count. Calibrate per language and per reader |
|
|
269
|
+
| **One thing, one name** | Pick one name for each thing and use it for the whole text. Do not vary it for style: a reader who sees a second name assumes a second thing |
|
|
270
|
+
| **A clear subject and the active voice** | Say who does what. The passive is acceptable when the actor is unknown or does not matter |
|
|
271
|
+
| **One step, one action** | A procedure is a numbered list with one action per item, not a paragraph |
|
|
272
|
+
| **Few semicolons** | A semicolon joins two ideas the reader must hold at once. Split into two sentences or a list |
|
|
273
|
+
| **Numbers carry units** | "30 seconds", "3 files", "NT$1,200" — never a bare "30" |
|
|
274
|
+
|
|
275
|
+
**Why optional**: the ranges above are starting points that have not been calibrated against
|
|
276
|
+
reader outcomes, and no checker enforces them. A *required* rule with a threshold nobody can
|
|
277
|
+
verify produces mechanical compliance — sentences split until they stop reading as sentences —
|
|
278
|
+
and an expert reader may be better served by denser text. These principles are guidance a writer
|
|
279
|
+
applies with judgment; 12.1 is the part that does not bend.
|
|
280
|
+
|
|
281
|
+
#### What this rule does not take from ASD-STE100
|
|
282
|
+
|
|
283
|
+
ASD-STE100's **approved dictionary** (one meaning per approved English word, with a closed list
|
|
284
|
+
of allowed words) and its **tense restrictions** depend on the English language. They do not apply
|
|
285
|
+
to Chinese or to other non-English text, and this standard ships **no word list of any kind**.
|
|
286
|
+
Only the principles in 12.2 are taken, restated so that each can be applied in any language.
|
|
287
|
+
|
|
288
|
+
For the same reason, do not use a counter that splits on whitespace or ASCII characters to gauge
|
|
289
|
+
non-English text: it reads a Chinese paragraph as one "word" and passes it however long it is. A
|
|
290
|
+
gauge that is always green on a language measures nothing in that language.
|
|
291
|
+
|
|
292
|
+
#### Example: one passage, three rewrites, and one that is not allowed
|
|
293
|
+
|
|
294
|
+
The example is in Chinese on purpose: the rule is language-neutral, and Chinese is where an
|
|
295
|
+
English-only approach does not carry over. The three valid versions keep the hedges 可能 (might),
|
|
296
|
+
推斷 (inferred) and 尚未 (not yet) and add no fact the original lacks.
|
|
297
|
+
|
|
298
|
+
**Original**
|
|
299
|
+
|
|
300
|
+
```text
|
|
301
|
+
經過檢查,登入頁面在高流量時段回應變慢,這個問題可能是資料庫連線池被耗盡所造成的,我們推斷是因為上週的改版新增了一個會長時間佔用連線的查詢;目前尚未在測試環境重現,所以修復後的效果還需要被確認,建議在確認之前先不要對外宣布已經解決。
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
**About 80%** — shorter sentences, still reads as prose
|
|
305
|
+
|
|
306
|
+
```text
|
|
307
|
+
登入頁面在高流量時段回應變慢。原因可能是資料庫連線池被耗盡。我們推斷,上週改版新增了一個查詢,它會長時間佔用連線。這一點尚未在測試環境重現,修復後有沒有效,也還沒確認。確認之前,建議先不要對外宣布已經解決。
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
**Strict** — one idea per line, labelled, hedges kept
|
|
311
|
+
|
|
312
|
+
```text
|
|
313
|
+
登入頁面在高流量時段回應變慢。
|
|
314
|
+
1. 原因:可能是資料庫連線池被耗盡。
|
|
315
|
+
2. 推斷:上週改版新增了一個查詢,這個查詢可能長時間佔用連線。
|
|
316
|
+
3. 狀態:尚未在測試環境重現。
|
|
317
|
+
4. 修復效果:尚未確認。
|
|
318
|
+
5. 建議:確認之前,不要對外宣布已解決。
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
**Not a valid rewrite** — shortest of all, and wrong
|
|
322
|
+
|
|
323
|
+
```text
|
|
324
|
+
登入頁面變慢,原因是資料庫連線池被耗盡,已確認由上週改版造成。
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
The last version is the shortest and the easiest to read, and it fails 12.1 twice: "可能" became
|
|
328
|
+
a flat statement of cause, and "尚未重現" became "已確認" (confirmed), a fact the original never
|
|
329
|
+
stated. A reader who approves a fix on the strength of it has been given something untrue.
|
|
330
|
+
|
|
217
331
|
---
|
|
218
332
|
|
|
219
333
|
## Contextual Templates
|
|
@@ -408,6 +522,7 @@ Each tool's integration layer is responsible for rendering the Navigation Footer
|
|
|
408
522
|
| R9 | *(Optional)* No preamble. Closers still required — see R1 |
|
|
409
523
|
| R10 | *(Optional)* Plain language is the subject; identifiers support it, after the claim |
|
|
410
524
|
| R11 | *(Optional)* Every option states what it buys and costs — not only the recommended one |
|
|
525
|
+
| R12 | **12.1 *(Required)***: when simplifying, shortening or translating, keep the hedges — never turn "might" into "is". 12.2 *(Optional)*: short sentences in the language's own unit, one name per thing, active voice, one action per step, few semicolons, numbers with units. No English dictionary — it does not carry to other languages |
|
|
411
526
|
|
|
412
527
|
| Exempt | Not Exempt |
|
|
413
528
|
|--------|------------|
|
|
@@ -431,6 +546,7 @@ Each tool's integration layer is responsible for rendering the Navigation Footer
|
|
|
431
546
|
|
|
432
547
|
| Version | Date | Changes |
|
|
433
548
|
|---------|------|---------|
|
|
549
|
+
| 1.4.0 | 2026-10-05 | Add R12, controlled language, language-neutral. One clause is required (12.1: a simplified text keeps the writer's hedges — "might" does not become "is" and no unstated fact is added); the rest (12.2: sentence length in the language's own unit, one name per thing, active voice, one action per step, few semicolons, numbers with units) is optional, with the reason recorded. Takes the principles of ASD-STE100 and none of its English dictionary or tense rules, and says so in the standard. Ships a Chinese before/after example in three strictness levels plus one rewrite that is shorter and wrong. R10 now points to R12, because putting a claim in plain words is a rewrite and a rewrite is where hedges get lost |
|
|
434
550
|
| 1.3.0 | 2026-08-17 | Add optional R10–R11. R10 governs register: plain language is the subject of the sentence and identifiers support it — distinct from R7, which orders finding before evidence, because a response can lead with its finding and still state it in vocabulary only its author holds. R11 extends Rule 2 from the recommended option to all of them: a list where only the recommendation is argued hands the comparison back to the reader, and an option shown without its cost reads as having none |
|
|
435
551
|
| 1.2.0 | 2026-08-17 | Add optional R7–R9 governing the answer itself (lead with the finding, restate state, no preamble). Borrowed from `ayghri/i-have-adhd` (MIT), 3 of its 10 rules; the other 7 were dropped as duplicated by R1–R2, in conflict with R1, or covered by estimation-standards. Rules 1–6 could all be satisfied by a response that buries its conclusion — R7–R9 close that |
|
|
436
552
|
| 1.1.0 | 2026-06-10 | Add R6 optional model tier annotation (`〔model: Fast\|Standard\|Capable〕`); vendor-neutral; no forced changes to existing skills |
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
> **Language**: English | [繁體中文](../locales/zh-TW/core/code-review-checklist.md)
|
|
4
4
|
|
|
5
|
-
**Version**: 1.
|
|
6
|
-
**Last Updated**: 2026-08
|
|
5
|
+
**Version**: 1.6.0
|
|
6
|
+
**Last Updated**: 2026-10-08
|
|
7
7
|
**Applicability**: All software projects with code review processes
|
|
8
8
|
**Scope**: universal
|
|
9
9
|
**Industry Standards**: SWEBOK v4.0 Chapter 10
|
|
@@ -141,6 +141,7 @@ This standard provides a comprehensive checklist for reviewing code changes, ens
|
|
|
141
141
|
- Test names describe scenarios
|
|
142
142
|
- Assertions are clear
|
|
143
143
|
- No flaky tests
|
|
144
|
+
- Expected values are independent of the code under test: a literal, a hand-computed example or the spec — not the same call repeated, not the same arithmetic typed again (see [Forbidden: Tautology Assertions](full-coverage-testing.md))
|
|
144
145
|
|
|
145
146
|
- [ ] **Test coverage maintained**
|
|
146
147
|
- Coverage not decreased
|
|
@@ -247,6 +248,19 @@ This standard provides a comprehensive checklist for reviewing code changes, ens
|
|
|
247
248
|
|
|
248
249
|
---
|
|
249
250
|
|
|
251
|
+
### 11. Merge Danger (Reversibility)
|
|
252
|
+
|
|
253
|
+
- [ ] **The change states its door and its blast radius**
|
|
254
|
+
- **Two-way door**: after merging, it can be taken back easily
|
|
255
|
+
- **One-way door**: it cannot be undone, or only with difficulty — a data migration, a deletion, a changed default behavior, a changed exit code, a renamed public interface
|
|
256
|
+
- **Blast radius**: one word for how far it reaches (for example `docs`, `cli`, `adopters`)
|
|
257
|
+
|
|
258
|
+
- [ ] **A one-way door is known to the decision-maker before the merge**
|
|
259
|
+
- Whoever decides to merge has been told, in the PR description or the hand-off report, that this change cannot be easily undone
|
|
260
|
+
- If the field is missing, ask for it; do not infer the door from the diff alone
|
|
261
|
+
|
|
262
|
+
---
|
|
263
|
+
|
|
250
264
|
## Review Comment Types
|
|
251
265
|
|
|
252
266
|
Use these prefixes to clarify comment intent:
|
|
@@ -320,6 +334,7 @@ For teams preferring plain text labels without emojis:
|
|
|
320
334
|
1. Read PR description and linked issues
|
|
321
335
|
2. Understand WHY the change is needed
|
|
322
336
|
3. Review design/spec documents if linked
|
|
337
|
+
4. Read the Merge Danger field (door and blast radius); for a one-way door, confirm the decision-maker knows before merging
|
|
323
338
|
|
|
324
339
|
#### Step 2: High-Level Review
|
|
325
340
|
|
|
@@ -357,6 +372,7 @@ For teams preferring plain text labels without emojis:
|
|
|
357
372
|
2. **Run tests locally**
|
|
358
373
|
3. **Check CI status**
|
|
359
374
|
4. **Write clear PR description**
|
|
375
|
+
5. **State the Merge Danger** — door (two-way or one-way) and blast radius, in one word
|
|
360
376
|
|
|
361
377
|
#### During Review
|
|
362
378
|
|
|
@@ -650,6 +666,7 @@ All PRs must pass:
|
|
|
650
666
|
│ ✓ Errors - Properly handled? │
|
|
651
667
|
│ ✓ Docs - Updated? │
|
|
652
668
|
│ ✓ Dependencies - Necessary? │
|
|
669
|
+
│ ✓ Merge danger - One-way door told? │
|
|
653
670
|
└─────────────────────────────────────────┘
|
|
654
671
|
|
|
655
672
|
Comment Prefixes:
|
|
@@ -666,6 +683,7 @@ Comment Prefixes:
|
|
|
666
683
|
|
|
667
684
|
| Version | Date | Changes |
|
|
668
685
|
|---------|------|---------|
|
|
686
|
+
| 1.6.0 | 2026-10-08 | Added: Merge Danger (door and blast radius) as checklist item 11 and in the reviewer/author steps — a one-way door must be known to the decision-maker before merge; added to "Tests are good quality" that expected values are independent of the code under test (XSPEC-470 R1, R2) |
|
|
669
687
|
| 1.5.0 | 2026-08-24 | Added: pointer to `deferred-item-exit` for non-blocking comments accepted without a change (XSPEC-391 R5) |
|
|
670
688
|
| 1.4.0 | 2026-06-18 | Added: source + configurability note for PR-size/response-time thresholds (SmartBear/Cisco study, Google practices) + bulk-change exception (XSPEC-292 T8) |
|
|
671
689
|
| 1.3.0 | 2026-01-12 | Added: Comprehensive Refactoring PRs section with pre-review checklist, review focus areas, large refactoring guidelines, red flags, and best practices |
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
> **Language**: English | [繁體中文](../locales/zh-TW/core/commit-message-guide.md)
|
|
4
4
|
|
|
5
|
-
**Version**: 1.
|
|
6
|
-
**Last Updated**:
|
|
5
|
+
**Version**: 1.4.0
|
|
6
|
+
**Last Updated**: 2026-10-12
|
|
7
7
|
**Applicability**: All projects using Git version control
|
|
8
8
|
**Scope**: universal
|
|
9
9
|
**Industry Standards**: Conventional Commits 1.0.0
|
|
@@ -64,22 +64,24 @@ Use English types for international teams and maximum tool compatibility.
|
|
|
64
64
|
|
|
65
65
|
### Option B: Traditional Chinese (Taiwanese Teams)
|
|
66
66
|
|
|
67
|
-
Use Traditional Chinese
|
|
68
|
-
|
|
69
|
-
| Type
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
73
|
-
|
|
|
74
|
-
|
|
|
75
|
-
|
|
|
76
|
-
|
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
67
|
+
Use the **English types of Option A** with a Traditional Chinese subject and body, for local teams preferring native language commits. The type stays English because tools read it (commitlint `type-enum`, changelog generators, `uds simulate`); only the subject and body are Chinese. A Chinese type such as `新增` is **not** allowed.
|
|
68
|
+
|
|
69
|
+
| Type | When to Use | Example |
|
|
70
|
+
| ---------- | --------------------- | --------------------------------- |
|
|
71
|
+
| `feat` | New feature | `feat(auth): 加入 OAuth2 登入` |
|
|
72
|
+
| `fix` | Bug fix | `fix(api): 處理空值回應` |
|
|
73
|
+
| `refactor` | Refactoring | `refactor(core): 簡化驗證邏輯` |
|
|
74
|
+
| `docs` | Documentation only | `docs(readme): 更新安裝指南` |
|
|
75
|
+
| `style` | Formatting only | `style(lint): 修正縮排` |
|
|
76
|
+
| `test` | Adding/updating tests | `test(auth): 新增登入單元測試` |
|
|
77
|
+
| `perf` | Performance | `perf(query): 最佳化資料庫查詢` |
|
|
78
|
+
| `build` | Build system | `build(deps): 升級 lodash` |
|
|
79
|
+
| `ci` | CI/CD changes | `ci(github): 新增覆蓋率工作流程` |
|
|
80
|
+
| `chore` | Maintenance | `chore(deps): 更新開發相依套件` |
|
|
81
|
+
| `revert` | Revert commit | `revert: feat(auth): 加入 OAuth2 登入` |
|
|
82
|
+
| `security` | Security fix | `security(auth): 修正 XSS 漏洞` |
|
|
83
|
+
|
|
84
|
+
> **Changed in 1.4.0** (XSPEC-475): earlier versions of this option listed Chinese types (`新增`, `修正`, ...). They are no longer allowed; a project that used them migrates by replacing the type with its English equivalent (`新增` → `feat`, `修正` → `fix`, `重構` → `refactor`, `文件` → `docs`, `樣式` → `style`, `測試` → `test`, `效能` → `perf`, `建置` → `build`, `整合` → `ci`, `維護` → `chore`, `回退` → `revert`, `安全` → `security`).
|
|
83
85
|
|
|
84
86
|
### Option C: Bilingual Mode (Recommended)
|
|
85
87
|
|
|
@@ -151,7 +153,7 @@ Use this guide to choose the appropriate commit message language for your projec
|
|
|
151
153
|
This project uses **English** commit types (feat, fix, refactor, etc.)
|
|
152
154
|
|
|
153
155
|
<!-- Option B: Traditional Chinese -->
|
|
154
|
-
This project uses **
|
|
156
|
+
This project uses **English** commit types (feat, fix, refactor, etc.) with **Traditional Chinese** subjects and bodies
|
|
155
157
|
|
|
156
158
|
<!-- Option C: Bilingual Mode -->
|
|
157
159
|
This project uses **Bilingual Mode** with English types/scopes and bilingual subject/body.
|
|
@@ -936,6 +938,7 @@ Closes #123
|
|
|
936
938
|
|
|
937
939
|
| Version | Date | Changes |
|
|
938
940
|
| ------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
941
|
+
| 1.4.0 | 2026-10-12 | Changed: Option B (Traditional Chinese) uses English types with Traditional Chinese subject and body; Chinese types (新增, 修正, ...) are no longer allowed (XSPEC-475 OQ1). Migration table added |
|
|
939
942
|
| 1.3.0 | 2026-03-16 | Added: Spec reference footer convention (Refs: SPEC-XXX) |
|
|
940
943
|
| 1.2.3 | 2025-12-24 | Added: Related Standards section |
|
|
941
944
|
| 1.2.2 | 2025-12-16 | Added: Language selection guide with decision matrix and quick selection tips |
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
> **Language**: English | [繁體中文](../locales/zh-TW/core/developer-memory.md)
|
|
4
4
|
|
|
5
|
-
**Version**: 1.2.
|
|
6
|
-
**Last Updated**: 2026-
|
|
5
|
+
**Version**: 1.2.1
|
|
6
|
+
**Last Updated**: 2026-10-07
|
|
7
7
|
**Applicability**: All software projects using AI assistants
|
|
8
8
|
**Scope**: universal
|
|
9
9
|
**Owning Spec**: XSPEC-291 (developer-memory has no dedicated feature XSPEC; XSPEC-291 owns it)
|
|
@@ -641,10 +641,20 @@ A tool without a session-start hook still satisfies this standard through either
|
|
|
641
641
|
|
|
642
642
|
---
|
|
643
643
|
|
|
644
|
+
## Boundary: What This Standard Does Not Hold
|
|
645
|
+
|
|
646
|
+
Two kinds of information are outside this standard, and writing them here is a mistake:
|
|
647
|
+
|
|
648
|
+
- **Personal, cross-project, identifiable facts** (who owns what, how to reach a particular environment). De-identification (see the schema above) would strip exactly these, so they cannot live in a memory entry. They belong in the memory of the user's own AI tool, which is bound to that user and that machine and is not shared.
|
|
649
|
+
- **Coordination between projects** (which piece of work is waiting on which other). That is open work, not memory: see [Open Work Tracking](open-work-tracking.md) (OWT-027–OWT-029).
|
|
650
|
+
|
|
651
|
+
---
|
|
652
|
+
|
|
644
653
|
## Version History
|
|
645
654
|
|
|
646
655
|
| Version | Date | Changes |
|
|
647
656
|
|---------|------|---------|
|
|
657
|
+
| 1.2.1 | 2026-10-07 | Added: a Boundary section — personal, cross-project, identifiable facts and coordination between projects are not memory entries (XSPEC-460 R5; patch, no behavioral change) |
|
|
648
658
|
| 1.2.0 | 2026-09-25 | Added: `code-reference` staleness check to Review (§3.4) — a memory citing a moved/missing file path or symbol is flagged before surfacing; reuses Knowledge Graph Memory's degraded/engine dual mode instead of inventing a third; `unresolvable` may not be read as present or missing; scope is file paths and symbol names only (`file:line` explicitly out of scope, DEC-115 OQ-1); §11 adds a non-normative Claude Code adoption example (DEC-115-L1) |
|
|
649
659
|
| 1.1.1 | 2026-06-18 | Added: `Owning Spec` header pointing to XSPEC-291 (patch, no behavioral change; XSPEC-291 §11 disposition) |
|
|
650
660
|
| 1.1.0 | 2026-06-18 | Added: rationale column + configurable note to Retirement Suggestions thresholds (XSPEC-292 T8) |
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Full Coverage Testing Standards
|
|
2
2
|
|
|
3
3
|
> **AI-optimized version**: `ai/standards/full-coverage-testing.ai.yaml`
|
|
4
|
-
> **XSPEC**: XSPEC-178
|
|
4
|
+
> **XSPEC**: XSPEC-178, XSPEC-444 (R2, R5 — pre-commit warnings and shipped gate scripts), XSPEC-470 (R1 — tautology means "expected value not independent")
|
|
5
5
|
> **Replaces**: Pyramid threshold model (UT≥80%, IT≥70%, E2E happy-path-only)
|
|
6
6
|
|
|
7
7
|
## Overview
|
|
@@ -50,18 +50,58 @@ Coverage improved: 91.3% → 92.0%. New baseline set.
|
|
|
50
50
|
|
|
51
51
|
### Forbidden: Tautology Assertions
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
An assertion that cannot disagree with the implementation provides false coverage. There are two kinds:
|
|
54
|
+
|
|
55
|
+
1. **Always true** — it passes whatever the code does: `expect(true).toBe(true)`, `assert 200 == 200`.
|
|
56
|
+
2. **Not independent** — the expected value is produced by the code under test, or by the same logic written a second time inside the test. It passes when the implementation is right, and it passes just as well when the implementation and the copy are wrong in the same way.
|
|
57
|
+
|
|
58
|
+
The second kind is defined with the vocabulary of [`verification-oracle`](verification-oracle.md): an assertion's **oracle** is the source that says what the right answer is, and a tautology is an assertion whose oracle *is the implementation itself*. This standard does not define "independent source of truth" a second time; it uses that standard's: a registered ground-truth case, a known literal, a hand-computed example, or the specification (see its *Oracle-ability Spectrum*).
|
|
54
59
|
|
|
55
60
|
```typescript
|
|
56
61
|
// ❌ FORBIDDEN — always passes, tests nothing
|
|
57
62
|
expect(true).toBe(true)
|
|
58
63
|
expect(result).toBeDefined() // without specific value
|
|
59
64
|
|
|
60
|
-
//
|
|
65
|
+
// ❌ FORBIDDEN — the oracle is the implementation
|
|
66
|
+
expect(countInstalled(manifest)).toBe(countInstalled(manifest)) // the same call on both sides
|
|
67
|
+
expect(countInstalled(manifest)).toBe(manifest.standards.filter(s => s.installed).length) // the same logic, typed again
|
|
68
|
+
// ^ a reviewer's call: the scanner catches only the subset listed under "What the shipped scanner decides" below, and this one is not in it
|
|
69
|
+
|
|
70
|
+
// ✅ REQUIRED — a value that was decided before the code ran
|
|
61
71
|
expect(result).toBe(90)
|
|
62
72
|
expect(result).toEqual({ discount: 10, total: 90 })
|
|
73
|
+
expect(countInstalled({ standards: [{ id: 'a', installed: true }, { id: 'b', installed: false }] })).toBe(1)
|
|
63
74
|
```
|
|
64
75
|
|
|
76
|
+
Not every comparison of two computed values is a tautology. These are fine, and are **not** reported:
|
|
77
|
+
|
|
78
|
+
| Looks similar | Why it is a real test |
|
|
79
|
+
|---------------|-----------------------|
|
|
80
|
+
| `expect(snapshot(dir)).toEqual(before)` after an action | Asks "did anything change?" — the two values are taken at different moments |
|
|
81
|
+
| `expect(parse(a)).toEqual(parseWithOldEngine(a))` | A second, independently written implementation is the oracle |
|
|
82
|
+
| `expect(hash(x)).toBe(hash(x))` in a test named for determinism | Comparing two calls is the point of the test |
|
|
83
|
+
| `expect(report.total).toBe(rows.reduce(...))` where `report` comes from a different data path than `rows` | A reconciliation between two sources |
|
|
84
|
+
|
|
85
|
+
#### What the shipped scanner decides, and what stays a reviewer's question
|
|
86
|
+
|
|
87
|
+
`scripts/check-anti-fake-tests.mjs` (see "The two scanners" below) names the two shapes that can be decided from the text alone. It reads **JavaScript/TypeScript** (`toBe`, `toEqual`, `toStrictEqual`, chai `to.equal`/`to.eql`, node `assert.equal`/`strictEqual`/`deepEqual`/`deepStrictEqual`):
|
|
88
|
+
|
|
89
|
+
| Shape | Example | Reported when |
|
|
90
|
+
|-------|---------|---------------|
|
|
91
|
+
| **same call** | `expect(total(items)).toBe(total(items))` | both sides are the same call with the same arguments (and no other call or `new` inside the call), written in one statement, and the test is not named for comparing two calls (determinism, idempotence, caching, identity) |
|
|
92
|
+
| **recomputed** | `expect(total(items)).toBe(items.reduce((s, i) => s + i.price, 0))` | the call under test takes an input, and the expected value runs that same input (named as the argument itself, e.g. `items.reduce`, not a field of it) through `reduce`, `map`, `flatMap` or `filter` with a callback that uses nothing but its own parameters (plus pure built-ins such as `Math`, `Number`, `String`), holds no literal and is not a mere copy (`(x) => x`, `(x) => ({ ...x })`); the call under test is one call with no other call or `new` inside it and nothing after it such as `.length`. Only the text of the assertion is read: a name set on an earlier line is never looked through |
|
|
93
|
+
|
|
94
|
+
These look similar and are **left alone on purpose**, because the text cannot tell them from a sound test: `expect(priceOf(ids)).toEqual(ids.map(id => KNOWN_PRICES[id]))` (the expected value is read from a fixed table, an independent source); `expect(activeOf(users)).toEqual(users.filter(u => u.id === 2))` (the literal is knowledge the test author supplied); `expect(render(now())).toBe(render(now()))` (two calls to `now()` are two values, so the two sides are not known to be equal); `expect(parse(serialize(rows))).toEqual(rows.map(r => r))` (a round trip: there is a call inside the call under test); `expect(clone(input)).toEqual(input.map(x => x))` (a callback that only hands its parameter back, or a shallow copy of it such as `u => ({ ...u })`, or a destructured parameter put straight back in the same shape such as `([k, v]) => [k, v]`, is a copy and not logic; a `filter(x => x)`, which selects by truthiness, is logic, but it is left alone with them because the text cannot tell it from a copy); `expect(sortUsers(users).length).toBe(users.filter(u => u.name).length)` (the value under test is a property of the result, and which side is right cannot be read from the text). `const before = items.map(i => i.price); freezeCart(items); expect(pricesOf(items)).toEqual(before)` (a name set on an earlier line holds a value from an earlier moment, and what happened in between is what the test asks about; the same-call shape is read the same way). The rule is: when in doubt, miss it rather than accuse it.
|
|
95
|
+
|
|
96
|
+
**Two costs that are accepted, not hidden.**
|
|
97
|
+
|
|
98
|
+
1. **Differential tests are named.** A test that uses a reference implementation as its oracle, `expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`, looks exactly like the textbook example, so the scanner names it. Such a test is legitimate (see the table above, "a second, independently written implementation"); the ways to settle it are: put one assertion against a hand-computed literal in the same test (a test is reported only when none of its assertions is a real one), or list the file under `ignore` in `.standards/test-policy.json` (this removes the whole file from every check of this scanner, and `ignore` takes no reason, so say why in a comment). A test name such as "matches the reference implementation" does **not** exempt it, and the `exempt` list does not apply to this scanner (it belongs to the code-without-a-test check).
|
|
99
|
+
2. **The rule is easy to get around.** Wrapping the **value under test** in `Number(...)`, adding `.valueOf()` or `[0]` to it, or passing `items.slice()` instead of `items` is enough to stop the scanner from seeing it. (Doing the same to the **expected** value changes nothing: that is still named.) It is a prompt for the reviewer, not a gate that holds against someone who means to avoid it, and that includes an AI agent writing the test: do not read a clean scan as evidence that the expected values are independent. The reviewer's questions below are the control; the script only points at the cheapest cases.
|
|
100
|
+
|
|
101
|
+
As with `expect(true).toBe(true)`, a test is reported only when **none** of its assertions is a real one; a self-comparison next to an assertion against a literal is left to the reviewer. When the text cannot decide, the scanner stays silent — a scanner that cries wolf is switched off.
|
|
102
|
+
|
|
103
|
+
Everything else is a **reviewer's question**, asked in code review (see [Code Review Checklist](code-review-checklist.md)): Where did this expected value come from? Could it be produced by running the code under test? Would the test still pass if the implementation were wrong in the way the test's own arithmetic is wrong? Typical cases the scanner does not judge: a hand-written loop that re-derives the answer, a helper that wraps the implementation, a snapshot generated from the implementation's own first output, and every language other than JavaScript/TypeScript.
|
|
104
|
+
|
|
65
105
|
### Forbidden: Mocking Core Business Logic
|
|
66
106
|
|
|
67
107
|
Mocking your own code means the business logic is never actually executed.
|
|
@@ -228,6 +268,60 @@ Axis ⑨ is satisfied when this section declares all three: **derive** (Step 1 m
|
|
|
228
268
|
|
|
229
269
|
---
|
|
230
270
|
|
|
271
|
+
## Pre-commit Warnings and Gate Scripts Shipped by UDS (XSPEC-444 R2, R5)
|
|
272
|
+
|
|
273
|
+
The rules above used to depend on scripts the standard told you to write yourself. `uds init` now writes the scanners for you, and `uds check` — the command UDS's pre-commit hook runs — prints what they and one more check find. **All of it warns by default and blocks nothing**; tightening is opt-in (see "Warn first, tighten later").
|
|
274
|
+
|
|
275
|
+
### The two scanners (`uds init` writes them to `scripts/`)
|
|
276
|
+
|
|
277
|
+
| Script | Finds |
|
|
278
|
+
|--------|-------|
|
|
279
|
+
| `scripts/check-anti-fake-tests.mjs` | a test with **no assertion**; a test whose only assertions are **tautologies** (`expect(true).toBe(true)`, `assert 200 == 200`; in JavaScript/TypeScript also an expected value that is the same call as the code under test, or is recomputed from the same input with `reduce`/`map`/`filter` — see "Forbidden: Tautology Assertions"); a test file in which **every test is skipped or todo** |
|
|
280
|
+
| `scripts/check-stubs.mjs` | `// WARNING: STUB` markers; a body that says it is **not implemented** (`raise NotImplementedError`, `todo!()`, `TODO()` ...) with no marker beside it; a named function whose body is **empty** with no marker beside it |
|
|
281
|
+
|
|
282
|
+
- Pure Node, no dependencies, no test framework assumed. They are **your files**: edit them, wire them into CI. Run on its own, each exits non-zero when it finds something — `node scripts/check-stubs.mjs` is the pre-push/deploy gate this standard's deployment gates describe.
|
|
283
|
+
- `uds init` never overwrites a file that exists, and `uds update` never overwrites one either; for a project initialised earlier, `uds update` offers to write them (the prompt defaults to no; `uds update -y` answers it yes).
|
|
284
|
+
- With files staged they read only those files; with nothing staged (a CI run, a manual `uds check`) each walks the whole project — the walk stops at 200,000 files, and `uds check` gives each scanner 120 seconds (past that it reports "could not judge", never a pass) — so in a very large repository run them in CI rather than expecting them to be instant.
|
|
285
|
+
- A placeholder is *declared* by `STUB` or `COVERAGE_EXEMPT` on its line or the three above; a declared placeholder is reported once, as its marker.
|
|
286
|
+
- **Languages.** Test-file rules exist for JavaScript/TypeScript, Python, Java/Kotlin/Scala/C#, Go, Rust, Ruby, Elixir, PHP, Swift, Dart, Lua and C/C++. A test file in any **other** language is listed as "NOT scanned" — never counted as clean. Empty-function rules exist for JavaScript/TypeScript, Python, Go, Rust, Ruby and PHP; elsewhere markers and "not implemented" bodies are still found and the output says which languages had no empty-function rule.
|
|
287
|
+
- They read text; they do not run your tests. A helper that asserts under a name the scanner cannot recognise is reported as "no-assertion": name it `assert*` / `verify*` / `expect*`, or list its pattern under `assertionPatterns` in the policy file.
|
|
288
|
+
- Each run first checks itself against known fakes and known good tests; if that fails it exits `2` ("could not judge"), which is never a pass.
|
|
289
|
+
|
|
290
|
+
### Code changed without a test (`uds check`, on staged changes)
|
|
291
|
+
|
|
292
|
+
When files are staged for commit, `uds check` compares what changed:
|
|
293
|
+
|
|
294
|
+
- code files changed and **no test file** changed in the same commit → a warning that lists the code files;
|
|
295
|
+
- a changed file of a type UDS does not recognise → a warning that lists it and says how to classify it (never assumed fine, never blocks);
|
|
296
|
+
- a deletion is not a change that needs a test; a **pure rename** (git's `R100`) and a path matching an `exempt` entry are exempt, and the output records the reason.
|
|
297
|
+
|
|
298
|
+
With nothing staged (a CI run, a manual `uds check`) the diff check says nothing; the two scanners then look at the whole project.
|
|
299
|
+
|
|
300
|
+
### The policy file `.standards/test-policy.json` (optional)
|
|
301
|
+
|
|
302
|
+
Which paths are tests and which are code is data with defaults for the common ecosystems, not a list of frameworks. Every list **adds to** the defaults:
|
|
303
|
+
|
|
304
|
+
```json
|
|
305
|
+
{
|
|
306
|
+
"mode": "warn",
|
|
307
|
+
"testDirs": ["integration"],
|
|
308
|
+
"testPatterns": ["*.itest.*"],
|
|
309
|
+
"sourceExtensions": ["zig"],
|
|
310
|
+
"nonCodeExtensions": ["gradle"],
|
|
311
|
+
"ignore": ["generated/**"],
|
|
312
|
+
"exempt": [{ "pattern": "src/gen/**", "reason": "generated by protoc" }],
|
|
313
|
+
"assertionPatterns": ["\\bmustMatch\\w*\\s*\\("]
|
|
314
|
+
}
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
An `exempt` entry without a `reason` is not honored and is reported: an exemption must say why.
|
|
318
|
+
|
|
319
|
+
### Warn first, tighten later
|
|
320
|
+
|
|
321
|
+
`"mode": "warn"` (the default) prints and lets the commit through. `"mode": "block"` makes `uds check` exit non-zero — and so stops the commit — when a scanner finds something, a scanner cannot judge, or code changed without a test. A file type UDS does not recognise never blocks. **Not implemented yet** (the specification does not say where a baseline would live or what it counts): a ratchet on the number of unpaired changes, and a per-commit exemption reason (a pre-commit hook cannot read the commit message).
|
|
322
|
+
|
|
323
|
+
---
|
|
324
|
+
|
|
231
325
|
## Migration from Pyramid Model
|
|
232
326
|
|
|
233
327
|
If your project previously used pyramid thresholds:
|
|
@@ -235,8 +329,8 @@ If your project previously used pyramid thresholds:
|
|
|
235
329
|
1. **Delete** any hardcoded coverage thresholds from `jest.config.js` / `vitest.config.ts` (`coverageThreshold` option)
|
|
236
330
|
2. **Install** `.coverage-baseline.json` with current coverage as the starting ratchet
|
|
237
331
|
3. **Add** `scripts/check-coverage-ratchet.sh` to CI
|
|
238
|
-
4. **Add** `scripts/check-stubs.
|
|
239
|
-
5. **Add** `scripts/check-anti-fake-tests.
|
|
332
|
+
4. **Add** `scripts/check-stubs.mjs` to deploy.sh and pre-push hook (written by `uds init`; `uds update` offers it to an existing project)
|
|
333
|
+
5. **Add** `scripts/check-anti-fake-tests.mjs` to pre-commit or CI (written by `uds init`; `uds check` already runs it and warns)
|
|
240
334
|
|
|
241
335
|
The ratchet starts at your current coverage. From that point on, it can only increase.
|
|
242
336
|
|