MVP Creator — Maquina

A Claude Code plugin that creates comprehensive MVP documentation for Rails applications through guided research and discovery. Go from idea to implementation-ready deliverables.

What Is This?

A Claude Code agent that:

Researches your topic using web search and competitive analysis
Guides you through discovery questions to refine the MVP scope
Generates a Research Report with market context and competitor landscape
Produces an MVP Business Plan with feature priorities and user stories
Creates a Brand Guide with visual identity and tone of voice
Builds a Technical Guide with architecture decisions and Rails conventions
Configures Claude Setup (CLAUDE.md, .mcp.json, commands) for development handoff

The Workflow

Step	What Happens
1. Topic/Idea	You describe your app concept or business idea
2. Research	Agent researches competitors, market, and technology landscape
3. Discovery Questions	Interactive Q&A to refine scope, audience, and priorities
4. Generate Deliverables	Five documents produced in sequence
5. Handoff	Ready for Spec-Driven Development to begin implementation

The agent walks you through each step interactively. You provide context and make decisions — the agent handles research, structure, and writing.

Quick Start

1. Add the Marketplace

/plugin marketplace add maquina-app/rails-claude-code

2. Install the Plugin

/plugin install mvp-creator@maquina

3. Start Creating

> I have an idea for a project management app

Deliverables

Every MVP session produces five documents:

Deliverable	Description
Research Report	Competitor analysis, market overview, feature comparison
MVP Business Plan	Vision, feature priorities, user flows, success metrics
Brand Guide	Logo direction, colors, typography, components, voice
Technical Guide	Architecture, patterns, data models, code style
Claude Setup	CLAUDE.md, .mcp.json, and commands for Claude Desktop/Code

Research Report

The agent searches the web for competitors, analyzes their features, pricing, and positioning. You get a structured comparison that informs every subsequent deliverable.

MVP Business Plan

Defines what to build first. Includes prioritized features, user stories, and success metrics. Scoped to what a single developer can ship.

Brand Guide

Visual identity decisions: color palette, typography, component styling, and tone of voice. Ready to apply when building the UI.

Technical Guide

Rails-specific architecture: models, associations, authentication approach, API patterns, and testing strategy. Follows 37signals conventions.

Claude Setup

Pre-configured CLAUDE.md with project context, .mcp.json for MCP server integration, and custom commands. Drop these into your new Rails project and start building with full AI context.

Usage Examples

Start from an Idea

> I have an idea for a project management app

The agent begins with research, then asks discovery questions to shape the MVP.

Plan a SaaS Product

> Help me plan a SaaS for freelancers

The agent treats this as a full MVP session — research, discovery, and all five deliverables.

Research Competitors

> Research competitors for a booking system

The agent focuses on the research phase and produces a detailed competitor analysis.

Create a Business Plan

> Create a business plan for my app idea

Skips research if you already know the market. Goes straight to discovery and deliverables.

Design a Brand

> Design a brand for my Rails project

Generates the Brand Guide deliverable with color palette, typography, and voice guidelines.

Package Contents

mvp-creator/
├── agents/mvp-creator.md               # Main agent
├── QUICKSTART.md                        # Quick reference
├── scripts/
│   └── init.sh                          # Project initialization
└── references/
    ├── rails-philosophy.md              # Rails conventions and principles
    ├── rails-ui-patterns.md             # UI design patterns
    ├── rails-api-patterns.md            # API design patterns
    ├── rails-implementation-patterns.md # Implementation guidelines
    └── deliverable-templates/           # Templates for all 5 deliverables
        ├── research-report.md
        ├── mvp-business-plan.md
        ├── brand-guide.md
        ├── technical-guide.md
        └── claude-setup.md

Team Installation

Add to your project’s .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "maquina": {
      "source": {
        "source": "github",
        "repo": "maquina-app/rails-claude-code"
      }
    }
  },
  "enabledPlugins": [
    "mvp-creator@maquina"
  ]
}