{"id":31533842,"url":"https://github.com/rsmdt/the-startup","last_synced_at":"2025-12-27T14:44:17.737Z","repository":{"id":309537163,"uuid":"1036625770","full_name":"rsmdt/the-startup","owner":"rsmdt","description":"The Agentic Startup - A collection of Claude Code commands, skills, and agents.","archived":false,"fork":false,"pushed_at":"2025-12-27T09:36:20.000Z","size":2439,"stargazers_count":132,"open_issues_count":0,"forks_count":16,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-27T09:52:07.847Z","etag":null,"topics":["claude-code","claude-code-plugin","claude-marketplace","claude-plugin"],"latest_commit_sha":null,"homepage":"https://r16t.com/agentic-startup","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rsmdt.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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":null}},"created_at":"2025-08-12T10:54:59.000Z","updated_at":"2025-12-27T09:36:24.000Z","dependencies_parsed_at":"2025-08-30T21:12:00.054Z","dependency_job_id":"bc35cd40-429d-4eff-8d55-a727fb4037dc","html_url":"https://github.com/rsmdt/the-startup","commit_stats":null,"previous_names":["rsmdt/the-startup"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/rsmdt/the-startup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsmdt%2Fthe-startup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsmdt%2Fthe-startup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsmdt%2Fthe-startup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsmdt%2Fthe-startup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rsmdt","download_url":"https://codeload.github.com/rsmdt/the-startup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsmdt%2Fthe-startup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28080060,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-27T02:00:05.897Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["claude-code","claude-code-plugin","claude-marketplace","claude-plugin"],"created_at":"2025-10-04T05:03:31.312Z","updated_at":"2025-12-27T14:44:17.730Z","avatar_url":"https://github.com/rsmdt.png","language":"Python","funding_links":[],"categories":["Tooling 🧰","6 つのトラック","HarmonyOS","AI Agent Frameworks"],"sub_categories":["Orchestrators","Tier 2：YC / Startup Accelerator","Windows Manager"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/rsmdt/the-startup/blob/main/logo.png\" width=\"400\" alt=\"The Agentic Startup\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Ship faster. Ship better. Ship with \u003cb\u003eThe Agentic Startup\u003c/b\u003e.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/rsmdt/the-startup/releases/latest\"\u003e\n    \u003cimg alt=\"Release\" src=\"https://github.com/rsmdt/the-startup/actions/workflows/release.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/rsmdt/the-startup/releases\"\u003e\n    \u003cimg alt=\"Downloads\" src=\"https://img.shields.io/github/downloads/rsmdt/the-startup/total?style=flat\u0026label=downloads\u0026color=blue\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/rsmdt/the-startup/stargazers\"\u003e\n    \u003cimg alt=\"GitHub Stars\" src=\"https://img.shields.io/github/stars/rsmdt/the-startup?style=flat\u0026color=yellow\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/hesreallyhim/awesome-claude-code\"\u003e\n    \u003cimg alt=\"Mentioned in Awesome Claude Code\" src=\"https://awesome.re/mentioned-badge.svg\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n## 🤖 What is The Agentic Startup?\n\n**The Agentic Startup** is a spec-driven development framework for Claude Code that transforms how you build software. Think Y Combinator demo day energy meets engineering discipline - multiple specialists executing in parallel while you stay in control.\n\nWe follow **[Spec-Driven Development](https://www.perplexity.ai/?q=Spec+Driven+Development)**, where comprehensive specifications are created before coding begins, ensuring clarity and reducing rework.\n\n**The workflow**:\n\n1. **📋 Specify** - Turn ideas into comprehensive specification documents\n2. **✅ Validate** - Quality gate to check specs, implementations, or understanding\n3. **⚡ Implement** - Execute plans phase-by-phase with parallel agent coordination\n\nThe framework leverages **Claude Code's plugin system** to provide workflow commands, autonomous skills, specialized agents, and quality templates - all working together like a high-velocity startup team.\n\n---\n\n## ✨ Key Features\n\n**Native Claude Code Integration** - Distributed as official marketplace plugins with zero manual configuration\n\n**Autonomous Skills System** - Model-invoked skills that activate based on natural language with progressive disclosure\n\n**Specialized Agent Team** - 11 agent roles across 27 activity-based specializations (optional [`team@the-startup`](plugins/team/README.md) plugin)\n\n**Structured Momentum** - Y Combinator energy meets engineering discipline - parallel execution with quality gates\n\n---\n\n## 📦 Plugins\n\n### Start Plugin (`start@the-startup`)\n\n**Core workflow orchestration** — 9 commands, 16 skills, 2 output styles\n\n| Category | Capabilities |\n|----------|-------------|\n| **Build** | `specify` → `validate` → `implement` pipeline with parallel agent coordination |\n| **Quality** | Multi-agent code review, security scanning, test coverage checks |\n| **Maintain** | Documentation generation, codebase analysis, safe refactoring, debugging |\n| **Git** | Optional branch/commit/PR workflows integrated into commands |\n\n### Team Plugin (`team@the-startup`) — *Optional*\n\n**Specialized agent library** — 11 roles, 27 activity-based specializations\n\n| Role | Focus Areas |\n|------|-------------|\n| **Chief** | Complexity assessment, activity routing, parallel execution |\n| **Analyst** | Requirements, prioritization, project coordination |\n| **Architect** | System design, technology research, quality review, documentation |\n| **Software Engineer** | APIs, components, domain modeling, performance |\n| **QA Engineer** | Test strategy, exploratory testing, load testing |\n| **Designer** | User research, interaction design, design systems, accessibility |\n| **Platform Engineer** | IaC, containers, CI/CD, monitoring, data pipelines |\n| **Meta Agent** | Agent design and generation |\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n**Requirements**: Claude Code v2.0+ with marketplace support\n\n```bash\n# Add The Agentic Startup marketplace\n/plugin marketplace add rsmdt/the-startup\n\n# Install the Start plugin (core workflows)\n/plugin install start@the-startup\n\n# (Optional) Install the Team plugin (specialized agents)\n/plugin install team@the-startup\n```\n\n**📖 [View all available agents →](plugins/team/README.md)**\n\nAlternatively, browse and install interactively via `/plugin`\n\n### Initialize Your Environment\n\nConfigure output style and statusline (one-time setup):\n\n```bash\n/start:init\n```\n\n### Your First Workflow\n\n**1. Create a specification:**\n```bash\n/start:specify Add user authentication with OAuth support\n```\n\nCreates `docs/specs/001-user-authentication/` with product-requirements.md, solution-design.md, and implementation-plan.md documents.\n\n**2. Execute the implementation:**\n```bash\n/start:implement 001\n```\n\nRuns phase-by-phase with parallel agents, validation gates, and progress tracking.\n\n---\n\n## 📋 Commands\n\nQuick reference for all workflow commands:\n\n| Command | Description |\n|---------|-------------|\n| `/start:init` | Initialize environment (output style, statusline) |\n| `/start:specify` | Create specification documents from brief description |\n| `/start:implement` | Execute implementation plan phase-by-phase |\n| `/start:validate` | Validate specs, implementations, or understanding (quality gate) |\n| `/start:analyze` | Discover and document patterns, rules, interfaces |\n| `/start:refactor` | Improve code quality while preserving behavior |\n| `/start:debug` | Conversational debugging with systematic root cause analysis |\n\n**📖 [View detailed command documentation →](plugins/start/README.md)**\n\n---\n\n## 🔄 Typical Development Workflow\n\n### Specify → Validate → Implement\n\n**1. Create Specification**\n\n```bash\n/start:specify Add real-time notification system with WebSocket support\n```\n\n- Creates comprehensive specs in `docs/specs/001-notification-system/`\n- Documents discovered patterns and interfaces\n- Duration: 15-30 minutes\n\n**2. Validate Before Implementation (Optional)**\n\n```bash\n/start:validate 001\n```\n\n- Checks completeness, consistency, correctness\n- Detects ambiguities and gaps\n- Provides advisory recommendations\n- Duration: 2-5 minutes\n\n**3. Execute Implementation**\n\n```bash\n/start:implement 001\n```\n\n- Executes phases sequentially with user approval\n- Parallel agent coordination within phases\n- Continuous test validation\n- Duration: Varies by complexity\n\n### Separate Workflows\n\n**Validate understanding or implementation:**\n```bash\n/start:validate Check the current auth implementation against the SDD\n```\n\n**Analyze existing code:**\n```bash\n/start:analyze security patterns in authentication\n```\n\n**Refactor code safely:**\n```bash\n/start:refactor Simplify the WebSocket connection manager\n```\n\n**Debug issues conversationally:**\n```bash\n/start:debug The API returns 500 errors when uploading large files\n```\n\n---\n\n## 🎯 Philosophy\n\n### Why Activity-Based Agents?\n\nResearch shows **2-22% accuracy improvement** with specialized task agents vs. single broad agents ([Multi-Agent Collaboration, 2025](https://arxiv.org/html/2501.06322v1)). Leading frameworks organize agents by **capability**, not job titles. The Agentic Startup applies this research through activity-based specialization.\n\n### The Problem We Solve\n\nDevelopment often moves too fast without proper planning:\n- Features built without clear requirements\n- Architecture decisions made ad-hoc during coding\n- Technical debt accumulates from lack of upfront design\n- Teams struggle to maintain consistency across implementations\n\n### Our Approach: Spec-Driven Development\n\n**The Agentic Startup** enforces a disciplined workflow that balances speed with quality:\n\n**1. Specify First** - Create comprehensive specifications before writing code\n- **product-requirements.md** - What to build and why\n- **solution-design.md** - How to build it technically\n- **implementation-plan.md** - Executable tasks and phases\n\n**2. Review \u0026 Refine** - Validate specifications with stakeholders\n- Catch issues during planning, not during implementation\n- Iterate on requirements and design cheaply\n- Get alignment before costly development begins\n\n**3. Implement with Confidence** - Execute validated plans phase-by-phase\n- Clear acceptance criteria at every step\n- Parallel agent coordination for speed\n- Built-in validation gates and quality checks\n\n**4. Document \u0026 Learn** - Capture patterns for future reuse\n- Automatically document discovered patterns\n- Build organizational knowledge base\n- Prevent reinventing solutions\n\n### Core Principles\n\n**Measure twice, cut once** - Investing time in specifications saves exponentially more time during implementation.\n\n**Documentation as code** - Specs, patterns, and interfaces are first-class artifacts that evolve with your codebase.\n\n**Parallel execution** - Multiple specialists work simultaneously within clear boundaries, maximizing velocity without chaos.\n\n**Quality gates** - Definition of Ready (DOR) and Definition of Done (DOD) ensure standards are maintained throughout.\n\n**Progressive disclosure** - Skills and agents load details only when needed, optimizing token efficiency while maintaining power.\n\n---\n\n## 📚 Documentation\n\n### Patterns\n\nReusable architectural patterns and design decisions:\n\n| Pattern | Description |\n|---------|-------------|\n| [Slim Agent Architecture](docs/patterns/slim-agent-architecture.md) | Structure agents to maximize effectiveness while minimizing context usage |\n\n### Additional Resources\n\n- [Start Plugin Documentation](plugins/start/README.md) - Workflow commands and skills\n- [Team Plugin Documentation](plugins/team/README.md) - Specialized agents and skills library\n- [Migration Guide](MIGRATION.md) - Upgrading from v1.x\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eReady to 10x your development workflow?\u003c/strong\u003e\u003cbr\u003e\n  Let's ship something incredible! 🚀\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsmdt%2Fthe-startup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsmdt%2Fthe-startup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsmdt%2Fthe-startup/lists"}