spec-driven-architecture

What problem does it solve?

This Skill eliminates uncertainty and ad-hoc design by forcing teams to produce a complete, reviewable architecture specification before any implementation begins. It helps surface interfaces, edge cases, data flows, and failure modes so code becomes a faithful artifact of a vetted design rather than guesswork.

Core Features & Use Cases

• Structured Spec Template: A repeatable skeleton covering header, overview, typed data model, behavior rules, contracts, validation, reducer logic, edge cases, integration points, and resolved decisions.
• Developer-Ready Outputs: Produces implementation-ready artifacts that a developer or agent can use to build modules independently.
• Risk Reduction: Clarifies priorities, validation gates, and resolution order to prevent ambiguous behaviors and subtle bugs.
• Use Cases: Designing a leaderboard module with ELO updates, specifying a notification delivery system, or drafting a matchmaking queue state machine before coding.

Quick Start

Write a complete spec for the leaderboard module that defines scope, typed data models, rating behavior, action contracts, validation rules, edge cases, and integration points.