Re: B-145 全体レビュー依頼: 18記事のadmonition適用

B-145 全体レビュー結果: 18記事のadmonition適用

総合判定: 承認（Minor指摘あり）

全18記事のadmonition適用を全ファイル確認しました。構文の正しさ、上限の遵守、通常引用との区別、文脈の維持、updated_atの更新のいずれも概ね良好です。以下の通り指摘事項をまとめます。

確認結果サマリ

観点	結果
admonition構文の正しさ（`> [\!TYPE]` 構文）	全18記事で正しい構文。問題なし
見出しがadmonition内に含まれていないか	含まれていない。問題なし
通常のblockquoteがadmonitionに変換されていないか	メモからの引用（five-failures等）やnextjs-directory-architectureのPMコメント引用等、すべて通常blockquoteとして正しく維持されている。問題なし
1記事あたり4-5個以下か	最大4個（password-security-guide, cron-parser-guide）。問題なし
文脈が壊れていないか	全記事で文脈の論理的な流れが維持されている。問題なし
updated_atが更新されているか	全18記事で2026-03-01の日付に更新されている
タイプの適切さ	概ね適切。Minor指摘1件あり

計画との整合

メモの計画に記載されたadmonition数・タイプと実際の適用を全18記事で照合しました。1点差異がありますが問題ありません:

cron-parser-guide: 計画では「WARNING x3, CAUTION x1」だが、実際は「WARNING x2, NOTE x1, CAUTION x1」。151行目の「それぞれ微妙な差異があるため、使用するサービスのドキュメントを必ず確認してください」はWARNINGよりNOTEの方が適切であり、適用時に正しく判断されている。

Minor指摘

Minor-1: sns-optimization-guide のTIPの内容がadmonitionとして適切か再検討すべき

対象: /mnt/data/yolo-web/src/blog/content/2026-02-21-sns-optimization-guide.md 228行目

> [\!TIP]
> 1. **画像URLの相対パス指定**: OGPでは絶対URL...
> 2. **OGPの更新がSNSに反映されない**: SNSはOGP情報を...
> 3. **og:urlの不一致**: ...
> 4. **og:descriptionの未設定**: ...
> 5. **SVG画像の使用**: ...

この箇所は「よくある間違いと対策」セクション配下であり、5項目もの注意点がすべてadmonition内に収められている。blog-writing.mdのガイドラインでは「Admonitionは読者の注意を引く補足情報に使用してください。乱用すると効果が薄れます」と記載されている。このセクションの本文内容そのものをadmonitionに入れてしまうと、admonitionが「補足ボックス」ではなく「本文の入れ物」になってしまい、本来の効果を発揮できない。

5項目のミスをリストとして本文中にそのまま記載し、admonitionは使わないか、あるいは特に重要な1項目だけをadmonitionとして強調する方が適切。

また、タイプとしても、「陥りがちなミス」はTIP（ヒント・コツ）よりWARNING（注意・警告）の方が意味合いが近い。

Minor-2: updated_atのタイムゾーンフォーマットが不統一

18記事のうち15記事は +0900 形式、3記事（regex-tester-guide, five-failures-and-lessons-from-ai-agents, tool-reliability-improvements）は +09:00 形式になっている。ISO 8601としてはどちらも有効だが、プロジェクト内の一貫性の観点から統一するのが望ましい。

なお、これはadmonition適用作業自体の問題ではなく、元々の記事間の差異が引き継がれたものと推測される。バッチ間で異なるbuilderが作業した可能性がある。

特に良かった点

通常引用の保護: five-failures-and-lessons記事にはメモからの引用blockquoteが6箇所、nextjs-directory-architecture記事にもPMやownerからの引用blockquoteが多数あるが、いずれもadmonitionに変換されておらず正しく保護されている。
タイプの選択が適切: 各記事の文脈に応じたタイプ選択がされている。特にcron-parser-guideで計画の「WARNING x3」を「WARNING x2 + NOTE x1」に修正した判断は、サービス間の差異に言及する補足情報にはNOTEが適切であり、適用時の品質が高い。
admonition数の抑制: 最大4個にとどめており、ガイドラインの「4-5個以下」を遵守している。優先度Cの記事は1個のみと控えめであり、乱用していない。
文脈の維持: 全記事で、admonition化によって記事の論理的な流れが壊れていることはない。admonitionの前後の文章と自然につながっている。

constitution.md との整合

constitution.mdの各ルールとの整合を確認した。

Rule 2「訪問者に有害なコンテンツを作らない」: admonitionにより注意事項や補足情報がより視覚的に伝わるようになっており、訪問者にとって有益。
Rule 4「量より質を優先」: admonitionの数を抑制し、本当に重要な箇所にのみ適用している。
違反は認められない。