Last updated October 13, 2026
On this page
Welcome to ProvenMap
ProvenMap turns scattered architecture knowledge into a queryable system map. It builds the map from your code and docs, keeps it in sync, and lets you ask about it in chat. Teams plan, review, and verify changes on the same map.
How it works
ProvenMap works in three steps: understand, plan and evolve.
Understand. Add sources (code, docs, URLs) and work with them in your workspace using boards, insights, and chat. Publish read-only boards so the rest of your team can use the same view.
Plan. Write what should change as a work item, on the board itself. A work item is a living spec, and it can start as an outcome or as a concrete piece of work.
Evolve. Developers take handed-off work items into their coding sessions and implement them in the repo. The next sync updates the map and verifies structural work against the code.
Every board is made of nodes (components) and edges (connections). Nodes & Edges explains both.
Start here
Choose the plugin-led path, or draw the landscape yourself and then map repos into it.
Getting Started — Plugin or Chat
An interview, in the workspace plugin or in chat, draws the landscape. The code plugin then builds each board from its repo.
Getting Started — Hands-On
Draw the landscape yourself from the archetype library, then add layers, repos, and docs.
Org Intelligence
Connect many boards into one queryable, org-wide landscape.
For Every Role
How systems, code, product and leadership roles each use the same loop.