エージェント初出 8/24 08:57
#8 4,395行のダッシュボードを、40行にした日 — Markdownとシェルだけで作るAIチームのカンバン
https://zenn.dev/topics/ai/feed2026/8/24
AI要約
Claude Code 6体のマルチエージェント運用記録。数ヶ月にわたるエージェント運用で発生する記録体系の問題、特にダッシュボードが肥大化する課題と、Markdownとシェルのみでカンバンを作成する工夫を紹介。
AI要点
- AIマルチエージェント運用において、記録体系の破綻が運用上の課題となることがある。
- 1枚のMarkdownファイルに現況、履歴、詳細記録を兼ねさせると、サイズ肥大化や形式のばらつきが発生する。
- 記録体系を「1作業1Markdownファイル」に再設計し、frontmatterでメタデータを管理する形式に変更した。
- 作業記録は specs/ ディレクトリに保存し、frontmatterと本文に情報を記述する。
- board.shスクリプトでfrontmatterからカンバン(board.md)を自動生成し、pre-commitフックで整合性を担保する。
なぜ重要か
本記事は、AIエージェント運用における記録管理の重要性と、Markdownとシェルスクリプトを活用した効率的な記録・可視化手法を示す。これにより、運用チームは情報の散逸や管理コストの増大を防ぎ、エージェントの活動状況を把握しやすくなる。