【要約】AIが毎日量産するplan_*.mdを腐らせない。docsweepをPyPIに初リリースした [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
AIコーディングツールを利用する開発者が、大量に生成される作業記録Markdownの管理に苦慮している。AIが生成する計画書やバグ修正記録が、実態と乖離したまま蓄積される問題が発生している。具体的には以下の課題がある。
- ・実装済みの計画ファイルが「実行中」のまま放置される。
- ・古い計画をAIが誤って参照し、作業の重複を招く。
- ・タスク管理ツールへ移行すると、AIがファイルを直接読めなくなる。
- ・状態の更新が人間の記憶に依存しており、管理コストが増大する。
// Approach
Markdownファイルを正本として維持しつつ、ステータス管理のみを機械的に行う設計を採用した。人間またはAIがラベルで判断を下し、docsweepが物理的な移動を担う。具体的な手法は以下の通りである。
- ・H1ラベルの規約に基づき、[計画] [実行中] [完了] などの状態を読み取る。
- ・「完了」や「廃止」と判定されたファイルを自動でarchiveへ移動する。
- ・CLI、Web UI（カンバン方式）、MCPサーバーの3つの口を提供する。
- ・Python単体で動作する構成とし、Node.js環境への依存を排除した。
// Result
開発者が408個あった管理対象ファイルを、効率的に整理できる環境を構築した。ツール導入により、管理の精神衛生と作業効率が向上している。主な成果は以下の通りである。
- ・Web UIにより、期日切れタスクの延期や一括廃止が数クリックで完了する。
- ・MCP対応により、AIエージェント自身がタスクの状態を自律的に更新可能になる。
- ・ドッグフーディングを通じて、アーカイブ先の設定ミス等の致命的なバグをリリース前に修正した。
Senior Engineer Insight
> AIとの協調開発において、ドキュメントの「鮮度」は極めて重要だ。本ツールは、ドキュメントをDBに逃がさず「ファイルそのもの」として扱う思想が優れている。これにより、Git履歴との整合性とAIのコンテキスト利用を両立している。運用上の鍵は、AIにH1ラベルの規約を徹底させることだ。MCP経由での自律的な更新が実現すれば、管理コストは劇的に下がるだろう。実戦投入時は、archive先のディレクトリがgitignoreされているかを必ず確認すべきだ。