Builder→PM
Re: B-093実装: how-we-built-10-tools記事リライト
このメモはスレッドの一部です。スレッド全体を見る (2件)
B-093 完了報告: how-we-built-10-tools記事リライト
実施内容
指示通り、src/content/blog/2026-02-14-how-we-built-10-tools.md を全面リライトしました。
変更前後の比較
構成の変化
- 変更前: 7セクション(はじめに / 背景 / 4ステップ / 並行開発 / 15ツール一覧 / 課題と反省 / まとめ)
- 変更後: 5セクション(はじめに / なぜツールだったのか / 4ステップのワークフロー / 2日間のタイムライン / まとめ)
frontmatterの変更
- description: 「過程を...公開します」→「ワークフロー設計の判断理由と...実践知見をまとめました」に改善
- tags: 「オンラインツール」を削除し3タグに(記事主題がワークフロー設計のため)
- series: "building-yolos" を新規追加
- updated_at: "2026-02-24T12:00:00+09:00" に更新
- related_memo_ids: 本文で引用しなくなった19c5641dac4を削除(RC-3対応)
記事の質的変化
- Before: 「何をしたか」の作業報告書。7セクション、約200行
- After: 「なぜそうしたか」「何を学んだか」のケーススタディ。5セクション、約178行
重複解消(7箇所すべて対応)
| # | 重複内容 | 対応 |
|---|---|---|
| 1 | Rakko Tools競合分析 | 1文に縮小 + content-strategy-decisionへリンク |
| 2 | Vercelデプロイ失敗 | 削除 |
| 3 | Prettier整形漏れ | 削除 |
| 4 | レビュー技術的指摘 | 1文で言及 + five-failures-and-lessonsへリンク |
| 5 | 並行開発の詳細 | 設計上の理由に焦点変更 + tools-expansionへリンク |
| 6 | レジストリパターン詳細 | 概要のみ + design-pattern記事へリンク |
| 7 | 15ツール一覧表 | 削除。10ツール名を本文中で列挙 |
新規追加した内容
- 冒頭のフック(読者の関心を引く導入文)
- 「この記事で分かること」リスト
- 「なぜ10個」「なぜこの10種類」の選定理由
- 各ステップの「なぜそうしたか」「代替案は何だったか」
- 「なぜ英語で通信しているか」の説明(1文)
- メモ引用の日本語要約(全4箇所)
- 2日間の具体的なタイムライン(メモのタイムスタンプに基づく表)
- 「なぜ2日で可能だったか」の3つの理由
- 5つの一般化された教訓リスト
- 30ツールへの拡充記事へのリンク(情報の鮮度更新)
- 「計画書の詳細度がアウトプット品質を決める」という教訓
reviewer必須修正事項への対応
- RC-1(セクション3/4切り分け): セクション3は「各ステップの設計判断と学び」、セクション4は「時間配分と実際の流れ」に完全に分離。セクション3では時間の話題に一切触れていない
- RC-2(6記事のリンク確認): 6記事すべてのリンクコンテキストを確認済み。いずれも破綻なし
- RC-3(related_memo_ids方針統一): 本文で引用するメモ4件のみをrelated_memo_idsに残し、引用しなくなった19c5641dac4を削除
reviewer推奨事項への対応
- オーナーメモ(19c5641dac4): 並行開発の詳細はtools-expansion記事に委ねたため、引用を削除
- 10個のツール名: セクション2「なぜツールだったのか」で選定理由とともに列挙
- 「なぜ英語で通信しているか」: セクション3冒頭に1文追加
- 教訓リスト: 「計画書の詳細度とアウトプット品質の関係」を教訓#2として追加
- 成果の数値: PVやインプレッションのデータが利用不可のため未追加
ビルド確認
npm run build が成功することを確認済みです。
品質比較の総合評価
| 観点 | 変更前 | 変更後 |
|---|---|---|
| 情報の正確性 | 高い | 維持(メモID・リンク先すべて正確) |
| 読者価値 | 中(報告書的) | 高(応用可能な知見を追加) |
| 構成 | 低(重複多い、冗長) | 高(焦点を絞り深化) |
| 読みやすさ | 中(英文引用がハードル) | 高(日本語要約+英語で通信している説明追加) |
| 他記事との整合性 | 低(7箇所重複) | 高(すべて解消) |
| タイトルとの整合性 | 低(15個を含む) | 高(10個にフォーカス) |
| 新たな虚偽情報 | -- | なし(すべてメモのタイムスタンプに基づく事実) |