brgen

rebrgen の設計判断を ADR として記録するか検討する。設計方針の議論、選択肢の比較、既存判断の変更、判断理由を残す場面で使用する。

rebrgen のビルド、初期セットアップ、EBM再生成、ebmcodegen復旧、新言語ジェネレーター追加を行うときに使用する。

rebrgen のコンパイルエラー、テスト失敗、想定外の挙動を調査するときに使用する。型や構造の定義から原因を追跡するデバッグ手順を提供する。

rebrgen 内部の機能、マクロ、Context型、実装場所や構造を調べるときに使用する。開発中に関連定義やAPIの所在を確認するための知識を提供する。

rebrgen の複数言語ジェネレーターにまたがるリファクタリング、共通部分の整理、EBM構造変更の影響調査を行うときに使用する。

rebrgen のコードジェネレーターへ新機能を追加するときに使用する。共通処理と言語固有処理の配置、EBM変更の判断、実装時の注意点を提供する。

新しい rebrgen 言語ジェネレーターを追加するときに使用する。スケルトン生成、フック実装、ビルド、テストの手順を提供する。

rebrgen の作業開始時や、プロジェクト全体像、ASTからEBMを経由するパイプライン、主要ディレクトリと責務を把握するときに使用する。

ebmgen のインタラクティブクエリエンジンで EBM ファイルの構造や参照を調査・デバッグするときに使用する。

rebrgen の unictest を安全に実行し、失敗、未実装フック、生成コードの問題を調査するときに使用する。必ず対象言語や入力を絞る。

rebrgen のビルド・再生成手順を提示する。ビルドエラー、EBM構造変更、ebmcodegen の再生成、新言語ジェネレーター追加時に参照する。

新しい言語ジェネレーター (ebm2<lang>) の追加手順とフック実装の方法。新言語対応を始めるときに参照する。

unictest.py を使った自動テストの実行方法と解釈。テスト失敗、未実装フックの確認、デバッグ出力の読み方に使う。**テスト実行直前に必ず読むこと。**

開発上重要なtips。例えばどの機能がどこに定義されていてどんな構造になっているかの概要です。マクロやContext_XXXなどについてわかります。開発中に「どこに何があるんだっけ or let me know...」となったらここを参照すること。

rebrgen のコードジェネレーターに新機能を追加する時の方法と注意点。コードジェネレーターの構造の理解、共通部分と言語固有部分の整理、EBM構造の変化への対応などを扱う。

rebrgen プロジェクトの全体像、アーキテクチャ、ファイル構成の概要。プロジェクトを把握したいとき、どこに何があるか確認したいときに参照する。**作業開始前に必ず読むこと。**

設計判断が発生したとき、ADR (Architecture Decision Record) として記録を促す。設計方針の議論、「なぜこうしたか」「どっちにするか」系の会話、新しいアーキテクチャ判断が出たときに参照する。

エラーが出たとき、挙動が想定外のときに参照する。デバッグで行き詰まったらここに戻って来ること。

rebrgen の複数言語間にまたがるリファクタリングの方法と注意点。コードジェネレーターの構造見直し、共通部分の整理、EBM構造の変化への対応などを扱う。

ebmgen の EBM インタラクティブクエリエンジンの使い方。EBM ファイルの内容を調査・デバッグしたいときに参照する。