Ship faster. Ship better. Ship with The Agentic Startup.
- π€ What is The Agentic Startup?
- π Quick Start
- π The Complete Workflow
- π― Which Command Should I Use?
- π¦ Plugins
- π¨ Output Styles
- π― Philosophy
- π Documentation
The Agentic Startup is a spec-driven development framework for Claude Code. Create comprehensive specifications before coding, then execute with parallel specialist agentsβY Combinator energy meets engineering discipline.
Key Features:
- Native Claude Code Integration β Marketplace plugins with zero configuration
- Spec-Driven Development β PRD β SDD β Implementation Plan β Code
- Parallel Agent Execution β Multiple specialists work simultaneously
- Quality Gates β Built-in validation at every stage
Requirements: Claude Code v2.0+ with marketplace support
# Add The Agentic Startup marketplace
/plugin marketplace add rsmdt/the-startup
# Install the Start plugin (core workflows)
/plugin install start@the-startup
# (Optional) Install the Team plugin (specialized agents)
/plugin install team@the-startup
# Initialize your environment (statusline)
/start:init
# Choose your output style
/output-style start:The Startup # High-energy, fast execution
/output-style start:The ScaleUp # Calm confidence, educationalCreate a specification and implement it:
# Create a specification
/start:specify Add user authentication with OAuth support
# Execute the implementation
/start:implement 001That's it! You're now using spec-driven development.
The Agentic Startup follows spec-driven development: comprehensive specifications before code, ensuring clarity and reducing rework.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β SETUP (one-time) β
β β
β /start:init ββββββββΊ Configure statusline & environment β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β BUILD (primary flow) β
β β
β /start:specify βββββΊ Create specs (PRD + SDD + PLAN) β
β β β
β βΌ β
β /start:validate ββββΊ Check quality (3 Cs framework) β
β β β
β βΌ β
β /start:implement βββΊ Execute plan phase-by-phase β
β β β
β βΌ β
β /start:review ββββββΊ Multi-agent code review β
β β β
β βΌ β
β /start:document ββββΊ Generate/sync documentation β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β MAINTAIN (as needed) β
β β
β /start:analyze βββββΊ Discover patterns & rules β
β β
β /start:refactor ββββΊ Improve code (preserve behavior) β
β β
β /start:debug βββββββΊ Fix bugs (root cause analysis) β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
/start:specify Add real-time notification system with WebSocket supportThis creates a specification directory with three documents:
docs/specs/001-notification-system/
βββ product-requirements.md # What to build and why
βββ solution-design.md # How to build it technically
βββ implementation-plan.md # Executable tasks and phases
The spec cycle may take 15-30 minutes. Claude will research your codebase, ask clarifying questions, and produce comprehensive documents. The process naturally involves multiple back-and-forth exchanges.
Large specifications may approach Claude's context window limits. When this happens:
# Start a new conversation and resume where you left off
/start:specify 001The resume pattern:
- Pass the spec ID (e.g.,
001) instead of a description - Claude reads the existing spec files and continues from there
- You can reset context as many times as needed
- Each document (PRD β SDD β PLAN) can be completed in separate sessions if needed
Pro tip: If Claude suggests "you may want to reset context", do it! The quality of output improves with fresh context.
/start:validate 001This quality gate checks:
- Completeness - All sections filled, no missing details
- Consistency - No contradictions between documents
- Correctness - Requirements are testable and achievable
Validation is advisoryβit provides recommendations but doesn't block you.
/start:implement 001Claude will:
- Parse the implementation plan
- Execute phases sequentially (with your approval between phases)
- Run tests after each task
- Use parallel agents within phases for speed
Large implementations may also need context resets. Simply run /start:implement 001 again in a fresh conversationβClaude tracks progress in the spec files.
/start:reviewFour parallel specialists review your code:
- π Security - Authentication, authorization, input validation
- β‘ Performance - Query optimization, memory management
- β¨ Quality - Code style, design patterns, maintainability
- π§ͺ Tests - Coverage gaps, edge cases
What do you need to do?
β
ββ Build something new? βββββββββββββββββββΊ /start:specify
β Then: /start:validate β /start:implement
β
ββ Understand existing code? ββββββββββββββΊ /start:analyze
β ββ Want to improve it? ββββββββββββββββΊ Then: /start:refactor
β
ββ Something is broken? βββββββββββββββββββΊ /start:debug
β
ββ Code ready for merge? ββββββββββββββββββΊ /start:review
β
ββ Need documentation? ββββββββββββββββββββΊ /start:document
β
ββ First time setup? ββββββββββββββββββββββΊ /start:init
| Command | Purpose | When to Use |
|---|---|---|
/start:specify |
Create specifications | New features, complex changes |
/start:implement |
Execute plans | After spec is validated |
/start:validate |
Check quality | Before implementation, after specs |
/start:review |
Multi-agent code review | Before merging PRs |
/start:document |
Generate documentation | After implementation |
/start:analyze |
Extract knowledge | Understanding existing code |
/start:refactor |
Improve code quality | Cleanup without behavior change |
/start:debug |
Fix bugs | When something is broken |
/start:init |
Setup environment | First-time configuration |
| Capability | specify | implement | validate | review | document | analyze | refactor | debug |
|---|---|---|---|---|---|---|---|---|
| Creates specifications | β | - | - | - | - | - | - | - |
| Executes implementation plans | - | β | - | - | - | - | - | - |
| Runs tests | - | β | β | - | - | - | β | β |
| Creates git branches | β | β | - | - | - | - | β | - |
| Creates PRs | β | β | - | - | - | - | - | - |
| Multi-agent parallel | β | β | - | β | β | β | - | - |
| Security scanning | - | - | β | β | - | - | - | - |
| Generates documentation | β | - | - | - | β | β | - | - |
validate vs review β Different purposes, different timing
| Aspect | /start:validate |
/start:review |
|---|---|---|
| When | During development | Before merging |
| Focus | Spec compliance, quality gates | Code quality, security, performance |
| Output | Advisory recommendations | PR comments, findings report |
analyze vs document β Discovery vs generation
| Aspect | /start:analyze |
/start:document |
|---|---|---|
| Purpose | Discover what exists | Generate documentation |
| Output | Knowledge documentation | API docs, READMEs, JSDoc |
refactor vs debug β Improvement vs fixing
| Aspect | /start:refactor |
/start:debug |
|---|---|---|
| Behavior | Must preserve exactly | Expected to change (fix) |
| Tests | Must all pass throughout | May need new/updated tests |
The Agentic Startup is distributed as Claude Code marketplace pluginsβnative integration with zero manual configuration.
Core workflow orchestration β 9 commands, 16 skills, 2 output styles
| Category | Capabilities |
|---|---|
| Build | specify β validate β implement pipeline with parallel agent coordination |
| Quality | Multi-agent code review, security scanning, test coverage checks |
| Maintain | Documentation generation, codebase analysis, safe refactoring, debugging |
| Git | Optional branch/commit/PR workflows integrated into commands |
π View detailed command documentation β
Specialized agent library β 11 roles, 27 activity-based specializations
| Role | Focus Areas |
|---|---|
| Chief | Complexity assessment, activity routing, parallel execution |
| Analyst | Requirements, prioritization, project coordination |
| Architect | System design, technology research, quality review, documentation |
| Software Engineer | APIs, components, domain modeling, performance |
| QA Engineer | Test strategy, exploratory testing, load testing |
| Designer | User research, interaction design, design systems, accessibility |
| Platform Engineer | IaC, containers, CI/CD, monitoring, data pipelines |
| Meta Agent | Agent design and generation |
π View all available agents β
The Start plugin includes two output styles that change how Claude communicates while working. Both maintain the same quality standardsβthe difference is in personality and explanation depth.
Switch anytime: /output-style start:The Startup or /output-style start:The ScaleUp
High-energy execution with structured momentum.
- Vibe: Demo day energy, Y Combinator intensity
- Voice: "Let's deliver this NOW!", "BOOM! That's what I'm talking about!"
- Mantra: "Done is better than perfect, but quality is non-negotiable"
Best for: Fast-paced sprints, high-energy execution, when you want momentum and celebration.
Calm confidence with educational depth.
- Vibe: Professional craft, engineering excellence
- Voice: "We've solved harder problems. Here's the approach."
- Mantra: "Sustainable speed at scale. We move fast, but we don't break things."
Unique feature β Educational Insights: The ScaleUp explains decisions as it works:
π‘ Insight: I used exponential backoff here because this endpoint has rate limiting. The existing
src/utils/retry.tshelper already implements this pattern.
Best for: Learning while building, understanding codebase patterns, onboarding to unfamiliar codebases.
| Dimension | The Startup | The ScaleUp |
|---|---|---|
| Energy | High-octane, celebratory | Calm, measured |
| Explanations | Minimalβships fast | Educational insights included |
| On failure | "That didn't work. Moving on." | "Here's what failed and why..." |
| Closing thought | "What did we deliver?" | "Can the team maintain this?" |
Research shows 2-22% accuracy improvement with specialized task agents vs. single broad agents (Multi-Agent Collaboration, 2025). Leading frameworks organize agents by capability, not job titles. The Agentic Startup applies this research through activity-based specialization.
Development often moves too fast without proper planning:
- Features built without clear requirements
- Architecture decisions made ad-hoc during coding
- Technical debt accumulates from lack of upfront design
- Teams struggle to maintain consistency across implementations
1. Specify First β Create comprehensive specifications before writing code
- product-requirements.md β What to build and why
- solution-design.md β How to build it technically
- implementation-plan.md β Executable tasks and phases
2. Review & Refine β Validate specifications with stakeholders
- Catch issues during planning, not during implementation
- Iterate on requirements and design cheaply
- Get alignment before costly development begins
3. Implement with Confidence β Execute validated plans phase-by-phase
- Clear acceptance criteria at every step
- Parallel agent coordination for speed
- Built-in validation gates and quality checks
4. Document & Learn β Capture patterns for future reuse
- Automatically document discovered patterns
- Build organizational knowledge base
- Prevent reinventing solutions
Measure twice, cut once β Investing time in specifications saves exponentially more time during implementation.
Documentation as code β Specs, patterns, and interfaces are first-class artifacts that evolve with your codebase.
Parallel execution β Multiple specialists work simultaneously within clear boundaries, maximizing velocity without chaos.
Quality gates β Definition of Ready (DOR) and Definition of Done (DOD) ensure standards are maintained throughout.
Progressive disclosure β Skills and agents load details only when needed, optimizing token efficiency while maintaining power.
Reusable architectural patterns and design decisions:
| Pattern | Description |
|---|---|
| Slim Agent Architecture | Structure agents to maximize effectiveness while minimizing context usage |
- Start Plugin Documentation β Workflow commands and skills
- Team Plugin Documentation β Specialized agents and skills library
- Migration Guide β Upgrading from v1.x
Ready to 10x your development workflow?
Let's ship something incredible! π
