Architecture Notes

All Articles

git worktree はコードしか隔離しない。worktree ごとに専用 DB・動的ポート・dev サーバを生やし、WorktreeCreate / SessionStart / SessionEnd フックでライフサイクルを自動管理する。3 つのプロジェクトで運用して固まった設計原則。

Data Connect・Firestore・Zod・API DTO で同じモデルを多重管理する drift を、YAML 契約を single source of truth にしたコード生成で構造的に消す設計。

複数リポジトリを横断する AI エージェントの作業を、スコープと権限の宣言ファイルで強制する。セッション単位のガードレール設計と、権限定義そのものを触らせない自己制約、push を物理的に固める二重防御。

GCP / Firebase を設定から払い出した先に残る「DNS・認証・配信証明書・env 値」を、同じ source of truth に追従させる CI パイプラインの設計。

サービスごとの設定ファイルを SoT に、GCP Project 作成から Firebase Platform 構築までを keyless で自動連鎖させる基盤の設計。

1 つの GCP プロジェクトに複数サービスを同居させた開発環境を、「どう動くか（ランタイム）」と「どう届けるか（デリバリ）」の 2 断面から紹介します。

Cloud SQL を SoT、Firestore を読み取り投影面と位置づけたときに見えてくる設計上の利点と、その代償。