The System

ASDO — Autonomous Software Development Organization

Build production-ready software with 26 AI agents working as your complete development team

→ 🚀 Get started in 2 minutes | Build your first app today

The System simulates a complete software development organization with 26 specialized AI agents across 6 departments, taking your ideas from concept to production while you focus on strategic decisions.

---

---

🚀 What is The System?

Think of it as your AI development team. Instead of context-switching between architecture, coding, testing, and deployment, you make strategic decisions while specialized agents handle execution.

💡 Your App Requirements
     ↓
🏢 The System (Your AI Development Organization)
     ├── 📐 Architecture Team    → System design & technical decisions
     ├── 🎨 Design Team         → **🚀 Requirements → prototypes in 5-6 minutes**
     ├── 📦 Product Team        → MVP definition & business strategy
     ├── 💻 Development Team    → Full-stack implementation & testing
     ├── 🚀 Release Team        → Documentation, security & deployment
     └── 🌐 Operations Team     → Live monitoring & maintenance
     ↓
🚀 Production-Ready Software

Why Choose The System?

Traditional Development	The System
You write all the code	AI agents write code, you review and approve
Context switching between tasks	Specialized agents handle each domain
Manual deployment setup	Automated Infrastructure as Code
Greenfield projects only	Analyze & complete existing/legacy projects
Forgetting architectural decisions	Everything documented in ADRs

---

⚡ Quick Start

🎯 Use GitHub Template (Recommended)

Get a complete AI development team in 2 minutes:

1. Click "Use this template" at the top of this repository

2. Clone your new repo:

   git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
   cd YOUR_REPO
   
   # Verify installation
   ./scripts/verify-the-system.sh

3. Start building:

   # Launch Claude Code
   claude
   
   # Create your first project
   /ts-new-project my-blog
   "Blog website with posts and user comments"
   
   # Build it autonomously (15-20 minutes)
   /ts-turbo my-blog "blog with posts, comments, and admin panel" --build=mvp

🎉 Result: Complete production app with frontend, backend, database, tests, and documentation!

🔧 Alternative: Submodule Installation

# Create project directory
mkdir my-project && cd my-project
git init

# Add The System as a submodule
git submodule add https://github.com/vedanta/the-system.git .the-system
git submodule update --init --recursive

# Create symbolic links
ln -s .the-system/.claude .claude
ln -s .the-system/CLAUDE.md CLAUDE.md
mkdir -p input output

# Verify and start
.the-system/scripts/verify-the-system.sh
claude
/ts-new-project my-app

---

🎯 What You Can Build

⚡ From App Requirements to Prototypes (5-6 minutes) 🚀 NEW

# Complete app requirements → interactive prototypes pipeline
/ts-design-turbo --app-spec=requirements/banking-app.md --fidelity=high --review-server
/ts-design-turbo --app-spec=requirements/ecommerce.json --save-spec=specs/design.yaml

# Traditional: Working code prototypes (3-5 minutes)
/ts-turbo todo-demo "task management app" --build=prototype
/ts-turbo blog-demo "personal blog" --build=prototype

📦 Production MVPs (15-20 minutes)

/ts-turbo recipe-site "recipe sharing website with user ratings" --build=mvp
/ts-turbo photo-gallery "photo gallery with uploads and albums" --build=mvp
/ts-turbo inventory-tracker "inventory management for small business" --build=mvp

🏢 Enterprise Applications (45-60 minutes)

/ts-turbo employee-directory "company staff directory with advanced search" --build=production
/ts-turbo conference-manager "event booking system with payments" --build=production
/ts-turbo project-tracker "project management with team collaboration" --build=production

🗺️ Existing Project Completion

# Analyze and complete legacy codebases
/ts-assess --existing my-legacy-app
/ts-assess --existing old-project --gaps        # Find missing components
/ts-assess --existing inherited-code --security # Security audit

---

✨ Key Features

🎨 Design Department: Prototype-First Pipeline

