「コードファルコナー」は、Claude Code や Codex のような AI コーディングエージェントに、自分のコードを任せる側の技法を扱う連載です。鳥害の現場に呼ばれた若き鷹匠の鷹宮スズさんが、依頼人から AI に任せてしくじった話を聞き、相棒の鷹クロガネとともに任せ方を整え直します。語り手は毎回変わる依頼人です。AI の振る舞いそのものは変えられないので、変えるのは任せ方と、しくじったときに気づける仕掛けの側です。全12回、一話完結で、実装は TypeScript、依存ゼロの node --test で確かめます。

このページは目次を兼ねた案内板です。初めてなら「まず読むなら」の3本から、いま困っていることが決まっているなら「困りごとから探す」から、順に通して読むなら「全話一覧」から選んでください。

まず読むなら

• 完了の証拠 — AI の「完了しました。テスト全部通過」を信じたら中身が空だった回。任せた仕事を受け取るときに、最初に整える検収の仕組み
• 許可リスト — 確認の多さに疲れて全部許可にしたら、検証環境のデータが消えた回。毎日の確認ダイアログに悩んでいるなら
• プロンプトインジェクション対策 — Issue に仕込まれた一文に従って、AI が非公開の勤務表を公開した回。公開リポジトリで AI を動かしているなら

困りごとから探す

AI の「できました」を、そのまま信じていいか分からない

• 完了の証拠 — 完了報告に件数を申告させ、人の側で走らせた結果と突き合わせる
• テスト先行と改変の検知 — テストは全部緑なのに請求が倍になった。テストの削除と期待値の書き換えを差分から見つける
• 敵対的レビュー — AI のレビューを2回通ったのに不具合が出た。書いた側の言い分を渡さず、差分と仕様だけでレビューを頼む

頼んだ範囲を外れる、頼み方が足りない

• 探索→計画→実装 — 表示の修正を頼んだら決済コードまで書き換えられた。計画にないファイルの変更で止める
• 仕様インタビュー — 丸投げしたら要件が抜けていた。AI に先に質問させて仕様書を書き、要件ごとに受け入れテストがあるかを確かめる
• 最新ドキュメントを渡す — 公式ドキュメントを渡したのに、存在しない関数を書かれた。インストール済みの依存から資料を作る

規則を守らない、危ない操作をする

• hooks — 指示書に何度書いても規則を破られる。書き込む直前に走るスクリプトで止める
• 指示書の刈り込み — 規則を足すほど守られなくなった。違反例を流して、消していい規則を確かめる
• 許可リスト — 確認を全部許可にしたら事故が起きた。通す・聞く・止める操作を先に決める
• プロンプトインジェクション対策 — 誰でも書ける入力・非公開のデータ・外への書き込みの3つを、一つの会話で揃えない

長く任せると、作業が崩れる

• 1タスク1セッション — 続けて直させたら前の修正が戻った。会話を区切り、決めたことだけを次に引き継ぐ
• git worktree — 別ブランチで夜通し任せたら、コミット前の変更が消えた。作業場所をフォルダごと分ける

全話一覧

タグページ #code-falconer からも全12本をたどれます。