AI-Native Workflow Framework for Enterprise Software Development
English | 简体中文
SkillOS is a document-driven, AI-orchestrated, quality-assured development workflow framework that brings enterprise-grade quality control to modern software development.
Traditional workflows struggle with:
- ❌ Small fixes take 5+ minutes (waiting for CI)
- ❌ Large features lack quality guardrails (rely on manual review)
- ❌ Security issues slip through (multi-tenancy, permissions, audit)
- ❌ Lost context: "Why did we design it this way?" 6 months later
- ✅ Hybrid Mode: Small fixes in 2 seconds, complex features with full pipeline
- ✅ Gate System: 7 quality checkpoints with automated RLS/audit/state-machine validation
- ✅ Document-Driven: PRD → UI → Schema → Code, fully traceable
- ✅ AI Orchestration: Claude/GPT-4 automatically executes and enforces quality
Hybrid Mode (3 Execution Lanes):
Express Lane: Trivial tasks → 2 seconds
Fast Lane: Read-only ops → Instant
Controlled: Complex changes → Full Pipeline
Quality Gates:
- SPEC Gate: Requirements clarity check
- DATA Gate: Schema + permissions design review
- MIGRATION Gate: Database migration safety check
- IMPLEMENT Gate: Code implementation quality
- QA Gate: Test coverage + invariant checks
- CODE_REVIEW: Multi-dimensional code review
- RELEASE Gate: Release readiness check
AI Orchestration:
- Auto-detect optimal lane
- Auto-generate PRD/UI/Review docs
- Auto-execute quality checks
- Auto-update router state# Clone the repository
git clone https://github.com/yourusername/skill-os.git
cd skill-os
# Copy templates to your project
cp -r templates/.claude /path/to/your-project/
cp -r templates/docs /path/to/your-project/Add SkillOS rules to your project's .claude/CLAUDE.md:
# Load SkillOS Configuration
[Content will be generated during setup]# Simple fix (Express Lane)
Tell Claude: "Fix typo in dashboard page"
→ Completes in 2 seconds ✅
# New feature (Controlled Lane)
Tell Claude: "Implement user tagging feature"
→ Full Pipeline (2 hours) ✅┌─────────────────────────────────────────────┐
│ User Request (Natural Language) │
└──────────────┬──────────────────────────────┘
│
▼
┌──────────────────────────────────────────────┐
│ Smart Router (AI Auto-Detect Lane) │
│ - Express: 1 file ≤20 lines → 2s │
│ - Fast: Read-only → Instant │
│ - Controlled: Complex → Pipeline │
└──────────────┬───────────────────────────────┘
│
┌───────┼───────┐
│ │ │
▼ ▼ ▼
Express Fast Controlled
2s Instant Pipeline
│
▼
┌─────────────────┐
│ B0: Context │
│ B1: Spec │
│ B2: Data │◄── Gate: DATA
│ B3: Implement │◄── Gate: IMPLEMENT
│ B4: Validate │◄── Gate: QA
│ B5: Release │◄── Gate: RELEASE
└─────────────────┘
Task: "Fix 'Dashbaord' typo in dashboard page"
Execution:
[Auto-detect] → Express Lane
[Auto-edit] → src/app/dashboard/page.tsx
[Skip checks] → Rely on PR checks
[Complete] → 2 seconds ✅
Git log:
fix: correct typo in dashboard page
Co-Authored-By: Claude <noreply@anthropic.com>Task: "Implement document tagging feature"
Execution:
[B0_CONTEXT] Cache current module context
[B1_SPEC] Generate PRD + UI design
→ SPEC Gate ✅
[B2_DATA] Design Schema + RLS policies
→ DATA Gate ✅
→ Found: Missing company_id ❌ → Auto-fix
[B3_IMPLEMENT] Implement Frontend + Backend
→ IMPLEMENT Gate ✅
[B4_VALIDATE] Run tests + Code Review
→ QA Gate: Tenant isolation ✅, Audit coverage ✅
→ CODE_REVIEW Gate ✅
[B5_RELEASE] Generate release plan
→ RELEASE Gate ✅
Artifacts:
- docs/prd/exec/PRD-document-tags.md
- docs/ui/UI-document-tags.md
- migrations/20260209_document_tags.sql
- src/lib/actions/document-tags.ts
- src/components/DocumentTags.tsx
- docs/testing/TEST-document-tags.md
Total time: 2 hours
Quality: All 7 gates passed ✅Location: examples/nextjs-supabase/
A fully-working multi-tenant SaaS starter demonstrating:
- ✅ All 3 lanes (Express/Fast/Controlled)
- ✅ Multi-tenancy with RLS
- ✅ Server Actions pattern
- ✅ Invariant checks (tenant isolation, RLS policies)
- ✅ CI integration (3 GitHub Actions workflows)
- ✅ Complete documentation
Quick start:
cd examples/nextjs-supabase
npm install
supabase start
supabase db reset
npm run devSee README for full walkthrough.
Location: examples/minimal/
The simplest possible SkillOS setup:
- Single-file configuration
- Basic Express/Fast/Controlled lanes
- No database setup required
- Perfect for learning
- ✅ Next.js + Supabase - Complete example
- ✅ Django + PostgreSQL (Beta)
- ⏳ Rails + MySQL (Planned)
- Laravel + PostgreSQL
- FastAPI + SQLAlchemy
- Spring Boot + MySQL
| Dimension | GitHub Flow | GitFlow | Trunk-Based | SkillOS |
|---|---|---|---|---|
| Simplicity | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| Quality Assurance | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Speed (Small) | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| AI Integration | ⭐ | ⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| SaaS Security | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
- Multi-tenant SaaS (Stripe, Notion, Linear style)
- High security requirements (FinTech, HealthTech, GovTech)
- Long-term maintenance projects (5+ year lifecycle)
- Small AI-assisted teams (1-3 developers)
- Complex business logic (50+ database tables)
- MVP validation phase
- Large parallel teams (10+ developers)
- Simple CRUD projects
- One-off scripts
- 📖 Getting Started - 10-minute setup
- 🧠 Core Concepts - Deep dive into 6 concepts
- ⚡ Hybrid Mode Guide - Express/Fast/Controlled lanes
- 🎨 Customization - Adapt to your tech stack
- ❓ FAQ - 47 common questions answered
We welcome all contributions! See CONTRIBUTING.md for guidelines.
Quick Links:
MIT License - see LICENSE file
SkillOS was born from real-world production experience building enterprise multi-tenant SaaS applications. Thanks to all early users for their feedback.
Built with ❤️ for AI-Native Development