メインコンテンツへスキップ
見出し画像

AIに渡した設計書は、本当に読まれているのか

    こんばんは。
    久しぶりの更新です。

    低頻度ですがマイペースでしばらく仕事での気づきを整理していきます。

    丁寧に作った設計書への不安

    最近、仕事でAIを使いながら、あるシステムの設計を進めている。

    AIは本当に便利だ。資料を読み、情報を整理し、設計書のたたき台を作ってくれる。以前なら何時間もかかっていた作業が、驚くほど短い時間で形になる。

    それでも、設計が進むほど、ひとつの不安が大きくなってきた。

    この設計書は、実装するときに本当に読まれるのだろうか。

    せっかく時間をかけて考えたことも、AIがコードを書くときに参照しなければ意味がない。

    人間なら、分からないことがあれば設計者に聞くかもしれない。でもAIは、与えられた情報だけで、それらしい答えを作れてしまう。

    しかも、その答えが一見正しく見えることもある。

    そこに、少し怖さを感じた。

    書いたことと、伝わったことは違う

    最初は、設計書をもっと詳しく書けばいいのだと思っていた。

    けれど、よく考えると問題はそこではなかった。

    どれほど丁寧な説明でも、相手が読んでいなければ伝わらない。これはAIに限った話ではない。

    例えば、職場で誰かに仕事を引き継ぐとき。

    資料を共有しただけで、引き継ぎが完了したと思ってしまうことがある。でも、本当に大切なのは、相手が必要な場面で必要な情報を使えることだ。

    AIとの仕事も同じなのだと思う。

    設計書を作ることと、設計の意図が実装に届くこと。

    この二つは、似ているようで違う。

    人が頑張らなくても届く仕組み

    この不安をきっかけに、最近は仕事の進め方そのものを考えている。

    例えば、実装を始める前に、必要な設計情報を確認する。どの要求に対応する作業なのかを明確にする。終わったときには、設計と実装のつながりを確かめる。

    特別に難しいことではない。

    ただ、これを毎回人間が思い出して指示するのでは、いつか抜けてしまう。

    だから、担当者が意識しなくても自然に確認できる流れを作れないか、と考えている。

    もちろん、仕組みを作ればすべて解決するわけではない。確認の仕組み自体が間違っている可能性もあるし、最後には人間の判断が必要になる。

    それでも、誰かの注意力だけに頼らないという考え方には、意味がある気がしている。

    AI時代の設計とは

    AIを使い始めた頃は、どれだけ上手に指示できるかが重要だと思っていた。

    今でも指示の仕方は大切だ。

    でも最近は、少し違うことを考えるようになった。

    大切なのは、良い答えを一度出してもらうことだけではなく、その答えに至るための意図を、次の作業へ残していくことではないか。

    人間同士でも、言葉にしなかった前提がすれ違いを生む。

    AIが相手になると、そのすれ違いは見えにくくなるのかもしれない。AIは迷っていても、流暢に答えてしまうからだ。

    だからこそ、何を決めたのか、なぜそう決めたのか、何をまだ決めていないのか。

    それらを次の作業に渡せる形にしておきたい。

    これは単なる開発手法の話ではないように思う。

    自分の考えを、相手にどう届けるか。

    AIと仕事をすることは、そんな当たり前で難しい問いを、もう一度考える機会なのかもしれない。

    設計書が完成したとき、仕事が終わるのではない。

    その意図が誰かの仕事に届いたとき、初めて設計は役割を果たす。

    最近は、そんなふうに感じている。

     
     
    仕事も生活も抱えたまま、AIとnoteで小さな逃げ道を試しています。IT業界20年以上。AIに正解を聞くより、自分の問い・一次情報・止まっても戻れる仕組みを大切に。成功談だけでなく、迷いと検証をそのまま書きます。しんどい会社員が、自分のペースで小さく試すための部屋です。

    あなたへのおすすめ