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 →Blurb: DESIGN.md is an open spec for encoding your visual identity in one repo file: YAML tokens plus Markdown rationale, a CLI for linting (including WCAG contrast) and exporting to Tailwind or DTCG, and a plain-text contract so coding agents stop improvising your design system from scratch. Contents When you ask a coding agent to build […]
Read More →512,000+ lines of Anthropic’s Claude Code CLI leaked from a source map left in their public npm package. 1,900 TypeScript files exposing multi-agent orchestration, 40 permission-gated tools, and unreleased feature flags. Not a hack. A build config nobody checked. Table of contents Anthropic’s Claude Code CLI, all 512,000+ lines of it, got exposed to the […]
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 →