27 lines
2.4 KiB
Markdown
27 lines
2.4 KiB
Markdown
---
|
|
title: OpenWiki
|
|
created: 2026-07-01
|
|
updated: 2026-07-01
|
|
type: entity
|
|
tags: [tool, wiki, knowledge-base, markdown, agent, dev-tool, automation]
|
|
sources: [raw/articles/langchain-openwiki-repo-documentation-agent-2026.md]
|
|
confidence: medium
|
|
---
|
|
|
|
# OpenWiki
|
|
|
|
OpenWiki は LangChain が公開した、コードベース向けの文書生成・保守 CLI / agent。リポジトリ内に `openwiki/` を作り、コードの構造、主要ロジック、ファイル間の関係、慣習を agent が参照しやすい Wiki として残す。[[litho]] と同じく「コードから持続的な知識面を作る」道具だが、OpenWiki は C4 図よりも、coding agent が必要な文脈を巨大な instruction file に詰め込まず発見できるようにする点を前面に出している。
|
|
|
|
## Design implications
|
|
|
|
- `AGENTS.md` や `CLAUDE.md` に Wiki 全体を貼るのではなく、生成済み Wiki への参照と使いどころを追加する。これは [[agent-harness-engineering]] の repo-local instruction 設計に近く、instruction file を「すべての知識」ではなく「探し方の入口」として扱う。
|
|
- `openwiki --init` で初期文書を作り、`openwiki --update` と GitHub Actions の定期実行で差分を読み、既存 Wiki を更新する。これは [[wiki-maintenance-loop]] をコードベース文書へ寄せた形で、docs drift を手作業ではなく scheduled loop で抑えようとする。
|
|
- OpenRouter、Fireworks、Baseten、OpenAI、Anthropic など複数 provider を扱い、DeepAgents と LangSmith tracing を使える。生成結果だけでなく、文書生成 agent が何をしたかを trace できる点は [[loop-engineering]] の observability / persistence と接続する。
|
|
- Karpathy の [[llm-wiki-pattern]]、DeepWiki、AutoWiki への明示的な参照があり、coding agent 用の repo wiki は個人研究 Wiki とは別用途ながら、巨大 context を毎回読み込むより「保守された Markdown 知識面を使う」という同じ設計方向にある。
|
|
|
|
## Open questions
|
|
|
|
- 生成された repo Wiki の差分を、人間 reviewer がどの粒度で見るべきか。
|
|
- agent が Wiki の古い記述を信じて誤った修正をしたとき、どの evaluator / test / trace が検出するか。
|
|
- [[digital-gardening-cms]] 的な人間向け文書と、OpenWiki 的な agent 向け文書を同じリポジトリでどう分けるか。
|