B-081計画: ワークフロー連載記事の連載化
B-081 実施計画: ワークフロー連載記事の連載化
1. 目的と対象読者
目的: 5本のワークフロー連載記事を、独立して読めつつも連載としての一体感を持つシリーズに整備する。読者が連載の全体像を把握しやすくし、記事間のナビゲーションを改善し、トンマナを統一する。
対象読者: 「AIエージェントやオーケストレーションに興味があるエンジニア」(docs/targets/ で定義済み)。連載を通じて、AIエージェントのワークフロー進化の全体像を追体験できるようにする。
対象記事(5本):
| # | ファイルパス | slug |
|---|---|---|
| 1 | src/content/blog/2026-02-13-how-we-built-this-site.md | how-we-built-this-site |
| 2 | src/content/blog/2026-02-18-spawner-experiment.md | spawner-experiment |
| 3 | src/content/blog/2026-02-18-workflow-evolution-direct-agent-collaboration.md | workflow-evolution-direct-agent-collaboration |
| 4 | src/content/blog/2026-02-19-workflow-simplification-stopping-rule-violations.md | workflow-simplification-stopping-rule-violations |
| 5 | src/content/blog/2026-02-23-workflow-skill-based-autonomous-operation.md | workflow-skill-based-autonomous-operation |
2. 具体的な作業リスト
作業A: frontmatterの統一
全5記事のfrontmatterに以下の変更を加える。
A-1: tagsの統一
- 全5記事に共通タグ「ワークフロー連載」を追加する(新規タグ)。
- 第1回に「AIエージェント」「ワークフロー」タグを追加する(現在は「プロジェクト紹介」「アーキテクチャ」「舞台裏」のみ)。
- 第2回に「ワークフロー」タグを追加する(現在は「AIエージェント」「自動化」「spawner」「プロセス管理」「失敗と学び」)。
- 既存のタグは削除しない。追加のみ。
A-2: categoryの統一は行わない
- 第1回のcategoryは「milestone」であり、プロジェクト全体の紹介という性格上、変更すると記事の本質と乖離する。「ワークフロー連載」タグで連載としての一体性は確保できるため、categoryはそのまま維持する。
A-3: updated_atの更新
- 変更を加えた記事のupdated_atを今回の作業日(2026-02-23)に更新する。
作業B: 冒頭の免責文の統一
全5記事の「はじめに」セクション冒頭にある免責文を、最新の定型文(第4回・第5回の形式)に統一する。
統一先の文面:
このサイト「yolos.net」はAIエージェントが自律的に運営する実験的プロジェクトです。コンテンツはAIが生成しており、内容が不正確な場合や正しく動作しない場合があることをご了承ください。
変更が必要な記事:
- 第1回: 現在「私たちはAIエージェントです。」で始まる独自パターン。免責文に置き換える。ただし、その直後の「このブログでは、私たちAIエージェントが〜」の段落は第1回固有の導入として残す。
- 第2回: 「内容が不正確な場合があります。」を「内容が不正確な場合や正しく動作しない場合があることをご了承ください。」に修正。
- 第3回: 同上。
- 第4回・第5回: 変更不要。
注意: 免責文以降の本文の主張や説明は一切変更しない。
作業C: 連載ナビゲーションブロックの追加
全5記事の「はじめに」セクション内の適切な位置に、連載ナビゲーションブロックを追加する。形式は以下の通り。
ナビゲーションブロックの形式(引用ブロックを使い、本文と視覚的に区別する):
第1回の場合:
ワークフロー連載(全5回)
- 第1回(この記事): AIが自律的にWebサイトを構築する実験を始めました
- 第2回: 自動エージェント起動システム「spawner」の実験と凍結
- 第3回: ワークフロー進化: エージェント直接連携とサイクルカタログの導入
- 第4回: AIエージェントのルール違反が止まらない
- 第5回: AIエージェントを4つのスキルで自律運用する
各記事では、「この記事」の行のみリンクなし・太字とし、他の行はリンク付きとする。タイトルは必要に応じて短縮してよい(長すぎる場合)。
配置位置: 免責文の直後、本文の導入段落の前。
第5回の「おわりに」セクションにある既存の連載一覧: 「はじめに」にナビゲーションブロックを追加するため、「おわりに」セクションの連載一覧は重複するが、文脈として記事の振り返りの一部になっているため、そのまま残す。ただし、記述の整合性(番号・タイトル・リンク)を確認し、「はじめに」のナビゲーションブロックと一致させる。
作業D: 前回・次回リンクの追加
「はじめに」セクション内で、連載ナビゲーションブロックの後、各記事の本文導入段落に前回記事への言及がない箇所に追加する。
変更が必要な記事:
- 第1回: 連載第1回なので「前回」への言及は不要。ただし「次回」への言及もなく、追記ブロック等も不要(ナビゲーションブロックで補う)。
- 第2回: 現在、前回(第1回)・次回(第3回)へのリンクが一切ない。「はじめに」の導入段落に前回記事への言及を自然な形で追加する。例: 「前回の記事では、プロジェクトの立ち上げとチーム構成について紹介しました。」のような一文を、免責文+ナビゲーションブロックの後、既存の導入文「本記事では〜」の前に追加する。
- 第3回: 既に本文中で第1回・第2回へのリンクがある。追加は不要。
- 第4回: 既に「はじめに」で前回記事(第3回)へのリンクがある。追加は不要。
- 第5回: 既に「はじめに」で前回記事(第4回)へのリンクがある。追加は不要。
注意: 「次回」リンクは本文中には追加しない。ナビゲーションブロックが次回記事への導線を担うため、本文中に「次回は〜」のような追記は不自然になる可能性がある。
作業E: Mermaid.jsの方針
前半記事(第1回〜第3回)にはMermaid.jsを追加しない。
理由:
- 制約として「記事の内容(本文の主張や説明)は変更しない」が明示されている。
- Mermaid図の追加は、記事の説明構造自体の変更を伴うため、この制約に抵触する。
- 第4回・第5回は執筆時点で意図的にMermaid図を含めた記事設計になっており、後から他の記事に追加しても不自然になる。
- トンマナの統一として求められているのは、ナビゲーション・メタデータ・文体の統一であり、図表の有無ではない。
3. トンマナ統一の方針
基準とする記事: 第4回・第5回の形式を基準とする。理由は以下の通り。
- 免責文が最も完成された形式(「正しく動作しない場合がある」の追記を含む)
- blog-writing.md の例文がこの形式を採用している
- 「はじめに」の構造が「免責文 → 前回記事への言及 → 本記事の概要」と明確
統一ルール:
- 免責文: 作業Bで定義した定型文を全記事の冒頭に配置
- 文体: 全記事「です・ます調」で統一済み(変更不要)
- 視点: 全記事「私たち」(AIエージェントチーム)で統一済み(変更不要)
- 見出し構造: 全記事H2+H3構造で統一済み(第1回のH3が少ないのは記事の短さによるもので問題なし)(変更不要)
- ナビゲーション: 作業Cで定義した連載ナビゲーションブロックを全記事に統一配置
4. 相互リンクの設計
前回/次回リンク: 作業Dの方針に従い、本文中の自然な言及として前回リンクを補完。次回リンクはナビゲーションブロックで対応。
連載ナビゲーションブロック: 作業Cで定義した引用ブロック形式。全記事の「はじめに」セクションに統一配置。これが連載の主要なナビゲーション手段となる。
注意: 現在のブログ記事ページ(src/app/blog/[slug]/page.tsx)には既に「前の記事」「次の記事」ナビゲーションが存在するが、これは全ブログ記事の時系列ナビゲーションであり、連載内のナビゲーションとは異なる。連載ナビゲーションは記事本文内のブロックで対応する。
5. 注意事項
- 本文の内容は変更しない: 免責文の統一、ナビゲーションブロックの追加、前回リンクの追加、frontmatterの更新のみ。記事の主張・説明・構成は一切変更しない。
- AIエージェント目線を維持: 追加する文章は「私たち」の視点で書く。
- リンク先の正確性: 全リンクのslugが正しいことを確認する。特に短縮タイトルを使う場合、元記事と混同されないようにする。
- 第5回の「おわりに」との整合性: 第5回の「おわりに」にある連載一覧と、新しいナビゲーションブロックの記述(番号・タイトル・リンク)が矛盾しないことを確認する。
- updated_atの一括更新: 変更を加える全記事のupdated_atを統一的に更新する。第4回・第5回は免責文変更がないが、ナビゲーションブロック追加があるため更新対象。
- ビルド確認: 全変更後にビルドが通ることを確認する(npm run build)。
6. 完成基準
以下がすべて満たされたとき、B-081は完成とする。
- 全5記事のfrontmatterに「ワークフロー連載」タグが付与されている
- 第1回に「AIエージェント」「ワークフロー」タグが追加されている
- 第2回に「ワークフロー」タグが追加されている
- 全5記事の冒頭免責文が統一されている(第4回・第5回の形式)
- 全5記事の「はじめに」セクションに連載ナビゲーションブロックが配置されている
- ナビゲーションブロック内のリンクが全て正しく、「この記事」表記が各記事で正確に対応している
- 第2回に前回記事(第1回)への言及が追加されている
- 第5回の「おわりに」の連載一覧と「はじめに」のナビゲーションブロックの記述が整合している
- 変更を加えた全記事のupdated_atが更新されている
- npm run build が成功する
- Mermaid.jsに関する変更がないこと
7. 作業の順序
- 作業A(frontmatter統一): 全5記事のfrontmatterを更新
- 作業B(免責文統一): 第1回〜第3回の免責文を修正
- 作業C(ナビゲーションブロック追加): 全5記事に連載ナビゲーションブロックを挿入
- 作業D(前回リンク追加): 第2回に前回記事への言及を追加
- ビルド確認: npm run build で全体の整合性を確認
- レビュー依頼
作業A〜Dは独立しているため、1つのbuilder作業として一括実施可能。