https://github.com/asiaostrich/universal-dev-standards
Universal, language-agnostic development standards for software projects. Includes coding standards, git workflows, testing guidelines, documentation structure, and AI collaboration rules.
https://github.com/asiaostrich/universal-dev-standards
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
Last synced: 5 days ago
JSON representation
Universal, language-agnostic development standards for software projects. Includes coding standards, git workflows, testing guidelines, documentation structure, and AI collaboration rules.
- Host: GitHub
- URL: https://github.com/asiaostrich/universal-dev-standards
- Owner: AsiaOstrich
- License: other
- Created: 2025-12-24T01:36:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-31T15:36:37.000Z (6 days ago)
- Last Synced: 2026-03-31T17:18:21.835Z (6 days ago)
- 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
- Language: JavaScript
- Homepage:
- Size: 7.8 MB
- Stars: 50
- Watchers: 1
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Universal Development Standards
[](https://www.npmjs.com/package/universal-dev-standards)
[](LICENSE)
[](https://nodejs.org/)
> **Language**: English | [繁體中文](locales/zh-TW/README.md) | [简体中文](locales/zh-CN/README.md)
**Version**: 5.1.0-beta.4 | **Released**: 2026-04-01 | **License**: [Dual License](LICENSE) (CC BY 4.0 + MIT)
Language-agnostic, framework-agnostic development standards for software projects. Ensure consistency, quality, and maintainability across diverse technology stacks with AI-native workflows.
---
## 🚀 Quick Start
### Install via npm (Recommended)
```bash
# Install globally (stable)
npm install -g universal-dev-standards
# Initialize your project
uds init
```
> Looking for beta or RC versions? See [Pre-release Versions](docs/PRE-RELEASE.md).
### Or use npx (No installation required)
```bash
npx universal-dev-standards init
```
> **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.
### 🗺️ What's Next?
| I want to... | Command |
| :--- | :--- |
| **Understand an existing codebase** | `/discover` |
| **Build a new feature with specs** | `/sdd` |
| **Work with legacy code** | `/reverse` |
| **Choose a development methodology** | `/methodology` |
| **Make a clean commit** | `/commit` |
> **Tip**: Type `/dev-workflow` for a complete guide to all development phases and available commands.
>
> See also: [Daily Workflow Guide](adoption/DAILY-WORKFLOW-GUIDE.md)
---
## ✨ Features
| Category | Count | Description |
|----------|-------|-------------|
| **Core Standards** | 71 | Universal development guidelines |
| **AI Skills** | 46 | Interactive skills |
| **Slash Commands** | 50 | Quick actions |
| **CLI Commands** | 9 | list, init, configure, check, update, skills, audit, agent, workflow |
> **What's New in 5.0?** See [Pre-release Notes](docs/PRE-RELEASE.md) for details on new features.
---
## 🏗️ Architecture
UDS uses a **Dual-Layer Execution Model** designed for both high-speed interactive development and deep technical compliance.
```mermaid
graph TD
A[AI Agent / Developer] --> B{Action Layer}
B -- "Daily Tasks" --> C[Skills Layer (.ai.yaml)]
B -- "Deep Review" --> D[Standards Layer (.md)]
C --> C1[Token-Efficient]
C --> C2[Interactive Wizards]
D --> D1[Comprehensive Theory]
D --> D2[Tool Configurations]
C1 -. "Fallback" .-> D1
```
| Aspect | Skills (Execution) | Core Standards (Knowledge) |
| :--- | :--- | :--- |
| **Format** | YAML-optimized | Full Markdown |
| **Goal** | High-speed interactive lookup | Deep understanding & Rationale |
| **Token Usage** | Minimal (AI-Friendly) | Detailed (Reference) |
---
## 🤖 AI Tool Support
| AI Tool | Status | Skills | Slash Commands | Configuration |
| :--- | :--- | :---: | :---: | :--- |
| **Claude Code** | ✅ Complete | **29** | **33** | `CLAUDE.md` |
| **OpenCode** | ✅ Complete | **29** | **33** | `AGENTS.md` |
| **Gemini CLI** | 🧪 Preview | **18+** | **20+** | `GEMINI.md` |
| **Cursor** | ✅ Complete | **Core** | **Simulated** | `.cursorrules` |
| **Cline / Roo Code**| 🔶 Partial | **Core** | **Workflow** | `.clinerules` |
| **Windsurf** | 🔶 Partial | ✅ | **Rulebook** | `.windsurfrules` |
> **Status Legend**: ✅ Complete | 🧪 Preview | 🔶 Partial | ⏳ Planned
---
## 📦 Installation Methods
### CLI Tool (Primary)
**npm (Recommended)**
```bash
npm install -g universal-dev-standards
uds init # Interactive initialization
uds check # Check adoption status
uds update # Update to latest version
uds config # Manage preferences (language, mode)
uds uninstall # Remove standards from project
```
---
## ⚙️ Configuration
Use `uds config` to manage your preferences:
| Parameter | Command | Description |
| :--- | :--- | :--- |
| **Commit Language** | `uds config --lang zh-TW` | Set preferred language for AI commits |
| **Standards** | `uds init` | Install all available standards |
| **Tool Mode** | `uds config --mode skills` | Choose between Skills, Standards, or Both |
---
## 👥 Contributing
1. **Suggest Improvements**: Open an issue with problem and solution.
2. **Add Examples**: Submit real-world usage examples.
3. **Extend Standards**: Contribute language/framework extensions.
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
---
## 🌐 Ecosystem
UDS is the **standards definition layer** in the AsiaOstrich three-layer product architecture:
```
UDS (What to do) → DevAP (How agents do it) → VibeOps (Full lifecycle)
```
| Layer | Product | Role | License |
|-------|---------|------|---------|
| Standards | **UDS** | Development methodology framework | MIT + CC BY 4.0 |
| Orchestration | [DevAP](https://github.com/AsiaOstrich/dev-autopilot) | Agent-agnostic orchestration engine | Apache-2.0 |
| Lifecycle | [VibeOps](https://github.com/AsiaOstrich/vibeops360) | AI-driven software factory | AGPL-3.0-only |
- **UDS** defines development standards → consumed by DevAP (quality gates) and VibeOps (agent pipeline)
- **DevAP** orchestrates AI agents using UDS standards → VibeOps is one of its consumers
- **VibeOps** provides full software lifecycle → integrates UDS via `uds init` (copy-once)
UDS remains **tool-agnostic**: it supports Claude Code, OpenCode, Gemini CLI, Cursor, Cline, and Windsurf. DevAP and VibeOps are consumers, not requirements.
---
## 📄 License
| Component | License |
| :--- | :--- |
| **Documentation** | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
| **CLI Tool** | [MIT](cli/LICENSE) |
## Acknowledgments
UDS draws architectural inspiration from these outstanding open-source projects:
| Project | Inspiration | License |
|---------|------------|---------|
| [Superpowers](https://github.com/obra/superpowers) | Systematic debugging, agent dispatch, verification evidence | MIT |
| [GSD](https://github.com/gsd-build/get-shit-done) | Structured task definition, traceability matrix, verification loop cap | MIT |
| [PAUL](https://github.com/ChristopherKahler/paul) | Plan-Apply-Unify loop, acceptance-driven development | MIT |
| [CARL](https://github.com/ChristopherKahler/carl) | Context-aware loading, dynamic rule injection | MIT |
| [CrewAI](https://github.com/crewAIInc/crewAI) | Multi-agent communication protocol, context budget tracking | MIT |
| [LangGraph](https://github.com/langchain-ai/langgraph) | Workflow state protocol, HITL interrupt checkpoints | MIT |
| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | Event sourcing, action-observation stream patterns | MIT |
| [DSPy](https://github.com/stanfordnlp/dspy) | Agent signatures, structured I/O contracts | MIT |
> **Note**: UDS adopts concepts and methodologies only — no source code from these projects is included.
---
**Maintained with ❤️ by the open-source community**