2.3 KiB
2.3 KiB
title, created, updated, type, tags, sources, confidence
| title | created | updated | type | tags | sources | confidence | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Litho | 2026-06-30 | 2026-07-01 | entity |
|
|
medium |
Litho
Litho(deepwiki-rs)は、ソースコードから C4 model のアーキテクチャ図と Wiki 風ドキュメントを自動生成する Rust 製の AI 文書化エンジン。README では、コードベース解析、依存関係・構造抽出、LLM によるドキュメント生成、Mermaid 図、CI/CD 連携、外部知識の取り込みを特徴としている。
Yuta の Wiki 文脈では、これは digital-gardening-cms や llm-wiki-pattern と同じ「読むたびに都度検索する」のではなく、「コードから持続的に読める知識面を作る」方向の道具。ただし Litho は人間の研究 Wiki というより、コードベース理解・オンボーディング・設計書の鮮度維持に寄っている。同じ方向の openwiki は、C4 図よりも agent instruction file から参照される repo Wiki と scheduled update に重点を置く。
Design implications
- 設計書が腐る問題を、手書きドキュメントではなくコード解析と生成のループで扱う。
- C4 の context/container/component/code レベルを出力するため、単なる README 生成よりも構造化された設計理解を狙う。
- CI/CD で毎コミット生成できると説明しており、wiki-maintenance-loop 的な継続更新をソフトウェア設計書に適用する例になる。
- 生成物は便利だが、アーキテクチャ判断の正しさや命名の妥当性は別途レビューが必要。自動生成 Wiki は、信頼できる最終文書というより、保守される下書き・索引として扱うのが安全。
Open questions
- 生成された C4 図や説明が、実際の設計意図とずれたときに誰がどう検証するか。
- コードから抽出できない運用上の制約、歴史的経緯、暗黙の責務をどこで補うか。
- LLM 生成ドキュメントを CI/CD に組み込む場合、差分レビューとノイズ抑制をどう設計するか。