すべての記事
MCP の tools 以外の3つの能力を使い分ける：resources・prompts・sampling の設計
MCP サーバーで何でも tools にしてしまう設計の限界を、resources・prompts・sampling という3つの primitive で解きほぐします。壁紙アプリのアセット管理サーバーを題材に、判断基準と実装、クライアント対応の現実的な制約までまとめました。
Claude Code で「Credit balance is too low」が出る時の原因と対処
Claude Code を起動した瞬間に「Credit balance is too low」と返ってきて作業が止まる。サブスクリプションには加入しているのに、なぜか API のクレジット残高を見に行ってしまう——この食い違いの正体と、認証経路の切り替え・残高補充・自動チャージの設定までを、実運用の手順で順番に整理します。
Claude Design のデザインシステムを“作り捨て”にしない運用設計
Claude Design で一度きれいな資料が出ても、デザインシステムを毎回作り直していては資産になりません。既存資料からの抽出を再現性のある運用に落とし込み、原稿を渡すだけで誰でも同じ品質の資料を立ち上げる回し方を、個人開発とアート活動の現場目線で設計します。
Claude Design に既存スライドを一枚渡して、会社資料のブランド再現を自動化した話
会社紹介や採用資料を作り直すたびに時間を奪っていたのは中身ではなく『ブランドを毎回手で再現する』作業でした。既存スライドを1枚渡してデザインシステムを抽出し、原稿を渡すだけで統一資料が立ち上がるまでの実体験を、個人開発とアート活動を続けてきた立場からまとめます。
Claude on Xcode と Claude Code を、iOS 個人開発の日常で 2 週間使い分けた所感
Xcode に常駐する Claude on Xcode と、ターミナルで動く Claude Code を、壁紙アプリの実務で 2 週間並行して使いました。どちらをどの作業に充てると手が止まらないのか、実際の振り分けと判断基準を残します。
自律エージェントの破壊的操作に事前条件・事後条件の契約ゲートを付ける
スキーマも型も通るのに中身が壊れている——自律エージェントのもっともらしい失敗を、事前条件・事後条件の契約ゲートで止める設計です。tryGuard・commitGuard・rollbackの構造、TypeScriptでの実装、スナップショットによる安全な巻き戻し、既存エージェントへの後付け手順まで紹介します。
ユーザーレビューやクラッシュログをClaude APIに渡す前に — 個人情報を可逆マスキングする前処理の設計メモ
App StoreのレビューやCrashlyticsのログをClaude APIで分析するとき、本文に紛れ込む個人情報をどう扱うかは避けて通れません。出力から実データへ辿り直せる可逆マスキングの設計と、本番で踏んだ落とし穴を実装コード付きでまとめました。
Claude Code から git push すると 403 Write access to repository not granted が出るときの対処
Claude Code の自動化で GitHub に push すると 403『Write access to repository not granted』が出る原因を、classic PAT と fine-grained PAT の違いから整理し、リポジトリアクセス・Contents 権限・組織承認の確認手順を解説します。
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での再開の使い分け、タスクを小さく分割する設計、コンテキストを節約する習慣、/clearとの違いまで順に整理しました。