Introduction
Throughspec is a publishable scaffolding tool - distributed on npm and PyPI - that bootstraps a Claude Code project around a deterministic, spec-first SDLC.
The value proposition is simple: collapse the gap between idea and shipped software. You provide decisions; Claude does the heavy lifting; the Kit enforces structure so the work compounds rather than drifts.
Composes, never replaces
Throughspec sits on top of Claude Code’s permission, hook, and settings model. It scaffolds process, not application source - and never hosts or runs Claude Code itself.
Core philosophy
The Kit is built on three load-bearing beliefs.
Spec-driven beats vibe-driven. Cross-questioning before code generation beats open-ended prompting - so specs are a precondition.
Memory beats re-derivation. Re-reading source to reconstruct intent is a token tax. The Kit writes condensed memory once and amortizes it.
Structure compounds. A predictable layout means skills, agents, and humans always know where to look. The Kit refuses to ship freeform.
Who it’s for
Vibe-CoderNon-developer building real products through prompting - needs a safe, opinionated workflow that prevents drift.StudentLearning engineering via real projects - needs an auditable trail of why every decision was made.Solo EngineerUsing Claude Code for velocity - needs token-efficient context and a reproducible SDLC.Team LeadAdopting AI-first engineering - needs a shared structural contract every contributor follows.