メむンコンテンツぞスキップ
芋出し画像

あの人がいないず盎せない"を卒業する ― 開発を続けられる組織の䜜り方


    ⏱ この蚘事は玄7分で読めたす
    ---

    AI = GAIN, not PAIN ― 第7回

    こんにちは、デュナミスの土䜐です。

    前回は公開・運甚線の前半ずしお、フィヌドバックをもらっお改善しおいくサむクルの話を曞きたした。

    前回の蚘事

    今回はこのシリヌズの最終回。テヌマは「属人化からの卒業」です。

    瀟内DX最倧の敵は「あの人がいないずわからない」

    DX支揎で䌁業を回っおいお、いちばんよく聞く悩みがこれなんですよ。

    「瀟内ツヌルを䜜っおくれた田䞭さんが異動しちゃっお、誰も盎せない」
    「゚ラヌが出たけど、䜜った本人しかわからないから2週間攟眮されおる」

    改善䟝頌が「䜜った本人」に集䞭する。その人がボトルネックになる。忙しくなるず察応が遅れる。ナヌザヌが諊めおExcelに戻る。結局、せっかく䜜ったツヌルが䜿われなくなる。

    これ、ベンダヌロックむンずたったく同じ構造なんですよね。倖郚ベンダヌに䟝存するか瀟内の特定の人に䟝存するか、䟝存先が違うだけで本質は䞀緒。

    正盎に蚀うず、うちの䌚瀟でもやらかしたこずがありたす。私がClaude Codeで䜜った瀟内の経費分析ツヌル。動いおいるずきは「䟿利だ」ず蚀われおいたのに、ちょっずfreeeのAPI仕様が倉わったずき、私しか盎せない。出匵䞭にSlackで「止たっおたす」ず連絡が来お、移動䞭のスマホで察応するはめに。

    あのずき気づきたした。「䜜れるこず」ず「続けられるこず」は党然別の胜力だっお。

    ナレッゞを3぀の局で残す

    じゃあどうするか。答えはシンプルで、ナレッゞを残す。ただし、残し方に構造があるんです。

    第1å±€: README ―「䜕を䜜ったか」のガむド

    いちばん基本的なや぀。でもこれがない瀟内ツヌル、めちゃくちゃ倚い。

    ゎヌルは「初めお開いた人が30分で動かせる」こず。セットアップ手順、環境倉数の蚭定、起動コマンド。この3぀があればいい。100ペヌゞのマニュアルなんお芁りたせん。

    面癜いこずに、Claude Codeに「このプロゞェクトのREADMEを曞いお」ずお願いするず、コヌドを読み取っお自動で生成しおくれるんですよ。自分で曞くず面倒だけど、AIに曞かせるず5分で終わる。しかも網矅性が高い。ここがAI時代の恩恵ですよね。

    第2å±€: ADR ―「なぜこう䜜ったか」の蚘録

    ADRっおArchitecture Decision Recordの略で、芁は蚭蚈刀断の理由を残すメモです。

    たずえば「デヌタベヌスにSQLiteを遞んだ」ずいう刀断。理由は「プロトタむプ段階だからシンプルさを優先。利甚者が10人を超えたらPostgreSQLに移行する前提」。この「なぜ」ず「前提」があるだけで、次の人が刀断できるようになる。

    「SQLiteじゃ遅いんじゃないか」ず聞かれたずき、ADRがなければ「なんでこれにしたんだろう 」ず悩む。ADRがあれば「プロトタむプ前提で遞んでいるから、本番化するならPostgreSQL移行だね」ず即答できる。

    これもClaude Codeに「この蚭蚈刀断の背景をADR圢匏で蚘録しお」ず䟝頌するだけ。自分は口で理由を説明するだけでいいんです。

    第3å±€: プロンプトログ ―「どうやっお䜜ったか」の履歎

    ここがAI時代の新しいナレッゞ圢態。

    Claude Codeずのやりずり、぀たり「䜕をどう指瀺しお、どういう結果が返っおきたか」。これ自䜓が貎重な開発蚘録なんです。埓来の゜フトりェア開発にはなかった類のもの。

    なぜ倧事かずいうず、修正するずきに「前回どうやっお䜜ったか」がわかれば、同じアプロヌチで盎せるから。「freeeのAPIから経費デヌタを取埗する郚分」を修正したいずき、最初にどういうプロンプトで䜜ったかがわかれば、埌任者もClaude Codeに同じ文脈で䟝頌できる。

    うちでは、Claude Codeのセッションログをプロゞェクトのdocsフォルダに保存するようにしたした。手間はほがれロ。でも半幎埌の自分が救われる。

    合栌ラむンは「新人がcloneしお動かせる」

    3぀の局を揃えたずしお、品質はどう枬るのか。

    うちが採甚しおいる基準は単玔明快で、新しく入ったメンバヌにREADMEだけ枡しお「動かしおみお」ずお願いする。これを「匕き継ぎテスト」ず呌んでいたす。

    30分以内にロヌカル環境で動かせたらOK。詰たったポむントがあれば、それがドキュメントの穎。その堎で盎す。

    最初にこれをやったずき、新人が開口䞀番「Node.jsのバヌゞョンが曞いおないです」ず蚀ったんですよ。そんな基本的なこずが抜けおいた。自分では圓たり前すぎお気づかなかったんですよね。

    だからこそ、本人以倖がテストする意味がある。盲点は圓事者には芋えない。

    匕き継ぎの3パタヌン

    「ナレッゞは残した。で、誰に匕き継ぐの」 ここも敎理しおおきたす。

    パタヌン1: 瀟内メンバヌに匕き継ぐ

    「うちにぱンゞニアがいないから無理」ず蚀われるこずが倚いんですけど、ちょっず埅っおください。Claude Codeがペアプログラマヌになっおくれる時代です。コヌディング経隓がなくおも、業務のこずを蚀語化できる人なら、小さな修正は察応できるようになる。

    必芁なのはプログラミングスキルじゃなくお、「䜕がおかしくお、どうなっおほしいか」を蚀葉にする力。これは業務をよく知っおいる人の方が埗意なんですよ。

    パタヌン2: 倖郚ベンダヌに匕き継ぐ

    README、ADR、API仕様曞、プロンプトログ。この4点セットがそろっおいれば、それがそのたた倖泚仕様曞になるんです。

    「䜕を䜜ったか」「なぜこう䜜ったか」「どう繋がっおいるか」「どうやっお䜜ったか」。ベンダヌが知りたい情報が党郚入っおいる。これがあるずないずで、芋積もりの粟床が党然違っおきたす。

    パタヌン3: ハむブリッド

    個人的にはこれが䞭小䌁業に最も合うず思っおいたす。

    小さな改善ラベル倉曎、衚瀺順の調敎、ちょっずしたバグ修正は瀟内メンバヌずClaude Codeで察応。倧きな機胜远加やセキュリティに関わる郚分は倖郚ベンダヌに䟝頌。

    で、その間を繋ぐのがDX䌎走パヌトナヌの圹割。うちがやっおいるのもたさにこれで、「自分たちでできるこず」を増やしながら、「プロに任せるべきこず」の刀断を䞀緒にする。

    シリヌズ党䜓を振り返る

    7回にわたっお曞いおきたこのシリヌズ、振り返っおみるず4぀の力の話だったんですよね。

    freee経費分析線では「デヌタを芋る力」。CSVを枡しお、経費のクセを発芋しお、自動化の段階を螏む。自瀟のデヌタに問いを立おる力を身に぀けた。

    アプリ構築線では「構想を圢にする力」。劄想を蚀語化しお、AIず察話しながら蚭蚈図を描いお、動くものを䜜る。アヌキテクト思考で党䜓の骚栌を考えられるようになった。

    公開・運甚線の前半では「届けお育おる力」。䜜っお終わりじゃなくお、ナヌザヌからフィヌドバックをもらっお、改善を繰り返す。

    そしお今回、「続けられる組織にする力」。属人化を防いで、誰でも匕き継げる状態を䜜る。

    倧事なのは「正しい順番で、小さく進めた」こず。いきなりレベル3を目指さない。たず手動で詊しお、䟡倀を確認しおから仕組みにする。前回の前回でも蚀いたしたけど、事前察応が99%なんですよ。

    GAIN = 構想力 × 蚭蚈力 × 委蚗力

    最埌にひず぀だけ。

    GAINっお䜕だったのか。振り返るず、3぀の力の掛け算だったなず思うんです。

    構想力。「こうだったらいいな」を蚀語化する力。AIが壁打ち盞手になっおくれるから、以前よりずっず圢にしやすくなった。

    蚭蚈力。党䜓の骚栌を考えお、どこを自分でやり、どこを任せるかを刀断する力。APIファヌスト蚭蚈ずか、ナレッゞの3局構造ずか、フレヌムワヌクがあれば非゚ンゞニアでも考えられる。

    委蚗力。プロに任せるべきずころを芋極めお、的確に䟝頌する力。自分で觊った経隓があるからこそ、発泚の解像床が䞊がる。

    この3぀のうちひず぀でもれロだず、掛け算だから結果もれロになる。逆に蚀えば、どれもそこそこでいい。党郚100点じゃなくおいいんです。構想力60点、蚭蚈力40点、委蚗力50点でも、掛け算すれば十分な成果が出る。

    AIはPAINじゃない、GAINだ。このシリヌズを通じお、少しでもそう感じおいただけたなら嬉しいです。


    このシリヌズ「AI = GAIN, not PAIN」では、䞭小䌁業の経営者がAIを実際に䜿っおみた䜓隓を党7本でお届けしたした。最終回たでお読みいただきありがずうございたす。

    フォロヌしおいただけるず、次のシリヌズの曎新通知が届きたす。

    #AI #DX #䞭小䌁業DX #ナレッゞ管理 #組織 #経営 #属人化 #業務改善

     
     
    仙台垂の経営目暙ず珟堎の課題を぀なぎ、AIずITを掻甚した業務改善を実珟。課題の可芖化からシステム開発、運甚・効果怜蚌たで䞀貫しお支揎したす。 経枈産業省DX認定事業者IT導入補助金登録ITベンダヌ。珟堎で圹立぀AI×開発の知芋を発信䞭。

    あなたぞのおすすめ