> TL;DR: Vibe coding ships fast, but it often fails to preserve the reasoning behind product behaviors — and agents refactoring later will “reasonably” change things users rely on. A lightweight behavior spec .pbc.md makes “what must happen / must no...

> TL;DR: CLAUDE.md and AGENTS.md are excellent at steering how agents write code. They were never designed to capture what the product promises to do. When agents refactor, extend, or integrate code, they need a behavior spec — not more workflow inst...