2026年6月

AIエージェントが道具をうまく使えないのは、モデルが悪いんじゃなくて「道具棚」が雑だからかもしれません — Function Calling（ツール）設計の実践ガイド

最近、AIエージェントを触っていて、こんな経験ありませんか。 モデルをもっと賢いものに変えた。プロンプトも何度も書き直した。なのに、エージェントは相変わらず不安定。変なツールを呼んだり、引数を間違えた…

AIが書いたSQL、そのまま本番で叩いて大丈夫ですか？ — 「動く」を卒業して、EXPLAINで測って、影響範囲を囲ってから出すための実践ガイド

AIが書いたSQL、そのまま本番で叩いて大丈夫ですか？ — 「動く」を卒業して、EXPLAINで測って、影響範囲を囲ってから出すための実践ガイド はじめに — 「動くSQL」と「本番で安全なSQL」は…

AIにテストを書かせたら、カバレッジは上がったのに品質は上がらない理由 — “テストの良し悪し”をミューテーションテストで測る実践ガイド

はじめに — 緑のバーは、安心していい合図ですか？ AIにテストを書かせると、ほんまに一瞬ですよね。 「このコードのテスト書いて」とお願いするだけで、ファイルがどんと出てくる。流すと、テストランナーが…

そのコード、AIに送る前に一回止まりませんか？ — 自分のマシンでLLMを動かす「ローカルLLM」入門と、API／ローカルの賢い使い分け

AIに「コード丸ごと渡し」はもう卒業。巨大・レガシーなコードを“地図化”して調査も改修も任せる技術

この記事のゴール AIコーディング支援を使っていて、こんな経験はないでしょうか。 「このバグ直して」ってリポジトリごと渡したのに、 全然関係ないファイルをいじってくる 。 「この機能どこで実装されてる…

AI時代の成果物は「作って終わり」じゃない: ObsidianとTypeScriptで配送OSを作る

AIが書いたコードを毎回"目視"レビューするのは、もう限界。評価(Eval)を仕組みにして"任せて確かめる"開発へ

はじめに：AIの出力、"合ってる"ってどうやって判断してます？ 最近、コードのかなりの部分をAIに書いてもらってる人、増えてきましたよね。 Claude CodeにしてもCursorにしても、関数1個…

AIが参照してるの、半年前の“嘘ドキュメント”かもしれません — ドキュメントドリフトを止めて、人間とAIの「共通の文脈」を保つ実践ガイド

はじめに：AIで速くなったのに、なぜ“前と同じ説明”を何度もしてるのか AIにコードを書かせるの、ほんまに速くなりましたよね。 要件をざっくり伝えたら関数ができて、テストも生えて、リファクタもしてくれ…

AIに大量に書かせたコード、いざ「戻したい」時に戻せますか？ — コミットを“レビューとロールバックの単位”として設計する実践ガイド

AIに大量に書かせたコード、いざ「戻したい」時に戻せますか？ — コミットを“レビューとロールバックの単位”として設計する実践ガイド はじめに：速くなったのは「書く」ところだけかもしれない 正直に言う…

AIが書いたコードは「動く」のに半分は脆弱 — AI生成コードのセキュリティを「動くか」と「安全か」で分けて検証する実践ガイド

はじめに：「動く」と「安全」は、実は別の話なんです AIにコードを書かせると、ほんまに速い。 仕様をざっと伝えたら、数十秒で関数ができあがって、ローカルで動かしたらちゃんと動く。テストも通る。「もう完…

AIにライブラリ移行を丸投げすると、なぜ静かに事故るのか — 大規模コードマイグレーションを「決定的codemod × LLM × 人間」で仕分ける実践ガイド

はじめに：作るのは速くなったのに、「作り替える」はなぜ怖いままなのか 正直に言うと、AIが来てから、新しいコードを書くのはほんとに速くなりました。 でも、不思議なことに、もうひとつの仕事だけはあんまり…

本番でAIが「たまに落ちる」を許す設計 — LLM呼び出しの信頼性エンジニアリング（リトライ・タイムアウト・フォールバック）実践ガイド

本番でAIが「たまに落ちる」を許す設計 — LLM呼び出しの信頼性エンジニアリング（リトライ・タイムアウト・フォールバック）実践ガイド はじめに — 「ローカルでは動いたのに、本番でたまに落ちる」の正…

AIに「コマンド実行」まで任せて事故る前に — AIエージェントを“安全な作業部屋”に閉じ込めるサンドボックス設計の実践ガイド

AIで開発は速くなったのに、半年後のコードが「重い」理由 — AI時代の技術的負債を、測って・借りて・返す実践ガイド

はじめに：速くなったはずなのに、なぜか苦しい AIコーディング支援を使い始めて、開発はたしかに速くなりました。書きたい関数の名前を打てば中身が出てくるし、テストの雛形も一瞬。正直、最初の数週間はちょっ…

AIの“自信満々”は、正しさの保証じゃない — ハルシネーション（もっともらしい嘘）を、根拠づけと出力検証で“捕まえる”技術

