universal-dev-standards 4.2.0 → 5.0.0-beta.10

package/bundled/skills/tools/cline/.clinerules

@@ -0,0 +1,79 @@
+# Cline Rules - Universal Development Standards
+# Source: https://github.com/AsiaOstrich/universal-dev-standards
+# Version: 1.0.0
+
+You are an expert software developer following universal development standards.
+
+## Commit Standards
+
+Use Conventional Commits:
+<type>(<scope>): <subject>
+
+Types: feat | fix | refactor | docs | test | style | perf | build | ci | chore
+
+Examples:
+- feat(api): add user authentication endpoint
+- fix(ui): resolve button alignment issue
+- docs(readme): add installation guide
+
+## Code Review Checklist
+
+Functionality:
+- Code works correctly
+- Edge cases handled
+- Proper error handling
+
+Quality:
+- Readable code
+- No duplication
+- Descriptive names
+
+Security:
+- Input validation
+- No injection vulnerabilities
+- No exposed secrets
+
+Testing:
+- Unit tests present
+- Edge cases covered
+
+## Testing Standards
+
+Pyramid: UT 70% → IT 20% → E2E 10%
+
+- UT: Single function, <100ms, mocked deps
+- IT: Component interaction, real DB
+- E2E: Critical user journeys
+
+Pattern: Arrange → Act → Assert
+Principles: FIRST (Fast, Independent, Repeatable, Self-validating, Timely)
+
+## Git Workflow
+
+Branches:
+- feature/* for new features
+- fix/* for bug fixes
+- hotfix/* for urgent fixes
+
+Rules:
+- Atomic commits
+- Meaningful messages
+- No secrets in commits
+
+## Documentation
+
+Root files: README.md, CONTRIBUTING.md, CHANGELOG.md (UPPERCASE)
+Docs folder: lowercase-kebab-case (getting-started.md)
+
+## AI Best Practices
+
+Do:
+- Ask clarifying questions when uncertain
+- State assumptions explicitly
+- Check existing patterns first
+- Explain reasoning
+
+Don't:
+- Guess configurations
+- Assume without checking
+- Override project conventions

package/bundled/skills/tools/cline/README.md

@@ -0,0 +1,50 @@
+# Cline Rules
+
+Cline-specific rules derived from universal-dev-standards.
+
+## Status
+
+✅ **Complete** - Ready to use
+
+## Installation
+
+Copy the `.clinerules` file to your project root:
+
+```bash
+cp skills/cline/.clinerules .clinerules
+```
+
+Or copy from this repository directly:
+
+```bash
+curl -o .clinerules https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/cline/.clinerules
+```
+
+## What's Included
+
+The `.clinerules` file includes guidance for:
+
+- **Commit Standards** - Conventional Commits format
+- **Code Review** - Quality checklist
+- **Testing** - Testing pyramid and FIRST principles
+- **Git Workflow** - Branch naming
+- **Documentation** - File conventions
+- **AI Best Practices** - Guidelines for AI collaboration
+
+## Structure
+
+```
+cline/
+├── .clinerules     # Main rules file
+└── README.md       # This file
+```
+
+## Version
+
+- **Version**: 1.0.0
+- **Last Updated**: 2025-12-29
+- **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+## License
+
+CC BY 4.0

package/bundled/skills/tools/copilot/README.md

@@ -0,0 +1,99 @@
+# GitHub Copilot Instructions
+
+GitHub Copilot instructions derived from universal-dev-standards.
+
+## Status
+
+✅ **Complete** - Ready to use
+
+## Quick vs Full Version
+
+| Version | Location | Content |
+|---------|----------|---------|
+| **Quick** (this folder) | `skills/copilot/` | Essential standards only |
+| **Full** | `integrations/github-copilot/` | Complete standards + Chat reference + Skills mapping |
+
+**Recommendation**: Use the Full version from `integrations/github-copilot/` for comprehensive coverage.
+
+## Installation
+
+### Option 1: Quick Version (This Folder)
+
+```bash
+mkdir -p .github
+cp skills/copilot/copilot-instructions.md .github/copilot-instructions.md
+```
+
+### Option 2: Full Version (Recommended)
+
+```bash
+mkdir -p .github
+cp integrations/github-copilot/copilot-instructions.md .github/copilot-instructions.md
+```
+
+### Option 3: Download via curl
+
+```bash
+mkdir -p .github
+# Full version (recommended)
+curl -o .github/copilot-instructions.md \
+  https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/github-copilot/copilot-instructions.md
+```
+
+## What's Included
+
+### Quick Version (This Folder)
+
+- Commit Messages - Conventional Commits format
+- Code Quality - Naming and structure guidelines
+- Security - Input validation and injection prevention
+- Testing - AAA pattern and FIRST principles
+- Documentation - API documentation standards
+- Git - Branch naming conventions
+- AI Collaboration - Best practices
+
+### Full Version (integrations/github-copilot/)
+
+All of the above, plus:
+
+- **TDD Guidelines** - Red-Green-Refactor cycle, FIRST principles
+- **Test Coverage** - 7 dimensions framework
+- **Code Review** - 10-category checklist, comment prefixes
+- **Pre-commit Checklist** - Quality gates
+- **Requirement Writing** - INVEST criteria, user story format
+- **SDD Priority** - Spec-Driven Development rules
+- **Chat Reference** - Prompt templates for Copilot Chat
+- **Skills Mapping** - Claude Code skills equivalents
+
+## Additional Resources
+
+See `integrations/github-copilot/` for:
+
+- `README.md` - Complete documentation
+- `copilot-instructions.md` - Full version instructions
+- `COPILOT-CHAT-REFERENCE.md` - Chat prompt templates
+- `skills-mapping.md` - Claude Code skills mapping
+
+## Structure
+
+```
+skills/copilot/
+├── copilot-instructions.md  # Quick version instructions
+└── README.md                # This file
+
+integrations/github-copilot/
+├── README.md                # Full documentation
+├── copilot-instructions.md  # Full version instructions
+├── COPILOT-CHAT-REFERENCE.md # Chat prompts
+└── skills-mapping.md        # Skills mapping
+```
+
+## Version
+
+- **Version**: 2.0.0
+- **Last Updated**: 2026-01-13
+- **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+## License
+
+CC BY 4.0

package/bundled/skills/tools/copilot/copilot-instructions.md

@@ -0,0 +1,71 @@
+# GitHub Copilot Instructions
+<!-- Source: https://github.com/AsiaOstrich/universal-dev-standards -->
+<!-- Version: 1.0.0 -->
+
+## Development Standards
+
+Follow these standards when generating code suggestions.
+
+### Commit Messages
+
+Use Conventional Commits format:
+```
+<type>(<scope>): <subject>
+```
+
+**Types:**
+- `feat` - New feature
+- `fix` - Bug fix
+- `refactor` - Code refactoring
+- `docs` - Documentation
+- `test` - Tests
+- `chore` - Maintenance
+
+**Examples:**
+- `feat(auth): add OAuth2 login`
+- `fix(api): handle null user`
+
+### Code Quality
+
+When generating code:
+- Use descriptive variable/function names
+- Follow single responsibility principle
+- Avoid code duplication
+- Handle errors appropriately
+- Validate inputs
+
+### Security
+
+Always include:
+- Input validation
+- Parameterized queries (no SQL injection)
+- Output encoding (no XSS)
+- No hardcoded credentials
+
+### Testing
+
+Generate tests following:
+- AAA pattern: Arrange → Act → Assert
+- FIRST principles: Fast, Independent, Repeatable, Self-validating, Timely
+- Edge case coverage
+
+### Documentation
+
+For public APIs:
+- Include JSDoc/docstring comments
+- Document parameters and return values
+- Provide usage examples
+
+### Git
+
+Branch naming:
+- `feature/*` - New features
+- `fix/*` - Bug fixes
+- `hotfix/*` - Urgent fixes
+
+### AI Collaboration
+
+When uncertain:
+- Ask clarifying questions
+- State assumptions explicitly
+- Provide multiple options when applicable

package/bundled/skills/tools/cursor/.cursorrules

@@ -0,0 +1,101 @@
+# Cursor Rules - Universal Development Standards
+# Source: https://github.com/AsiaOstrich/universal-dev-standards
+# Version: 1.0.0
+
+You are an expert software developer. Follow these development standards in all interactions.
+
+## Commit Message Standards
+
+Use Conventional Commits format:
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+Types: feat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security
+
+Examples:
+- feat(auth): add OAuth2 login support
+- fix(api): resolve null pointer in user endpoint
+- docs(readme): update installation instructions
+
+## Code Review Checklist
+
+When reviewing or writing code, verify:
+
+### Functionality
+- [ ] Code works correctly
+- [ ] Edge cases handled
+- [ ] Error handling appropriate
+
+### Code Quality
+- [ ] Readable and self-documenting
+- [ ] Single responsibility principle
+- [ ] No code duplication (DRY)
+- [ ] Descriptive names
+- [ ] No magic numbers
+
+### Security
+- [ ] No SQL injection
+- [ ] No XSS vulnerabilities
+- [ ] Input validation present
+- [ ] No exposed credentials
+
+### Testing
+- [ ] Unit tests included
+- [ ] Edge cases covered
+
+## Testing Standards
+
+Follow the testing pyramid:
+- Unit Tests (UT): 70% - Single function/class, <100ms, all mocked
+- Integration Tests (IT/SIT): 20% - Component interaction, real DB
+- E2E Tests: 10% - User journeys, critical paths only
+
+Use AAA pattern: Arrange → Act → Assert
+Follow FIRST principles: Fast, Independent, Repeatable, Self-validating, Timely
+
+## Git Workflow
+
+Branch naming:
+- feature/* - New features
+- fix/* - Bug fixes
+- hotfix/* - Urgent production fixes
+- release/* - Release preparation
+
+Always:
+- Write meaningful commit messages
+- Keep commits atomic
+- Never commit secrets or credentials
+
+## Documentation
+
+Root files (UPPERCASE): README.md, CONTRIBUTING.md, CHANGELOG.md, LICENSE
+Docs folder (lowercase-kebab): getting-started.md, api-reference.md
+
+README must include:
+- Project description
+- Installation instructions
+- Usage examples
+- License
+
+## AI Collaboration Best Practices
+
+When uncertain:
+1. Ask clarifying questions first
+2. State assumptions explicitly
+3. Provide confidence levels for recommendations
+
+Never:
+- Guess at project-specific configurations
+- Assume technology choices without checking
+- Provide outdated version information without verification
+
+Always:
+- Check existing code patterns before suggesting new ones
+- Respect project conventions over personal preferences
+- Explain the reasoning behind suggestions

package/bundled/skills/tools/cursor/README.md

@@ -0,0 +1,50 @@
+# Cursor Rules
+
+Cursor-specific rules derived from universal-dev-standards.
+
+## Status
+
+✅ **Complete** - Ready to use
+
+## Installation
+
+Copy the `.cursorrules` file to your project root:
+
+```bash
+cp skills/cursor/.cursorrules .cursorrules
+```
+
+Or copy from this repository directly:
+
+```bash
+curl -o .cursorrules https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/cursor/.cursorrules
+```
+
+## What's Included
+
+The `.cursorrules` file includes guidance for:
+
+- **Commit Messages** - Conventional Commits format
+- **Code Review** - Quality and security checklists
+- **Testing** - Testing pyramid and best practices
+- **Git Workflow** - Branch naming and commit rules
+- **Documentation** - File naming and structure
+- **AI Collaboration** - Best practices for AI assistance
+
+## Structure
+
+```
+cursor/
+├── .cursorrules    # Main rules file
+└── README.md       # This file
+```
+
+## Version
+
+- **Version**: 1.0.0
+- **Last Updated**: 2025-12-29
+- **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+## License
+
+CC BY 4.0

package/bundled/skills/tools/windsurf/.windsurfrules

@@ -0,0 +1,76 @@
+# Windsurf Rules - Universal Development Standards
+# Source: https://github.com/AsiaOstrich/universal-dev-standards
+# Version: 1.0.0
+
+You are an expert software developer. Follow these development standards.
+
+## Commit Messages
+
+Format: <type>(<scope>): <subject>
+
+Types:
+- feat: New feature
+- fix: Bug fix
+- refactor: Code refactoring
+- docs: Documentation
+- test: Tests
+- chore: Maintenance
+
+Example: feat(auth): add OAuth2 support
+
+## Code Quality
+
+When writing or reviewing code:
+- Use descriptive variable names
+- Follow single responsibility principle
+- Avoid code duplication
+- Handle errors appropriately
+- Validate all inputs
+
+## Security
+
+Always check for:
+- SQL injection vulnerabilities
+- XSS vulnerabilities
+- Exposed credentials
+- Missing authentication/authorization
+
+## Testing
+
+Testing pyramid ratio: 70% UT / 20% IT / 10% E2E
+
+- Unit Tests: Fast, isolated, mocked dependencies
+- Integration Tests: Real database, component boundaries
+- E2E Tests: Critical user paths only
+
+Use AAA pattern: Arrange → Act → Assert
+
+## Git Workflow
+
+Branch naming:
+- feature/* - New features
+- fix/* - Bug fixes
+- hotfix/* - Urgent fixes
+
+Commit rules:
+- Atomic commits
+- Meaningful messages
+- Never commit secrets
+
+## Documentation
+
+- README.md: Project overview and setup
+- CONTRIBUTING.md: Contribution guidelines
+- CHANGELOG.md: Version history (Keep a Changelog format)
+
+## AI Collaboration
+
+When uncertain:
+- Ask clarifying questions
+- State assumptions explicitly
+- Verify before suggesting changes
+
+Respect:
+- Existing project conventions
+- Team preferences
+- Current technology choices

package/bundled/skills/tools/windsurf/README.md

@@ -0,0 +1,51 @@
+# Windsurf Rules
+
+Windsurf-specific rules derived from universal-dev-standards.
+
+## Status
+
+✅ **Complete** - Ready to use
+
+## Installation
+
+Copy the `.windsurfrules` file to your project root:
+
+```bash
+cp skills/windsurf/.windsurfrules .windsurfrules
+```
+
+Or copy from this repository directly:
+
+```bash
+curl -o .windsurfrules https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/windsurf/.windsurfrules
+```
+
+## What's Included
+
+The `.windsurfrules` file includes guidance for:
+
+- **Commit Messages** - Conventional Commits format
+- **Code Quality** - Best practices and principles
+- **Security** - Common vulnerabilities to avoid
+- **Testing** - Testing pyramid and patterns
+- **Git Workflow** - Branch naming conventions
+- **Documentation** - File structure standards
+- **AI Collaboration** - Guidelines for AI interaction
+
+## Structure
+
+```
+windsurf/
+├── .windsurfrules  # Main rules file
+└── README.md       # This file
+```
+
+## Version
+
+- **Version**: 1.0.0
+- **Last Updated**: 2025-12-29
+- **Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+## License
+
+CC BY 4.0

package/bundled/skills/{claude-code/workflows → workflows}/README.md

@@ -1,6 +1,6 @@
 # UDS Workflows
 
-> **Language**: English | [繁體中文](../../../locales/zh-TW/skills/claude-code/workflows/README.md)
+> **Language**: English | [繁體中文](../../locales/zh-TW/skills/workflows/README.md)
 
 **Version**: 1.1.0
 **Last Updated**: 2026-01-21