minimal-first-implementation

Implement minimal feature versions with exhaustive case coverage and typed errors.

16|3|Updated May 5, 2026
One-click install
npx skills add https://github.com/Kevin-Liu-01/Agent-Machines --skill minimal-first-implementation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minimal-first-implementation
Source: https://github.com/Kevin-Liu-01/Agent-Machines/tree/main/knowledge/skills/minimal-first-implementation
Command: npx skills add https://github.com/Kevin-Liu-01/Agent-Machines --skill minimal-first-implementation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The smallest correct version first approach helps teams avoid overbuilding by ensuring exhaustive case coverage and fail-closed behavior from day one.

Core Features & Use Cases

  • Exhaustive upfront decision space: define all variants before implementation.
  • Fail-closed error handling: unimplemented paths return typed errors rather than silent failures.
  • Lean scope discipline: ship minimal functionality with real consumer value, extract shared components only after second consumer exists.
  • Use Case: when designing new systems, extracting shared packages, or deciding how much to build before shipping.

Quick Start

Identify the core path for your feature and implement only that path, returning typed errors for any unimplemented variants.

Frequently Asked Questions about minimal-first-implementation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the minimal correct version approach in software engineering?

The minimal correct version approach in software engineering designs the smallest functional feature iteration while enforcing exhaustive case coverage and fail-closed behavior. It prevents overbuilding by returning typed errors for unimplemented paths.

How do I avoid over-engineering new features before shipping?

Avoid over-engineering features by defining the core path and implementing only that functionality first. Return typed errors for any unimplemented variants instead of guessing scope, and extract shared packages only after a second consumer exists.

When should I extract shared packages during early-stage design?

Extract shared packages during early-stage design only after a second consumer for the shared logic exists. Premature extraction leads to overbuilding; ship the minimal correct version first and wait for actual duplication to justify abstraction.

How does fail-closed error handling work with unimplemented feature variants?

Fail-closed error handling returns typed errors for unimplemented feature variants instead of allowing silent failures. This exhaustive decision logic ensures all possible paths are explicitly addressed upfront, maintaining system correctness even in an incomplete state.

Does lean scope discipline work for extracting shared components across projects?

Yes, lean scope discipline applies to extracting shared components by enforcing a second-consumer rule. You ship the minimal implementation first, then extract the shared package only when actual duplication occurs across software projects.

What are the limitations of shipping the smallest correct version first?

Shipping the smallest correct version requires upfront exhaustive decision space definition, which adds initial design overhead. It is limited by the need to define all variants before implementation, making it less suited for truly exploratory prototypes lacking clear scope.