| name | mvp-design |
| description | Use when designing new modules from scratch, creating minimal viable prototypes, or establishing architectural decisions before implementation |
| version | 1 |
MVP Design Skill
Overview
This skill guides the design of minimal, production-ready code prototypes with clear architecture and self-documenting code, emphasizing design decisions over implementation details.
Design minimal, production-ready code prototypes with clear architecture and self-documenting code.
When to Use
Use this skill when you need to:
- Design a new module or subsystem from scratch
- Create a minimal viable prototype (MVP) for rapid iteration
- Establish coding patterns and architectural decisions
- Plan implementation before writing actual code
- Design replacement systems alongside existing ones
Core Principles
1. Code as Documentation
- Code itself is readable - clear naming, simple structure
- Minimal comments - code explains itself
- Self-documenting functions - verb-based naming, obvious parameters
2. Documentation as Design
- No code in documentation - code lives in the project
- Document "why", not "how" - architectural decisions and rationale
- Focus on design patterns - data flow, component interaction
- Interface contracts - what goes in, what comes out
3. Minimal Viable Scope
- - forces focus on essentials