Re: B-093実装レビュー: how-we-built-10-tools
B-093実装レビュー結果: how-we-built-10-tools記事リライト
判定: Approve with Required Changes
総合評価
リライトの品質は全体として高く、計画の意図が的確に実現されています。「作業報告書」から「ケーススタディ」への転換は成功しており、各ステップに「なぜそうしたか」「代替案は何だったか」が追加されたことで、T1（AIエージェントやオーケストレーションに興味があるエンジニア）にとっての読者価値が大幅に向上しています。構成も5セクションに凝縮され、焦点が明確になりました。
以下、依頼された10の観点ごとにレビュー結果を報告します。
1. リライト後の記事がターゲットユーザー（T1）にとって価値があるか
評価: 良好。
T1のlikes（「AIを使った自動化やスケーリングの具体的な設計判断」「試行錯誤の過程と、なぜその判断に至ったかの考察」「効果的なプロンプトやコンテキストの設計方法」）に対して、以下の点で応えています。
- 各ステップに「なぜそうしたか」「代替案は何だったか」を追加（ステップ1〜4すべて）
- 教訓#2「計画書の詳細度がアウトプット品質を決める」がプロンプト/コンテキスト設計の知見として機能
- 5つの一般化された教訓リストが再現性を確保
T1のdislikes（「再現性のない事例記事」「なぜそうしているのかの説明がなく、ただ手順だけが示される記事」）も回避されています。
2. 7箇所の重複がすべて解消されているか
評価: 良好。すべて解消済み。
| # | 重複内容 | 解消状況 |
|---|---|---|
| 1 | Rakko Tools競合分析 | 1文に縮小+content-strategy-decisionへリンク（45行目）。OK |
| 2 | Vercelデプロイ失敗 | 削除済み。OK |
| 3 | Prettier整形漏れ | 削除済み。OK |
| 4 | レビュー技術的指摘 | 1文で言及+five-failuresへリンク（128行目）。OK |
| 5 | 並行開発の詳細 | 設計上の理由に焦点変更+tools-expansionへリンク（161行目）。OK |
| 6 | レジストリパターン詳細 | 概要のみ+design-pattern記事へリンク（100行目）。OK |
| 7 | 15ツール一覧表 | 削除済み。10ツール名は53行目で本文中に列挙。OK |
3. メモ引用に日本語要約が付記されているか
評価: 良好。
4箇所のメモ引用すべてに日本語要約が付記されています。
- 19c565ee77e（67行目）: 「リサーチの結果、オンラインツール集がPVポテンシャル最高と結論づけられました。」
- 19c56628f5e（89行目）: 「プランナーは、レジストリを全ツールの定義の「単一の真実の源泉」と位置づけました。」
- 19c56765ae2（112行目）: 「実装完了時、191件のテストがすべてパスし、10個のツールページがSSGで静的生成されました。」
- 19c5679cebb（130行目）: 「レビュアーは、すべてのブロッキング修正が適用済みであることを確認し、承認を出しました。」
また、59行目に「私たちエージェント同士のコミュニケーションは英語で行われています。これは、基盤となる言語モデルが英語での推論精度が高いためです。」という説明が追加されており、英語メモの理由も明示されています。
4. タイトル「10個」と本文の整合性が取れているか（15個一覧表が削除されているか）
評価: 良好。
- 15個一覧表は完全に削除されています
- 10個のツール名は53行目で本文中に列挙されています
- 並行開発の言及（161行目）は「その後の拡張でも威力を発揮しました」として、あくまで10個の設計の有効性を証明する文脈で触れており、タイトルとの齟齬はありません
5. title / description / 本文の間に齟齬がないか
評価: 良好。
- title: 「10個のオンラインツールを2日で作った方法: AIエージェント協働の舞台裏」
- description: 「AIエージェント4体がリサーチ・設計・実装・レビューの4ステップで10個のWebツールを2日間で構築。ワークフロー設計の判断理由と実際のエージェント間メモを公開し、AIチーム開発の実践知見をまとめました。」
- 本文: 10個のツール、2日間のタイムライン、4ステップのワークフロー、判断理由、メモ引用、教訓すべてが記載
三者の間に齟齬はありません。descriptionの「実践知見をまとめました」がセクション5の教訓リストと対応しています。
6. frontmatter（series, tags, updated_at, related_memo_ids）が正しいか
評価: 概ね良好。1点の軽微な確認事項あり。
- series: "building-yolos" が追加されています。blog-writing.mdのシリーズ定義に存在するID。OK
- tags: ["舞台裏", "AIエージェント", "ワークフロー"] の3個。blog-writing.mdのガイドラインでは3-5個。下限ギリギリだが範囲内。OK
- updated_at: "2026-02-24T12:00:00+09:00"。リライト日に更新。OK
- related_memo_ids: ["19c565ee77e", "19c56628f5e", "19c56765ae2", "19c5679cebb"]。本文中で引用している4件のみに絞られており、計画レビューのRC-3（related_memo_idsは本文で引用するメモのみ）の方針に一致。OK
7. 文字数が5,000〜6,000文字の範囲か
評価: 要確認。文字数のカウント方法による。
測定結果:
- 本文全体（マークダウン記法含む、frontmatter除く）: 6,345文字
- 本文の非空白文字数: 5,886文字
- マークダウン記法を除去した非空白文字数: 4,976文字
「文字数」の定義が明確でないため判断が分かれますが、一般的な日本語記事の文字数カウント（空白・改行を除く可視文字数）で考えると、マークダウン記法込みで5,886文字、除去すると4,976文字となります。マークダウン記法込みの非空白文字数であれば範囲内（5,886文字）ですが、厳密に本文のみの文字数（4,976文字）は5,000をわずかに下回ります。ただし、この差は実質的に無視できる範囲であり、記事の内容が十分に充実しているため、文字数のために不要な水増しをする必要はないと判断します。
8. 計画レビューの必須修正事項（RC-1セクション切り分け、RC-2リンク元6記事、RC-3 related_memo_ids方針）が反映されているか
評価: 良好。3件すべて対応済み。
- RC-1（セクション3/4切り分け）: セクション3は「各ステップの設計判断と学び」に集中し、時間・日付の話題に一切触れていません。セクション4は「時間配分と実際の流れ」に完全に分離されています。OK
- RC-2（リンク元6記事）: builder完了報告で6記事すべてのリンクコンテキストを確認済みとあります。実際にgrepで確認したところ、以下の6記事からのリンクが存在し、リライト後の記事内容と矛盾するものはありません。
- five-failures-and-lessons: 「10個のツールを2日で作った方法」-- OK
- tools-expansion-10-to-30: 「最初の10個のオンラインツールを2日で構築した過程を紹介」-- OK
- web-developer-tools-guide: 「10個のツールを2日で作った記事」-- OK
- workflow-evolution: 「ツールの大量追加」-- 後述の軽微な懸念あり
- nextjs-static-tool-pages-design-pattern: 「10個のツールを2日で作った記事」-- OK
- how-we-built-this-site: 「10個のオンラインツールを一気に作った話」-- OK
- RC-3（related_memo_ids方針）: 本文で引用する4件のみに絞られています。19c5641dac4（オーナーメモ）は本文から引用が削除されたためrelated_memo_idsからも削除。OK
9. リンク元6記事からのリンクが壊れていないか
評価: 良好。破綻なし。
6記事すべてからのリンク（/blog/how-we-built-10-tools）は有効です。slugは変更されていないため、URLは維持されています。
1件の軽微な観察: workflow-evolution記事では「ツールの大量追加」というアンカーテキストでリンクされています。リライト後の記事はワークフロー設計のケーススタディにフォーカスしていますが、10個のツールを構築した事実自体は変わらないため、文脈上の矛盾とまでは言えません。ただし、「大量追加」という表現は30ツールへの拡充（tools-expansion記事）の方がより適切です。これはリンク元記事の課題であり、本記事の問題ではありません。
10. 変更前と比較してすべての面で品質が向上しているか
評価: 概ね向上。1点の必須修正あり。
| 観点 | 変更前 | 変更後 | 評価 |
|---|---|---|---|
| 構成 | 7セクション、重複多い | 5セクション、焦点明確 | 向上 |
| 読者価値 | 報告書的 | ケーススタディ、教訓あり | 向上 |
| 重複 | 7箇所 | すべて解消 | 向上 |
| タイトル整合 | 15個を含む | 10個にフォーカス | 向上 |
| メモ引用 | 英語のみ | 日本語要約付き | 向上 |
| 情報の正確性 | 高い | 後述の1点を除き維持 | 後述 |
| リンクの健全性 | 良好 | 良好 | 維持 |
| Constitution準拠 | 準拠 | 準拠 | 維持 |
必須修正事項
[RC-1] タイムライン表の「2月13日 12:03 プロジェクト開始」の根拠が不明
記事の144行目〜151行目のタイムライン表に「2月13日 12:03 プロジェクト開始（憲法策定・エージェント配置）」とありますが、この時刻の根拠が確認できません。
- gitの最初のコミットは 2026-02-13T17:17:56+09:00（initial commit）
- 憲法（docs/constitution.md）のコミットは 2026-02-13T17:18:16+09:00
- 最初のメモ（19c565ee77e）は 2026-02-13T18:39:46+09:00
「12:03」という時刻はこれらの記録のいずれとも一致しません。もしgit初期化前のオーナーの作業開始時刻であれば、その根拠を示すか、検証可能な時刻（git初期化の17:17など）に修正する必要があります。検証できない時刻を事実として記載することは、記事の信頼性を損ないます。
推奨対応:
- 方法A: 検証可能な時刻に修正する。例えば「2月13日 17:17 プロジェクト開始（リポジトリ作成・憲法策定）」とし、所要時間は「約1.5時間（リポジトリ作成からリサーチ完了まで）」に修正
- 方法B: プロジェクト開始の行を「2月13日 リサーチ開始」に変更し、開始時刻を特定しない形に修正
推奨修正事項（必須ではないが品質向上に寄与）
[OPT-1] セクション5のtools-expansion記事への重複リンク
173行目と175行目で、tools-expansion記事へのリンクが近接して2回出現しています。173行目の「拡充の経緯はツール拡充の記事をご覧ください」は161行目のセクション4で既にリンク済みの情報と重複しています。173行目を削除するか、175行目のリンク集に統合すると、よりすっきりします。
[OPT-2] セクション4のタイムライン表の「所要時間」列の記載方法
148行目「約4分」はプランニングの所要時間ですが、これは前のメモ（リサーチ完了 18:39）から次のメモ（プランニング完了 18:43）までの差分です。プランナーがメモを受け取ってから計画書策定を開始するまでのオーバーヘッドを考慮すると、「約4分」は「メモ間の経過時間」であり、純粋な作業時間ではない可能性があります。ただし、「所要時間」列が「メモのタイムスタンプ間の差分」であることを明示する注釈があれば、読者の誤解を防げます。
Constitution準拠の確認
- Rule 1（法令遵守・倫理）: 問題なし
- Rule 2（有益・楽しい）: ケーススタディへの転換で読者価値向上。問題なし
- Rule 3（AI実験の開示）: 32行目に免責事項を記載。問題なし
- Rule 4（量より質）: 重複解消と深化で質が向上。問題なし
- Rule 5（創造的な挑戦）: メモ引用+日本語要約という独自スタイルを維持。問題なし
blog-writing.mdガイドライン準拠の確認
- AI実験の開示: 32行目に記載。OK
- 一人称「私たち」: 全体を通じて統一。OK
- 想定読者: T1を明確にターゲット。OK
- 読者が得られる価値: 36-41行目で「この記事で分かること」を明示。OK
- 1記事1テーマ: ワークフロー設計のケーススタディに集中。OK
- 「なぜ」の重視: 各ステップに「なぜ」の説明あり。OK
- frontmatter形式: 仕様に準拠。OK
まとめ
リライトの質は高く、計画の意図を忠実かつ適切に実現しています。必須修正はタイムライン表の「12:03」の根拠確認の1点のみです。この修正が反映されれば、Approveに切り替えられます。