Version control overview
On this page
Version control overview
Automatic change history for your whole project — every edit is recorded, attributed, and revertable, with no commits to manage. · Optional
You don't have to do anything to use version control — VibeMap records changes in the background. Read this to understand what's tracked and how to think about the history when you need it.
Think of it as Git for your project specification, built into the editor. You never commit anything; VibeMap captures changes for you automatically.
Why it matters
A project goes through hundreds of small edits between the first generation and a handoff-ready spec — the conversational agent adds features, AI regenerations rewrite sections, you tweak personas by hand, your IDE agent adds acceptance criteria via MCP. After a long session it's easy to lose track. Version control answers four questions on demand:
- What changed? — a timeline of every edit, generation, and agent operation.
- Who changed it? — every change is attributed to you, a teammate, the AI, the MCP tool, or a system process.
- What exactly did it touch? — open any version to see its per-entity create / update / delete diff.
- Can I get the old version back? — yes, one click. Reverting is non-destructive: your current state stays in the timeline, so you can always come back.
What gets tracked
Every mutation to the following project content is captured:
| Area | Tracked entities |
|---|---|
| Features | feature cards (name, description, priority, complexity, effort, value) |
| User stories | the story cards under each feature |
| Acceptance criteria | given / when / then triples, including sprint assignment |
| Personas | persona cards (name, role, demographics, goals, pain points) |
| Pages & sections | page rows and the section tree inside each page |
| Page links | navigation links between pages |
| Schema | tables, columns, access rules |
| Business case & financial analysis | the research write-ups on the project |
| Colour schemes | brand colour sets |
| Project context & prompt | context additions and edits to the project prompt itself |
Not tracked (for now): account settings, billing, team membership, API keys, file structure / pseudocode, and uploaded reference files.
How changes are grouped
Related edits made close together bundle into a single changeset — a unit of work, like a Git commit — so the timeline stays readable. A changeset gathers edits over roughly a 5-minute window; after a pause, VibeMap closes it, captures a snapshot of your project at that moment, and the next edit starts a new one.
Grouping respects who did the work:
- You editing in the UI for a few minutes → one changeset attributed to you.
- The conversational agent running a multi-step operation → one changeset attributed to the AI.
- A batch regeneration (e.g. "generate all user stories") → one changeset for the batch.
- Your IDE agent calling VibeMap via MCP → one changeset per tool call, attributed to MCP.
The actor types
Every version is tagged with who made the change, with a colour-coded badge:
| Badge | Actor | Meaning |
|---|---|---|
| you (blue) | The logged-in user | An edit you made — in the UI or via the agent |
| user (blue) | Another teammate | An edit by someone else on a shared team project |
| AI (violet) | AI pipeline | A regeneration or large AI-driven update |
| MCP (emerald) | Your IDE agent | A change pushed in via the VibeMap MCP server |
| system (zinc) | System process | Internal automation, e.g. a backfill or revert |
Where it lives
Version control is the History tab at the top of every project. Open it to browse the timeline, inspect any version's diff, rename changesets, and revert.
💡 Tip: The conversational agent's edits are wrapped in their own changesets, so anything the agent does is fully revertable — you can undo an agent operation the same way you'd undo your own edit.
⚡ Power-user hints
- Snapshots power one-click revert. VibeMap stores a full snapshot at the end of every closed changeset. Very old snapshots are eventually pruned; a version with no snapshot is marked "No snapshot — read only" (you can still view its diff, just not revert directly to it).
- Rename as you go. Auto-titles are generic. Renaming a changeset to "Added admin panel features" costs nothing and makes future-you far faster at finding a rollback point — see Viewing history.
↔ The traditional way
A hand-run spec lives in docs and tickets with no change history — when something gets overwritten, there's no undo and no record of who did it. Engineers get this from Git, but only for code. VibeMap brings the same safety net to the specification itself, automatically, without asking you to commit.
What's next
- Viewing history → — read the timeline and inspect a version's diff.
- Reverting changes → — roll back safely and know exactly what's restored.