すべての記事
Claude Code を相棒に Firebase を CocoaPods から SPM へ移したときの実装メモ
個人開発の iOS アプリで Firebase を CocoaPods から Swift Package Manager へ移行した記録です。Claude Code に何を任せ、何を自分で判断したか、Crashlytics の dSYM でつまずいた点まで率直にまとめました。
Crashlyticsのクラッシュを根本原因ごとに束ねる — Claude APIで作るトリアージの設計メモ
Crashlyticsの「Issue」は同じ原因を別物として散らしてしまうことがあります。累計5,000万DLのアプリ運用で溜まったクラッシュを、Claude APIで根本原因ごとに束ね直して優先順位をつける設計を、動くコードと実測値とともに共有します。
Claude 非同期パイプラインで「毒メッセージ」を隔離する — デッドレターキュー設計の実装メモ
1件の壊れた入力がバッチ全体を止める「毒メッセージ」問題を、Cloudflare Queues のデッドレターキューで隔離する設計と実装。Claude API 特有の失敗パターンの切り分けまで実体験ベースでまとめます。
Claude Code のコンテキスト上限エラーが出たときの原因と対処
長時間の Claude Code セッションでコンテキスト上限に達したとき、/compact と --continue の使い分けや、セッション分割の設計パターンを実体験から解説します。
Claude Code と Claude in Chrome の使い分け — 運用で見えた境界線
個人でアプリを運営していると、エディタとブラウザの行き来が集中力を削ります。Claude Code と Claude in Chrome をどちらに任せるかで整理した 1 ヶ月の運用と、境界が曖昧だった領域の判断基準を、実数値とあわせて記録しました。
再現できないエージェント障害をなくす設計 — 決定論的リプレイとイベントソーシング
深夜に落ちた自律エージェントは、そのままでは再現できません。モデル出力やツール入出力など非決定の境界をイベントとして記録し、決定論的にリプレイする設計を、実装コードと運用知見つきで解説します。
効くスキルの設計 — テンプレート固定と判断基準で Claude Code の出力を安定させる
Claude Code のスキルで毎回ブレる出力を安定させるための実践設計。いつ使うかの明示、判断基準テーブル、references テンプレートでの品質固定、トレーサビリティ規則を、実運用のコード付きで解説します。
SKILL.md の後半が読まれていなかった話 — 200行に収める設計と progressive disclosure
Codex CLI が SKILL.md を約220行で読み止める観測をきっかけに、エージェントが実際に読む長さと、SKILL.md を200行以内に収める設計・references への退避の考え方を整理しました。
Claude API の max_tokens 打ち切りを継続生成でつなぐ — 重複とコードブロック分断を防ぐ実装
長文生成が途中で切れる max_tokens 打ち切りを検出し、assistant プレフィルで続きを書かせ、つなぎ目の重複やコードフェンスの分断を防いで安全に組み立てる継続生成の実装パターンをまとめました。
Dynamic Workflow を自作する — phase / agent / pipeline で再現可能な調査パイプラインを書く
Claude Code の Dynamic Workflow を自作するための実践ガイド。phase / agent / pipeline / parallel のプリミティブ、JSON Schema による出力の固定、敵対的検証パターンの移植、トークンコストの設計までをコード付きで解説します。
git の detected dubious ownership が出てコマンドが止まるときの原因と対処
Claude Code やコンテナ・CI でgitを動かすと突然出る「detected dubious ownership in repository」の原因を整理し、safe.directory設定から所有権の根本対処までを実例で解説します。
Claude Code の Dynamic Workflow を動かして掴んだ、サブエージェント並列実行の勘所
Claude Code v2.1.154 で入った Dynamic Workflow を実際に動かし、/deep-research の流れ、有効化、/workflows での進行確認、ワークフローの保存までを個人開発の視点で整理しました。