universal-dev-standards 3.0.0

package/standards-registry.json

@@ -0,0 +1,658 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "version": "3.0.0",
+  "lastUpdated": "2025-12-30",
+  "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
+  "formats": {
+    "ai": {
+      "name": "AI-Optimized",
+      "description": "Token-optimized YAML format for AI assistants",
+      "extension": ".ai.yaml",
+      "basePath": "ai/"
+    },
+    "human": {
+      "name": "Human-Readable",
+      "description": "Full Markdown format for human readers",
+      "extension": ".md",
+      "basePath": "core/"
+    }
+  },
+  "optionCategories": {
+    "workflow": {
+      "name": "Branching Strategy",
+      "nameZh": "分支策略",
+      "appliesTo": ["git-workflow"]
+    },
+    "merge_strategy": {
+      "name": "Merge Strategy",
+      "nameZh": "合併策略",
+      "appliesTo": ["git-workflow"]
+    },
+    "commit_language": {
+      "name": "Commit Message Language",
+      "nameZh": "提交訊息語言",
+      "appliesTo": ["commit-message"]
+    },
+    "test_level": {
+      "name": "Test Level",
+      "nameZh": "測試層級",
+      "appliesTo": ["testing"]
+    },
+    "project_language": {
+      "name": "Project Language",
+      "nameZh": "專案語言",
+      "appliesTo": ["project-structure"]
+    }
+  },
+  "repositories": {
+    "standards": {
+      "name": "universal-dev-standards",
+      "url": "https://github.com/AsiaOstrich/universal-dev-standards",
+      "version": "3.0.0"
+    },
+    "skills": {
+      "name": "universal-dev-standards",
+      "url": "https://github.com/AsiaOstrich/universal-dev-standards",
+      "localPath": "skills/claude-code",
+      "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code",
+      "version": "3.0.0",
+      "note": "Skills are now included in the main repository under skills/"
+    }
+  },
+  "supportedAITools": {
+    "claude-code": {
+      "name": "Claude Code",
+      "skillsPath": "skills/claude-code",
+      "status": "complete"
+    },
+    "cursor": {
+      "name": "Cursor",
+      "skillsPath": "skills/cursor",
+      "status": "planned"
+    },
+    "windsurf": {
+      "name": "Windsurf",
+      "skillsPath": "skills/windsurf",
+      "status": "planned"
+    },
+    "cline": {
+      "name": "Cline",
+      "skillsPath": "skills/cline",
+      "status": "planned"
+    },
+    "copilot": {
+      "name": "GitHub Copilot",
+      "skillsPath": "skills/copilot",
+      "status": "planned"
+    }
+  },
+  "skillFiles": {
+    "ai-collaboration-standards": [
+      "skills/claude-code/ai-collaboration-standards/SKILL.md",
+      "skills/claude-code/ai-collaboration-standards/anti-hallucination.md",
+      "skills/claude-code/ai-collaboration-standards/certainty-labels.md"
+    ],
+    "commit-standards": [
+      "skills/claude-code/commit-standards/SKILL.md",
+      "skills/claude-code/commit-standards/conventional-commits.md",
+      "skills/claude-code/commit-standards/language-options.md"
+    ],
+    "code-review-assistant": [
+      "skills/claude-code/code-review-assistant/SKILL.md",
+      "skills/claude-code/code-review-assistant/checkin-checklist.md",
+      "skills/claude-code/code-review-assistant/review-checklist.md"
+    ],
+    "testing-guide": [
+      "skills/claude-code/testing-guide/SKILL.md",
+      "skills/claude-code/testing-guide/testing-pyramid.md"
+    ],
+    "release-standards": [
+      "skills/claude-code/release-standards/SKILL.md",
+      "skills/claude-code/release-standards/changelog-format.md",
+      "skills/claude-code/release-standards/semantic-versioning.md"
+    ],
+    "git-workflow-guide": [
+      "skills/claude-code/git-workflow-guide/SKILL.md",
+      "skills/claude-code/git-workflow-guide/branch-naming.md",
+      "skills/claude-code/git-workflow-guide/git-workflow.md"
+    ],
+    "documentation-guide": [
+      "skills/claude-code/documentation-guide/SKILL.md",
+      "skills/claude-code/documentation-guide/documentation-structure.md",
+      "skills/claude-code/documentation-guide/readme-template.md"
+    ],
+    "requirement-assistant": [
+      "skills/claude-code/requirement-assistant/SKILL.md",
+      "skills/claude-code/requirement-assistant/requirement-checklist.md",
+      "skills/claude-code/requirement-assistant/requirement-writing.md"
+    ],
+    "project-structure-guide": [
+      "skills/claude-code/project-structure-guide/SKILL.md",
+      "skills/claude-code/project-structure-guide/language-patterns.md"
+    ],
+    "spec-driven-dev": [
+      "skills/claude-code/spec-driven-dev/SKILL.md"
+    ],
+    "test-coverage-assistant": [
+      "skills/claude-code/test-coverage-assistant/SKILL.md"
+    ],
+    "changelog-guide": [
+      "skills/claude-code/changelog-guide/SKILL.md"
+    ],
+    "error-code-guide": [
+      "skills/claude-code/error-code-guide/SKILL.md"
+    ],
+    "logging-guide": [
+      "skills/claude-code/logging-guide/SKILL.md"
+    ]
+  },
+  "categories": {
+    "skill": {
+      "name": "Skill",
+      "description": "Standards implemented as Claude Code Skills. Install the skill for interactive AI assistance.",
+      "adoptionMethod": "Install via universal-dev-skills"
+    },
+    "reference": {
+      "name": "Reference Document",
+      "description": "Static reference documents not suitable for Skills conversion. Copy to project's .standards/ directory.",
+      "adoptionMethod": "Copy to project"
+    },
+    "extension": {
+      "name": "Extension",
+      "description": "Language, framework, or locale-specific standards. Apply based on project requirements.",
+      "adoptionMethod": "Copy if applicable"
+    },
+    "integration": {
+      "name": "Integration",
+      "description": "AI tool configuration files. Copy to tool's expected location.",
+      "adoptionMethod": "Copy to tool location"
+    },
+    "template": {
+      "name": "Template",
+      "description": "Document templates for specific purposes. Use as starting point for project documents.",
+      "adoptionMethod": "Copy and customize"
+    }
+  },
+  "adoptionLevels": {
+    "1": {
+      "name": "Essential",
+      "nameZh": "基本",
+      "description": "Minimum viable standards for any project",
+      "setupTime": "30 minutes"
+    },
+    "2": {
+      "name": "Recommended",
+      "nameZh": "推薦",
+      "description": "Professional quality standards for team projects",
+      "setupTime": "2 hours"
+    },
+    "3": {
+      "name": "Enterprise",
+      "nameZh": "企業",
+      "description": "Comprehensive standards for enterprise or regulated projects",
+      "setupTime": "1-2 days"
+    }
+  },
+  "standards": [
+    {
+      "id": "anti-hallucination",
+      "name": "Anti-Hallucination Guidelines",
+      "nameZh": "反幻覺指南",
+      "source": "core/anti-hallucination.md",
+      "category": "skill",
+      "skillName": "ai-collaboration-standards",
+      "level": 1,
+      "description": "Guidelines for AI collaboration to prevent hallucination and ensure evidence-based responses"
+    },
+    {
+      "id": "commit-message",
+      "name": "Commit Message Guide",
+      "nameZh": "提交訊息指南",
+      "source": {
+        "human": "core/commit-message-guide.md",
+        "ai": "ai/standards/commit-message.ai.yaml"
+      },
+      "category": "skill",
+      "skillName": "commit-standards",
+      "level": 1,
+      "description": "Conventional Commits format for standardized git commit messages",
+      "options": {
+        "commit_language": {
+          "default": "english",
+          "choices": [
+            {
+              "id": "english",
+              "name": "English",
+              "nameZh": "英文",
+              "source": {
+                "human": "options/commit-message/english.md",
+                "ai": "ai/options/commit-message/english.ai.yaml"
+              }
+            },
+            {
+              "id": "traditional-chinese",
+              "name": "Traditional Chinese",
+              "nameZh": "繁體中文",
+              "source": {
+                "human": "options/commit-message/traditional-chinese.md",
+                "ai": "ai/options/commit-message/traditional-chinese.ai.yaml"
+              }
+            },
+            {
+              "id": "bilingual",
+              "name": "Bilingual",
+              "nameZh": "雙語",
+              "source": {
+                "human": "options/commit-message/bilingual.md",
+                "ai": "ai/options/commit-message/bilingual.ai.yaml"
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "id": "checkin-standards",
+      "name": "Code Check-in Standards",
+      "nameZh": "程式碼簽入標準",
+      "source": "core/checkin-standards.md",
+      "category": "reference",
+      "skillName": null,
+      "level": 1,
+      "description": "Quality gates and verification steps before committing code",
+      "note": "Partially incorporated into code-review-assistant skill"
+    },
+    {
+      "id": "spec-driven-development",
+      "name": "Spec-Driven Development",
+      "nameZh": "規格驅動開發",
+      "source": "core/spec-driven-development.md",
+      "category": "skill",
+      "skillName": "spec-driven-dev",
+      "level": 1,
+      "description": "Methodology for specification-first development approach"
+    },
+    {
+      "id": "code-review",
+      "name": "Code Review Checklist",
+      "nameZh": "程式碼審查清單",
+      "source": "core/code-review-checklist.md",
+      "category": "skill",
+      "skillName": "code-review-assistant",
+      "level": 2,
+      "description": "Systematic checklist for reviewing code quality, security, and maintainability"
+    },
+    {
+      "id": "git-workflow",
+      "name": "Git Workflow Guide",
+      "nameZh": "Git 工作流程指南",
+      "source": {
+        "human": "core/git-workflow.md",
+        "ai": "ai/standards/git-workflow.ai.yaml"
+      },
+      "category": "skill",
+      "skillName": "git-workflow-guide",
+      "level": 2,
+      "description": "Branching strategies including Trunk-Based, GitHub Flow, and GitFlow",
+      "options": {
+        "workflow": {
+          "default": "github-flow",
+          "choices": [
+            {
+              "id": "gitflow",
+              "name": "GitFlow",
+              "nameZh": "GitFlow 工作流",
+              "source": {
+                "human": "options/git-workflow/gitflow.md",
+                "ai": "ai/options/git-workflow/gitflow.ai.yaml"
+              },
+              "conditions": {
+                "release_frequency": "monthly+",
+                "team_size": "10+"
+              }
+            },
+            {
+              "id": "github-flow",
+              "name": "GitHub Flow",
+              "nameZh": "GitHub Flow 工作流",
+              "source": {
+                "human": "options/git-workflow/github-flow.md",
+                "ai": "ai/options/git-workflow/github-flow.ai.yaml"
+              },
+              "conditions": {
+                "release_frequency": "weekly",
+                "team_size": "5-15"
+              }
+            },
+            {
+              "id": "trunk-based",
+              "name": "Trunk-Based Development",
+              "nameZh": "主幹開發",
+              "source": {
+                "human": "options/git-workflow/trunk-based.md",
+                "ai": "ai/options/git-workflow/trunk-based.ai.yaml"
+              },
+              "conditions": {
+                "release_frequency": "daily+",
+                "ci_cd_maturity": "advanced"
+              }
+            }
+          ]
+        },
+        "merge_strategy": {
+          "default": "squash",
+          "choices": [
+            {
+              "id": "merge-commit",
+              "name": "Merge Commit",
+              "nameZh": "合併提交",
+              "source": {
+                "human": "options/git-workflow/merge-commit.md",
+                "ai": "ai/options/git-workflow/merge-commit.ai.yaml"
+              }
+            },
+            {
+              "id": "squash",
+              "name": "Squash Merge",
+              "nameZh": "壓縮合併",
+              "source": {
+                "human": "options/git-workflow/squash-merge.md",
+                "ai": "ai/options/git-workflow/squash-merge.ai.yaml"
+              }
+            },
+            {
+              "id": "rebase-ff",
+              "name": "Rebase + Fast-Forward",
+              "nameZh": "變基快進",
+              "source": {
+                "human": "options/git-workflow/rebase-ff.md",
+                "ai": "ai/options/git-workflow/rebase-ff.ai.yaml"
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "id": "versioning",
+      "name": "Semantic Versioning",
+      "nameZh": "語意化版本",
+      "source": "core/versioning.md",
+      "category": "skill",
+      "skillName": "release-standards",
+      "level": 2,
+      "description": "SemVer standard for version numbering (MAJOR.MINOR.PATCH)"
+    },
+    {
+      "id": "changelog",
+      "name": "Changelog Standards",
+      "nameZh": "變更日誌標準",
+      "source": "core/changelog-standards.md",
+      "category": "skill",
+      "skillName": "release-standards",
+      "level": 2,
+      "description": "Keep a Changelog format for documenting notable changes"
+    },
+    {
+      "id": "testing",
+      "name": "Testing Standards",
+      "nameZh": "測試標準",
+      "source": {
+        "human": "core/testing-standards.md",
+        "ai": "ai/standards/testing.ai.yaml"
+      },
+      "category": "skill",
+      "skillName": "testing-guide",
+      "level": 2,
+      "description": "Testing pyramid and recommended coverage ratios (70/20/7/3)",
+      "options": {
+        "test_level": {
+          "default": null,
+          "multiSelect": true,
+          "choices": [
+            {
+              "id": "unit-testing",
+              "name": "Unit Testing",
+              "nameZh": "單元測試",
+              "source": {
+                "human": "options/testing/unit-testing.md",
+                "ai": "ai/options/testing/unit-testing.ai.yaml"
+              }
+            },
+            {
+              "id": "integration-testing",
+              "name": "Integration Testing",
+              "nameZh": "整合測試",
+              "source": {
+                "human": "options/testing/integration-testing.md",
+                "ai": "ai/options/testing/integration-testing.ai.yaml"
+              }
+            },
+            {
+              "id": "system-testing",
+              "name": "System Testing",
+              "nameZh": "系統測試",
+              "source": {
+                "human": "options/testing/system-testing.md",
+                "ai": "ai/options/testing/system-testing.ai.yaml"
+              }
+            },
+            {
+              "id": "e2e-testing",
+              "name": "End-to-End Testing",
+              "nameZh": "端對端測試",
+              "source": {
+                "human": "options/testing/e2e-testing.md",
+                "ai": "ai/options/testing/e2e-testing.ai.yaml"
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "id": "documentation-structure",
+      "name": "Documentation Structure",
+      "nameZh": "文件結構",
+      "source": "core/documentation-structure.md",
+      "category": "skill",
+      "skillName": "documentation-guide",
+      "level": 3,
+      "description": "Standard directory structure for project documentation"
+    },
+    {
+      "id": "documentation-writing",
+      "name": "Documentation Writing Standards",
+      "nameZh": "文件撰寫標準",
+      "source": "core/documentation-writing-standards.md",
+      "category": "reference",
+      "skillName": null,
+      "level": 3,
+      "description": "Content requirements and writing guidelines for different project types"
+    },
+    {
+      "id": "project-structure",
+      "name": "Project Structure",
+      "nameZh": "專案結構",
+      "source": "core/project-structure.md",
+      "category": "skill",
+      "skillName": "project-structure-guide",
+      "level": 3,
+      "description": "Standard directory conventions for source code organization"
+    },
+    {
+      "id": "error-code-standards",
+      "name": "Error Code Standards",
+      "nameZh": "錯誤碼標準",
+      "source": "core/error-code-standards.md",
+      "category": "skill",
+      "skillName": "error-code-guide",
+      "level": 2,
+      "description": "Standardized error code format and categorization"
+    },
+    {
+      "id": "logging-standards",
+      "name": "Logging Standards",
+      "nameZh": "日誌標準",
+      "source": "core/logging-standards.md",
+      "category": "skill",
+      "skillName": "logging-guide",
+      "level": 2,
+      "description": "Structured logging format and best practices"
+    },
+    {
+      "id": "test-completeness-dimensions",
+      "name": "Test Completeness Dimensions",
+      "nameZh": "測試完整性維度",
+      "source": "core/test-completeness-dimensions.md",
+      "category": "skill",
+      "skillName": "test-coverage-assistant",
+      "level": 2,
+      "description": "Framework for evaluating test coverage completeness"
+    },
+    {
+      "id": "csharp-style",
+      "name": "C# Style Guide",
+      "nameZh": "C# 風格指南",
+      "source": "extensions/languages/csharp-style.md",
+      "category": "extension",
+      "skillName": null,
+      "level": 2,
+      "description": "C# naming conventions and code style rules",
+      "applicability": "C# projects"
+    },
+    {
+      "id": "php-style",
+      "name": "PHP Style Guide",
+      "nameZh": "PHP 風格指南",
+      "source": "extensions/languages/php-style.md",
+      "category": "extension",
+      "skillName": null,
+      "level": 2,
+      "description": "PHP 8.1+ PSR-12 style guide",
+      "applicability": "PHP 8.1+ projects"
+    },
+    {
+      "id": "fat-free-patterns",
+      "name": "Fat-Free Framework Patterns",
+      "nameZh": "Fat-Free 框架模式",
+      "source": "extensions/frameworks/fat-free-patterns.md",
+      "category": "extension",
+      "skillName": null,
+      "level": 2,
+      "description": "Development patterns for Fat-Free Framework v3.8+",
+      "applicability": "Fat-Free Framework projects"
+    },
+    {
+      "id": "zh-tw-locale",
+      "name": "Traditional Chinese Locale",
+      "nameZh": "繁體中文本地化",
+      "source": "extensions/locales/zh-tw.md",
+      "category": "extension",
+      "skillName": null,
+      "level": 2,
+      "description": "Traditional Chinese (Taiwan) localization for all standards",
+      "applicability": "Traditional Chinese speaking teams"
+    },
+    {
+      "id": "copilot-integration",
+      "name": "GitHub Copilot Instructions",
+      "nameZh": "GitHub Copilot 指令",
+      "source": "integrations/github-copilot/copilot-instructions.md",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "Custom instructions for GitHub Copilot Chat",
+      "targetPath": ".github/copilot-instructions.md"
+    },
+    {
+      "id": "cursor-integration",
+      "name": "Cursor Rules",
+      "nameZh": "Cursor 規則",
+      "source": "integrations/cursor/.cursorrules",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "AI assistant rules for Cursor IDE",
+      "targetPath": ".cursorrules"
+    },
+    {
+      "id": "windsurf-integration",
+      "name": "Windsurf Rules",
+      "nameZh": "Windsurf 規則",
+      "source": "integrations/windsurf/.windsurfrules",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "AI assistant rules for Windsurf IDE",
+      "targetPath": ".windsurfrules"
+    },
+    {
+      "id": "cline-integration",
+      "name": "Cline Rules",
+      "nameZh": "Cline 規則",
+      "source": "integrations/cline/.clinerules",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "AI assistant rules for Cline",
+      "targetPath": ".clinerules"
+    },
+    {
+      "id": "antigravity-integration",
+      "name": "Google Antigravity Instructions",
+      "nameZh": "Google Antigravity 指令",
+      "source": "integrations/google-antigravity/INSTRUCTIONS.md",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "System prompt snippets for Google Antigravity agent",
+      "targetPath": "See integration README"
+    },
+    {
+      "id": "openspec-integration",
+      "name": "OpenSpec Integration",
+      "nameZh": "OpenSpec 整合",
+      "source": "integrations/openspec/",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "Spec-Driven Development tooling integration for OpenSpec",
+      "targetPath": "See integration README",
+      "note": "SDD tool, not AI coding assistant. Manual integration only."
+    },
+    {
+      "id": "speckit-integration",
+      "name": "Spec Kit Integration",
+      "nameZh": "Spec Kit 整合",
+      "source": "integrations/spec-kit/",
+      "category": "integration",
+      "skillName": null,
+      "level": 2,
+      "description": "Lightweight specification tracking tool integration",
+      "targetPath": "See integration README",
+      "note": "SDD tool, not AI coding assistant. Manual integration only."
+    },
+    {
+      "id": "requirement-templates",
+      "name": "Requirement Document Templates",
+      "nameZh": "需求文件模板",
+      "source": "templates/requirement-*.md",
+      "category": "skill",
+      "skillName": "requirement-assistant",
+      "level": 2,
+      "description": "Templates for writing requirement documents and user stories"
+    },
+    {
+      "id": "migration-template",
+      "name": "Migration Plan Template",
+      "nameZh": "遷移計畫模板",
+      "source": "templates/migration-template.md",
+      "category": "template",
+      "skillName": null,
+      "level": 3,
+      "description": "Template for planning technology migrations",
+      "applicability": "Migration projects"
+    }
+  ]
+}