本編（#0000〜#0008）では思想からアーキテクチャ、実装ログまで積み上げてきましたが、今回は少し毛色が違う話です。今日はコードを1行も触っていません。代わりに、開発ドキュメントが気づけば散らかっていた問題と、丸一日向き合っていました。

何が散らかっていたか

ロードマップだけで実質3つのファイルがありました。8/6時点で更新した最新版、8/5時点の引継書（Developer Handbookの目次計画と同居していたもの）、それにGitHubリポジトリのdocs-ja/roadmap/mvp-scope.md。どれも似た内容を持っていて、どれが最新か自分でも分からなくなっていました。

Qiita記事の加筆用に使っていたプロンプトファイルも見返してみると、もっと厄介でした。中の「黄金フォーマット」は、実はこのシリーズの記事生成に使っているtrueful-dev-docsスキルを作った時点で、すでに新フォーマットに置き換わっていて、自分では気づかないまま死んでいた設定だったんです。

正本をどこに置くか

まず決めたのは、ロードマップの置き場所でした。選択肢は3つです。

選択肢	判定
Google Drive	採用
GitHub `docs-ja/roadmap/mvp-scope.md`	却下（同期先としては残すが正本ではない）
Project Knowledgeに1本化	却下

GitHubを正本にしなかった理由は単純で、Claudeがそこに直接書き込むには毎回pushの許可が必要になるからです。個人開発でそこまで摩擦を作りたくなかった。Project Knowledgeも検討しましたが、こちらはClaude側から書き込む権限自体がなく、結局「私がダウンロードしてアップロードし直す」という手作業が残ってしまいます。

残ったのがGoogle Driveでした。ここならClaudeが直接読み書きできて、GitHubへの反映は「気が向いたときに手動で」というゆるい運用にできます。

これでフォルダ構成をTrueful/直下に整理し、ロードマップの正本と、Qiita記事一式（#0000〜#0008に加えて、番外編1と電子透かし記事も）をTrueful/Qiita記事/にまとめました。

スキルとの役割分担

Qiitaプロンプトファイルの「黄金フォーマット」部分は、もう死んでいたので捨てました。代わりに、その中にあった本当に価値のある部分——GitHubから一次情報を取ってくる手順（raw.githubusercontent.com経由で取得する、docs-jaを優先する、といった技術）だけを抜き出して、スキルの参照ファイルreferences/enrichment-research.mdとして移設しました。

最終的な役割分担はこうなりました。

型（フォーマット・手順） はスキルが持つ
今の状態（ロードマップの中身、記事ファイル） はDriveが持つ
Project Knowledge には、頻繁に変わらない安定した資料（Developer Handbookの目次計画など）だけを残す

自動化に一度ブレーキをかけた話

整理の途中、スキルの説明文に「設計判断や進捗が一区切りついた場面では必ず使う」という一文を書いていました。会話の流れをClaudeが読んで、自発的にドキュメント生成を始めるという設計です。

一度は良さそうに思えたんですが、実際に運用する自分の立場になって考え直しました。技術的な決定をしている最中に、横から勝手にドキュメント化が始まるのは、思ったより落ち着かない。かといって、固定のコマンド文言を毎回律儀に打つのも面倒です。

結局選んだのは、「ユーザーが何か言うまでは静かに待つ、ただし言い方は自由」という形でした。「ドキュメント化して」でも「今日はこれで終わろうか」でも、区切りを示す一言さえあれば拾う。でも、その一言がない限りは、どれだけ技術的な進捗があっても自分からは動かない。

これは細かい設定変更に見えて、実は「自動化の範囲をどこまで許すか」という判断そのものでした。Truefulの設計で何度も出てきた「案内は自由、実行は同意が必要」という考え方が、開発ドキュメントの運用ルールにもそのまま効いてきた形です。

まとめ

ロードマップとQiita記事の正本はGoogle Driveに統一した
Qiitaプロンプトの死んでいた設定を発見し、生きている部分だけスキルに移設した
ドキュメント生成の自動トリガーは、結局「ユーザーの一言待ち」に戻した

次回

#0009 ようやくWorkspace管理の実装に戻ります。corruption checkロジックから着手する予定です。

GitHub

今回の作業の詳細な事実記録はこちら
https://github.com/Trueful/Trueful/blob/main/docs-ja/devlog/2026-08-15.md

AIの利用について

この記事は、Claudeに一次稿を作成してもらい、内容を確認・修正したものです。設計判断そのものは自分で行っており、実装コードも自分の手で書いています。Claudeの使い方については番外編1に詳しく書いています。