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.

来源