In OpenSpec, the standard spec format is a structured Markdown document that defines exactly what a system should do through requirements and how that behavior is verified through scenarios. 1. Core Specification Structure (spec.md) The “Source of Truth” file (located in openspec/specs/<domain>/spec.md) follows a specific hierarchy: 2. The Scenario Format (GIVEN/WHEN/THEN) Scenarios are the most critical […]

Read More →

Vibe coding broke as fast as it shipped. Spec-Driven Development is the industry’s course correction — putting structured specs, not chat prompts, at the center of AI-assisted engineering. This post compares the leading SDD frameworks, their trade-offs, and when (or whether) to adopt one. Table of Contents Introduction: From Vibe Coding to Verified Intent In […]

Read More →

OpenSpec is an open-source framework that brings spec-driven development to AI coding agents. Write specs in Markdown, agree on the plan before writing code, and keep your project’s requirements versioned in Git. Three commands — propose, apply, archive — and your agent finally builds what you actually want. Table of Contents You’ve been there. You […]

Read More →