Jamstackのプレビルド思想は何を優先したのか:Single Source of TruthとTTFBのどちらを守るかという価値選択
Jamstackのプレビルドアーキテクチャは、リクエスト時の処理を最小化するために、コンテンツの唯一の情報源をどこに置くかという責務の配置を優先している。
① Jamstackのプレビルド思想は何を優先したか
一般的なSSRブログでは、アクセスのたびにMarkdownの解析・HTML変換・シンタックスハイライト適用というコストが繰り返し発生する。記事の内容は変わっていないのに、リクエストごとに同じ処理を払い続ける。
Jamstackのプレビルド思想は「重い処理はビルド時に完結させ、リクエスト時の責務を最小化する」という原則を取る。ただしこれは「どこに何を持たせるか」という選択でもある。生成済みのHTMLファイル自体をGitで管理する案も検討できるが、その場合Markdownとの同期が崩れるリスクが生まれ、「どちらが正本か」が曖昧になる。
- 【優先した価値】: Markdownを唯一の情報源(Single Source of Truth)として維持すること。生成物(TypeScriptモジュール)はビルドのたびに作り直される派生物として扱い、Git管理から外す
- 【犠牲にした価値】: デプロイの単純さ。生成済みHTMLをそのままコミットしていれば、デプロイ時のビルドステップ自体が不要になる。SSoTを守るためにこの単純さを手放した
② ClaudeMixでやったこと
Before: content/blog/posts/ のMarkdownファイルを、loader がリクエストのたびに読み込んで変換していた。
// app/data-io/blog/posts/fetchPosts.server.ts(変更前・概念)
export async function fetchPosts() {
const files = await fs.readdir('content/blog/posts');
return Promise.all(files.map(f => parseAndConvert(f)));
}After: npm run build の一部として scripts/prebuild/generate-blog-data.ts を実行し、Markdownの解析・HTML変換・シンタックスハイライト適用を全てビルド時に完了させる。結果は app/generated/blog-posts.ts に書き出し、この生成ファイルは .gitignore の対象にした。
// package.json
{
"scripts": {
"prebuild": "node scripts/prebuild/generate-blog-data.ts",
"build": "npm run prebuild && remix vite:build"
}
}# .gitignore
app/generated/リクエスト時のデータアクセス層は、生成済みモジュールをimportするだけになった。
③ 技術的負債
- 【解消した負債】: リクエストのたびに繰り返していたMarkdown解析・HTML変換処理。ビルド時に一度だけ実行する構成に変わった
- 【新たに生まれた負債(あれば)】: 記事を追加・更新するたびにビルドが必要になった。記事数が増えるにつれてビルド時間も増加する。また、生成ファイルをGit管理から外したことで、「ビルドを一度も実行していない環境ではコンテンツが存在しない」という前提を開発者全員が理解している必要がある
本文には他記事(Shikiのビルド時変換、ファイルシステム非互換への対応)で実測されたBefore/After値への言及はあるが、この記事自体の固有の定量値は存在しない。そのため実測値による比較は行わない。
④ 経営翻訳
各支店が抱える正本資料をどこに置くかという選択に相当する。「支店ごとに複製した最新版の写しを配布しておく」案は、原本の更新時に写しとの食い違いが生じるリスクを持つ。「原本は本部の1箇所にのみ置き、配布物は毎回そこから作り直す」案は、配布のたびに作成の手間がかかるが、どちらが正本かで迷うことがなくなる。
今回は後者を選んだ。作成の手間は自動化された手続きに委ね、正本の所在を一つに保つことを優先した。
この「ビルド時に責務を前倒しする」という考え方は、Shikiのシンタックスハイライトが抱えていたWASM制約への対応にも共通する。また、後に判明することだが、Remix + ViteスタックにはPSI計測上の構造的な上限が存在し、プレビルドによるTTFB短縮だけでは超えられない壁もある。この点は後の記事で詳しく検証している。