プロンプトパイプラインはメタプログラミングの特性を示す

開発者が、型付き入出力、制御フロー、ループ、ステートマシン、モジュールインターフェースを含むメタプログラミング言語の構造的特性を示すElectronアプリ（Claude Code CLI、React、TypeScript、SQLite）の構築に使用されたプロンプトパイプラインを文書化しました。

パイプラインアーキテクチャ

このシステムは、型付き契約を持つ4つの異なる段階で動作します。

ステージ1：静的解析

repo-eval.mdプロンプトはコードベース全体のスキャンを実行します。すべてのソースファイルを読み込み、依存関係グラフをトレースし、IPCフローをエンドツーエンドでマッピングし、構造化された調査結果レポートをissues.mdに出力します。各調査結果には以下が含まれます：

• セクションID
• タイトル
• 重大度（クリティカル/高/中/低）
• カテゴリ
• 行範囲付きファイルパス
• 証拠
• 影響評価
• 推奨修正

ステージ2：コンパイル

address-issues.mdプロンプトはステージ1の出力を解析します。調査結果をファイルの関連性でグループ化し、プロンプト番号（FIX-01、FIX-02、...）を割り当て、プロンプト間の依存関係を決定し、重大度でソートします。出力は以下を含むディレクトリ（prompts/arch/r{NNN}/）です：

• FIX-NN.md — 目的、対応する調査結果、変更するファイル、実装手順、検証基準を指定した自己完結型の修正プロンプト。
• STATE.md — プロンプトごとのステータス（保留/進行中/完了/ブロック）、依存関係グラフ、完了日、引き継ぎメモを含む実行状態トラッカー。
• MASTER.md — 実行ループ仕様。

ステージ3：実行

MASTER.mdはランタイムループとして機能します。各反復で：

1. STATE.mdを読み込む
2. 依存関係が満たされた次の保留プロンプトを選択
3. プロンプトを読み込む
4. 影響を受けるすべてのソースファイルを読み込む
5. 実装手順を実行
6. 検証を実行（tsc --noEmit、削除されたパターンのgrep、行数チェック）
7. STATE.mdを更新
8. 変更ログエントリを追加、アーキテクチャドキュメントを更新
9. ステップ1にループ

ステージ4：パッケージング

release-notes.mdプロンプトは変更ログを読み込み、最後のタグに対してgit logとgit diff --statを実行し、変更を分類し、バージョンアップ推奨を含むフォーマットされたリリースノートを出力します。

主要特性

型付き契約： repo-evalの出力スキーマはaddress-issuesの入力契約です。address-issuesの出力スキーマはMASTERの入力契約です。FIXプロンプトはaddress-issuesが生成する正確な形式を消費します。STATE.mdにはMASTERが読み書きする定義されたスキーマがあります。

自動ドキュメンテーション： すべてのClaude Codeコンテキストウィンドウに添付されたシステムプロンプト（agents.md）には、実行後のプロトコルが含まれます：変更ログエントリを追加、影響を受けるアーキテクチャドキュメントを更新、状態追跡を更新。ドキュメントはプロンプト実行の副作用として出力され、コンテキストの劣化を排除します。

ADRとしてのプロンプト： 各FIX-NN.mdは設計文書、作業指示書、アーキテクチャ決定記録として機能し、実行前に問題、理論的根拠、実装計画、検証基準を捕捉します。

出力

このパイプラインを1日実行した結果：

• 2回の完全なリポジトリ評価
• 2回の改訂ラウンドで17のバグ修正（競合状態、ストリームアーキテクチャ、並行状態管理）
• サービス分解：1,218行 → 403行 + 5つの抽出サービス
• 追加の3つのクラッシュ修正
• ソースに対して検証されたREADME書き換え
• 6ページのGitHub Pagesウェブサイト
• 21の変更ログエントリ