# Minimum Viable

> Before building anything, justify the tool choice and complexity level. Could a shell script do this? Does it need Node.js? A full application? Prevents over-engineering by requiring explicit justification before choosing a heavier approach. Use when this capability is needed.

- Skill: `tomevault-io/minimum-viable` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/minimum-viable`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/minimum-viable/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/minimum-viable

---


# Minimum Viable Implementation Check

Answer every question before writing any code. If the simple version is sufficient, build that. Document why only if you choose a heavier approach.

## Required Questions

**1. What are you building?**
One sentence. If you cannot describe it in one sentence, the scope is not defined yet.

**2. What is the simplest possible implementation?**
Usually: a shell script, a single file, a few commands piped together, a cron entry, a git hook. Describe it. Estimate the line count.

**3. Why is the simple version insufficient?**
State a concrete reason. Not "it won't scale" but "it cannot handle binary data" or "it requires a persistent HTTP connection." If you cannot state a concrete reason, build the simple version.

**4. What is the proposed implementation?**
If you are not building the simple version: name the language, framework, and every dependency. Justify each one.

**5. Are dependencies available and working on this platform?**
For each dependency: is it installed? Does it work on the current OS and architecture? Have you verified this, or are you assuming? Check before committing to an approach.

**6. What is the maintenance cost?**
Will this break when a dependency updates? Who fixes it? If the answer is "whoever is here then," that is a cost. Weight it against the benefit of the heavier approach.

## Decision Rule

- If question 3 has no answer: build the simple version, stop here.
- If question 3 has an answer: proceed with the proposed implementation, but document the reason in a comment or README so the next person knows why the complexity exists.
- If question 5 reveals a missing dependency: verify availability before starting, or redesign to avoid it.

---
> Source: [ferrumclaudepilgrim/claude-code-android](https://github.com/ferrumclaudepilgrim/claude-code-android) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-18 -->

