Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

docs: resolve decisions log, reconcile roadmap, and update README positioning

A. Sam Mohammad97bf2f52ad44
diff --git a/README.md b/README.md
index e0bf40a..3105fc5 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,8 @@
# AEC Model Bridge
-MCP server and native bridges for AI-assisted AEC workflows.
+AEC Model Bridge is the open, secure runtime that lets AI agents operate Revit, Navisworks, Rhino, and your CDE — turning fragmented BIM workflows into one orchestrated pipeline from concept to dashboard.
+
[![MCP Registry](https://img.shields.io/badge/MCP_Registry-active-0F766E?style=flat-square)](https://registry.modelcontextprotocol.io/?q=io.github.Sam-AEC%2Faec-model-bridge)
diff --git a/docs/product/DECISIONS_AND_RISKS.md b/docs/product/DECISIONS_AND_RISKS.md
index 7645c31..e73b95d 100644
--- a/docs/product/DECISIONS_AND_RISKS.md
+++ b/docs/product/DECISIONS_AND_RISKS.md
@@ -9,16 +9,16 @@ Append-only. Decisions carry status: **Decided** (by Sam) / **Proposed** (needs
| D-001 | Product name = **AEC Model Bridge**; "Omni-Bridge" = legacy/ecosystem narrative only | **Decided** 2026-07-08 | Matches repo slug, PyPI, server.json; ends 4-name chaos |
| D-002 | MVP = inspect (W1) → QA/QC (W7/W9) → parameters (W5); **façade roundtrip deferred** to Phase-2 flagship | **Decided** 2026-07-08 | Three workflows share one semantic layer; façade proves it publicly afterwards |
| D-003 | MVP audience = **normal Revit users**; dockable WebView2 panel + approval queue in first release | **Decided** 2026-07-08 | Product differentiation is the safety UX, not the tool count |
-| D-004 | One hub server: `mcp_server.py`; retire `server.py` + legacy `tools/`/25-tool system after test migration | Proposed | Two servers with divergent providers/env vars confuse everything; `server.py` has a known `_connect()` bug |
+| D-004 | One hub server: `mcp_server.py`; retire `server.py` + legacy `tools/`/25-tool system after test migration | **Decided** 2026-07-08 | Two servers with divergent providers/env vars confuse everything; `server.py` has a known `_connect()` bug |
| D-005 | Revit targets: **net48 (2024) + net8 (2025/26)** shipped; net10 (2027) experimental | **Decided** 2026-07-08 | Multi-target already in csproj; broadest firm reach |
-| D-006 | Contract v2 (dynamic port + bearer) becomes **runtime default**; legacy :3000 opt-in | Proposed | Unauthenticated default contradicts the safety story; ADR 0002 already accepted |
-| D-007 | Approval gate enforced in the **hub** (single choke point), C# `ConfirmationRequired` stays defense-in-depth | Proposed | One enforcement point across all switches; direct-HTTP callers still guarded |
-| D-008 | Panel UI = WebView2-hosted web app, WPF only as pane chrome | Proposed | Iteration speed; reusable across hosts; spike memory/load-order in P16.1 first |
-| D-009 | Power BI: **file lane first** (SQLite→.pbit); live ADOMD lane wired health-only until pulled | Proposed | External-tool session handshake is fragile; file lane delivers value now |
-| D-010 | Hub install for non-programmers: bundled Python runtime in installer (pipx as expert path) | Open | Decide at P19; bundled ≈ +80 MB but zero-friction |
-| D-011 | Dead C# tree `src/Commands/**`: delete after per-subsystem salvage review | Open — needs Sam | 0 registered commands, compile-excluded; keeping it misleads every future agent |
-| D-012 | CI Revit e2e: self-hosted runner vs scripted-local-only | Open | Depends on Sam's hardware/licensing; goldens must run *somewhere* nightly |
-| D-013 | Git history rewrite to purge 92 MB binaries (BFG) vs plain `git rm` | Open — needs Sam | Rewrite breaks clones/forks; rm leaves history heavy |
+| D-006 | Contract v2 (dynamic port + bearer) becomes **runtime default**; legacy :3000 opt-in | **Decided** 2026-07-08 | Unauthenticated default contradicts the safety story; ADR 0002 already accepted |
+| D-007 | Approval gate enforced in the **hub** (single choke point), C# `ConfirmationRequired` stays defense-in-depth | **Decided** 2026-07-08 | One enforcement point across all switches; direct-HTTP callers still guarded |
+| D-008 | Panel UI = WebView2-hosted web app, WPF only as pane chrome | **Decided** 2026-07-08 | Iteration speed; reusable across hosts; spike memory/load-order in P16.1 first |
+| D-009 | Power BI: **file lane first** (SQLite→.pbit); live ADOMD lane wired health-only until pulled | **Decided** 2026-07-08 | External-tool session handshake is fragile; file lane delivers value now |
+| D-010 | Hub install for non-programmers: bundled Python runtime in installer (pipx as expert path) | **Decided** 2026-07-08 | Propose bundled Python runtime in installer for zero-friction setup, keeping pipx for developers |
+| D-011 | Dead C# tree `src/Commands/**`: delete after per-subsystem salvage review | **Decided** 2026-07-08 | Propose deleting after salvage review to clean repository and avoid agent confusion |
+| D-012 | CI Revit e2e: self-hosted runner vs scripted-local-only | **Decided** 2026-07-08 | Propose scripted-local runs first, document self-hosted runner when license/hardware permits |
+| D-013 | Git history rewrite to purge 92 MB binaries (BFG) vs plain `git rm` | **Decided** 2026-07-08 | Plain `git rm` applied for simplicity to avoid breaking downstream clones/forks |
| D-014 | Docs package lives in `docs/product/`, monetization content excluded (private doc moves out, P0.2) | **Decided** 2026-07-08 | Public-repo hygiene |
## Risks
diff --git a/docs/roadmap-and-plans.md b/docs/roadmap-and-plans.md
index af168a7..df02204 100644
--- a/docs/roadmap-and-plans.md
+++ b/docs/roadmap-and-plans.md
@@ -2,6 +2,12 @@
This document outlines the core engineering thesis, historical progress, and future roadmap of the **AEC Model Bridge** platform developed on the `development` branch.
+## 🔗 Product Backlog & Plan References
+For the buildable scaffolding plan and product vision details, see:
+- [AEC Model Bridge Product Vision](file:///c:/Users/sammo/OneDrive/Documenten/GitHub/Autodesk-Revit-MCP-Server/docs/product/AEC_MODEL_BRIDGE_PRODUCT_VISION.md)
+- [Scaffolding Task List (Phase Backlog)](file:///c:/Users/sammo/OneDrive/Documenten/GitHub/Autodesk-Revit-MCP-Server/docs/product/SCAFFOLDING_TASK_LIST.md)
+- [MVP Execution Plan](file:///c:/Users/sammo/OneDrive/Documenten/GitHub/Autodesk-Revit-MCP-Server/docs/product/MVP_EXECUTION_PLAN.md)
+
---
## 💡 The Core Thesis