Some context:

I intentionally avoided OpenAPI / heavy spec formats. The goal was: - something devs actually write - easy to diff in PRs - flexible enough for non-API workflows too

If you’ve tried spec-first approaches before and bounced off them, I’d love to know what didn’t work for you.