universal-dev-standards 4.2.0 → 5.0.0-beta.10
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 +3 -3
- package/bin/uds.js +165 -5
- package/bundled/core/acceptance-test-driven-development.md +19 -721
- package/bundled/core/accessibility-standards.md +862 -0
- package/bundled/core/ai-agreement-standards.md +95 -0
- package/bundled/core/ai-friendly-architecture.md +2 -0
- package/bundled/core/ai-instruction-standards.md +2 -0
- package/bundled/core/anti-hallucination.md +90 -637
- package/bundled/core/behavior-driven-development.md +20 -735
- package/bundled/core/changelog-standards.md +4 -0
- package/bundled/core/checkin-standards.md +21 -4
- package/bundled/core/code-review-checklist.md +3 -0
- package/bundled/core/commit-message-guide.md +14 -3
- package/bundled/core/deployment-standards.md +296 -0
- package/bundled/core/developer-memory.md +568 -0
- package/bundled/core/documentation-structure.md +114 -18
- package/bundled/core/documentation-writing-standards.md +272 -2
- package/bundled/core/error-code-standards.md +3 -0
- package/bundled/core/forward-derivation-standards.md +134 -8
- package/bundled/core/git-workflow.md +72 -686
- package/bundled/core/guides/anti-hallucination-guide.md +517 -0
- package/bundled/core/guides/git-workflow-guide.md +954 -0
- package/bundled/core/guides/performance-guide.md +508 -0
- package/bundled/core/guides/refactoring-guide.md +608 -0
- package/bundled/core/guides/security-guide.md +485 -0
- package/bundled/core/logging-standards.md +337 -2
- package/bundled/core/performance-standards.md +231 -0
- package/bundled/core/project-context-memory.md +180 -0
- package/bundled/core/project-structure.md +315 -2
- package/bundled/core/refactoring-standards.md +81 -761
- package/bundled/core/requirement-engineering.md +39 -0
- package/bundled/core/reverse-engineering-standards.md +6 -4
- package/bundled/core/security-standards.md +244 -0
- package/bundled/core/spec-driven-development.md +20 -319
- package/bundled/core/test-completeness-dimensions.md +213 -11
- package/bundled/core/test-driven-development.md +22 -978
- package/bundled/core/testing-standards.md +222 -2903
- package/bundled/core/versioning.md +16 -55
- package/bundled/core/virtual-organization-standards.md +85 -0
- package/bundled/locales/README.md +4 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +18 -18
- package/bundled/locales/zh-CN/CLAUDE.md +3 -3
- package/bundled/locales/zh-CN/MAINTENANCE.md +7 -7
- package/bundled/locales/zh-CN/README.md +2 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +1 -1
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +3 -3
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +66 -7
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +22 -22
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +5 -5
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +4 -4
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +5 -5
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +13 -13
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +1 -1
- package/bundled/locales/zh-CN/core/anti-hallucination.md +39 -3
- package/bundled/locales/zh-CN/core/checkin-standards.md +18 -5
- package/bundled/locales/zh-CN/core/commit-message-guide.md +1 -1
- package/bundled/locales/zh-CN/core/developer-memory.md +576 -0
- package/bundled/locales/zh-CN/core/documentation-structure.md +43 -5
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +146 -5
- package/bundled/locales/zh-CN/core/git-workflow.md +179 -4
- package/bundled/locales/zh-CN/core/logging-standards.md +177 -4
- package/bundled/locales/zh-CN/core/project-structure.md +117 -5
- package/bundled/locales/zh-CN/core/refactoring-standards.md +3 -3
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +6 -6
- package/bundled/locales/zh-CN/core/spec-driven-development.md +516 -14
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +155 -24
- package/bundled/locales/zh-CN/core/test-driven-development.md +71 -20
- package/bundled/locales/zh-CN/core/testing-standards.md +4 -4
- package/bundled/locales/zh-CN/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +90 -51
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +184 -0
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +239 -0
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +320 -0
- package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +43 -43
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +440 -0
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +1 -1
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +1 -1
- package/bundled/locales/zh-CN/integrations/codex/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +5 -5
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +9 -9
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +18 -6
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +2 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +3 -3
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +22 -10
- package/bundled/locales/zh-CN/integrations/openspec/README.md +1 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +3 -3
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/english.md +1 -1
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +1 -1
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/go.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/java.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +1 -1
- package/bundled/locales/zh-CN/options/project-structure/python.md +1 -1
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +1 -1
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +1 -1
- package/bundled/locales/zh-CN/options/testing/system-testing.md +1 -1
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +1 -1
- package/bundled/locales/zh-CN/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +2 -2
- package/bundled/locales/zh-CN/skills/README.md +131 -81
- package/bundled/locales/zh-CN/skills/agents/README.md +281 -0
- package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +10 -10
- package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +8 -8
- package/bundled/locales/zh-CN/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +8 -8
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +221 -0
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +214 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +71 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +428 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +484 -0
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +368 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +68 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +406 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +454 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +324 -0
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +64 -0
- package/bundled/locales/zh-CN/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +6 -7
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-CN/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -7
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +5 -6
- package/bundled/locales/zh-CN/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/bdd.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/methodology.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/commands → commands}/refactor.md +3 -3
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +61 -0
- package/bundled/locales/zh-CN/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +5 -6
- package/bundled/locales/zh-CN/skills/{claude-code/commit-standards → commit-standards}/language-options.md +3 -3
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +59 -0
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +262 -0
- package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -8
- package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/forward-derivation/SKILL.md +62 -0
- package/bundled/locales/zh-CN/skills/forward-derivation/guide.md +130 -0
- package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-CN/skills/methodology-system/SKILL.md +78 -0
- package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/methodology-system → methodology-system}/runtime.md +3 -3
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +66 -0
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +371 -0
- package/bundled/locales/zh-CN/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +1 -1
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -8
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +64 -0
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/changelog-format.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +5 -6
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/release-workflow.md +7 -7
- package/bundled/locales/zh-CN/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +3 -3
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +4 -5
- package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +3 -3
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +17 -18
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +2 -2
- package/bundled/locales/zh-CN/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +3 -3
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +75 -0
- package/bundled/locales/zh-CN/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +10 -11
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +66 -0
- package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +12 -16
- package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
- package/bundled/locales/zh-CN/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +3 -3
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +65 -0
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +284 -0
- package/bundled/locales/zh-CN/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +8 -8
- package/bundled/locales/zh-CN/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +4 -4
- package/bundled/locales/zh-CN/skills/{cline → tools/cline}/README.md +1 -1
- package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/README.md +1 -1
- package/bundled/locales/zh-CN/skills/{copilot → tools/copilot}/copilot-instructions.md +1 -1
- package/bundled/locales/zh-CN/skills/{cursor → tools/cursor}/README.md +1 -1
- package/bundled/locales/zh-CN/skills/{windsurf → tools/windsurf}/README.md +1 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +16 -16
- package/bundled/locales/zh-TW/CLAUDE.md +3 -3
- package/bundled/locales/zh-TW/MAINTENANCE.md +7 -7
- package/bundled/locales/zh-TW/README.md +13 -7
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +1 -1
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +4 -4
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +66 -7
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +22 -22
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +5 -5
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +4 -4
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +5 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +13 -13
- package/bundled/locales/zh-TW/ai/standards/anti-hallucination.ai.yaml +3 -2
- package/bundled/locales/zh-TW/ai/standards/git-workflow.ai.yaml +4 -3
- package/bundled/locales/zh-TW/ai/standards/spec-driven-development.ai.yaml +3 -3
- package/bundled/locales/zh-TW/ai/standards/testing.ai.yaml +1 -0
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +1 -1
- package/bundled/locales/zh-TW/core/anti-hallucination.md +38 -701
- package/bundled/locales/zh-TW/core/changelog-standards.md +1 -1
- package/bundled/locales/zh-TW/core/checkin-standards.md +18 -5
- package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-TW/core/commit-message-guide.md +1 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +576 -0
- package/bundled/locales/zh-TW/core/documentation-structure.md +115 -22
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +126 -5
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +2 -2
- package/bundled/locales/zh-TW/core/git-workflow.md +38 -812
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +779 -0
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +1016 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +864 -0
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +2280 -0
- package/bundled/locales/zh-TW/core/logging-standards.md +159 -4
- package/bundled/locales/zh-TW/core/project-structure.md +102 -9
- package/bundled/locales/zh-TW/core/refactoring-standards.md +37 -823
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +6 -6
- package/bundled/locales/zh-TW/core/spec-driven-development.md +17 -268
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +128 -14
- package/bundled/locales/zh-TW/core/test-driven-development.md +20 -983
- package/bundled/locales/zh-TW/core/testing-standards.md +120 -2105
- package/bundled/locales/zh-TW/core/versioning.md +13 -55
- package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +90 -51
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +184 -0
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +239 -0
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +320 -0
- package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +71 -0
- package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +42 -42
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +440 -0
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +1 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +1 -1
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +44 -0
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +3 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +18 -6
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +22 -10
- package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +338 -0
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +1055 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +1 -1
- package/bundled/locales/zh-TW/options/commit-message/english.md +1 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +1 -1
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/go.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/java.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +1 -1
- package/bundled/locales/zh-TW/options/project-structure/python.md +1 -1
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +1 -1
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +1 -1
- package/bundled/locales/zh-TW/options/testing/system-testing.md +1 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +1 -1
- package/bundled/locales/zh-TW/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +2 -2
- package/bundled/locales/zh-TW/skills/README.md +131 -79
- package/bundled/locales/zh-TW/skills/agents/README.md +281 -0
- package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +7 -7
- package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +8 -8
- package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +8 -8
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +221 -0
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +214 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +71 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +428 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +484 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +368 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +68 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +406 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +454 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +324 -0
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +64 -0
- package/bundled/locales/zh-TW/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +6 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-TW/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -7
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +56 -0
- package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +2 -3
- package/bundled/locales/zh-TW/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/bdd.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/methodology.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/refactor.md +3 -3
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +61 -0
- package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +5 -6
- package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/language-options.md +3 -3
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +59 -0
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +262 -0
- package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -8
- package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md +62 -0
- package/bundled/locales/zh-TW/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md} +24 -19
- package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md +78 -0
- package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/methodology-system → methodology-system}/runtime.md +3 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +66 -0
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +371 -0
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +574 -0
- package/bundled/locales/zh-TW/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +4 -4
- package/bundled/locales/zh-TW/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +1 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-TW/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -8
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +64 -0
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/changelog-format.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +2 -3
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/release-workflow.md +60 -28
- package/bundled/locales/zh-TW/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +3 -3
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +2 -3
- package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +3 -3
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +67 -0
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +17 -18
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +2 -2
- package/bundled/locales/zh-TW/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +3 -3
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +75 -0
- package/bundled/locales/zh-TW/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +9 -10
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +66 -0
- package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +9 -10
- package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
- package/bundled/locales/zh-TW/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +3 -3
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +65 -0
- package/bundled/locales/zh-TW/skills/{claude-code/test-coverage-assistant/SKILL.md → test-coverage-assistant/guide.md} +27 -24
- package/bundled/locales/zh-TW/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +6 -6
- package/bundled/locales/zh-TW/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +4 -4
- package/bundled/locales/zh-TW/skills/{cline → tools/cline}/README.md +1 -1
- package/bundled/locales/zh-TW/skills/{copilot → tools/copilot}/README.md +1 -1
- package/bundled/locales/zh-TW/skills/{copilot → tools/copilot}/copilot-instructions.md +1 -1
- package/bundled/locales/zh-TW/skills/{cursor → tools/cursor}/README.md +1 -1
- package/bundled/locales/zh-TW/skills/{windsurf → tools/windsurf}/README.md +1 -1
- package/bundled/skills/INTEGRATION-GUIDE.md +210 -0
- package/bundled/skills/README.md +95 -0
- package/bundled/skills/_shared/README.md +60 -0
- package/bundled/skills/{claude-code/agents → agents}/README.md +2 -2
- package/bundled/skills/{claude-code/agents → agents}/code-architect.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/doc-writer.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/reviewer.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/spec-analyst.md +1 -1
- package/bundled/skills/{claude-code/agents → agents}/test-specialist.md +1 -1
- package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md +28 -5
- package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md +24 -5
- package/bundled/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md +31 -6
- package/bundled/skills/ai-friendly-architecture/SKILL.md +216 -0
- package/bundled/skills/ai-instruction-standards/SKILL.md +209 -0
- package/bundled/skills/atdd-assistant/SKILL.md +74 -0
- package/bundled/skills/{claude-code/atdd-assistant → atdd-assistant}/acceptance-criteria-guide.md +1 -1
- package/bundled/skills/{claude-code/atdd-assistant → atdd-assistant}/atdd-workflow.md +1 -1
- package/bundled/skills/{claude-code/atdd-assistant/SKILL.md → atdd-assistant/guide.md} +11 -11
- package/bundled/skills/bdd-assistant/SKILL.md +70 -0
- package/bundled/skills/{claude-code/bdd-assistant → bdd-assistant}/bdd-workflow.md +1 -1
- package/bundled/skills/{claude-code/bdd-assistant → bdd-assistant}/gherkin-guide.md +1 -1
- package/bundled/skills/{claude-code/bdd-assistant/SKILL.md → bdd-assistant/guide.md} +11 -11
- package/bundled/skills/changelog-guide/SKILL.md +66 -0
- package/bundled/skills/{claude-code/changelog-guide/SKILL.md → changelog-guide/guide.md} +8 -6
- package/bundled/skills/checkin-assistant/SKILL.md +52 -0
- package/bundled/skills/{claude-code/checkin-assistant/SKILL.md → checkin-assistant/guide.md} +6 -6
- package/bundled/skills/code-review-assistant/SKILL.md +53 -0
- package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/checkin-checklist.md +3 -3
- package/bundled/skills/{claude-code/code-review-assistant/SKILL.md → code-review-assistant/guide.md} +7 -5
- package/bundled/skills/{claude-code/code-review-assistant → code-review-assistant}/review-checklist.md +3 -3
- package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +290 -0
- package/bundled/skills/{claude-code/commands → commands}/README.md +13 -3
- package/bundled/skills/{claude-code/commands → commands}/atdd.md +3 -3
- package/bundled/skills/{claude-code/commands → commands}/bdd.md +2 -2
- package/bundled/skills/commands/changelog.md +58 -0
- package/bundled/skills/{claude-code/commands → commands}/check.md +1 -1
- package/bundled/skills/commands/checkin.md +53 -0
- package/bundled/skills/{claude-code/commands → commands}/commit.md +3 -3
- package/bundled/skills/{claude-code/commands → commands}/config.md +1 -1
- package/bundled/skills/{claude-code/commands → commands}/coverage.md +5 -4
- package/bundled/skills/commands/derive-all.md +53 -0
- package/bundled/skills/commands/derive-atdd.md +49 -0
- package/bundled/skills/commands/derive-bdd.md +47 -0
- package/bundled/skills/commands/derive-tdd.md +48 -0
- package/bundled/skills/commands/derive.md +72 -0
- package/bundled/skills/commands/discover.md +80 -0
- package/bundled/skills/commands/docgen.md +61 -0
- package/bundled/skills/commands/docs.md +59 -0
- package/bundled/skills/commands/guide.md +44 -0
- package/bundled/skills/{claude-code/commands → commands}/init.md +2 -2
- package/bundled/skills/{claude-code/commands → commands}/methodology.md +32 -16
- package/bundled/skills/{claude-code/commands → commands}/refactor.md +2 -2
- package/bundled/skills/commands/release.md +56 -0
- package/bundled/skills/{claude-code/commands → commands}/requirement.md +3 -3
- package/bundled/skills/commands/reverse-bdd.md +47 -0
- package/bundled/skills/commands/reverse-sdd.md +51 -0
- package/bundled/skills/commands/reverse-tdd.md +51 -0
- package/bundled/skills/commands/reverse.md +63 -0
- package/bundled/skills/{claude-code/commands → commands}/review.md +3 -3
- package/bundled/skills/commands/sdd.md +135 -0
- package/bundled/skills/{claude-code/commands → commands}/tdd.md +3 -3
- package/bundled/skills/{claude-code/commands → commands}/update.md +2 -2
- package/bundled/skills/commit-standards/SKILL.md +60 -0
- package/bundled/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md +3 -3
- package/bundled/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} +17 -5
- package/bundled/skills/{claude-code/commit-standards → commit-standards}/language-options.md +2 -2
- package/bundled/skills/docs-generator/SKILL.md +69 -0
- package/bundled/skills/docs-generator/guide.md +258 -0
- package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md +7 -7
- package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md +3 -3
- package/bundled/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md +2 -2
- package/bundled/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md +7 -5
- package/bundled/skills/forward-derivation/SKILL.md +61 -0
- package/bundled/skills/{claude-code/forward-derivation/SKILL.md → forward-derivation/guide.md} +44 -29
- package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/SKILL.md +7 -5
- package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/branch-naming.md +2 -2
- package/bundled/skills/{claude-code/git-workflow-guide → git-workflow-guide}/git-workflow.md +3 -3
- package/bundled/skills/{claude-code/logging-guide → logging-guide}/SKILL.md +7 -5
- package/bundled/skills/methodology-system/SKILL.md +75 -0
- package/bundled/skills/{claude-code/methodology-system → methodology-system}/create-methodology.md +1 -1
- package/bundled/skills/{claude-code/methodology-system/SKILL.md → methodology-system/guide.md} +51 -16
- package/bundled/skills/methodology-system/integrated-flow.md +454 -0
- package/bundled/skills/{claude-code/methodology-system → methodology-system}/runtime.md +2 -2
- package/bundled/skills/project-discovery/SKILL.md +63 -0
- package/bundled/skills/project-discovery/guide.md +367 -0
- package/bundled/skills/project-discovery/workflow.md +566 -0
- package/bundled/skills/{claude-code/project-structure-guide → project-structure-guide}/SKILL.md +14 -4
- package/bundled/skills/refactoring-assistant/SKILL.md +78 -0
- package/bundled/skills/{claude-code/refactoring-assistant/SKILL.md → refactoring-assistant/guide.md} +7 -7
- package/bundled/skills/release-standards/SKILL.md +61 -0
- package/bundled/skills/{claude-code/release-standards → release-standards}/changelog-format.md +2 -2
- package/bundled/skills/{claude-code/release-standards/SKILL.md → release-standards/guide.md} +7 -5
- package/bundled/skills/{claude-code/release-standards → release-standards}/release-workflow.md +59 -24
- package/bundled/skills/{claude-code/release-standards → release-standards}/semantic-versioning.md +2 -2
- package/bundled/skills/requirement-assistant/SKILL.md +66 -0
- package/bundled/skills/{claude-code/requirement-assistant/SKILL.md → requirement-assistant/guide.md} +14 -6
- package/bundled/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-checklist.md +2 -2
- package/bundled/skills/{claude-code/requirement-assistant → requirement-assistant}/requirement-writing.md +2 -2
- package/bundled/skills/reverse-engineer/SKILL.md +64 -0
- package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/bdd-extraction.md +1 -1
- package/bundled/skills/{claude-code/reverse-engineer/SKILL.md → reverse-engineer/guide.md} +21 -18
- package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/tdd-analysis.md +1 -1
- package/bundled/skills/{claude-code/reverse-engineer → reverse-engineer}/workflow.md +2 -2
- package/bundled/skills/spec-driven-dev/SKILL.md +80 -0
- package/bundled/skills/{claude-code/spec-driven-dev/SKILL.md → spec-driven-dev/guide.md} +50 -8
- package/bundled/skills/tdd-assistant/SKILL.md +65 -0
- package/bundled/skills/{claude-code/tdd-assistant/SKILL.md → tdd-assistant/guide.md} +10 -10
- package/bundled/skills/{claude-code/tdd-assistant → tdd-assistant}/language-examples.md +3 -3
- package/bundled/skills/{claude-code/tdd-assistant → tdd-assistant}/tdd-workflow.md +2 -2
- package/bundled/skills/test-coverage-assistant/SKILL.md +63 -0
- package/bundled/skills/{claude-code/test-coverage-assistant/SKILL.md → test-coverage-assistant/guide.md} +39 -24
- package/bundled/skills/{claude-code/testing-guide → testing-guide}/SKILL.md +12 -7
- package/bundled/skills/{claude-code/testing-guide → testing-guide}/testing-pyramid.md +3 -3
- package/bundled/skills/testing-guide/testing-theory.md +2291 -0
- package/bundled/skills/tools/cline/.clinerules +79 -0
- package/bundled/skills/tools/cline/README.md +50 -0
- package/bundled/skills/tools/copilot/README.md +99 -0
- package/bundled/skills/tools/copilot/copilot-instructions.md +71 -0
- package/bundled/skills/tools/cursor/.cursorrules +101 -0
- package/bundled/skills/tools/cursor/README.md +50 -0
- package/bundled/skills/tools/windsurf/.windsurfrules +76 -0
- package/bundled/skills/tools/windsurf/README.md +51 -0
- package/bundled/skills/{claude-code/workflows → workflows}/README.md +1 -1
- package/bundled/skills/workflows/release.workflow.yaml +893 -0
- package/package.json +4 -1
- package/src/commands/check.js +195 -130
- package/src/commands/config.js +1262 -0
- package/src/commands/configure.js +3 -950
- package/src/commands/fix.js +53 -0
- package/src/commands/hitl.js +19 -0
- package/src/commands/init.js +320 -1030
- package/src/commands/list.js +1 -1
- package/src/commands/simulate.js +61 -0
- package/src/commands/spec.js +288 -0
- package/src/commands/start.js +373 -0
- package/src/commands/sweep.js +142 -0
- package/src/commands/update.js +136 -19
- package/src/commands/workflow.js +265 -1
- package/src/config/ai-agent-paths.js +89 -29
- package/src/core/constants.js +7 -1
- package/src/core/manifest.js +1 -0
- package/src/flows/init-flow.js +243 -0
- package/src/hitl/checkpoint.js +80 -0
- package/src/hitl/classifier.js +54 -0
- package/src/hitl/manager.js +88 -0
- package/src/i18n/messages.js +907 -99
- package/src/index.js +1 -0
- package/src/installers/integration-installer.js +237 -0
- package/src/installers/manifest-installer.js +131 -0
- package/src/installers/skills-installer.js +286 -0
- package/src/installers/standards-installer.js +193 -0
- package/src/missions/MissionManager.js +501 -0
- package/src/prompts/init.js +228 -130
- package/src/prompts/integrations.js +13 -1
- package/src/schemas/standard.schema.json +117 -0
- package/src/utils/agents-installer.js +2 -2
- package/src/utils/config-loader.js +47 -0
- package/src/utils/config-manager.js +108 -0
- package/src/utils/config-merger.js +47 -0
- package/src/utils/github.js +22 -18
- package/src/utils/inquirer-patch.js +98 -0
- package/src/utils/integration-generator.js +392 -58
- package/src/utils/reference-sync.js +69 -19
- package/src/utils/skills-installer.js +6 -3
- package/src/utils/standard-fixer.js +141 -0
- package/src/utils/standard-validator.js +329 -0
- package/src/utils/workflow-executor.js +886 -0
- package/src/utils/workflow-state.js +404 -0
- package/src/utils/workflows-installer.js +2 -2
- package/src/vibe/auto-sweep.js +349 -0
- package/src/vibe/micro-spec.js +428 -0
- package/standards-registry.json +278 -102
- package/bundled/locales/zh-CN/skills/claude-code/README.md +0 -174
- package/bundled/locales/zh-CN/skills/claude-code/test-coverage-assistant/SKILL.md +0 -282
- package/bundled/locales/zh-TW/skills/claude-code/README.md +0 -174
- package/bundled/skills/claude-code/README.md +0 -215
- package/bundled/skills/claude-code/commands/changelog.md +0 -57
- package/bundled/skills/claude-code/commands/derive-all.md +0 -214
- package/bundled/skills/claude-code/commands/derive-atdd.md +0 -177
- package/bundled/skills/claude-code/commands/derive-bdd.md +0 -158
- package/bundled/skills/claude-code/commands/derive-tdd.md +0 -259
- package/bundled/skills/claude-code/commands/docs.md +0 -75
- package/bundled/skills/claude-code/commands/release.md +0 -50
- package/bundled/skills/claude-code/commands/reverse-bdd.md +0 -264
- package/bundled/skills/claude-code/commands/reverse-spec.md +0 -185
- package/bundled/skills/claude-code/commands/reverse-tdd.md +0 -351
- package/bundled/skills/claude-code/commands/spec.md +0 -69
- package/bundled/skills/claude-code/methodology-system/integrated-flow.md +0 -322
- /package/bundled/skills/{claude-code/CONTRIBUTING.template.md → CONTRIBUTING.template.md} +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/checkin.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/commit.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/refactoring.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/ai → ai}/standards/testing.ai.yaml +0 -0
- /package/bundled/skills/{claude-code/project-structure-guide → project-structure-guide}/language-patterns.md +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/code-review.workflow.yaml +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/feature-dev.workflow.yaml +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/integrated-flow.workflow.yaml +0 -0
- /package/bundled/skills/{claude-code/workflows → workflows}/large-codebase-analysis.workflow.yaml +0 -0
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Requirement Engineering Standards
|
|
2
|
+
|
|
3
|
+
**Version**: 1.0.0
|
|
4
|
+
**Last Updated**: 2026-01-28
|
|
5
|
+
**Applicability**: All software projects
|
|
6
|
+
**Scope**: universal
|
|
7
|
+
**Industry Standards**: IEEE 830-1998, IEEE 29148-2018, SWEBOK v4.0
|
|
8
|
+
**References**: [computer.org](https://www.computer.org/education/bodies-of-knowledge/software-engineering/v4)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Summary
|
|
13
|
+
|
|
14
|
+
Requirements Engineering is the systematic process of eliciting, analyzing, specifying, and validating software requirements throughout the development lifecycle. It provides the theoretical foundation for writing, managing, and validating requirements based on industry standards including IEEE 830-1998, IEEE 29148-2018, SWEBOK v4.0, and ISO/IEC 25010.
|
|
15
|
+
|
|
16
|
+
The process encompasses Functional Requirements (what the system should DO), Non-Functional Requirements (quality attributes like performance, security, usability), and Constraints. User Stories (Agile format) with Acceptance Criteria (Given-When-Then) serve as the primary specification format, validated through INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable).
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
**Full Guide: [Requirement Engineering Guide](../methodologies/guides/requirement-engineering-guide.md)**
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Quick Reference
|
|
25
|
+
|
|
26
|
+
| Aspect | Description |
|
|
27
|
+
|--------|-------------|
|
|
28
|
+
| **Core Process** | Elicitation → Analysis → Specification → Validation |
|
|
29
|
+
| **Requirement Types** | Functional (FR), Non-Functional (NFR), Constraints |
|
|
30
|
+
| **Prioritization** | MoSCoW, P0-P3, Kano Model |
|
|
31
|
+
| **Quality Model** | ISO/IEC 25010 (8 characteristics) |
|
|
32
|
+
| **Standards** | IEEE 830, IEEE 29148, SWEBOK v4.0 |
|
|
33
|
+
|
|
34
|
+
## Related Standards
|
|
35
|
+
|
|
36
|
+
- [Spec-Driven Development](spec-driven-development.md)
|
|
37
|
+
- [Forward Derivation Standards](forward-derivation-standards.md)
|
|
38
|
+
- [Behavior-Driven Development](behavior-driven-development.md)
|
|
39
|
+
- [Testing Standards](testing-standards.md)
|
|
@@ -3,6 +3,8 @@
|
|
|
3
3
|
**Version**: 1.0.0
|
|
4
4
|
**Last Updated**: 2026-01-19
|
|
5
5
|
**Applicability**: All projects requiring code-to-specification transformation
|
|
6
|
+
**Scope**: uds-specific
|
|
7
|
+
**Industry Standards**: IEEE 830-1998, SWEBOK v4.0 Chapter 9
|
|
6
8
|
|
|
7
9
|
> **Language**: [English](../core/reverse-engineering-standards.md) | [繁體中文](../locales/zh-TW/core/reverse-engineering-standards.md)
|
|
8
10
|
|
|
@@ -359,10 +361,10 @@ Use reverse-engineered specifications to identify test coverage gaps:
|
|
|
359
361
|
|
|
360
362
|
### Skill References
|
|
361
363
|
|
|
362
|
-
- [Reverse Engineer Skill](../skills/
|
|
363
|
-
- [Spec-Driven Development Skill](../skills/
|
|
364
|
-
- [BDD Assistant Skill](../skills/
|
|
365
|
-
- [TDD Assistant Skill](../skills/
|
|
364
|
+
- [Reverse Engineer Skill](../skills/reverse-engineer/SKILL.md) - Detailed workflow implementation
|
|
365
|
+
- [Spec-Driven Development Skill](../skills/spec-driven-dev/SKILL.md) - SDD integration
|
|
366
|
+
- [BDD Assistant Skill](../skills/bdd-assistant/SKILL.md) - Gherkin formulation
|
|
367
|
+
- [TDD Assistant Skill](../skills/tdd-assistant/SKILL.md) - Test coverage analysis
|
|
366
368
|
|
|
367
369
|
---
|
|
368
370
|
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
# Security Standards
|
|
2
|
+
|
|
3
|
+
> **Language**: English | [繁體中文](../locales/zh-TW/core/security-standards.md)
|
|
4
|
+
|
|
5
|
+
**Version**: 1.1.0
|
|
6
|
+
**Last Updated**: 2026-01-29
|
|
7
|
+
**Applicability**: All software projects
|
|
8
|
+
**Scope**: universal
|
|
9
|
+
**Industry Standards**: OWASP Top 10 (2021), OWASP ASVS v4.0, NIST SP 800-53
|
|
10
|
+
**References**: [owasp.org](https://owasp.org/Top10/), [owasp.org](https://owasp.org/www-project-application-security-verification-standard/)
|
|
11
|
+
|
|
12
|
+
> **For detailed explanations and examples, see [Security Guide](guides/security-guide.md)**
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Purpose
|
|
17
|
+
|
|
18
|
+
This standard defines comprehensive security guidelines for software development, covering secure coding practices, vulnerability prevention, authentication/authorization, and security testing.
|
|
19
|
+
|
|
20
|
+
**Reference Standards**:
|
|
21
|
+
- [OWASP Top 10 (2021)](https://owasp.org/Top10/)
|
|
22
|
+
- [OWASP ASVS v4.0](https://owasp.org/www-project-application-security-verification-standard/)
|
|
23
|
+
- [NIST SP 800-53](https://csrc.nist.gov/publications/detail/sp/800-53/rev-5/final)
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Core Security Principles
|
|
28
|
+
|
|
29
|
+
| Principle | Implementation |
|
|
30
|
+
|-----------|----------------|
|
|
31
|
+
| **Least Privilege** | Role-based access, time-limited tokens |
|
|
32
|
+
| **Fail Securely** | Deny access on auth error, don't expose stack traces |
|
|
33
|
+
| **Separation of Duties** | Different roles for dev/deploy/admin |
|
|
34
|
+
| **Defense in Depth** | Don't rely on single control |
|
|
35
|
+
| **Security by Default** | Secure defaults, opt-in for less secure options |
|
|
36
|
+
| **Zero Trust** | Verify every request, assume breach |
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## OWASP Top 10 Prevention Checklist
|
|
41
|
+
|
|
42
|
+
| Vulnerability | Prevention |
|
|
43
|
+
|---------------|------------|
|
|
44
|
+
| **A01: Broken Access Control** | Deny by default, server-side checks, validate ownership |
|
|
45
|
+
| **A02: Cryptographic Failures** | Encrypt PII, use TLS 1.3, use secrets management |
|
|
46
|
+
| **A03: Injection** | Parameterized queries, validated input, use ORMs |
|
|
47
|
+
| **A04: Insecure Design** | Threat modeling, security requirements in specs |
|
|
48
|
+
| **A05: Security Misconfiguration** | Remove defaults, disable unused features, security headers |
|
|
49
|
+
| **A06: Vulnerable Components** | Maintain SBOM, scan with npm audit/Snyk, patch quickly |
|
|
50
|
+
| **A07: Auth Failures** | Strong passwords, MFA, secure sessions |
|
|
51
|
+
| **A08: Integrity Failures** | Code signing, verify checksums, secure CI/CD |
|
|
52
|
+
| **A09: Logging Failures** | Log security events, protect log integrity |
|
|
53
|
+
| **A10: SSRF** | Allowlist URLs, block internal IPs |
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Required Security Headers
|
|
58
|
+
|
|
59
|
+
```http
|
|
60
|
+
Content-Security-Policy: default-src 'self'; script-src 'self'
|
|
61
|
+
X-Content-Type-Options: nosniff
|
|
62
|
+
X-Frame-Options: DENY
|
|
63
|
+
Strict-Transport-Security: max-age=31536000; includeSubDomains
|
|
64
|
+
X-XSS-Protection: 0
|
|
65
|
+
Referrer-Policy: strict-origin-when-cross-origin
|
|
66
|
+
Permissions-Policy: geolocation=(), camera=(), microphone=()
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## Cryptography Requirements
|
|
72
|
+
|
|
73
|
+
### Algorithm Selection
|
|
74
|
+
|
|
75
|
+
| Purpose | Required | Avoid |
|
|
76
|
+
|---------|----------|-------|
|
|
77
|
+
| **Symmetric Encryption** | AES-256-GCM | DES, 3DES, AES-ECB |
|
|
78
|
+
| **Asymmetric Encryption** | RSA-2048+, ECDSA P-256+ | RSA-1024 |
|
|
79
|
+
| **Hashing** | SHA-256, SHA-3, BLAKE3 | MD5, SHA-1 |
|
|
80
|
+
| **Password Hashing** | Argon2id, bcrypt, scrypt | SHA-256, PBKDF2 |
|
|
81
|
+
| **TLS Version** | TLS 1.3, TLS 1.2 | TLS 1.0, TLS 1.1, SSL |
|
|
82
|
+
|
|
83
|
+
### Password Hashing Configuration
|
|
84
|
+
|
|
85
|
+
| Algorithm | Configuration |
|
|
86
|
+
|-----------|---------------|
|
|
87
|
+
| **Argon2id** | Memory: 64 MB, Iterations: 3, Parallelism: 4, Salt: 16 bytes |
|
|
88
|
+
| **bcrypt** | Cost factor ≥ 12 |
|
|
89
|
+
| **scrypt** | N=2^17, r=8, p=1 |
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Authentication Requirements
|
|
94
|
+
|
|
95
|
+
### Password Policy
|
|
96
|
+
|
|
97
|
+
| Requirement | Minimum | Recommended |
|
|
98
|
+
|-------------|---------|-------------|
|
|
99
|
+
| **Length** | 8 characters | 12+ characters |
|
|
100
|
+
| **Breached Password Check** | Required | HaveIBeenPwned API |
|
|
101
|
+
| **History** | Last 5 passwords | Last 10 passwords |
|
|
102
|
+
|
|
103
|
+
### Session Management
|
|
104
|
+
|
|
105
|
+
| Parameter | Recommended Value |
|
|
106
|
+
|-----------|-------------------|
|
|
107
|
+
| **Session ID Length** | ≥ 128 bits |
|
|
108
|
+
| **Session Timeout (idle)** | 15-30 minutes |
|
|
109
|
+
| **Session Timeout (absolute)** | 8-24 hours |
|
|
110
|
+
| **Cookie Flags** | `Secure; HttpOnly; SameSite=Strict` |
|
|
111
|
+
|
|
112
|
+
### MFA Requirements
|
|
113
|
+
|
|
114
|
+
- **Required for**: Admin access, sensitive operations, account recovery
|
|
115
|
+
- **Recommended for**: All user accounts
|
|
116
|
+
- **Preferred**: WebAuthn (phishing resistant)
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## Authorization Checklist
|
|
121
|
+
|
|
122
|
+
- [ ] Implement authorization on server-side (never trust client)
|
|
123
|
+
- [ ] Check permissions on every request
|
|
124
|
+
- [ ] Use deny by default
|
|
125
|
+
- [ ] Log authorization failures
|
|
126
|
+
- [ ] Implement rate limiting per user/role
|
|
127
|
+
- [ ] Review permissions periodically
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## Input Validation Rules
|
|
132
|
+
|
|
133
|
+
| Data Type | Validation |
|
|
134
|
+
|-----------|------------|
|
|
135
|
+
| **Email** | RFC 5322 regex + domain check |
|
|
136
|
+
| **URL** | Protocol allowlist, no internal IPs |
|
|
137
|
+
| **Phone** | E.164 format |
|
|
138
|
+
| **Date** | ISO 8601, reasonable range |
|
|
139
|
+
| **Integer** | Type check, min/max bounds |
|
|
140
|
+
| **String** | Length limits, character allowlist |
|
|
141
|
+
| **File** | Type, size, magic bytes |
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## API Security Requirements
|
|
146
|
+
|
|
147
|
+
### Rate Limiting
|
|
148
|
+
|
|
149
|
+
| Endpoint Type | Limit | Window |
|
|
150
|
+
|---------------|-------|--------|
|
|
151
|
+
| **Login** | 5 attempts | 15 minutes |
|
|
152
|
+
| **API (authenticated)** | 1000 requests | 1 hour |
|
|
153
|
+
| **API (unauthenticated)** | 100 requests | 1 hour |
|
|
154
|
+
| **Password reset** | 3 requests | 1 hour |
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## Security Testing Requirements
|
|
159
|
+
|
|
160
|
+
| Test Type | Frequency | Purpose |
|
|
161
|
+
|-----------|-----------|---------|
|
|
162
|
+
| **SAST** | Every commit | Find vulnerabilities in source code |
|
|
163
|
+
| **DAST** | Weekly/Release | Test running application |
|
|
164
|
+
| **SCA** | Daily | Check dependency vulnerabilities |
|
|
165
|
+
| **Penetration Testing** | Quarterly/Annually | Manual security testing |
|
|
166
|
+
| **Security Code Review** | Critical changes | Manual code review |
|
|
167
|
+
|
|
168
|
+
### Recommended Tools
|
|
169
|
+
|
|
170
|
+
| Category | Tools |
|
|
171
|
+
|----------|-------|
|
|
172
|
+
| **SAST** | SonarQube, Semgrep, CodeQL |
|
|
173
|
+
| **DAST** | OWASP ZAP, Burp Suite |
|
|
174
|
+
| **SCA** | Snyk, npm audit, Dependabot |
|
|
175
|
+
| **Secrets Scanning** | GitLeaks, TruffleHog |
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## Incident Response Severity
|
|
180
|
+
|
|
181
|
+
| Level | Description | Response Time |
|
|
182
|
+
|-------|-------------|---------------|
|
|
183
|
+
| **P1 Critical** | Active breach, data exfiltration | < 15 min |
|
|
184
|
+
| **P2 High** | Vulnerability exploited, no data loss | < 1 hour |
|
|
185
|
+
| **P3 Medium** | Vulnerability discovered, not exploited | < 24 hours |
|
|
186
|
+
| **P4 Low** | Minor security issue | < 1 week |
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
## Pre-Deployment Security Checklist
|
|
191
|
+
|
|
192
|
+
### Authentication & Authorization
|
|
193
|
+
- [ ] Passwords hashed with Argon2id/bcrypt
|
|
194
|
+
- [ ] MFA available for all users
|
|
195
|
+
- [ ] Session management secure (HttpOnly, Secure, SameSite)
|
|
196
|
+
- [ ] Authorization checked server-side on every request
|
|
197
|
+
|
|
198
|
+
### Input/Output
|
|
199
|
+
- [ ] All input validated server-side
|
|
200
|
+
- [ ] Output encoded for context (HTML, JS, URL)
|
|
201
|
+
- [ ] Parameterized queries for all database operations
|
|
202
|
+
- [ ] File uploads validated (type, size, content)
|
|
203
|
+
|
|
204
|
+
### Cryptography
|
|
205
|
+
- [ ] TLS 1.2+ enforced everywhere
|
|
206
|
+
- [ ] Strong algorithms used (AES-256, RSA-2048+)
|
|
207
|
+
- [ ] No secrets in code or version control
|
|
208
|
+
- [ ] Keys stored in secrets manager
|
|
209
|
+
|
|
210
|
+
### Configuration
|
|
211
|
+
- [ ] Security headers configured
|
|
212
|
+
- [ ] CORS restricted to allowed origins
|
|
213
|
+
- [ ] Debug mode disabled in production
|
|
214
|
+
- [ ] Default credentials changed
|
|
215
|
+
|
|
216
|
+
### Monitoring
|
|
217
|
+
- [ ] Security events logged
|
|
218
|
+
- [ ] Alerts configured for suspicious activity
|
|
219
|
+
- [ ] Incident response plan documented
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## Related Standards
|
|
224
|
+
|
|
225
|
+
- [Code Review Checklist](code-review-checklist.md) - Security review section
|
|
226
|
+
- [Testing Standards](testing-standards.md) - Security testing integration
|
|
227
|
+
- [Logging Standards](logging-standards.md) - Security logging
|
|
228
|
+
- [Error Code Standards](error-code-standards.md) - AUTH error codes
|
|
229
|
+
- [Deployment Standards](deployment-standards.md) - Pre-deployment security checklist
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
## Version History
|
|
234
|
+
|
|
235
|
+
| Version | Date | Changes |
|
|
236
|
+
|---------|------|---------|
|
|
237
|
+
| 1.1.0 | 2026-01-29 | Refactored: Split into Rules + Guide, moved explanations to guide |
|
|
238
|
+
| 1.0.0 | 2026-01-29 | Initial release |
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
## License
|
|
243
|
+
|
|
244
|
+
This standard is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
|
|
@@ -1,338 +1,39 @@
|
|
|
1
1
|
# Spec-Driven Development (SDD) Standards
|
|
2
2
|
|
|
3
|
-
**Version**: 1.
|
|
4
|
-
**Last Updated**: 2026-01-
|
|
3
|
+
**Version**: 2.1.0
|
|
4
|
+
**Last Updated**: 2026-01-26
|
|
5
5
|
**Applicability**: All projects adopting Spec-Driven Development
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## Purpose
|
|
12
|
-
|
|
13
|
-
This standard defines the principles and workflows for Spec-Driven Development (SDD), ensuring that changes are planned, documented, and approved via specifications before implementation.
|
|
14
|
-
|
|
15
|
-
**Key Benefits**:
|
|
16
|
-
- Reduced miscommunication between stakeholders and developers
|
|
17
|
-
- Clear audit trail for all changes
|
|
18
|
-
- Easier onboarding for new team members
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## SDD Workflow
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
|
26
|
-
│ Proposal │───▶│ Review │───▶│Implementation│
|
|
27
|
-
└──────────────┘ └──────────────┘ └──────────────┘
|
|
28
|
-
│
|
|
29
|
-
▼
|
|
30
|
-
┌──────────────┐ ┌──────────────┐
|
|
31
|
-
│ Archive │◀───│ Verification │
|
|
32
|
-
└──────────────┘ └──────────────┘
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
### Workflow Stages
|
|
36
|
-
|
|
37
|
-
| Stage | Description | Artifacts |
|
|
38
|
-
|-------|-------------|-----------|
|
|
39
|
-
| **Proposal** | Define what to change and why | `proposal.md` |
|
|
40
|
-
| **Review** | Stakeholder approval | Review comments, approval record |
|
|
41
|
-
| **Implementation** | Execute the approved spec | Code, tests, docs |
|
|
42
|
-
| **Verification** | Confirm implementation matches spec | Test results, review |
|
|
43
|
-
| **Archive** | Close and archive the spec | Archived spec with links to commits/PRs |
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
47
|
-
## Core Principles
|
|
48
|
-
|
|
49
|
-
### 1. Priority of SDD Tool Commands
|
|
50
|
-
|
|
51
|
-
**Rule**: When an SDD tool (such as OpenSpec, Spec Kit, etc.) is integrated and provides specific commands (e.g., slash commands like `/openspec` or `/spec`), AI assistants MUST prioritize using these commands over manual file editing.
|
|
52
|
-
|
|
53
|
-
**Rationale**:
|
|
54
|
-
- **Consistency**: Tools ensure the spec structure follows strict schemas.
|
|
55
|
-
- **Traceability**: Commands often handle logging, IDs, and linking automatically.
|
|
56
|
-
- **Safety**: Tools may have built-in validation preventing invalid states.
|
|
57
|
-
|
|
58
|
-
**Example**:
|
|
59
|
-
- ✅ Use `/openspec proposal "Add Login"` instead of manually creating `changes/add-login/proposal.md`.
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
63
|
-
### 2. Methodology Over Tooling
|
|
64
|
-
|
|
65
|
-
**Rule**: SDD is a methodology, not bound to a single tool. While OpenSpec is a common implementation, these standards apply to any SDD tool (e.g., Spec Kit).
|
|
66
|
-
|
|
67
|
-
**Guidelines**:
|
|
68
|
-
- **Universal Flow**: Proposal -> Review -> Implementation -> Verification -> Archive.
|
|
69
|
-
- **Tool Adaptation**: Adapt to the specific commands and patterns of the active SDD tool in the workspace.
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
73
|
-
### 3. Spec First, Code Second
|
|
74
|
-
|
|
75
|
-
**Rule**: No functional code changes shall be made without a corresponding approved specification or change proposal.
|
|
76
|
-
|
|
77
|
-
**Exceptions**:
|
|
78
|
-
- Critical hotfixes (restore service immediately, document later).
|
|
79
|
-
- Trivial changes (typos, comments, formatting).
|
|
6
|
+
**Scope**: universal
|
|
7
|
+
**Industry Standards**: None (Emerging 2025+ methodology)
|
|
8
|
+
**References**: [specmatic.io](https://specmatic.io/)
|
|
80
9
|
|
|
81
10
|
---
|
|
82
11
|
|
|
83
|
-
## Spec Document Template
|
|
84
|
-
|
|
85
|
-
### Proposal Template
|
|
86
|
-
|
|
87
|
-
```markdown
|
|
88
|
-
# [SPEC-ID] Feature Title
|
|
89
|
-
|
|
90
12
|
## Summary
|
|
91
|
-
Brief description of the proposed change.
|
|
92
|
-
|
|
93
|
-
## Motivation
|
|
94
|
-
Why is this change needed? What problem does it solve?
|
|
95
|
-
|
|
96
|
-
## Detailed Design
|
|
97
|
-
Technical approach, affected components, data flow.
|
|
98
|
-
|
|
99
|
-
## Acceptance Criteria
|
|
100
|
-
- [ ] Criterion 1
|
|
101
|
-
- [ ] Criterion 2
|
|
102
|
-
|
|
103
|
-
## Dependencies
|
|
104
|
-
List any dependencies on other specs or external systems.
|
|
105
|
-
|
|
106
|
-
## Risks
|
|
107
|
-
Potential risks and mitigation strategies.
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
---
|
|
111
|
-
|
|
112
|
-
## Integration with Other Standards
|
|
113
|
-
|
|
114
|
-
### With Commit Message Guide
|
|
115
|
-
|
|
116
|
-
When implementing an approved spec, reference the spec ID in commit messages:
|
|
117
|
-
|
|
118
|
-
```
|
|
119
|
-
feat(auth): implement login feature
|
|
120
|
-
|
|
121
|
-
Implements SPEC-001 login functionality with OAuth2 support.
|
|
122
|
-
|
|
123
|
-
Refs: SPEC-001
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
### With Check-in Standards
|
|
127
13
|
|
|
128
|
-
|
|
14
|
+
Spec-Driven Development (SDD) is an AI-era methodology (2025+) distinct from traditional TDD/BDD/ATDD. It ensures that changes are planned, documented, and approved via specifications before implementation. The core principle is **"Spec First, Code Second"** - no functional code changes without a corresponding approved specification.
|
|
129
15
|
|
|
130
|
-
|
|
131
|
-
2. ✅ Implementation matches spec
|
|
132
|
-
3. ✅ Tests cover acceptance criteria
|
|
133
|
-
4. ✅ Spec ID referenced in PR
|
|
134
|
-
|
|
135
|
-
### With Code Review Checklist
|
|
136
|
-
|
|
137
|
-
Reviewers should verify:
|
|
138
|
-
|
|
139
|
-
- [ ] Change matches approved spec
|
|
140
|
-
- [ ] No scope creep beyond spec
|
|
141
|
-
- [ ] Spec acceptance criteria met
|
|
142
|
-
|
|
143
|
-
---
|
|
144
|
-
|
|
145
|
-
## Common SDD Tools
|
|
146
|
-
|
|
147
|
-
| Tool | Description | Command Examples |
|
|
148
|
-
|------|-------------|------------------|
|
|
149
|
-
| **OpenSpec** | Specification management | `/openspec proposal`, `/openspec approve` |
|
|
150
|
-
| **Spec Kit** | Lightweight spec tracking | `/spec create`, `/spec close` |
|
|
151
|
-
| **Manual** | No tool, file-based | Create `specs/SPEC-XXX.md` manually |
|
|
16
|
+
SDD operates at different maturity levels: Spec-first (discard after completion), Spec-anchored (maintain throughout evolution), and Spec-as-source (spec is only source, code auto-generated). The methodology uses Forward Derivation to generate test artifacts (BDD scenarios, TDD skeletons, contracts) from specifications.
|
|
152
17
|
|
|
153
18
|
---
|
|
154
19
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
### Do's
|
|
158
|
-
|
|
159
|
-
- ✅ Keep specs focused and atomic (one change per spec)
|
|
160
|
-
- ✅ Include clear acceptance criteria
|
|
161
|
-
- ✅ Link specs to implementation PRs
|
|
162
|
-
- ✅ Archive specs after completion
|
|
163
|
-
|
|
164
|
-
### Don'ts
|
|
165
|
-
|
|
166
|
-
- ❌ Start coding before spec approval
|
|
167
|
-
- ❌ Modify scope during implementation without updating spec
|
|
168
|
-
- ❌ Leave specs in limbo (always close or archive)
|
|
169
|
-
- ❌ Skip verification step
|
|
170
|
-
|
|
171
|
-
---
|
|
172
|
-
|
|
173
|
-
## Integration with Reverse Engineering
|
|
174
|
-
|
|
175
|
-
### Overview
|
|
176
|
-
|
|
177
|
-
For existing codebases without specifications, use [Reverse Engineering Standards](reverse-engineering-standards.md) to generate SDD-compatible proposal drafts.
|
|
178
|
-
|
|
179
|
-
### Reverse Engineering → SDD Pipeline
|
|
180
|
-
|
|
181
|
-
```
|
|
182
|
-
┌─────────────────────────────────────────────────────────────────────────┐
|
|
183
|
-
│ Reverse Engineering → SDD Pipeline │
|
|
184
|
-
├─────────────────────────────────────────────────────────────────────────┤
|
|
185
|
-
│ │
|
|
186
|
-
│ Existing Code │
|
|
187
|
-
│ │ │
|
|
188
|
-
│ ▼ │
|
|
189
|
-
│ ┌────────────────────────────────────────────────────────────┐ │
|
|
190
|
-
│ │ /reverse-spec │ │
|
|
191
|
-
│ │ • Code scanning → Technical inventory [Confirmed] │ │
|
|
192
|
-
│ │ • Test analysis → Acceptance criteria [Confirmed/Inferred]│ │
|
|
193
|
-
│ │ • Gap identification → [Unknown] items │ │
|
|
194
|
-
│ └────────────────────────────────────────────────────────────┘ │
|
|
195
|
-
│ │ │
|
|
196
|
-
│ ▼ │
|
|
197
|
-
│ DRAFT SPEC (Reverse-Engineered) │
|
|
198
|
-
│ │ │
|
|
199
|
-
│ ▼ │
|
|
200
|
-
│ ┌────────────────────────────────────────────────────────────┐ │
|
|
201
|
-
│ │ SDD Review Process │ │
|
|
202
|
-
│ │ • Human fills [Unknown] sections (motivation, risks) │ │
|
|
203
|
-
│ │ • Stakeholder validation of [Inferred] items │ │
|
|
204
|
-
│ │ • Formal approval │ │
|
|
205
|
-
│ └────────────────────────────────────────────────────────────┘ │
|
|
206
|
-
│ │ │
|
|
207
|
-
│ ▼ │
|
|
208
|
-
│ APPROVED SPEC → Normal SDD workflow continues │
|
|
209
|
-
│ │
|
|
210
|
-
└─────────────────────────────────────────────────────────────────────────┘
|
|
211
|
-
```
|
|
212
|
-
|
|
213
|
-
### Requirements for Reverse-Engineered Specs
|
|
214
|
-
|
|
215
|
-
When a specification is generated via reverse engineering:
|
|
216
|
-
|
|
217
|
-
1. **Mark Status**: Include `Status: Draft (Reverse-Engineered)` in metadata
|
|
218
|
-
2. **Fill Unknowns**: All `[Unknown]` sections MUST be filled by humans before approval
|
|
219
|
-
3. **Validate Inferences**: All `[Inferred]` items must be reviewed and confirmed
|
|
220
|
-
4. **Standard Review**: Follow normal SDD review process before implementation
|
|
221
|
-
5. **Source Citations**: Maintain file:line references for traceability
|
|
222
|
-
|
|
223
|
-
### When to Use Reverse Engineering
|
|
224
|
-
|
|
225
|
-
| Scenario | Approach |
|
|
226
|
-
|----------|----------|
|
|
227
|
-
| Legacy system modernization | Start with reverse engineering |
|
|
228
|
-
| Documenting undocumented code | Generate specs from code |
|
|
229
|
-
| New team onboarding | Extract specifications for knowledge transfer |
|
|
230
|
-
| Pre-refactoring documentation | Create specs before major changes |
|
|
231
|
-
|
|
232
|
-
### Related Commands
|
|
233
|
-
|
|
234
|
-
| Command | Purpose |
|
|
235
|
-
|---------|---------|
|
|
236
|
-
| `/reverse-spec` | Generate SDD specification from existing code |
|
|
237
|
-
| `/reverse-bdd` | Convert acceptance criteria to Gherkin scenarios |
|
|
238
|
-
| `/reverse-tdd` | Analyze test coverage against BDD scenarios |
|
|
20
|
+
**Full Guide: [SDD Guide](../methodologies/guides/sdd-guide.md)**
|
|
239
21
|
|
|
240
22
|
---
|
|
241
23
|
|
|
242
|
-
##
|
|
243
|
-
|
|
244
|
-
### Overview
|
|
245
|
-
|
|
246
|
-
After a specification is approved, use [Forward Derivation Standards](forward-derivation-standards.md) to automatically generate BDD scenarios, TDD test skeletons, and ATDD acceptance tests from the Acceptance Criteria.
|
|
247
|
-
|
|
248
|
-
### Forward Derivation → SDD Pipeline
|
|
249
|
-
|
|
250
|
-
```
|
|
251
|
-
┌─────────────────────────────────────────────────────────────────────────┐
|
|
252
|
-
│ Approved Spec → Forward Derivation Pipeline │
|
|
253
|
-
├─────────────────────────────────────────────────────────────────────────┤
|
|
254
|
-
│ │
|
|
255
|
-
│ APPROVED SPEC-XXX.md │
|
|
256
|
-
│ │ │
|
|
257
|
-
│ ▼ │
|
|
258
|
-
│ ┌────────────────────────────────────────────────────────────┐ │
|
|
259
|
-
│ │ /derive-all specs/SPEC-XXX.md │ │
|
|
260
|
-
│ │ • Parse Acceptance Criteria │ │
|
|
261
|
-
│ │ • Transform AC → Gherkin scenarios [Generated] │ │
|
|
262
|
-
│ │ • Generate TDD test skeletons [Generated] │ │
|
|
263
|
-
│ │ • Create ATDD acceptance tables [Generated] │ │
|
|
264
|
-
│ └────────────────────────────────────────────────────────────┘ │
|
|
265
|
-
│ │ │
|
|
266
|
-
│ ▼ │
|
|
267
|
-
│ OUTPUT FILES │
|
|
268
|
-
│ ├── features/SPEC-XXX.feature (BDD) │
|
|
269
|
-
│ ├── tests/SPEC-XXX.test.ts (TDD) │
|
|
270
|
-
│ └── acceptance/SPEC-XXX-acceptance.md (ATDD) │
|
|
271
|
-
│ │ │
|
|
272
|
-
│ ▼ │
|
|
273
|
-
│ HUMAN REVIEW → BDD/TDD workflow continues │
|
|
274
|
-
│ │
|
|
275
|
-
└─────────────────────────────────────────────────────────────────────────┘
|
|
276
|
-
```
|
|
24
|
+
## Quick Reference
|
|
277
25
|
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
|
281
|
-
|
|
282
|
-
|
|
|
283
|
-
|
|
|
284
|
-
|
|
|
285
|
-
| Manual acceptance testing | Use `/derive-atdd` for test tables |
|
|
286
|
-
|
|
287
|
-
### Related Commands
|
|
288
|
-
|
|
289
|
-
| Command | Input | Output | Purpose |
|
|
290
|
-
|---------|-------|--------|---------|
|
|
291
|
-
| `/derive-bdd` | SPEC-XXX.md | .feature | AC → Gherkin scenarios |
|
|
292
|
-
| `/derive-tdd` | SPEC-XXX.md | .test.ts | AC → Test skeletons |
|
|
293
|
-
| `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → Test tables |
|
|
294
|
-
| `/derive-all` | SPEC-XXX.md | All above | Full derivation pipeline |
|
|
295
|
-
|
|
296
|
-
---
|
|
26
|
+
| Aspect | Description |
|
|
27
|
+
|--------|-------------|
|
|
28
|
+
| **Core Workflow** | Proposal → Review → Implementation → Verification → Archive |
|
|
29
|
+
| **Key Principle** | Spec First, Code Second |
|
|
30
|
+
| **Test Generation** | Forward Derivation (/derive-bdd, /derive-tdd, /derive-all) |
|
|
31
|
+
| **Maturity Levels** | Spec-first, Spec-anchored, Spec-as-source |
|
|
32
|
+
| **Tools** | OpenSpec, Spec Kit, Manual (file-based) |
|
|
297
33
|
|
|
298
34
|
## Related Standards
|
|
299
35
|
|
|
300
|
-
- [Forward Derivation Standards](forward-derivation-standards.md)
|
|
301
|
-
- [Reverse Engineering Standards](reverse-engineering-standards.md)
|
|
302
|
-
- [Test-Driven Development](test-driven-development.md)
|
|
303
|
-
- [Behavior-Driven Development](behavior-driven-development.md)
|
|
304
|
-
- [Acceptance Test-Driven Development](acceptance-test-driven-development.md) - ATDD workflow for business acceptance
|
|
305
|
-
- [Testing Standards](testing-standards.md) - Testing framework and best practices (or use `/testing-guide` skill)
|
|
306
|
-
- [Test Completeness Dimensions](test-completeness-dimensions.md) - 7-dimension test coverage
|
|
307
|
-
- [Commit Message Guide](commit-message-guide.md) - Commit message conventions
|
|
308
|
-
- [Code Check-in Standards](checkin-standards.md) - Code check-in requirements
|
|
309
|
-
- [Code Review Checklist](code-review-checklist.md) - Code review guidelines
|
|
310
|
-
- [Documentation Structure](documentation-structure.md) - Documentation structure standards
|
|
311
|
-
|
|
312
|
-
---
|
|
313
|
-
|
|
314
|
-
## Version History
|
|
315
|
-
|
|
316
|
-
| Version | Date | Changes |
|
|
317
|
-
|---------|------|---------|
|
|
318
|
-
| 1.4.0 | 2026-01-19 | Added: Integration with Forward Derivation section, derive commands |
|
|
319
|
-
| 1.3.0 | 2026-01-19 | Added: Integration with Reverse Engineering section, related commands |
|
|
320
|
-
| 1.2.0 | 2026-01-05 | Added: IEEE 830-1998 and SWEBOK v4.0 Chapter 1 (Software Requirements) to References |
|
|
321
|
-
| 1.1.0 | 2025-12-24 | Added: Workflow diagram, Spec template, Integration guide, Best practices, Related standards, License |
|
|
322
|
-
| 1.0.0 | 2025-12-23 | Initial SDD standard definition |
|
|
323
|
-
|
|
324
|
-
---
|
|
325
|
-
|
|
326
|
-
## References
|
|
327
|
-
|
|
328
|
-
- [OpenSpec Documentation](https://github.com/openspec)
|
|
329
|
-
- [Design Documents Best Practices](https://www.industrialempathy.com/posts/design-docs-at-google/)
|
|
330
|
-
- [ADR (Architecture Decision Records)](https://adr.github.io/)
|
|
331
|
-
- [IEEE 830-1998 - Software Requirements Specifications](https://standards.ieee.org/ieee/830/1222/) - Requirements documentation standard
|
|
332
|
-
- [SWEBOK v4.0 - Chapter 1: Software Requirements](https://www.computer.org/education/bodies-of-knowledge/software-engineering) - IEEE Computer Society
|
|
333
|
-
|
|
334
|
-
---
|
|
335
|
-
|
|
336
|
-
## License
|
|
337
|
-
|
|
338
|
-
This standard is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
|
|
36
|
+
- [Forward Derivation Standards](forward-derivation-standards.md)
|
|
37
|
+
- [Reverse Engineering Standards](reverse-engineering-standards.md)
|
|
38
|
+
- [Test-Driven Development](test-driven-development.md)
|
|
39
|
+
- [Behavior-Driven Development](behavior-driven-development.md)
|