Visualize architecture changes from the docs you already wrote

Описание и применение

Switchplinth автоматически преобразует существующие Markdown‑документы ADR, RFC и дизайн‑ноты в граф архитектуры, связывая каждое решение с исходным фрагментом текста и позволяя интерактивно переключать альтернативы, чтобы увидеть изменения в схеме.

Задача

Teams struggle to understand why components exist or how rejected options would alter the system because ADRs, RFCs, and design notes are scattered and lack explicit links to the architecture model.

Результат

Switchplinth turns existing Markdown decisions into a dynamic graph, enabling teams to see the impact of alternative choices and to trace every component back to its justification passage.

Рабочий процесс

• Discover all .md files and skip hidden/generated folders
• Split each file into passages at headings and blank lines
• Create evidence anchors with path, heading, hash, and context
• Extract decisions, entities, and options via rules or LLM
• Validate and write each record as a YAML file in .decision/
• Human review appends judgments or undos without editing inference
• Compile selected options into a graph, applying operations and checking conflicts
• Rebuild SQLite full-text and Qdrant vector indexes
• Render UI map, What‑if previews, and expose MCP tools

Доказательства

Switchplinth reads the Markdown already in a repo and treats each decision as the thing being modeled, with the documents as evidence.

Источник

The UI draws the graph, shows the cited passages for a component, and lets you switch a decision's option and watch the map update.

Источник

Each option adds its own resource and points it at a shared technology node. No option writes to the shared node, which is why two decisions can both use SQS without a conflict.

Источник