{"id":41928520,"url":"https://github.com/vedanta/the-system","last_synced_at":"2026-01-25T17:34:45.719Z","repository":{"id":332835782,"uuid":"1119097961","full_name":"vedanta/the-system","owner":"vedanta","description":"Org-aligned multi-agent orchestration framework with roles, stages, human gates and autonomous execution","archived":false,"fork":false,"pushed_at":"2026-01-15T18:50:10.000Z","size":9906,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-15T20:56:29.632Z","etag":null,"topics":["agentic-ai","autonomous-agents","claude-code","generative-ai"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vedanta.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"CLA.md"}},"created_at":"2025-12-18T18:32:34.000Z","updated_at":"2026-01-15T18:50:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vedanta/the-system","commit_stats":null,"previous_names":["vedanta/the-system"],"tags_count":6,"template":true,"template_full_name":null,"purl":"pkg:github/vedanta/the-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vedanta%2Fthe-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vedanta%2Fthe-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vedanta%2Fthe-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vedanta%2Fthe-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vedanta","download_url":"https://codeload.github.com/vedanta/the-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vedanta%2Fthe-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28755981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T16:32:25.380Z","status":"ssl_error","status_checked_at":"2026-01-25T16:32:09.189Z","response_time":113,"last_error":"SSL_read: 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":["agentic-ai","autonomous-agents","claude-code","generative-ai"],"created_at":"2026-01-25T17:34:45.634Z","updated_at":"2026-01-25T17:34:45.703Z","avatar_url":"https://github.com/vedanta.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The System\n**ASDO — Autonomous Software Development Organization**\n\n\u003e *Build production-ready software with 23 AI agents working as your complete development team*\n\n**→ [🚀 Get started in 2 minutes](#-quick-start) | Build your first app today**\n\nThe System simulates a complete software development organization with **23 specialized AI agents** across **5 departments**, taking your ideas from concept to production while you focus on strategic decisions.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/system-hero-2.png\" alt=\"The System - Autonomous Software Development Organization\" width=\"800\"/\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Agents-23-blue?style=for-the-badge\" alt=\"23 agents\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Commands-56-green?style=for-the-badge\" alt=\"56 commands\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Build_Speed-3--60min-yellow?style=for-the-badge\" alt=\"3-60min builds\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Deploy_Targets-13+-orange?style=for-the-badge\" alt=\"13+ Deploy Targets\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Design_Prototypes-3--4min-blueviolet?style=for-the-badge\" alt=\"Design Prototypes\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-LGPL--3.0-lightgreen?style=for-the-badge\" alt=\"LGPL-3.0 License\"/\u003e\n\u003c/p\u003e\n\n---\n\n## 🚀 What is The System?\n\n**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.\n\n```\n💡 Your Idea\n     ↓\n🏢 The System (Your AI Development Organization)\n     ├── 📐 Architecture Team    → System design \u0026 technical decisions\n     ├── 🎨 Design Team         → Interactive prototypes in 3-4 minutes\n     ├── 📦 Product Team        → MVP definition \u0026 business strategy\n     ├── 💻 Development Team    → Full-stack implementation \u0026 testing\n     ├── 🚀 Release Team        → Documentation, security \u0026 deployment\n     └── 🌐 Operations Team     → Live monitoring \u0026 maintenance\n     ↓\n🚀 Production-Ready Software\n```\n\n### Why Choose The System?\n\n| **Traditional Development** | **The System** |\n|----------------------------|----------------|\n| You write all the code | AI agents write code, you review and approve |\n| Context switching between tasks | Specialized agents handle each domain |\n| Manual deployment setup | Automated Infrastructure as Code |\n| Greenfield projects only | **Analyze \u0026 complete existing/legacy projects** |\n| Forgetting architectural decisions | Everything documented in ADRs |\n\n---\n\n## ⚡ Quick Start\n\n### 🎯 Use GitHub Template (Recommended)\n\n**Get a complete AI development team in 2 minutes:**\n\n1. **Click \"Use this template\"** at the top of this repository\n2. **Clone your new repo:**\n   ```bash\n   git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git\n   cd YOUR_REPO\n\n   # Verify installation\n   ./scripts/verify-the-system.sh\n   ```\n\n3. **Start building:**\n   ```bash\n   # Launch Claude Code\n   claude\n\n   # Create your first project\n   /ts-new-project my-blog\n   \"Blog website with posts and user comments\"\n\n   # Build it autonomously (15-20 minutes)\n   /ts-turbo my-blog \"blog with posts, comments, and admin panel\" --build=mvp\n   ```\n\n**🎉 Result:** Complete production app with frontend, backend, database, tests, and documentation!\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔧 Alternative: Submodule Installation\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Create project directory\nmkdir my-project \u0026\u0026 cd my-project\ngit init\n\n# Add The System as a submodule\ngit submodule add https://github.com/vedanta/the-system.git .the-system\ngit submodule update --init --recursive\n\n# Create symbolic links\nln -s .the-system/.claude .claude\nln -s .the-system/CLAUDE.md CLAUDE.md\nmkdir -p input output\n\n# Verify and start\n.the-system/scripts/verify-the-system.sh\nclaude\n/ts-new-project my-app\n```\n\n\u003c/details\u003e\n\n---\n\n## 🎯 What You Can Build\n\n### ⚡ Rapid Prototypes (3-5 minutes)\n```bash\n# Interactive design prototypes\n/ts-design-turbo input/fintech-app --domain=fintech --fidelity=high\n\n# Working code prototypes\n/ts-turbo todo-demo \"task management app\" --build=prototype\n/ts-turbo blog-demo \"personal blog\" --build=prototype\n```\n\n### 📦 Production MVPs (15-20 minutes)\n```bash\n/ts-turbo recipe-site \"recipe sharing website with user ratings\" --build=mvp\n/ts-turbo photo-gallery \"photo gallery with uploads and albums\" --build=mvp\n/ts-turbo inventory-tracker \"inventory management for small business\" --build=mvp\n```\n\n### 🏢 Enterprise Applications (45-60 minutes)\n```bash\n/ts-turbo employee-directory \"company staff directory with advanced search\" --build=production\n/ts-turbo conference-manager \"event booking system with payments\" --build=production\n/ts-turbo project-tracker \"project management with team collaboration\" --build=production\n```\n\n### 🗺️ Existing Project Completion\n```bash\n# Analyze and complete legacy codebases\n/ts-assess --existing my-legacy-app\n/ts-assess --existing old-project --gaps        # Find missing components\n/ts-assess --existing inherited-code --security # Security audit\n```\n\n---\n\n## ✨ Key Features\n\n### 🎨 Design Department: Prototype-First Pipeline\n**Get interactive demos in 3-4 minutes** with professional styling and realistic data.\n\n```bash\n# Default: Fast stakeholder demo (3-4 min)\n/ts-design-turbo input/my-app\n\n# High-fidelity investor presentation\n/ts-design-turbo input/startup-app --domain=fintech --fidelity=high --review-server\n\n# Complete development handoff\n/ts-design-turbo input/production-app --handoff=detailed --api-discovery\n```\n\n**Key capabilities:**\n- **Domain optimization** for fintech, ecommerce, healthcare, Azure/AWS\n- **Mobile-responsive** design across all devices\n- **Development handoff** with TypeScript interfaces and component specs\n\n👉 **[Complete Design Guide →](README_DESIGN_DEPT.md)**\n\n### 🗺️ Project Explorer: Beyond Greenfield\n**First AI development tool for existing project analysis.** Analyze inherited, legacy, or abandoned codebases.\n\n```bash\n/ts-assess --existing legacy-app           # Full analysis\n/ts-assess --existing my-app --health      # Code quality assessment\n/ts-assess --existing my-app --completion  # Completion strategies\n```\n\n### ⚡ Build Presets: Configure Speed vs Quality\nControl the trade-off between speed and completeness:\n\n- **🚀 Prototype (3-5 min):** Fast demos, proof-of-concepts\n- **📦 MVP (15-20 min):** Production-ready apps with professional quality\n- **🏢 Production (45-60 min):** Enterprise-grade with full compliance\n\n### 🚦 Human-in-the-Loop Control\nYou make **strategic decisions** at 8 key gates while agents handle execution:\n1. Architecture Start → 2. Architecture Lock → 3. **🚦 Green Light** → 4. Development → 5. Release → 6. Staging → 7. Production → 8. **🚀 Launch**\n\n---\n\n## 🎮 Essential Commands\n\n### Project Lifecycle\n```bash\n/ts-new-project \u003cname\u003e                    # Start new project\n/ts-new-project \u003cname\u003e --idea=file        # Start from idea file\n/ts-status                                # Check project status\n/ts-brief                                 # Get executive summary\n```\n\n### Rapid Development\n```bash\n/ts-turbo \u003cname\u003e \"\u003cidea\u003e\" --build=prototype     # Fast prototyping (3-5 min)\n/ts-turbo \u003cname\u003e --idea=file --build=mvp        # Production-ready (15-20 min)\n/ts-design-turbo \u003cpath\u003e --domain=\u003ctype\u003e         # Interactive prototypes (3-4 min)\n```\n\n### Stage Commands\n```bash\n/ts-architect                             # Design system architecture\n/ts-product → /ts-plan → /ts-analyze      # Business planning\n/ts-build database|backend|frontend      # Build application layers\n/ts-deploy staging|production             # Deploy to environments\n/ts-push vercel|railway|neon             # Quick deploy to managed platforms\n```\n\n### Utilities\n```bash\n/ts-fix                                   # Auto-fix common issues\n/ts-validate                              # Build verification\n/ts-docs-compliance                       # Check documentation compliance\n/ts-help [command]                        # Interactive help\n/ts-ask \"question\"                        # Ask the Founder-Advisor\n```\n\n👉 **[All 56 Commands →](docs/user/commands.md)**\n\n---\n\n## 📚 Learn More\n\n### Quick Guides\n- **[QUICKSTART.md](QUICKSTART.md)** → 5-minute tutorial with first project\n- **[USER-GUIDE.md](USER-GUIDE.md)** → Complete reference and workflows\n- **[README_DESIGN_DEPT.md](README_DESIGN_DEPT.md)** → Design Department guide\n\n### Advanced Topics\n- **[Architecture Tutorial](docs/user/architecture-tutorial.md)** → Hands-on system design\n- **[Build Presets Guide](docs/user/build-presets-practical.md)** → Speed optimization\n- **[Workflow Guide](docs/user/workflow.md)** → Step-by-step processes\n\n### References\n- **[All 23 Agents](docs/user/agents.md)** → Agent capabilities and roles\n- **[All 56 Commands](docs/user/commands.md)** → Complete command reference\n- **[Configuration](docs/user/configuration.md)** → Customization options\n\n### Generate Fresh Documentation\n```bash\n/ts-self-document  # Creates up-to-date documentation from framework\n```\n\n---\n\n## 🤝 Community\n\n### Getting Help\n```bash\n# Within The System\n/ts-help                     # Browse all commands\n/ts-help \u003ccommand\u003e           # Detailed command help\n/ts-ask \"How do I add authentication?\"  # Ask the advisor\n/ts-quickref                 # Quick reference\n\n# Self-diagnostics\n./scripts/verify-the-system.sh    # Health check\n/ts-validate                      # Build verification\n/ts-health                        # Live services check\n```\n\n### Contributing\nWe welcome contributions!\n\n**Quick contribution flow:**\n```bash\ngit checkout main \u0026\u0026 git pull\ngit checkout -b feat/your-feature    # Use descriptive branch names\n# Make your changes\ngit push -u origin feat/your-feature\n# Create PR\n```\n\n**Branch naming:** `feat/auth`, `fix/bugs`, `docs/api`, `chore/cleanup` (max 20 chars)\n\n**Before submitting:**\n- ✅ Run `./scripts/verify-the-system.sh`\n- ✅ Test thoroughly\n- ✅ Update docs if needed\n\n📋 **[Complete Guidelines →](CONTRIBUTING.md)**\n\n### Support\n- 📚 **Documentation:** [USER-GUIDE.md](USER-GUIDE.md)\n- 🐛 **Issues:** [GitHub Issues](https://github.com/vedanta/the-system/issues)\n- 💬 **Questions:** Use `/ts-ask` within The System\n\n---\n\n## 📄 License\n\n**LGPL-3.0** - Use commercially, modify freely, keep improvements open source.\n\n📄 **[Full License](LICENSE)** | 🔗 **[Contributing](CONTRIBUTING.md)** | 📋 **[CLA](CLA.md)**\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🛠️ Technology Stack \u0026 Architecture\u003c/strong\u003e\u003c/summary\u003e\n\n### Architecture Patterns\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Static-Sites-blueviolet?style=flat-square\u0026logo=html5\" alt=\"Static Sites\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Embedded-DB-blue?style=flat-square\u0026logo=sqlite\" alt=\"Embedded DB\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Full--Stack-JS-yellow?style=flat-square\u0026logo=javascript\" alt=\"Full-Stack JS\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/BaaS-green?style=flat-square\u0026logo=supabase\" alt=\"BaaS\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Microservices-orange?style=flat-square\u0026logo=docker\" alt=\"Microservices\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/CLI-Tools-grey?style=flat-square\u0026logo=terminal\" alt=\"CLI Tools\"/\u003e\n\u003c/p\u003e\n\n### Supported Technologies\n- **Frontend:** Next.js, React, Vue, SvelteKit (TypeScript, Tailwind CSS)\n- **Backend:** FastAPI, Express.js, NestJS, Django (RESTful APIs)\n- **Database:** PostgreSQL, MySQL, SQLite, MongoDB (With ORMs)\n- **Auth:** NextAuth.js, Clerk, Lucia, Firebase Auth\n- **Deploy:** Vercel, Railway, Fly.io, Netlify, Cloudflare Pages\n- **DevOps:** Terraform, GitHub Actions, Docker, Monitoring\n\n### Build Performance\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Design_Prototypes-3--4min-cyan?style=flat-square\u0026logo=figma\" alt=\"Design Prototypes\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Code_Prototype-3--5min-brightgreen?style=flat-square\u0026logo=rocket\" alt=\"Code Prototype\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MVP-15--20min-yellow?style=flat-square\u0026logo=target\" alt=\"MVP Build\"/\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Production-45--60min-red?style=flat-square\u0026logo=shield\" alt=\"Production Build\"/\u003e\n\u003c/p\u003e\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🏗️ Complete Workflow\u003c/strong\u003e\u003c/summary\u003e\n\n### Five-Stage Development Process\n\n| Stage | Department | Duration | Key Output |\n|-------|------------|----------|------------|\n| **1** | 📐 Architecture | 2-5 min | Tech stack \u0026 system design |\n| **1.5** | 🎨 Design | 3-4 min | Interactive prototypes |\n| **2** | 📦 Product | 3-8 min | MVP definition \u0026 user stories |\n| **3** | 💻 Development | 10-30 min | Database, backend, frontend |\n| **4** | 🚀 Release | 5-15 min | Docs, security, deployment |\n| **5** | 🌐 Operations | 5-10 min | Live monitoring \u0026 alerts |\n\n### Standard Workflow (Supervised)\n```bash\n# 1. Architecture\n/ts-new-project my-app\n/ts-architect → /ts-approve architecture-lock\n\n# 1.5. Design (Optional)\n/ts-design-turbo output/my-app --domain=fintech\n\n# 2. Product\n/ts-product → /ts-plan → /ts-analyze\n/ts-approve green-light 🚦\n\n# 3. Development\n/ts-build database → /ts-build backend → /ts-build frontend\n/ts-integrate → /ts-signoff → /ts-approve development\n\n# 4. Release\n/ts-docs → /ts-security → /ts-deploy staging\n/ts-approve production → /ts-deploy production\n\n# 5. Operations\n/ts-push vercel|railway|neon → /ts-monitor → /ts-alerts\n```\n\n### Turbo Mode (Autonomous)\n```bash\n# Runs Stages 1-4 automatically\n/ts-turbo my-app \"description\" --build=prototype|mvp|production\n/ts-turbo-quick my-app --idea=ideas/app.json\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🌐 Quick Deploy Targets\u003c/strong\u003e\u003c/summary\u003e\n\n### Popular Platform Combinations\n```bash\n# Full-stack deployment\n/ts-push vercel     # Frontend → Vercel\n/ts-push railway    # Backend → Railway\n/ts-push neon       # Database → Neon\n/ts-domain vercel myapp.com  # Custom domain\n\n# Alternative combinations\n/ts-push netlify    # Frontend alternative\n/ts-push fly        # Backend alternative\n/ts-push supabase   # Database with built-in auth\n```\n\n### Supported Platforms\n- **Frontend:** Vercel, Netlify, Cloudflare Pages\n- **Backend:** Railway, Fly.io, Render\n- **Database:** Neon, Supabase, PlanetScale, Turso\n- **Full-stack:** Railway (complete), Render (complete)\n\n**🎉 Production ready in under 10 minutes!**\n\n\u003c/details\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eReady to build production software with AI?\u003c/strong\u003e\u003cbr/\u003e\n  \u003cbr/\u003e\n  \u003ca href=\"QUICKSTART.md\"\u003e🚀 Quick Start\u003c/a\u003e •\n  \u003ca href=\"USER-GUIDE.md\"\u003e📚 User Guide\u003c/a\u003e •\n  \u003ca href=\"https://github.com/vedanta/the-system/issues\"\u003e🐛 Issues\u003c/a\u003e •\n  \u003ca href=\"CHANGELOG.md\"\u003e📋 Changelog\u003c/a\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvedanta%2Fthe-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvedanta%2Fthe-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvedanta%2Fthe-system/lists"}