記事一覧

「あの人に聞けばAIでうまくやってくれる」——気づけばAIの使いこなしが一部の人に偏っていませんか。立派なマニュアルではなく、「何に使って・どう頼んで・どこを人が見たか」を一行ずつ溜めて、週に一度だけ見返す。属人化をほどくナレッジの回し方を、そのまま使える型とチェックリストで整理します。

打ち合わせで同じ「顧客」と言っていたのに、営業は会社のこと、サポートは問い合わせてきた個人のことを指していた。誰も間違えていないのに、作ったものがずれる——そんな場面のために。AIにドメインモデルと用語を整理させるときの渡し方と確かめ方を、拾う・突き合わせる・決めるの順に一緒に整理します。

期待されて始めたAIの試みが、思ったほどうまくいかなかった。その報告を上にどう切り出すか、週末まで悩んでしまう——そんなときのために。「失敗しました」ではなく「わかったこと・原因・次の一手」の順で伝え、責められずに次の挑戦へ繋ぐ報告の型を、そのまま使える文例とチェックリストつきで整理します。

「なんでこの構成にしたんでしたっけ」と聞かれて、半年前の自分の判断なのに答えられない。決めたことは覚えていても、決めた理由は残っていなかった——そんな場面のために。AIにADR（設計判断の記録）の下書きを書かせるときの渡し方と、理由をAIに作らせない確かめ方を、集める・下書き・残すの順に一緒に整理します。

AIが出してくれたセットアップ手順を上から順に打ったのに、途中で赤い文字が出て止まった。手順が悪いのか、自分の環境が違うのか分からない——そんな夕方のために。AIに環境構築の手順を書かせるときの渡し方と、動かないときの切り分けを、揃える・確かめる・残すの順に一緒に整理します。

「一覧に検索をつけて」と言われて作ったのに、出してみたら「そういう意味じゃなかった」。手を抜いたわけではなく、完成の条件がどこにも書かれていなかっただけかもしれません。AIに受け入れ条件を言語化させるときの頼み方と確かめ方を、書き出す・問い返す・例で固めるの順に一緒に整理します。

コメントを信じて呼んだ関数が、書かれていない動きをしていた。AIに書かせたdocstringは整って見えるぶん、ずれたときに気づきにくいものです。後で嘘にならないコメントをAIと作る順番を、絞る・確かめる・一緒に直すの3つで一緒に整理します。

キャンセルしたはずの注文が、なぜか発送されていた。どの処理も仕様どおりに動いていたのに——状態と操作の組み合わせのうち、誰も決めていなかったマスがあっただけかもしれません。AIに状態遷移の抜けを洗わせるときの渡し方と確かめ方を、並べる・埋める・弾くの順に一緒に整理します。

「他社はもうAIを使ってるのに、うちは何してるの？」と言われて、焦りと言い訳の間で言葉に詰まったことはありませんか。比べられる焦りを受け止めつつ、「使っているか」を「何に効いているか」に置き換えて、自分たちの次の一歩に着地させる——落ち着いた返し方の順番と言い回しを整理します。

在庫がマイナスになっている、合計と明細が合わない。エラーは出ていないのに、数字だけが静かにズレている——同時に触られたときのことを、誰も渡していなかっただけかもしれません。AIにトランザクションの境界と排他制御を相談するときの前提の渡し方を、囲む・守る・諦めるの順に一緒に整理します。

外部APIとの連携は、つなぐところまでは驚くほど早く書けるのに、相手が落ちた日に初めて怖さが分かります。AIに設計を相談するとき、どこまで任せてどこを自分で決めるか。時間切れ・やり直し・遮断・代替の4つを軸に、一緒に整理していきます。

移行の週末が近づくたび、胃のあたりが重くなる。AIに手順を出させれば計画書らしいものはすぐ出てきますが、そのまま当日を迎えるのが怖いのは当然です。AIに任せられるところと、人が決めるしかないところを分けて、戻せる形で進める段取りを一緒に整理します。

テストでは何ともなかったCSVが、お客さんのExcelで開いた瞬間に文字化けしていた。電話番号の先頭ゼロが消えていた。AIに書かせた出力処理でこれが起きるのは、あなたの確認不足ではなく「誰がどう開くか」を渡していないからです。文字コード・エスケープ・化ける値の守り方を、明日そのまま使える順番で一緒に整理します。

使われていなさそうなのに、消す踏ん切りがつかないコード。AIに「未使用を洗って」と頼めば一覧はすぐ出ますが、その一覧をそのまま信じて消すのが怖い——その気持ち、まっとうです。AIに探させるところと、人が裏を取るところを分けて、戻せる形で少しずつ消していく手順を一緒に整理します。

リリースしたAI機能に、エラーも苦情も出ていない。それなのに、ふと出力を見たら前より雑になっている気がする——いつからだろう。AIの品質は「落ちる」のではなく「にじむ」ように変わるので、エラー監視には映りません。お手本を20件だけ固定して、毎朝くらべて、ずれたら知らせる。今日から仕込める小さな見張り方を一緒に整理します。

引き継いだコードをAIに見せたら、指摘が四十いくつ返ってきた。全部もっともらしいけれど、全部直す時間はない。AIが得意なのは「気になる箇所を並べること」で、「直す価値があるか」を知っているのは、次にそこを触る予定があるあなたのほうです。順番の決め方を整理しました。

障害の報告を受けてログを開いたら、残っていたのは「エラーが発生しました」の1行だけ——調査の入口で止まってしまう、あの感じ。AIにログの不足を指摘させるときの前提の渡し方と、量を増やさずに追えるようにする順番を、たどる・わかる・出さないの3つで整理しました。

同じ登録が2件、同じメールが2通、同じ請求が2回。コードは間違っていないのに、リクエストが2回来ることを想定に入れていなかっただけ——ということがあります。AIに冪等性の設計を相談するときの前提の渡し方と、AIが素通りしやすい競合の穴を、決める・弾く・返すの順に整理しました。

上がってくるコードはきれいなのに、「なぜこうしたの？」に少し間が空く。AIで速くなったぶん、詰まって考える時間が減っただけかもしれません。誰も責めずに、チームの学習を止めないための線引き・問い方・記録の残し方を整理しました。

検証では動いた。でも本番に出す当日、リリースボタンの前で手が止まる——AI機能は「バグがある」から怖いのではなく、正解が決まっていないから怖いんですよね。分ける・細く出す・すぐ戻す、の順に整えれば、出す判断はずっと軽くなります。切り戻しの決め方まで整理しました。