Stop Making AI Agents Grind Through Huge Codebases — I Built a Deterministic Wiki Build System for Them

说明与用途

repowiki 是一个确定性 CLI 工具，用于为大型仓库生成维基。它支持多代理并行任务分配，确保文档以代码形式存储、经过验证并可在 CI 中审查。

问题

Large codebases make AI agents struggle to generate reliable, up‑to‑date wikis: context doesn’t fit, interruptions reset progress, and parallel coordination is manual. Existing solutions either require cloud access, lock into a single IDE, or lack incremental, versioned output.

结果

repowiki enables reliable, parallel, and incremental wiki generation for large codebases without external API calls, ensuring documentation stays in sync with code and is reviewable via standard git workflows.

工作流

• 1. Run repowiki plan to scan the repo and split it into per‑page tasks.
• 2. Execute repowiki next to atomically claim a task directory.
• 3. Use any LLM agent (Claude Code, Codex, OpenCode, or a human) to generate the page content within the claimed task.
• 4. Agent writes output to the task directory; repowiki validates anchors, line numbers, and citations.
• 5. If validation passes, repowiki finalizes the page; otherwise the agent rewrites the page.
• 6. Repeat until all tasks are completed.
• 7. Run repowiki assemble to build the final wiki site and commit it to the repository.

证据

repowiki is "a build system that generates a structured wiki for any repository."

来源

The task catalog, claims, and heartbeats all live on disk under <repo>/.repowiki/

来源

The output is wiki‑as‑code. Markdown + mermaid diagrams + file:// source citations with line ranges, committed straight into your repository

来源