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 →

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 →