tinyspec — Spec-driven development with Claude Code

1 min read Original article ↗

Spec-driven development
with Claude Code

A tiny framework for writing structured specifications that turn ideas into tracked implementation plans — powered by AI.

Everything you need to plan with AI

Tinyspec keeps your specs structured, your progress visible, and your AI assistant focused on what matters.

Spec-driven workflow

Structure your ideas into Background, Proposal, and Implementation Plan sections. Break work into logical task groups with trackable subtasks.

Claude Code integration

Built-in slash commands — /refine to plan, /work to implement, /task for single steps. Claude reads your spec and works through it methodically.

Progress tracking

Check off tasks as you go with a real-time TUI dashboard. See completion status across all your specs at a glance.

Multi-repo support

Map application names to repository paths. Specs can reference multiple codebases, and tinyspec resolves the paths automatically.

Templates

Create custom spec scaffolds with variable substitution. Standardize how your team writes specs with reusable templates.

Get started in minutes

Install tinyspec, create a spec, and let Claude Code handle the rest.

1

$ curl -fsSL https://tinyspec.dev/install.sh | sh

2

Initialize in your project

3

Create a new spec

$ tinyspec new my-feature

4

Refine with Claude

> /tinyspec:refine my-feature

5

Implement the plan

> /tinyspec:do my-feature

Need to adjust the plan? Run /tinyspec:refine again to iterate, then /tinyspec:do to continue implementing.