Get interactive demos in 3-4 minutes with professional styling and realistic data.

# 🚀 NEW: Complete app requirements pipeline (5-6 min)
/ts-design-turbo --app-spec=requirements/banking-app.md --fidelity=high --review-server

# Traditional: Fast stakeholder demo (3-4 min)
/ts-design-turbo input/my-app

# Complete development handoff from requirements
/ts-design-turbo --app-spec=requirements/production-app.md --handoff=comprehensive --save-spec=specs/design.json

Key capabilities:

• 🚀 Complete pipeline: App requirements → auto-generated design specs → interactive prototypes
• 🤖 Intelligent analysis: Auto-detects domains (fintech, ecommerce, healthcare) and generates appropriate design systems
• 📋 Multi-format input: Supports .txt, .md, .json, .yaml app requirement files
• 💾 Reusable specs: Optionally save generated design specifications for team collaboration
• 📱 Mobile-responsive design across all devices
• 🔄 Full traceability: Complete transformation logs from requirements to prototypes

👉 Complete Design Guide →

🗺️ Project Explorer: Beyond Greenfield

First AI development tool for existing project analysis. Analyze inherited, legacy, or abandoned codebases.

/ts-assess --existing legacy-app           # Full analysis
/ts-assess --existing my-app --health      # Code quality assessment
/ts-assess --existing my-app --completion  # Completion strategies

⚡ Build Presets: Configure Speed vs Quality

Control the trade-off between speed and completeness:

• 🚀 Prototype (3-5 min): Fast demos, proof-of-concepts
• 📦 MVP (15-20 min): Production-ready apps with professional quality
• 🏢 Production (45-60 min): Enterprise-grade with full compliance

🚦 Human-in-the-Loop Control

You make strategic decisions at 8 key gates while agents handle execution:

1. Architecture Start → 2. Architecture Lock → 3. 🚦 Green Light → 4. Development → 5. Release → 6. Staging → 7. Production → 8. 🚀 Launch

---

🎮 Essential Commands

Project Lifecycle

/ts-new-project <name>                    # Start new project
/ts-new-project <name> --idea=file        # Start from idea file
/ts-status                                # Check project status
/ts-brief                                 # Get executive summary

Rapid Development

/ts-turbo <name> "<idea>" --build=prototype     # Fast prototyping (3-5 min)
/ts-turbo <name> --idea=file --build=mvp        # Production-ready (15-20 min)
/ts-design-turbo --app-spec=<requirements-file> # Requirements → prototypes (5-6 min) 🚀

Stage Commands

/ts-architect                             # Design system architecture
/ts-product → /ts-plan → /ts-analyze      # Business planning
/ts-build database|backend|frontend      # Build application layers
/ts-deploy staging|production             # Deploy to environments
/ts-push vercel|railway|neon             # Quick deploy to managed platforms

Utilities

/ts-fix                                   # Auto-fix common issues
/ts-validate                              # Build verification
/ts-docs-compliance                       # Check documentation compliance
/ts-help [command]                        # Interactive help
/ts-ask "question"                        # Ask the Founder-Advisor

👉 All 59 Commands →

---

📚 Learn More

Quick Guides

• QUICKSTART.md → 5-minute tutorial with first project
• USER-GUIDE.md → Complete reference and workflows
• README_DESIGN_DEPT.md → Design Department guide

Advanced Topics

• Architecture Tutorial → Hands-on system design
• Build Presets Guide → Speed optimization
• Workflow Guide → Step-by-step processes

References

• All 26 Agents → Agent capabilities and roles
• All 59 Commands → Complete command reference
• Configuration → Customization options

Generate Fresh Documentation

/ts-self-document  # Creates up-to-date documentation from framework

---

🤝 Community

Getting Help

# Within The System
/ts-help                     # Browse all commands
/ts-help <command>           # Detailed command help
/ts-ask "How do I add authentication?"  # Ask the advisor
/ts-quickref                 # Quick reference

