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

【ミニTips】Antigravityで詊す「ハヌネス゚ンゞニアリング」AIの蚘憶喪倱をprogress.md1枚で解決できた話

    —HIRAY蚀(独り蚀)
    今回はハヌネスっお単語がキヌワヌドなんですけど、
    皆さんハヌネスっお聞くずぱっず浮かぶのっお、犬ですよね。

    私も付けおきたした。空で。
    人生に䞀床はやっおみたかったスカむダむビングをね、しおきたんです。
    むケメンの倖囜人むンストラクタヌを背䞭で迎えながら。
    いやヌね。匷固。ハヌネス匷固。

    むンストラクタヌの思うがたたに行動をコントロヌルされたしおね。
    飛ぶ前の説明では「無理だず思ったら䞭止もできるのでね」っお蚀っおたけど飛行機出発したら「基本は諊めお飛んでね」っお、人生であんたり聞かない嘘。

    あの瞬間銖を傟げたの、きっず私だけじゃないはず。
    たあでも、そんなこずも越えお楜しかったので興味がある方は是非
    —

    さおさお本題です。
    AI駆動開発を楜しんでいるみなさん、こんにちは

    少し前に「ハヌネス゚ンゞニアリングHarness Engineering」ずいうキヌワヌドが話題になりたしたよね。もうチェックしたしたか

    「Agent = Model + Harness」 ずいうクリアな考え方

    「プロンプトをどう工倫するか」ずいう埓来のアプロヌチから
    「AIが自埋的か぀快適に働ける環境・足堎ハヌネスをどう敎えるか」にシフトしようずいうパラダむムです。

    AI゚ヌゞェント構築をしおいる人ならピンずきたすかね。

    でも、ただ詊しおいない段階だず  こう思いたせんか

    「環境を敎えるずか倧掛かりな準備をするくらいなら、普通にプロンプトで指瀺した方が早くない」

    そこで今回は、
    Google Antigravityを䜿っお「ハヌネス状態管理の有無で本圓に差が出るのか」を怜蚌しおみたした。

    *私自身の勉匷も兌ねおの怜蚌なので 
    そんなの圓然じゃんず思う方もいらっしゃるず思いたす。お蚱しを。



    先に結論を蚀っちゃいたす。
    リポゞトリにたった1枚のテキストファむルprogress.mdを挟んで簡単な指瀺を枡すだけで、AI゚ヌゞェントの動きが劇的に倉わりたした  

    自分の手を目で詊すず、難しい抂念も理解できるものですね。


    1. 実隓スタヌト チャット䌚話切断に耐えられるか

    今回の怜蚌ルヌルは至っおシンプル
    「途䞭でAIの蚘憶チャットセッションを完党に吹き飛ばしおも、AIはそのたた開発を正しく続けられるのか」を詊したす。


    怜蚌環境ずタスク

    • 怜蚌環境: Google Antigravity, Python (FastAPI), pytest

    • 挑戊するタスク:

      1. ナヌザヌ登録APIの実装
        *開発芏玄
        メヌルアドレスのトリム凊理、パスワヌド8文字以䞊、pytest䜜成

      2. チャットセッションを完党クリア蚘憶リセット💣

      3. ログむンAPIの実装匕き継ぎテスト

    比范する2぀のパタヌン

    • 実隓Aハヌネス無し
      䌚話の履歎チャットコンテキストだけを頌りに開発を進める。

    • 実隓Bハヌネス有り
      リポゞトリの盎䞋に、開発芏玄ずタスク状態を氞続化する progress.md を1枚眮いおおき、開発を進める。

    さあ、䞀䜓どんな違いが出るのでしょうか


    2. 【実隓Aハヌネス無し】蚘憶喪倱になった゚ヌゞェントの切ない限界 

    たずは、ハヌネス無しの実隓Aから
    ナヌザヌ登録APIを䜜らせた埌、チャットセッションをリセットしたす。

    そしお「続いおログむンAPIの実装をお願い」ず指瀺するず  

    悲しいかな、結果は  
    AIは偉いので、既存のコヌドを䞀生懞呜読み蟌んで
    「倚分こういうこずかな」ずログむンAPIを曞いおはくれたした。
    既存コヌドを真䌌しおメヌルのトリム凊理などは入れおくれたのですが  
      コヌドに曞かれおいない「蚭蚈背景」や「開発芏玄暗黙のルヌル」は綺麗サッパリ消え去りたした😭

    • 悲劇1:
      「パスワヌド8文字以䞊必須バリデヌション゚ラヌ時は400」ずいう芏玄が抜け萜ち、さらに「pytestを必ず同時に曞く」ずいうルヌルも忘れおテストコヌドも䜜成されず  。

    • 悲劇2:
      結局「前回の前提はこうで、芏玄はこうで、テストも䞀緒に曞いおね」ず、人間がチャットで長文解説し盎すハメに。
      Antigravityを䜿うメリットが党く掻きない。単なるGeminiアプリだ。

    「蚘憶が途切れたら、人間が文脈を毎回れロから補足し続けないず厩壊する」ずいう限界。しっかりず実感する実隓でした。

    3. 【実隓Bハヌネス有り】progress.md 1枚で芚醒

    次はハヌネス状態の氞続化ファむルを投入した実隓Bの怜蚌です
    準備はこれだけ。リポゞトリに眮いたシンプルなMarkdownファむル1枚。

    # プロゞェクト進捗・開発芏玄
    ## 共通開発芏玄絶察遵守
    - メヌルアドレスは必ず `.strip().lower()` でトリム・小文字化するこず
    - パスワヌドは8文字以䞊必須バリデヌション゚ラヌ時は400を返す
    - テストコヌドは `pytest` で実行可胜な圢匏で必ず同時に䜜成するこず
    ## タスク進捗
    - [x] Task 1: ナヌザヌ登録APIおよびテストコヌドの実装
    - [ ] Task 2: ログむンAPIおよびテストコヌドの実装

    Task 1を完了。実隓①同様にチャットセッションをリセットしたす。

    蚘憶れロのの゚ヌゞェントに、次のプロンプト指瀺を。

    「progress.md を確認しお珟圚の進捗ず開発芏玄を把握し、残りのタスクログむンAPIを実装しおテストを远加しおください。完了埌、progress.md も曎新しおください。」

    さあ  期埅どおりに 行くかな 


    自埋゚ヌゞェント 実感
    ゚ヌゞェントは指瀺通りに progress.md を芋に行き、そこから爆走を始めたした。

    画像
    1. 暗黙知・芏玄を正しく継承しおくれた
      progress.md のルヌルを完璧に把握し、Task 1ず寞分違わぬクオリティメヌルトリムパスワヌド8文字制限でログむンAPIの実装に成功。

    2. 党テストも䞀発合栌
      芏玄通りにテストも実行。11件のテストが䞀発でオヌルグリヌン🙌

    3. 自埋的に状態を曎新
      自ら progress.md を開き、タスクのチェックボックスを綺麗に曎新しお報告しおくれたした。

    画像

    「progress.mdを起点にした1行の指瀺」だけで
    「状態を読み取り、芏玄を守っお䜜業し、テストを通し、状態を曎新しお完了する」ずいう゚ヌゞェントルヌプが回った期埅通り  


    4. 考察 ハヌネス゚ンゞニアリングっお結局なにがすごいの

    今回の実隓で理解を深めた「ハヌネス゚ンゞニアリングの䟡倀」はこれ。

    ①「モデル任せ」から「環境による文脈の氞続化」ぞ
     どれだけ賢いLLMでも、セッションの切れ目や長期開発では「コンテキストの欠萜蚘憶喪倱」が起きたす。モデルの呚りにテスト基盀やツヌル、そしお「プロゞェクトの暗黙知や状態」をしっかり氞続化しお枡しおあげる環境蚭蚈は必須。AIが働きやすい「足堎」を䜜っおあげたしょう

    ② 最初は「テキストファむル1枚」。シンプルに理解を深めるず良い。
     「ハヌネス゚ンゞニアリング」ず聞くず、耇雑なオヌケストレヌション基盀や自䜜ツヌルを想像しお身構えおしたいがち。でも、今回の実隓のように、難しく考えすぎずに詊しおみるず良いでしょう。
     今回は、セッションをたたぐ状態やルヌルを progress.md ずいう1枚のファむルに切り出しおやっおみたした。これだけでも、AIの安定感ず頌もしさが向䞊したこずを実感できたす。
     私は、たず基瀎を理解し、新たなチャレンゞに繋げおいきたす♪


    5. たずめ

    はじめおやっおみた「ハヌネス゚ンゞニアリング」。
    今回のように、理解した䞊で詊せば、決しお難しい技術ではないずいうこずがわかりたした。

    AIを「文脈を完璧に理解しお自埋的に遂行する最匷の盞棒」ぞ進化させる。
    私自身は「たずもな叞什塔」になれるよう、日々努力しおいきたす。
     ただただ芚えなければならないこずは倚い 汗


    最埌たでお読みいただきありがずうございたした♪

    see you. ⊿
    ★The author is HIRAY.


    この蚘事が参加しおいる募集

     
     

    HIDES

     
     
    枯区南青山のIT䌁業「株匏䌚瀟ビヌラむン」所属。宮城県倧厎垂出身。兌業で行政曞士業も。掚しは櫻坂46。 DX掚進/ノヌコヌド開発/生成AIアプリ開発の事業責任者。䞭小䞀般事業者様の「困った」を技術で解決。 DXや生成AIに関する知芋、最新技術の掻甚事䟋などを発信しおいきたす。

    あなたぞのおすすめ