1. はじめに

これまでの記事で、V字モデルの適用やエリック・ジョージ手法の役割分担について解説してきました。本記事では、Webアプリのv2.19開発において、エリック・ジョージ手法を実際に適用した事例を報告します。

v2.19は、ブログ記事のスタイル崩れという実務上の問題を解決するために開発されました。開発の全体像、実測データ、そして実践から得られた教訓を共有します。

2. v2.19開発の概要

2-1. 開発の背景と目的

2026年1月8日、Webアプリのブログ記事において、Markdown形式のテキストがそのまま表示される問題が発見されました。見出しや段落が正しくHTMLに変換されず、ユーザーにとって読みづらい状態でした。

この問題を解決するため、Markdown→HTML変換機能を実装することが決定されました。

2-2. 開発要件と制約

本開発では、以下の要件と制約が設定されました：

• 機能要件：Markdownテキストを正しくHTMLに変換し、読みやすく表示する
• 非機能要件：既存機能（トップページ、占いフォーム）に一切影響を与えない
• 技術制約：外部ライブラリの追加は避け、標準機能のみで実装する

3. 開発プロセスと実測データ

3-1. エリック・ジョージの協働プロセス

3-1-1. エリックによる問題分析

エリックは、ブログ記事のスタイル崩れの報告を受けて、以下の手順で根本原因を特定しました：

1. 症状の確認：ブログページのHTMLソースを調査し、Markdownテキストがそのまま表示されていることを確認
2. 仮説の構築：データベースに保存された形式とブラウザ表示の差異から、変換処理が欠落していると推測
3. コード調査：webapp/functions/_middleware.tsを確認し、Markdown処理がないことを確認
4. 根本原因の特定：ミドルウェアでMarkdown→HTML変換を行う必要があると結論

この分析により、エリックは「既存のコードを最小限変更し、ブログ記事のみに影響を限定する」という実装方針を立てました。

3-1-2. エリックが作成した実装指示書

エリックはジョージに対して、以下の内容を含む実装指示書を作成しました：

## 実装指示書：Markdown→HTML変換の追加

### 対象ファイル
webapp/functions/_middleware.ts

### 実装方針
1. ブログ記事のパス（/blog/...）にのみ適用
2. 以下の変換ルールを実装：
   - # → &l;t;h2&g;t;、## → &l;t;h3&g;t;、### → &l;t;h4&g;t;
   - 段落を&l;t;p&g;t;で囲む
   - 改行を&l;t;br&g;t;に変換
3. 既存機能への影響ゼロを保証
4. セキュリティ：HTMLエスケープを適用

### テスト項目
- ブログ記事の表示確認
- トップページの動作確認
- 占いフォームの動作確認

この指示書の特徴は、具体的な実装方針と明確なテスト基準を示している点です。

3-1-3. ジョージによる実装

ジョージは、エリックの実装指示書に基づき、以下の実装を行いました：

// webapp/functions/_middleware.ts（抜粋）

function convertMarkdownToHtml(markdown: string): string {
  let html = markdown;
  
  // 見出しの変換（レベル3から順に処理）
  html = html.replace(/^### (.+)$/gm, '&l;t;h4&g;t;$1&l;t;/h4&g;t;');
  html = html.replace(/^## (.+)$/gm, '&l;t;h3&g;t;$1&l;t;/h3&g;t;');
  html = html.replace(/^# (.+)$/gm, '&l;t;h2&g;t;$1&l;t;/h2&g;t;');
  
  // 段落の処理
  html = html.split('\n\n').map(para =&g;t; {
    if (!para.startsWith('&l;t;h')) {
      return `&l;t;p&g;t;${para.replace(/\n/g, '&l;t;br&g;t;')}&l;t;/p&g;t;`;
    }
    return para;
  }).join('\n');
  
  return html;
}

// ブログ記事のみに適用
if (url.pathname.startsWith('/blog/')) {
  const content = await response.text();
  const convertedContent = convertMarkdownToHtml(content);
  return new Response(convertedContent, response);
}

ジョージの実装の特徴：

• シンプルな正規表現：外部ライブラリを使わず、必要最小限の変換のみ実装
• 条件分岐の明確化：url.pathname.startsWith('/blog/')で対象を限定し、既存機能への影響を防止
• 見出しの優先処理：見出しレベル3から順に処理し、正規表現のマッチング問題を回避

3-2. 実測データと手法との因果関係

v2.19開発における実測データを、エリック・ジョージ手法の各要素との因果関係で分析します：

4. 技術的な課題と解決策

4-1. 正規表現の処理順序

Markdownの見出し変換では、見出しレベルの処理順序が重要です。レベル1（#）から処理すると、レベル2（##）やレベル3（###）が誤ってマッチする可能性があります。

解決策：ジョージは、見出しレベル3から順に処理することで、この問題を回避しました。これは、エリックの実装指示書に明記された内容です。

4-2. 既存機能への影響防止

ブログ記事以外（トップページ、占いフォーム）への影響を防ぐため、url.pathname.startsWith('/blog/')という条件分岐を導入しました。

効果：この条件分岐により、既存機能への影響ゼロを実現し、リグレッションテストの工数を大幅に削減しました。

5. 改善点と今後の展望

5-1. 改善点

今回の開発で得られた改善点は以下の通りです：

• 実装指示書の標準化：エリックの実装指示書の形式を標準テンプレート化し、今後の開発に適用する
• テスト項目の明確化：「既存機能への影響ゼロ」を検証するテスト項目を、開発初期段階で定義する
• ドキュメント化：エリック・ジョージの対話ログを保存し、将来の参考資料として活用する

5-2. 今後の展望

エリック・ジョージ手法の今後の展開として、以下を検討しています：

1. 複雑な機能開発への適用：データベース設計や認証機能など、より複雑な開発にも適用を拡大
2. AIモデルの進化：より高度な推論能力を持つAIモデルへの移行により、エリックの分析精度をさらに向上
3. 品質指標の定量化：不具合発生率、開発時間、手戻り率などの指標を継続的に測定し、手法の効果を定量的に評価

6. まとめ

本記事では、エリック・ジョージ手法を用いたv2.19開発の実践事例を報告しました。主なポイントは以下の通りです：

• 不具合発生率0%：エリックの徹底した根本原因分析により、問題の本質を正確に特定
• 追加修正なし：具体的な実装指示書により、ジョージは一発で正しい実装を完成
• 開発時間約半日：役割分担の明確化により、各工程の効率を最大化
• 1ファイルのみ変更：最小変更の原則により、テスト工数とリスクを削減

v2.19開発の実測データは、エリック・ジョージ手法の有効性を実証するものです。今後も、この手法を継続的に改善し、より高品質なソフトウェア開発を実現していきます。