{"id":34979225,"url":"https://github.com/asiaostrich/universal-dev-standards","last_synced_at":"2026-04-02T14:01:17.000Z","repository":{"id":330236007,"uuid":"1122028424","full_name":"AsiaOstrich/universal-dev-standards","owner":"AsiaOstrich","description":"Universal, language-agnostic development standards for software projects. Includes coding standards, git workflows, testing guidelines, documentation structure, and AI collaboration rules.","archived":false,"fork":false,"pushed_at":"2026-03-31T15:36:37.000Z","size":8183,"stargazers_count":50,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-31T17:18:21.835Z","etag":null,"topics":["ai-collaboration","best-practices","claude-code","code-review","coding-standards","commit-conventions","conventional-commits","developer-tools","development-standards","devops","documentation","git-workflow","quality-assurance","semantic-versioning","skills","software-engineering","spec-driven-development","testing-standards"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AsiaOstrich.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T01:36:15.000Z","updated_at":"2026-03-31T15:36:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AsiaOstrich/universal-dev-standards","commit_stats":null,"previous_names":["asiaostrich/universal-dev-standards"],"tags_count":109,"template":false,"template_full_name":null,"purl":"pkg:github/AsiaOstrich/universal-dev-standards","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsiaOstrich%2Funiversal-dev-standards","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsiaOstrich%2Funiversal-dev-standards/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsiaOstrich%2Funiversal-dev-standards/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsiaOstrich%2Funiversal-dev-standards/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AsiaOstrich","download_url":"https://codeload.github.com/AsiaOstrich/universal-dev-standards/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AsiaOstrich%2Funiversal-dev-standards/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31307459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-collaboration","best-practices","claude-code","code-review","coding-standards","commit-conventions","conventional-commits","developer-tools","development-standards","devops","documentation","git-workflow","quality-assurance","semantic-versioning","skills","software-engineering","spec-driven-development","testing-standards"],"created_at":"2025-12-27T00:51:46.334Z","updated_at":"2026-04-02T14:01:16.974Z","avatar_url":"https://github.com/AsiaOstrich.png","language":"JavaScript","readme":"# Universal Development Standards\n\n[![npm version](https://img.shields.io/npm/v/universal-dev-standards.svg)](https://www.npmjs.com/package/universal-dev-standards)\n[![License: MIT + CC BY 4.0](https://img.shields.io/badge/License-MIT%20%2B%20CC%20BY%204.0-blue.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-green.svg)](https://nodejs.org/)\n\n\u003e **Language**: English | [繁體中文](locales/zh-TW/README.md) | [简体中文](locales/zh-CN/README.md)\n\n**Version**: 5.1.0-beta.4 | **Released**: 2026-04-01 | **License**: [Dual License](LICENSE) (CC BY 4.0 + MIT)\n\nLanguage-agnostic, framework-agnostic development standards for software projects. Ensure consistency, quality, and maintainability across diverse technology stacks with AI-native workflows.\n\n---\n\n## 🚀 Quick Start\n\n### Install via npm (Recommended)\n\n```bash\n# Install globally (stable)\nnpm install -g universal-dev-standards\n\n# Initialize your project\nuds init\n```\n\n\u003e Looking for beta or RC versions? See [Pre-release Versions](docs/PRE-RELEASE.md).\n\n### Or use npx (No installation required)\n\n```bash\nnpx universal-dev-standards init\n```\n\n\u003e **Note**: Copying standards alone won't enable AI assistance. Use `uds init` to automatically configure your AI tool or manually reference standards in your tool's configuration file.\n\n### 🗺️ What's Next?\n\n| I want to... | Command |\n| :--- | :--- |\n| **Understand an existing codebase** | `/discover` |\n| **Build a new feature with specs** | `/sdd` |\n| **Work with legacy code** | `/reverse` |\n| **Choose a development methodology** | `/methodology` |\n| **Make a clean commit** | `/commit` |\n\n\u003e **Tip**: Type `/dev-workflow` for a complete guide to all development phases and available commands.\n\u003e\n\u003e See also: [Daily Workflow Guide](adoption/DAILY-WORKFLOW-GUIDE.md)\n\n---\n\n## ✨ Features\n\n\u003c!-- UDS_STATS_TABLE_START --\u003e\n| Category | Count | Description |\n|----------|-------|-------------|\n| **Core Standards** | 71 | Universal development guidelines |\n| **AI Skills** | 46 | Interactive skills |\n| **Slash Commands** | 50 | Quick actions |\n| **CLI Commands** | 9 | list, init, configure, check, update, skills, audit, agent, workflow |\n\u003c!-- UDS_STATS_TABLE_END --\u003e\n\n\u003e **What's New in 5.0?** See [Pre-release Notes](docs/PRE-RELEASE.md) for details on new features.\n\n---\n\n## 🏗️ Architecture\n\nUDS uses a **Dual-Layer Execution Model** designed for both high-speed interactive development and deep technical compliance.\n\n```mermaid\ngraph TD\n    A[AI Agent / Developer] --\u003e B{Action Layer}\n    B -- \"Daily Tasks\" --\u003e C[Skills Layer (.ai.yaml)]\n    B -- \"Deep Review\" --\u003e D[Standards Layer (.md)]\n    \n    C --\u003e C1[Token-Efficient]\n    C --\u003e C2[Interactive Wizards]\n    \n    D --\u003e D1[Comprehensive Theory]\n    D --\u003e D2[Tool Configurations]\n    \n    C1 -. \"Fallback\" .-\u003e D1\n```\n\n| Aspect | Skills (Execution) | Core Standards (Knowledge) |\n| :--- | :--- | :--- |\n| **Format** | YAML-optimized | Full Markdown |\n| **Goal** | High-speed interactive lookup | Deep understanding \u0026 Rationale |\n| **Token Usage** | Minimal (AI-Friendly) | Detailed (Reference) |\n\n---\n\n## 🤖 AI Tool Support\n\n| AI Tool | Status | Skills | Slash Commands | Configuration |\n| :--- | :--- | :---: | :---: | :--- |\n| **Claude Code** | ✅ Complete | **29** | **33** | `CLAUDE.md` |\n| **OpenCode** | ✅ Complete | **29** | **33** | `AGENTS.md` |\n| **Gemini CLI** | 🧪 Preview | **18+** | **20+** | `GEMINI.md` |\n| **Cursor** | ✅ Complete | **Core** | **Simulated** | `.cursorrules` |\n| **Cline / Roo Code**| 🔶 Partial | **Core** | **Workflow** | `.clinerules` |\n| **Windsurf** | 🔶 Partial | ✅ | **Rulebook** | `.windsurfrules` |\n\n\u003e **Status Legend**: ✅ Complete | 🧪 Preview | 🔶 Partial | ⏳ Planned\n\n---\n\n## 📦 Installation Methods\n\n### CLI Tool (Primary)\n\n**npm (Recommended)**\n```bash\nnpm install -g universal-dev-standards\nuds init        # Interactive initialization\nuds check       # Check adoption status\nuds update      # Update to latest version\nuds config      # Manage preferences (language, mode)\nuds uninstall   # Remove standards from project\n```\n\n---\n\n## ⚙️ Configuration\n\nUse `uds config` to manage your preferences:\n\n| Parameter | Command | Description |\n| :--- | :--- | :--- |\n| **Commit Language** | `uds config --lang zh-TW` | Set preferred language for AI commits |\n| **Standards** | `uds init` | Install all available standards |\n| **Tool Mode** | `uds config --mode skills` | Choose between Skills, Standards, or Both |\n\n---\n\n## 👥 Contributing\n\n1. **Suggest Improvements**: Open an issue with problem and solution.\n2. **Add Examples**: Submit real-world usage examples.\n3. **Extend Standards**: Contribute language/framework extensions.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## 🌐 Ecosystem\n\nUDS is the **standards definition layer** in the AsiaOstrich three-layer product architecture:\n\n```\nUDS (What to do) → DevAP (How agents do it) → VibeOps (Full lifecycle)\n```\n\n| Layer | Product | Role | License |\n|-------|---------|------|---------|\n| Standards | **UDS** | Development methodology framework | MIT + CC BY 4.0 |\n| Orchestration | [DevAP](https://github.com/AsiaOstrich/dev-autopilot) | Agent-agnostic orchestration engine | Apache-2.0 |\n| Lifecycle | [VibeOps](https://github.com/AsiaOstrich/vibeops360) | AI-driven software factory | AGPL-3.0-only |\n\n- **UDS** defines development standards → consumed by DevAP (quality gates) and VibeOps (agent pipeline)\n- **DevAP** orchestrates AI agents using UDS standards → VibeOps is one of its consumers\n- **VibeOps** provides full software lifecycle → integrates UDS via `uds init` (copy-once)\n\nUDS remains **tool-agnostic**: it supports Claude Code, OpenCode, Gemini CLI, Cursor, Cline, and Windsurf. DevAP and VibeOps are consumers, not requirements.\n\n---\n\n## 📄 License\n\n| Component | License |\n| :--- | :--- |\n| **Documentation** | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |\n| **CLI Tool** | [MIT](cli/LICENSE) |\n\n## Acknowledgments\n\nUDS draws architectural inspiration from these outstanding open-source projects:\n\n| Project | Inspiration | License |\n|---------|------------|---------|\n| [Superpowers](https://github.com/obra/superpowers) | Systematic debugging, agent dispatch, verification evidence | MIT |\n| [GSD](https://github.com/gsd-build/get-shit-done) | Structured task definition, traceability matrix, verification loop cap | MIT |\n| [PAUL](https://github.com/ChristopherKahler/paul) | Plan-Apply-Unify loop, acceptance-driven development | MIT |\n| [CARL](https://github.com/ChristopherKahler/carl) | Context-aware loading, dynamic rule injection | MIT |\n| [CrewAI](https://github.com/crewAIInc/crewAI) | Multi-agent communication protocol, context budget tracking | MIT |\n| [LangGraph](https://github.com/langchain-ai/langgraph) | Workflow state protocol, HITL interrupt checkpoints | MIT |\n| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | Event sourcing, action-observation stream patterns | MIT |\n| [DSPy](https://github.com/stanfordnlp/dspy) | Agent signatures, structured I/O contracts | MIT |\n\n\u003e **Note**: UDS adopts concepts and methodologies only — no source code from these projects is included.\n\n---\n\n**Maintained with ❤️ by the open-source community**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasiaostrich%2Funiversal-dev-standards","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasiaostrich%2Funiversal-dev-standards","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasiaostrich%2Funiversal-dev-standards/lists"}