AI coding agents are fast, but they cut corners. Agent Skills is an open-source project by Addy Osmani that gives agents the same structured workflows senior engineers follow, from spec to ship. This post breaks down how it works, explains the Google engineering principles it builds on (Hyrum’s Law, Chesterton’s Fence, the Beyonce Rule, Shift […]
Read More →A practitioner’s guide to knowing which one you actually need. “Spec-driven” is not one practice. It is a ladder—spec-first (write then ship, spec often rots), spec-anchored (spec and code stay checked in CI), and spec-as-truth / spec-as-source (humans edit only the spec; code is generated). This piece maps the three levels (after Birgitta Böckeler on martinfowler.com), their tradeoffs, a cheat sheet, and […]
Read More →OpenSpec is a spec-driven development (SDD) framework designed to align humans and AI coding assistants by creating reviewable specifications before any code is written. It acts as “version control for intent,” helping to prevent “vibe coding” and maintain consistency. 1. Setup & Installation Get started by installing the CLI globally and initializing your project: 2. […]
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 →