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 skill 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 | Skill 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 skill walks you through each step interactively. You provide context and make decisions — the skill handles research, structure, and writing. --- ## Quick Start ### 1. Add the Marketplace ```bash /plugin marketplace add maquina-app/rails-claude-code ``` ### 2. Install the Plugin ```bash /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 skill 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 skill begins with research, then asks discovery questions to shape the MVP. ### Plan a SaaS Product ``` > Help me plan a SaaS for freelancers ``` The skill treats this as a full MVP session — research, discovery, and all five deliverables. ### Research Competitors ``` > Research competitors for a booking system ``` The skill 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/ ├── QUICKSTART.md # Quick reference └── skills/mvp-creator/ ├── SKILL.md # Main skill ├── 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`: ```json { "extraKnownMarketplaces": { "maquina": { "source": { "source": "github", "repo": "maquina-app/rails-claude-code" } } }, "enabledPlugins": [ "mvp-creator@maquina" ] } ``` --- ## Next Steps

GitHub Repository

View source code and contribute.

Spec-Driven Development

Continue from MVP to implementation with SDD.

Announcement Post

Watch the full 40-minute walkthrough video.