AIに「このコード速くして」と頼んでも速くならない理由 — 推測をやめて、計測（プロファイリング）でボトルネックをAIと潰す実践ガイド

はじめに — AIに「速くして」って言っても、なぜか速くならない話 正直に言いましょう。こんな経験、ありませんか。 アプリの動きがなんか重い。APIのレスポンスがもっさりしてる。そこでAIに、こうお願…

AI時代の先送り癖は「判断TTL」で減らせる: ObsidianとTypeScriptで意思決定を腐らせない仕組みを作る

AIで実装は速くなったのに、コードが読めるようにならない理由 — “受け身の要約”を卒業して、知らないコードをAIと読み解く実践ガイド

はじめに — 「で、これ結局なんで動いてるんやろ？」が増えていませんか AIにコードを書かせると、ほんまに速い。タスクはサクサク終わる。テストも通る。 でも、ふと立ち止まったときに、こう思うことってな…

AIに毎回「やり方」を説明するのをやめる — Agent Skills（SKILL.md）で“できる人の手順”を、文脈を溢れさせずにAIへ渡す実践ガイド

AIに毎回「やり方」を説明するのをやめる — Agent Skills（SKILL.md）で“できる人の手順”を、文脈を溢れさせずにAIへ渡す実践ガイド はじめに：AIは賢いのに、なぜか毎回ふりだしに…

その決断、いくらで巻き戻せますか ― AIで「やり直せる実験」を増やす意思決定の設計

AIとの会話が長くなると、なぜか話が噛み合わなくなる ― コンテキストウィンドウと文脈圧縮（Compaction）の実践ガイド

AIが賢いのに仕事できないのは、渡した道具のせいかもしれない — AIエージェントに持たせるツール（Function / MCP）設計の実践ガイド

はじめに：AIが失敗した時、つい「AIがアホやな」と思ってしまうけど AIエージェントを動かしていて、こんな経験ないですか。 「ちゃんと指示したのに、変なところを検索しに行った」 「引数を勝手に間違え…

AIが同じ質問に毎回ちがう答えを返すのは、なぜ？ — 非決定性（Non-determinism）と上手につき合う実践ガイド

推論モデルに「think step by step」は、もういらない — AIに「どれだけ考えさせるか」を設計する実践ガイド

AIに毎回プロジェクトを説明するのをやめる — AGENTS.mdで、コーディングエージェントに「リポジトリの歩き方」を1枚で渡す実践ガイド

はじめに — 毎回、同じ説明してませんか？ AIにコードを任せられるようになって、たしかに開発はめちゃくちゃ速くなりました。Cursor、Codex、Claude Code、GitHub Copilo…

AIで何でも作れる時代、本当に難しいのは「やめる」判断 — Kill Criteria（撤退基準）で、始める前に終わり方を決める実践ガイド

AIに「任せるか自分でやるか」を、気合いで決めるのをやめる — 比較優位と機会費用で人間とAIの仕事を分ける実践ガイド

AIに直させたら「別の場所」が壊れた、の正体 — リファクタリングを壊さない安全網（仕様化テスト）実践ガイド

はじめに：AIに「ここ直して」って頼んだだけなのに AIコーディング支援を使っていて、こんなこと、ありませんか。 「この関数だけちょっと整理して」とお願いしただけなのに、なぜか 全然関係ないところ が…

AIが書いたコード、動くけど「なんかズレてる」の正体 — Spec-Driven Development（仕様駆動開発）で、AIを“設計図どおり”に動かす実践ガイド

はじめに：「動くけど、なんか違う」あの感じ AIにコードを書かせるの、ほんまに速くなりましたよね。 「ログイン機能つけて」「この一覧、検索できるようにして」みたいにお願いするだけで、数十秒後にはそれっ…

AIを1体で使うのをやめる ― 自分を「並列化」するマルチエージェント・オーケストレーション入門

AIに「自分だけの知識」を持たせる技術 — RAG入門で、汎用AIを「あなた専用のエキスパート」に変える実践ガイド

深夜のアラートをAIと乗り切る技術 — “読む専用”から始めるAIインシデント対応の実践ガイド（仮説駆動トリアージ／ブラスト半径／ブレームレスポストモーテム）

はじめに：深夜3時、アラートが鳴る。あなたは何を最初に開きますか 深夜3時。スマホが震えて、画面に「決済APIのエラー率が急上昇」の通知。 このとき、頭のなかってだいたい真っ白になるんですよね。ログを…

AIエージェントに仕事を任せる前に「実行契約」を書く: ツール・権限・停止条件をコード化する実務入門

結論: これから大事になるのは「プロンプト」より、実行前の契約かもしれない 最近のAI開発ツールを見ていると、流れがかなり変わってきたなと思います。 コード補完からチャットへ。チャットからエージェント…

AIに任せる前に、仕事を観測可能にする ― Work ReceiptでレビューできるAI開発へ