mdspec.dev

Andrey Chernyshev and Mohammed Zameer looked at how teams handle specs and realized everyone was treating markdown files like they were code—committing them, branching them, merging conflicts on words. That's insane when you're drafting requirements, not shipping features. So they built mdspec.dev, an open-source platform that gives specifications their own home, completely separate from your repository.

Here's the problem: specs belong in Git until they don't. You want to brainstorm freely, iterate without history bloat, and share drafts across teams without triggering merge conflicts. mdspec stores your markdown files in the cloud, tracks every revision separately from Git, and lets you anchor comments to specific sections—so actual conversations happen right next to the content that needs them. It works with VSCode, Cursor, and Antigravity, so it's not some separate tool you have to switch to. You're writing markdown in your IDE, same as always, except now your specs live in mdspec and sync seamlessly. Cross-project referencing means Frontend and Backend teams can share API docs without copy-pasting into a monorepo. The native diff-viewer handles conflicts so you never accidentally overwrite your teammate's work.

mdspec is early—but the vision is clear. Specs shouldn't be hostage to your commit history. They're building the spec management layer that developers didn't know they needed but won't be able to live without once they try it.