品質
feat(feature-flags): 機能フラグと PostHog 計測基盤を追加

Cloudflare Workers と D1(SQLite)を組み合わせた、deploy 不要の機能フラグ基盤の構築事例です。FNV-1a ハッシュで variant を決定的に割り当て、PostHog は露出イベント記録のみに特化した設計を採用。外部障害耐性・SSR 対応・E2E テストのモック不要を同時に実現する方法を解説します。

続きを読む
インフラ
Cloudflare R2 の使用量を Workers cron で監視する——4段階ステートマシンと grace period の設計

Cloudflare R2の容量上限到達によるアップロード停止事故を防ぐため、Workers cronで利用量を監視。4段階ステートマシンとgrace periodの設計により、閾値通知から新規アップロード拒否までを自動化する勘所を解説する。

続きを読む
インフラ
ADRをコードで守る:pre-commitとCIで「決めた設計判断」の侵食を防ぐ実装パターン

ADR(Architecture Decision Record)の禁止事項をpre-commitとCIで機械的に守るための実装パターン。git merge-baseベースの差分スキャン、許可リスト、PRテンプレートの3層構造で、決めた設計判断の侵食を防ぎます。

続きを読む
Docker
AIチャットBotのDocker Compose環境をセキュリティを考慮して構築した話

AI チャット Bot を Docker Compose で安全に運用するためのセキュリティ設計を実践解説。非 root 実行・socat bridge による Gateway 分離・Telegram トークンのコンテナ分離など、ベストプラクティスを実装コード付きで紹介します。

続きを読む
Docker
Docker環境のOpenClawにTelegram音声文字起こしとモデル動的切替を設定した

「Telegramの音声メッセージが文字起こしできない」「環境変数を設定したのに反映されない」——Docker ComposeのOpenClawでこの2つにつまづいた解決手順を解説します。

続きを読む
インフラ
ESLint 9.x Flat ConfigとStylelintをVitePressに導入する完全ガイド

VitePressサイトにESLint 9.x Flat ConfigとStylelintを導入した実践ガイドです。TypeScript/JavaScript混在環境での設定方法、GitHub Actions CI/CD自動化、つまづきポイントと解決策を具体的なコード付きで解説します。

続きを読む
Cloudflare
Edge-side i18nリダイレクト実装ガイド | Cloudflare Pages Functionsで多言語対応

Accept-LanguageヘッダーとCookieを使用した自動言語判定、SEO対策(ボット検出)、セキュアなCookie実装を完全解説。Cloudflare Pages Functionsでの実装手順を35個のテストケース付きで紹介。

続きを読む
インフラ
【完全ガイド】Docker ComposeでAIアシスタント環境を構築する方法

clawdbot(openclaw)ことAIチャットアシスタントをDocker Compose環境で構築する方法を解説。Dockerfile、docker-compose.yml、Makefileの実装例と、非rootユーザー実行やsocat bridge等のセキュリティ設計のポイントを紹介します。

続きを読む
Cloudflare
ESLintがCloudflare Workers型を認識しない問題の解決【R2Object no-undef】

Cloudflare WorkersでR2を使用する際、ESLintが`R2Object`型を認識しない`no-undef`エラーの原因と解決方法を解説。必要なプロパティのみを持つインターフェースを定義することで、型安全性を保ちながらエラーを回避できます。

続きを読む
Cloudflare
【解決】Cloudflare R2「bucket not found」エラーの原因と対処法

Cloudflare Pages + R2でプレビューデプロイ時に「R2 bucket not found」エラーが発生していませんか? 本番環境では成功するのに、PRからのプレビュー環境だけ失敗する—— この問題の原因 […]

続きを読む