universal-dev-standards 5.14.0 → 5.16.0

package/bundled/core/knowledge-graph-memory.md

@@ -0,0 +1,119 @@
+# Knowledge Graph Memory Standards
+
+> **Language**: English | [繁體中文](../locales/zh-TW/core/knowledge-graph-memory.md)
+
+**Version**: 1.0.0
+**Last Updated**: 2026-05-30
+**Applicability**: Projects using AI assistants across code + specification/decision corpora
+**Scope**: uds-specific
+
+---
+
+## Purpose
+
+This standard defines a **relationship schema** so that specifications, decisions, and code can be traversed as a graph — answering questions like *"if I change `execute()`, which specs and decisions are affected?"*. It complements vector/semantic memory (which finds *similar* artifacts) with **structural traversal** (which finds *connected* artifacts).
+
+The schema is engine-agnostic: it is expressed as plain Markdown front-matter that an AI assistant can read directly (degraded mode), and that an optional graph engine (e.g. [EngramGraph](https://github.com/AsiaOstrich/EngramGraph)) can index for multi-hop queries (service mode).
+
+---
+
+## Quick Reference
+
+### Relationship Front-Matter Schema
+
+Add these optional fields to a spec/decision document's YAML front-matter:
+
+| Field | Type | Direction | Meaning |
+|-------|------|-----------|---------|
+| `related` | list of ids | undirected | Loosely associated artifacts |
+| `impacts` | list of spec ids | this → spec | This decision changes those specs |
+| `impacted_by` | list of decision ids | decision → this | Those decisions change this spec |
+| `supersedes` | list of decision ids | this → decision | This decision replaces those |
+| `implements` | list of spec ids | code/spec → spec | This artifact realises those specs |
+
+Ids are artifact identifiers (e.g. `XSPEC-205`, `DEC-062`, `ADR-001`). Inline `[[XSPEC-NNN]]` wiki-links in the body are an equivalent, lower-fidelity signal.
+
+### Node Kinds
+
+| Prefix | Node kind |
+|--------|-----------|
+| `XSPEC-*` / `SPEC-*` | Spec |
+| `DEC-*` / `ADR-*` | Decision |
+| function / class / module (from code) | Code node |
+
+---
+
+## 1. Schema
+
+### 1.1 Front-Matter Example
+
+```markdown
+---
+id: XSPEC-205
+title: Agent/Role Spec SDD Variant
+status: Implemented
+impacted_by: [DEC-062]
+related: [XSPEC-204]
+---
+```
+
+```markdown
+---
+id: DEC-069
+title: EngramGraph Architecture
+date: 2026-05-27
+supersedes: [DEC-057]
+impacts: [XSPEC-237]
+---
+```
+
+### 1.2 Edge Derivation
+
+| Front-matter on doc | Derived edge |
+|---------------------|--------------|
+| Decision `impacts: [SPEC]` | `IMPACTS` (Decision → Spec) |
+| Spec `impacted_by: [DEC]` | `IMPACTS` (Decision → Spec) |
+| Decision `supersedes: [DEC]` | `SUPERSEDES` (Decision → Decision) |
+| `[[XSPEC-NNN]]` link in a Decision body | `IMPACTS` (Decision → Spec) |
+
+Edges are **idempotent**: declaring the same relationship from both ends (a decision's `impacts` and the spec's `impacted_by`) yields one edge, not two.
+
+---
+
+## 2. Two Operating Modes
+
+A consumer of this standard MUST work in both modes:
+
+### 2.1 Degraded Mode (no engine)
+
+The AI assistant reads the target document, follows its front-matter / `[[ref]]` links by reading the linked files, and assembles the impact chain manually. Always available; bounded by how many files the assistant can read.
+
+### 2.2 Service Mode (graph engine available)
+
+The corpus is indexed into a graph engine; the assistant issues a single multi-hop query (e.g. `impact-analysis { nodeId, maxHops }`) and receives the full chain — including cross-domain links (code → spec → decision) that degraded mode would miss.
+
+> A correct implementation produces the **same answer shape** in both modes; service mode is faster and more complete, not different in kind.
+
+---
+
+## 3. Confidence (optional)
+
+Nodes MAY carry a `confidence` in `[0.1, 1.0]`. Feedback signals (test pass/fail, human correction, status changes) evolve confidence so that reads can surface the most-reinforced artifacts first. Confidence has a floor (never zero) so a run of failures cannot erase an important node. This is the basis of self-evolving graph memory (SAGE).
+
+---
+
+## 4. Rules
+
+1. Relationship fields are **optional** and **additive** — absence never breaks tooling.
+2. Reference ids that do not (yet) exist are allowed; they become stub nodes resolved when the target document appears.
+3. Declare each relationship from the side that *owns* it (a decision owns `impacts`/`supersedes`; a spec owns `impacted_by`), but either side is accepted.
+4. The graph engine is **opt-in**. Tools MUST degrade gracefully to Markdown reading when no engine is configured.
+5. Vector/semantic memory is **complementary**, not replaced — use graph traversal for structure, vectors for similarity.
+
+---
+
+## Related Standards
+
+- [Project Context Memory](project-context-memory.md) — per-project long-term facts
+- [Developer Memory](developer-memory.md) — universal, transferable preferences
+- [ADR Standards](adr-standards.md) — decision record format that feeds Decision nodes

package/bundled/locales/COVERAGE.md

@@ -0,0 +1,226 @@
+# UDS Locale Coverage
+
+> Auto-generated by `scripts/generate-locale-coverage.mjs` on 2026-05-28.
+> Do not edit manually — re-run the script.
+
+> **Canonical**: `skills/` (54) + `core/` (127). **Locales tracked**: `zh-CN`, `zh-TW`.
+
+## Skills (54 canonical)
+
+| Skill | zh-CN | zh-TW |
+| :-- | :-: | :-: |
+| ac-coverage | :x: | :white_check_mark: 1.0.0 |
+| adr-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-collaboration-standards | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| ai-friendly-architecture | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-instruction-standards | :white_check_mark: 2.0.0 | :white_check_mark: 2.0.0 |
+| api-design-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| atdd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| audit-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| bdd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| brainstorm-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| changelog-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| checkin-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ci-cd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| code-review-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| commit-standards | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| contract-test-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| database-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| deploy-assistant | :x: | :white_check_mark: 1.0.0 |
+| dev-methodology | :x: | :white_check_mark: 1.0.0 |
+| dev-workflow-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| docs-generator | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| documentation-guide | :white_check_mark: 2.1.0 | :white_check_mark: 2.1.0 |
+| durable-execution-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| e2e-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| error-code-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| git-workflow-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| incident-response-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| journey-test-assistant | :x: | :white_check_mark: 1.0.0 |
+| logging-guide | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| metrics-dashboard-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| migration-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| observability-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| orchestrate | :x: | :warning: 1.0.0 (major) |
+| plan | :x: | :warning: 1.0.0 (major) |
+| pr-automation-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| project-discovery | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| project-structure-guide | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| push | :x: | :warning: 1.0.0 (major) |
+| refactoring-assistant | :white_check_mark: 2.0.0 | :white_check_mark: 2.0.0 |
+| release-standards | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| requirement-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| retrospective-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| reverse-engineer | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| runbook-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| security-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| security-scan-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| skill-builder | :x: | :white_check_mark: 1.0.0 |
+| slo-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| spec-derivation | :x: | :white_check_mark: 1.0.0 |
+| spec-driven-dev | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| sweep | :x: | :white_check_mark: 1.0.0 |
+| tdd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| test-coverage-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| testing-guide | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+
+**zh-CN skills coverage**: 44/54 (81%)
+**zh-TW skills coverage**: 54/54 (100%)
+
+## Standards (`core/` — 127 canonical)
+
+| Standard | zh-CN | zh-TW |
+| :-- | :-: | :-: |
+| acceptance-criteria-traceability.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| acceptance-test-driven-development.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| accessibility-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| adr-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| adversarial-test.md | :x: | :x: |
+| agent-behavior-discipline.md | :x: | :x: |
+| agent-communication-protocol.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| agent-dispatch.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-agreement-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-command-behavior.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-friendly-architecture.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| ai-instruction-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| ai-response-navigation.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| alerting-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| anti-hallucination.md | :white_check_mark: 1.5.1 | :white_check_mark: 1.5.1 |
+| anti-sycophancy-prompting.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| api-design-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| behavior-driven-development.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| behavior-snapshot.md | :x: | :x: |
+| branch-completion.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| browser-compatibility-standards.md | :x: | :warning: 0.0.0 (major) |
+| capability-declaration.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| cd-deployment-strategies.md | :x: | :x: |
+| change-batching-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| changelog-standards.md | :white_check_mark: 1.0.2 | :white_check_mark: 1.0.2 |
+| chaos-engineering-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| chaos-injection-tests.md | :x: | :x: |
+| checkin-standards.md | :white_check_mark: 1.6.0 | :white_check_mark: 1.6.0 |
+| circuit-breaker.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| code-review-checklist.md | :white_check_mark: 1.3.0 | :white_check_mark: 1.3.0 |
+| commit-message-guide.md | :white_check_mark: 1.3.0 | :white_check_mark: 1.3.0 |
+| container-security.md | :x: | :x: |
+| containerization-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| context-aware-loading.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| contract-testing-standards.md | :x: | :warning: 0.0.0 (major) |
+| cost-budget-test.md | :x: | :x: |
+| cross-flow-regression.md | :x: | :warning: 0.0.0 (major) |
+| data-migration-testing.md | :x: | :x: |
+| database-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| deployment-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| deprecation-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| design-document-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| developer-memory.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| disaster-recovery-drill.md | :x: | :x: |
+| documentation-lifecycle.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| documentation-structure.md | :white_check_mark: 1.5.0 | :white_check_mark: 1.5.0 |
+| documentation-writing-standards.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| dual-phase-output.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| environment-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| error-code-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.2.0 |
+| estimation-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| execution-history.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| failure-source-taxonomy.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| feature-flag-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| feature-manifest-standard.md | :x: | :x: |
+| flaky-test-management.md | :x: | :x: |
+| flow-based-testing.md | :x: | :x: |
+| forward-derivation-standards.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| frontend-design-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| full-coverage-testing.md | :x: | :x: |
+| git-workflow.md | :white_check_mark: 1.4.0 | :white_check_mark: 1.4.0 |
+| git-worktree.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| governance-layer.md | :x: | :white_check_mark: 1.0.0 |
+| health-check-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| immutability-first.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| knowledge-transfer-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| license-compliance.md | :x: | :x: |
+| llm-output-validation.md | :x: | :x: |
+| logging-standards.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| mock-boundary.md | :x: | :x: |
+| model-selection.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| mutation-testing.md | :x: | :x: |
+| no-cicd-deployment.md | :x: | :x: |
+| observability-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| packaging-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| performance-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| pipeline-integration-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| pipeline-security-gates.md | :x: | :x: |
+| policy-as-code-testing.md | :x: | :x: |
+| postmortem-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| privacy-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| project-context-memory.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| project-structure.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| prompt-regression.md | :x: | :x: |
+| property-based-testing.md | :x: | :x: |
+| recovery-recipe-registry.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| refactoring-standards.md | :white_check_mark: 2.1.0 | :white_check_mark: 2.1.0 |
+| release-quality-manifest.md | :x: | :x: |
+| release-readiness-gate.md | :x: | :warning: 0.0.0 (major) |
+| replay-test.md | :x: | :x: |
+| requirement-engineering.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| retrospective-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| retry-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| reverse-engineering-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| rollback-standards.md | :x: | :x: |
+| runbook-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| sast-advanced.md | :x: | :x: |
+| secure-op.md | :x: | :x: |
+| security-decision.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| security-standards.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| security-testing.md | :x: | :x: |
+| self-review-protocol.md | :x: | :white_check_mark: ? |
+| server-ops-security.md | :x: | :x: |
+| skill-standard-alignment-check.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| slo-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| smoke-test.md | :x: | :x: |
+| spec-driven-development.md | :white_check_mark: 2.2.0 | :white_check_mark: 2.2.0 |
+| standard-admission-criteria.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| standard-lifecycle-management.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| structured-task-definition.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| supply-chain-attestation.md | :x: | :x: |
+| supply-chain-security-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| systematic-debugging.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| tech-debt-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| test-completeness-dimensions.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| test-data-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| test-driven-development.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| test-governance.md | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
+| testing-standards.md | :white_check_mark: 3.2.0 | :white_check_mark: 3.2.0 |
+| timeout-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| token-budget.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| translation-lifecycle-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| verification-evidence.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| versioning.md | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
+| virtual-organization-standards.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| workflow-enforcement.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+| workflow-state-protocol.md | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
+
+**zh-CN core coverage**: 90/127 (71%)
+**zh-TW core coverage**: 96/127 (76%)
+
+## Drift Warnings
+
+Locale variants whose `translation_version` lags `source_version` by more than 2 minor versions, or by any major version. (Per XSPEC-239 Chimera Prevention — `translation-drift-warn`.)
+
+### zh-TW
+
+- **skill/orchestrate**: translation `1.0.0` vs source `2.0.0` (major-version gap)
+- **skill/plan**: translation `1.0.0` vs source `2.0.0` (major-version gap)
+- **skill/push**: translation `1.0.0` vs source `2.0.0` (major-version gap)
+- **core/browser-compatibility-standards.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+- **core/contract-testing-standards.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+- **core/cross-flow-regression.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+- **core/release-readiness-gate.md**: translation `0.0.0` vs source `1.0.0` (major-version gap)
+
+## Legend
+
+| Symbol | Meaning |
+|--------|---------|
+| :white_check_mark: `x.y.z` | Translated; `translation_version` shown |
+| :warning: `x.y.z` (drift) | Translation lags source by > 2 minor versions |
+| :warning: `x.y.z` (major) | Translation lags source by a major version |
+| :x: | Not translated for this locale |

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.14.0
-translation_version: 5.14.0
-last_synced: 2026-05-27
+source_version: 5.16.0
+translation_version: 5.16.0
+last_synced: 2026-06-08
 status: current
 ---
 
@@ -17,6 +17,45 @@ status: current
 
 ## [Unreleased]
 
+## [5.16.0] - 2026-06-08
+
+### 新增 — 测试推导链延伸至用户指南（XSPEC-260）
+
+- **`core/forward-derivation-standards.md`**：新增 `## Terminal Projection: User Guide`（终端投影：用户指南）段 + `### Single-Spine Principle`（单一主干原则）。把推导管道从测试延伸到用户指南——用户指南是 journey／E2E 测试以机器验证的同一条 AC 主干的终端投影。定义共用 `T-NNN` 编号（用户指南步骤的 `T-NNN` 必须等于某个真实 journey／E2E 测试的 id）、user-facing AC 筛选与保守预设，以及单一主干原则：测试／文件来源是同一 AC 主干的 N×1 投影、非 N×N 平行对照；另立平行编号体系即为违规。
+- **`ai/standards/forward-derivation-standards.ai.yaml`**：对应 `terminal_projection` 区块 + 3 条 rules（`single-spine-no-parallel-numbering`、`user-guide-shared-tnnn`、`user-facing-ac-conservative-default`）。
+- **`core/acceptance-criteria-traceability.md`**：新增 `## User-Documentation Coverage`（用户文件覆盖）维度——追踪 user-facing AC 是否被用户指南记载。含 user-facing AC 筛选（保守预设：判不准归 user-facing）、沿用 ✅/⚠️/❌ 状态，及排除非 user-facing 与 `not_implemented` AC 的覆盖率公式。
+- **`ai/standards/acceptance-criteria-traceability.ai.yaml`**：对应 `user_doc_coverage` 区块 + 2 条 rules（`user-doc-user-facing-only`、`user-doc-shared-tnnn`）。
+- **zh-TW / zh-CN 语言版**：两标准的新段落均完整翻译。
+
+## [5.15.0] - 2026-05-28
+
+### 新增 — i18n 分层语言策略（XSPEC-239）
+
+- **`core/ai-instruction-standards.md` v1.0.0 → v1.1.0**：新增 `## 国际化（i18n）` 章节，定义 SKILL.md 与 root 级 AI 指令档的 L1/L2/L3/L4 分层语言策略。**范围延伸**自原本只规范 root 级（`CLAUDE.md`、`.cursorrules` 等）扩张至涵盖 skill 级档案（`SKILL.md`）。定义 canonical/locale 档案结构、责任边界、chimera 防范规则、采用者安装模式。
+- **`ai/standards/ai-instruction-standards.ai.yaml` v1.0.0 → v1.1.0**：对应的 `i18n:` 区块 + 4 条新规则。
+- **10 个缺漏 zh-TW locale skill 变体**：`ac-coverage`、`deploy-assistant`、`dev-methodology`、`journey-test-assistant`、`orchestrate`、`plan`、`push`、`skill-builder`、`spec-derivation`、`sweep`。zh-TW skill 覆盖率达 54/54（100%）。
+- **`cli/src/lint/i18n.js` + `uds check --i18n` 命令**：强制执行 5 条 chimera 防范规则。Error 退出码 1。`--json` 模式给 CI 用。
+- **`scripts/generate-locale-coverage.mjs` + 自动产生的 `locales/COVERAGE.md`**：依 skill/standard × locale 的覆盖率矩阵 + drift 警告。npm script `docs:locale-coverage`。
+- **`UDS_LOCALE` 环境变数支援**。
+- **`.uds/install.yaml` `locale:` 栏位支援**：让采用者宣告偏好 locale 一次，免去每次 `--locale`。
+- **Locale fallback WARN**：取代原本的 silent fallback。
+- **i18n 讯息**：新增 `localeFallbackTitle` / `localeFallbackHint` 键（en/zh-tw/zh-cn）。
+
+### 变更
+
+- **CLI locale 解析优先顺序**：6 阶层 — `--locale` > `.uds/install.yaml` > `UDS_LOCALE` env > manifest > `.standards/` 侦测 > `'en'`。
+- **`core/ai-instruction-standards.md` 译本**：zh-TW 与 zh-CN locale 同步至 v1.1.0 含完整在地化 i18n 章节。（zh-CN 章节标记 pending-review，依 XSPEC-239 O-2 — 简中翻译质量策略未定。）
+
+### 修正
+
+- **29 个 canonical SKILL.md 描述 chimera 修正**（XSPEC-239 Phase 1B）：从下列 skill 的 `description:` frontmatter 移除 CJK 内容：`adr-assistant`、`ai-collaboration-standards`、`ai-friendly-architecture`、`ai-instruction-standards`、`api-design-assistant`、`audit-assistant`、`ci-cd-assistant`、`contract-test-assistant`、`database-assistant`、`deploy-assistant`、`documentation-guide`、`error-code-guide`、`git-workflow-guide`、`incident-response-assistant`、`journey-test-assistant`、`logging-guide`、`observability-assistant`、`orchestrate`、`plan`、`pr-automation-assistant`、`project-structure-guide`、`push`、`retrospective-assistant`、`runbook-assistant`、`security-assistant`、`security-scan-assistant`、`slo-assistant`、`sweep`、`testing-guide`。
+- **`skills/reverse-engineer/SKILL.md` description em dash** 改为 ASCII hyphen。
+- **`locales/zh-TW/core/self-review-protocol.md` 缺 YAML frontmatter** 已补。
+
+### 采用者升级注意
+
+对于以 `--locale zh-TW` 或 `--locale zh-CN` 安装 UDS 的项目，请执行 `uds update`。手动编辑过 canonical 档案的采用者，请将客制化内容调整至 locale 变体或 overlay。新的 `uds check --i18n` lint 可验证项目干净。
+
 ## [5.14.0] - 2026-05-27
 
 ### 新增

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

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

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

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支持状态 |
 |------|--------|
-| 5.13.2 | ✅ 最新正式版 |
+| 5.15.0 | ✅ 最新正式版 |
 | < 5.0.0 | ❌ 已终止支持 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 

package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md

@@ -116,6 +116,52 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
 
 ---
 
+## 用户文件覆盖
+
+上方的 AC↔测试矩阵验证 AC 是否被*测试*。第二个维度则验证 **user-facing AC 是否同时被用户指南记载**。这把可追溯主干从测试延伸到用户指南——见正向推演标准 →《终端投影：用户指南》。用户指南与 journey／E2E 套件是同一作业流程的两个投影，因此共用一把尺：`T-NNN`。
+
+### User-Facing AC 筛选
+
+此维度**只套用于 user-facing AC**——终端用户可直接观察或操作者。如此可避免此维度退化成对每个内部 AC 的全面文件义务。
+
+| AC 类型 | user-facing？ |
+|---------|--------------|
+| UI 流程、画面、导航 | 是 |
+| 用户执行的 CLI 指令／标志 | 是 |
+| 对外 API 的用户语义（用户调用的公开契约）| 是 |
+| 内部重构／模块契约 | 否 |
+| 性能门槛、容量 | 否 |
+| 安全内控、内部护栏 | 否 |
+
+**保守预设**：判不准时一律归 user-facing。排除某个 AC 必须**明确标记**（如 `user_facing: false`），绝不静默省略。
+
+### 用户文件状态
+
+沿用相同符号，改回答「此 user-facing AC 是否被某个用户指南步骤覆盖？」：
+
+| 状态 | 符号 | 定义 |
+|------|------|------|
+| **已记载** | ✅ | 有用户指南步骤覆盖此 AC，并标上该 AC 共用的 `T-NNN` |
+| **部分** | ⚠️ | 有用户指南步骤但不完整或标记模棱两可 |
+| **未记载** | ❌ | 无任何用户指南步骤引用此 user-facing AC |
+
+`not_implemented`（🚫）AC 排除于用户文件分母之外，与测试覆盖率计算一致。
+
+### 用户文件覆盖率计算
+
+```
+用户文件覆盖率 % = (已记载 + 部分 × 0.5) / (user_facing_ac_count - not_implemented_count) × 100
+
+其中：
+  user_facing_ac_count = 归类为 user-facing 的 AC 数（套用保守预设）
+  非 user-facing AC 不计入分子也不计入分母
+  部分计为 0.5
+```
+
+> **同一把尺**：用户指南步骤的 `T-NNN` 必须等于某个真实 journey／E2E 测试的 id（正向推演标准）。这把同一 AC 的三个投影——测试、journey、用户指南——绑到单一主干。自造平行 id 却无对应测试的用户指南步骤，一律报为**未记载**，绝不算覆盖。
+
+---
+
 ## 品质门槛
 
 ### 默认门槛

package/bundled/locales/zh-CN/core/ai-instruction-standards.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../core/ai-instruction-standards.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-14
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-05-28
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **语言**: [English](../../../core/ai-instruction-standards.md) | [简体中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
 
-**版本**: 1.0.0
-**最后更新**: 2026-01-14
+**版本**: 1.1.0
+**最后更新**: 2026-05-28
 **适用范围**: 所有使用 AI 编码助手的项目
 
 ---
@@ -151,6 +151,111 @@ AI 指令文件通常混合两种类型的内容：
 
 ---
 
+## 国际化（i18n）
+
+AI 指令档常需提供多语言版本——既为了国际采用者，也为了非英语母语维护者主导的项目。本章节定义多语言指令档的组织、验证与安装规则。
+
+### AI 指令档的范围
+
+本标准涵盖两个层级的 AI 指令档：
+
+| 层级 | 范例 | i18n 模式 |
+|------|------|----------|
+| **Root 层** | `CLAUDE.md`、`.cursorrules`、`.windsurfrules`、`.opencode/instructions.md` | 单档内以 inline 段落分语言（例：`## 中文` / `## English`）|
+| **Skill 层** | Claude Code `.claude/skills/{name}/SKILL.md`、OpenCode plugin instructions | Canonical（英文）+ `locales/{lang}/` 变体 |
+
+> 注意：skill 层的多档结构主要对 Claude Code 适用。其他工具是 root 单档；对它们只有下方「分层语言策略」与「Chimera 防范」规则适用。
+
+### 分层语言策略
+
+每份 AI 指令档概念上有 **4 层**，各层语言责任不同：
+
+| 层 | 内容 | Canonical (en) | Locale ({lang}) | 为何分这层 |
+|----|------|---------------|----------------|-----------|
+| **L1 — Metadata** | YAML frontmatter `description`、`argument-hint`、`allowed-tools` | **必须英文** | **必须对应 locale 语言** | AI 触发讯号；英文 token 效率最高 + 训练语料密度高 |
+| **L2 — 指令（Instructions）** | 对 AI 的命令式规则 | **必须英文** | 对应 locale 语言（可选；可保留英文）| AI 读英文指令最精准 |
+| **L3 — 输出范本（Output Templates）** | 范例输出、回应格式、情境范本 | 英文（canonical 锁定英文）| **强制对应 locale**（mandatory）| **唯一直接影响 AI 输出语言的层** |
+| **L4 — 人类文件** | 维护者注解、贡献者说明 | 英文 | 对应 locale 语言（强烈建议）| 给人类维护者读，AI 不读 |
+
+**关键 insight**：L1（description）是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3（output template）才是控制 AI 输出语言的唯一开关。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误。**
+
+### Canonical / Locale 档案结构
+
+UDS 标准与 skill 的 locale 变体结构：
+
+```text
+core/{name}.md
+core/{name}.ai.yaml
+locales/{lang}/core/{name}.md
+locales/{lang}/ai/standards/{name}.ai.yaml
+skills/{name}/SKILL.md
+locales/{lang}/skills/{name}/SKILL.md
+```
+
+**命名惯例**：使用 BCP 47 语言标签——`zh-TW`、`zh-CN`、`ja`、`ko`、`en-US` 等。
+
+### Locale 变体 Frontmatter 必填栏位
+
+```yaml
+---
+name: {与 canonical 同名}
+source: {指回 canonical 的相对路径}
+source_version: {翻译时 canonical 的版本}
+translation_version: {本翻译的版本}
+---
+```
+
+`source_version` 落后超过 2 个 minor 版本会触发 drift 警告。
+
+### 责任边界
+
+| 角色 | 拥有 | 必须做 |
+|------|------|--------|
+| **Canonical 拥有者** | `core/{name}.md` 等 | 维持 L1/L2/L3/L4 为英文；breaking change 时 bump `source_version` |
+| **Locale 维护者** | `locales/{lang}/...` | `translation_version` 对齐 `source_version`；翻译 L1（必）、L2（选）、L3（必）、L4（建议）|
+| **采用者** | 自己的 `.claude/skills/`、`CLAUDE.md` | 用 `uds install --locale {lang}` 安装；**绝不**手动修改 canonical |
+
+### Chimera 防范
+
+| 模式 | 严重度 | 侦测方式 |
+|------|--------|----------|
+| Canonical 的 `description` 含 CJK | ❌ Error | Lint |
+| Locale 变体的 `description` 是纯 ASCII | ❌ Error | Lint |
+| Locale 变体缺 `source:` frontmatter | ❌ Error | Lint |
+| Canonical L3 含非英文范例 | ⚠️ Warn | Lint |
+| 采用者档案与 canonical/locale 都不同 | ⚠️ Warn | Sync check |
+| `translation_version` 落后过多 | ⚠️ Warn | Drift check |
+
+### 采用者安装
+
+```bash
+uds install --locale zh-CN   # 以简体中文安装 skills 与 standards
+```
+
+**Locale 解析优先顺序**：`--locale` flag > `.uds/install.yaml` > `UDS_LOCALE` env > fallback `en`
+
+Locale 不存在时 fallback 到 canonical + WARN，**不**阻断安装。
+
+### 迁移：已有 chimera 的采用者
+
+1. **辨识 chimera**：比对采用者档案与 UDS canonical / locale 变体
+2. **安装正确变体**：`uds install --locale {lang}`
+3. **保留专案级客制**：抽出为 overlay
+4. **丢弃纯翻译**：locale 变体取代之
+
+### 快速参考
+
+| 动作 | 何时 | 工具 / 档案 |
+|------|------|------------|
+| 新增语言支援 | 想支援新 locale | `locales/{lang}/...` |
+| 更新 canonical | 改进英文 source | Bump `source_version` |
+| 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version` |
+| 检查覆盖率 | 定期 review | `locales/COVERAGE.md` |
+| 带 locale 安装 | 采用者初设 | `uds install --locale {lang}` |
+| 跑 i18n lint | Commit 前 / CI | `uds lint --i18n` |
+
+---
+
 ## 维护检查清单
 
 在提交 AI 指令文件的变更之前：
@@ -205,6 +310,7 @@ grep -n "npm\|yarn\|pip\|cargo" CLAUDE.md | head -20
 | 版本 | 日期 | 变更 |
 |------|------|------|
 | 1.0.0 | 2026-01-14 | 初始发布 |
+| 1.1.0 | 2026-05-28 | 新增 i18n 章节；范围延伸至 skill 层级文件 |
 
 ---
 

package/bundled/locales/zh-CN/core/forward-derivation-standards.md

@@ -333,6 +333,25 @@ spec-review → forward-derivation → discovery
 
 ---
 
+## 终端投影：用户指南
+
+推演链不止于测试。**用户指南是同一条链的终端投影**——E2E／旅程测试以机器验证的那条作业流程，其供人阅读的视图。「用户读到的操作步骤」与「E2E 实际验证的行为」因此成为一个被维持的不变量。
+
+- **单一真实来源**：SPEC 的验收条件（AC）。所有下游产物——BDD 场景、TDD／IT／E2E 骨架、ATDD 表格、契约，**以及用户指南**——都是同一条 AC 主干的投影。用户指南不是另一个要互相对照的来源，而是又一个投影。
+- **仅限 user-facing AC**：唯有**终端用户可直接观察或操作**的 AC（UI 流程、CLI 指令、对外 API 的用户语义）才需要用户指南步骤。纯内部 AC（重构、内部模块契约、性能门槛、安全内控）无用户指南义务。**判不准时一律归 user-facing**——保守预设；必须明确标记才能排除。
+- **共用编号（`T-NNN`）**：每个用户指南步骤标 `T-NNN`，且该 `T-NNN` 必须是某个真实 journey／E2E 测试的 id。用户指南与 E2E 套件是同一作业流程的两个投影、共用一把尺。模棱两可或未标记一律报为**未覆盖**（宁可冗余不要遗漏）。
+  - ✅ 用户指南步骤 `T-012「创建项目」` ↔ journey spec 中的 E2E 测试 `T-012`。
+  - ❌ 用户指南自造 `UG-3` 却无对应测试 → drift，报为未覆盖。
+- **Drift 反例**：用户指南写「2-click checkout」、E2E 却仍验「3-step payment」——没有共用编号就无人察觉。共用 `T-NNN` 把这种 drift 变成被报出的覆盖缺口。
+
+### 单一主干原则（非平行对照）
+
+测试与文件来源是**同一条 AC 主干的多层投影**，不是互相对照的独立真实来源。TDD／IT／E2E 是同一主干的金字塔**层级**（依 AC 性质分层），非彼此竞争的来源。两两对照 N 个来源（N×N）会滋生 drift；把每个产物投影回单一 AC 主干（N×1）则消除它。
+
+> **规则**：每个测试或文件产物都必须回溯到某个 AC。另立**平行编号体系**——一条脱离 AC 主干的第二套 `T-NNN` 系列——即为违规。只有一把尺：AC 主干，且 `T-NNN` 由 journey／E2E 测试与用户指南共用。
+
+---
+
 ## 命令
 
 ### 命令参考