Skip to content

rsmdt/the-startup

Repository files navigation

The Agentic Startup

Ship faster. Ship better. Ship with The Agentic Startup.

Release Downloads GitHub Stars Mentioned in Awesome Claude Code


Table of Contents


πŸ€– What is The Agentic Startup?

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

Installation

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, educational

πŸš€ Quick Start

Create a specification and implement it:

# Create a specification
/start:specify Add user authentication with OAuth support

# Execute the implementation
/start:implement 001

That's it! You're now using spec-driven development.


πŸ“– The Complete Workflow

The Agentic Startup follows spec-driven development: comprehensive specifications before code, ensuring clarity and reducing rework.

All Commands at a Glance

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    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)     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Step-by-Step Walkthrough

Step 1: Create Your Specification

/start:specify Add real-time notification system with WebSocket support

This 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.

Step 2: Handle Context Limits (Resume Pattern)

Large specifications may approach Claude's context window limits. When this happens:

# Start a new conversation and resume where you left off
/start:specify 001

The 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.

Step 3: Validate Before Implementation

/start:validate 001

This 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.

Step 4: Execute the Implementation

/start:implement 001

Claude will:

  1. Parse the implementation plan
  2. Execute phases sequentially (with your approval between phases)
  3. Run tests after each task
  4. 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.

Step 5: Review and Ship

/start:review

Four 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

🎯 Which Command Should I Use?

Decision Tree

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 Reference

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 Matrix

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 βœ… - - - βœ… βœ… - -

When Commands Overlap

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

πŸ“¦ Plugins

The Agentic Startup is distributed as Claude Code marketplace pluginsβ€”native integration with zero manual configuration.

Start Plugin (start@the-startup)

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 β†’

Team Plugin (team@the-startup) β€” Optional

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 β†’


🎨 Output Styles

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

The Startup πŸš€

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.

The ScaleUp πŸ“ˆ

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.ts helper already implements this pattern.

Best for: Learning while building, understanding codebase patterns, onboarding to unfamiliar codebases.

Comparison

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?"

🎯 Philosophy

Why Activity-Based Agents?

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.

The Problem We Solve

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

Our Approach: Spec-Driven Development

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

Core Principles

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.


πŸ“š Documentation

Patterns

Reusable architectural patterns and design decisions:

Pattern Description
Slim Agent Architecture Structure agents to maximize effectiveness while minimizing context usage

Additional Resources


Ready to 10x your development workflow?
Let's ship something incredible! πŸš€