Claude Codeの記事が薄くなる理由——AIエージェントに設計議論が届いていなかった

• URL: https://zenn.dev/tottoko_hamu/articles/2026-06-02-120000
• 日付: 2026-06-11
• Tier: Tier 3
• 要旨: Writerエージェントが書く記事が「正確だが生きていない」問題の根本原因を特定した実録。問題は書き方ではなく「設計議論の生発言がWriterの参照範囲にない」構造的欠陥にあり、対話アーカイブシステム（knowledge/dialogue/）を実装することで解決した。

詳細

問題の構造：

• Writerエージェントが参照できるのはcontent/writing/netacho/（ネタ帳）のみ
• 設計議論・判断の迷い・「なぜこの選択か」の根拠はネタ帳に転写されない限り消える
• セッションが終わると対話ログは失われる

3案比較と選択：

1. 入口で拾う案（運用ルール強化）
2. 物理保存案（対話をgrepできるデータベース）← 採用
3. 執筆時参照案（プロンプト強化）

選択理由：「私が保存してといったときだけでいい」という制約が自動化の過剰複雑化を防いだ。

実装内容（5ファイルのみ、スクリプトなし）：

• knowledge/dialogue/README.md（ディレクトリ説明）
• ops/playbooks/dialogue-archive.md（アーカイブ手順）
• .claude/agents/writer.md（参照Playbook追記）
• .gitignoreに例外追加（/knowledge/* + !/knowledge/dialogue/）

要約せずそのまま写す：要約すると生の言葉が失われる。引用は一字一句の精度が素材価値を決める。

メタ構造：対話アーカイブシステムの設計議論が、そのシステムで保存された最初の記録になった。保存した素材が後の記事で実際に使われ「保存したから引けた」サイクルを実証。