# Self-diagnostics
./scripts/verify-the-system.sh    # Health check
/ts-validate                      # Build verification
/ts-health                        # Live services check

Contributing

We welcome contributions!

Quick contribution flow:

git checkout main && git pull
git checkout -b feat/your-feature    # Use descriptive branch names
# Make your changes
git push -u origin feat/your-feature
# Create PR

Branch naming: feat/auth, fix/bugs, docs/api, chore/cleanup (max 20 chars)

Before submitting:

• ✅ Run ./scripts/verify-the-system.sh
• ✅ Test thoroughly
• ✅ Update docs if needed

📋 Complete Guidelines →

Support

• 📚 Documentation: USER-GUIDE.md
• 🐛 Issues: GitHub Issues
• 💬 Questions: Use /ts-ask within The System

---

📄 License

LGPL-3.0 - Use commercially, modify freely, keep improvements open source.

📄 Full License | 🔗 Contributing | 📋 CLA

---

🛠️ Technology Stack & Architecture

Architecture Patterns

Supported Technologies

• Frontend: Next.js, React, Vue, SvelteKit (TypeScript, Tailwind CSS)
• Backend: FastAPI, Express.js, NestJS, Django (RESTful APIs)
• Database: PostgreSQL, MySQL, SQLite, MongoDB (With ORMs)
• Auth: NextAuth.js, Clerk, Lucia, Firebase Auth
• Deploy: Vercel, Railway, Fly.io, Netlify, Cloudflare Pages
• DevOps: Terraform, GitHub Actions, Docker, Monitoring

Build Performance

🏗️ Complete Workflow

Five-Stage Development Process

Stage	Department	Duration	Key Output
1	📐 Architecture	2-5 min	Tech stack & system design
1.5	🎨 Design	3-4 min	Interactive prototypes
2	📦 Product	3-8 min	MVP definition & user stories
3	💻 Development	10-30 min	Database, backend, frontend
4	🚀 Release	5-15 min	Docs, security, deployment
5	🌐 Operations	5-10 min	Live monitoring & alerts

Standard Workflow (Supervised)

# 1. Architecture
/ts-new-project my-app
/ts-architect → /ts-approve architecture-lock

# 1.5. Design (Optional) - 🚀 Enhanced with requirements pipeline
/ts-design-turbo --app-spec=requirements/my-app.md --save-spec=specs/design.json

# 2. Product
/ts-product → /ts-plan → /ts-analyze
/ts-approve green-light 🚦

# 3. Development
/ts-build database → /ts-build backend → /ts-build frontend
/ts-integrate → /ts-signoff → /ts-approve development

# 4. Release
/ts-docs → /ts-security → /ts-deploy staging
/ts-approve production → /ts-deploy production

# 5. Operations
/ts-push vercel|railway|neon → /ts-monitor → /ts-alerts

Turbo Mode (Autonomous)

# Runs Stages 1-4 automatically
/ts-turbo my-app "description" --build=prototype|mvp|production
/ts-turbo-quick my-app --idea=ideas/app.json

🌐 Quick Deploy Targets

Popular Platform Combinations

# Full-stack deployment
/ts-push vercel     # Frontend → Vercel
/ts-push railway    # Backend → Railway
/ts-push neon       # Database → Neon
/ts-domain vercel myapp.com  # Custom domain

# Alternative combinations
/ts-push netlify    # Frontend alternative
/ts-push fly        # Backend alternative
/ts-push supabase   # Database with built-in auth

Supported Platforms

• Frontend: Vercel, Netlify, Cloudflare Pages
• Backend: Railway, Fly.io, Render
• Database: Neon, Supabase, PlanetScale, Turso
• Full-stack: Railway (complete), Render (complete)

🎉 Production ready in under 10 minutes!

---

Ready to build production software with AI?

🚀 Quick Start • 📚 User Guide • 🐛 Issues • 📋 Changelog