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

ATDDとBDDでテストを先に作る話

    youtube解説はこちら

    AIを使った開発を行っていくうちに、機能を足したら前の機能が動かなくなって焦ったことはありませんか。

    僕はこれ、開発を続けるほど本当に起きやすい問題だと感じています。
    今回の話は、そんな不安を減らすためのATDDとBDDの考え方です。
    Claude Codeを使う前提で、スターターキットに入れておきたい仕組みを整理していきます。

    ATDDとBDDって、そもそも何なの?

    まず大事なのは、ATDDもBDDも「テスト」を先に考えるやり方だということです。
    TDD、テスト駆動開発は聞いたことがあるかもしれません。
    先にテストを書いて、最初は失敗する状態を作ります。
    そのあと実装して、テストが通るようにしていく流れなんですよね。

    TDDでは、まずレッド、つまり失敗から始めます。
    次にコードを書いてグリーン、成功に持っていきます。
    最後にリファクタリングで、コードを整理します。
    コードがぐちゃぐちゃになっていくのを防ぐための作業なんです。

    最近僕が特に気にしているのは、回帰です。
    新機能を追加したら、以前は動いていた機能が動かなくなる。

    これ、実際にClaude Codeでも何度も経験している話なんですよね。
    だからこそ、テストで既存機能を守るのが大事なんです。

    ATDDは、ユーザーの使い方から考えるんです

    ATDDのAはAcceptance、受け入れのことです。
    これは、ユーザーが実際に使う流れを想定したテストなんですよね。
    たとえばログインなら、メールアドレスを入れて、パスワードを入れて、ボタンを押す。
    その結果、ログインできればOK、という形です。

    この考え方のいいところは、実際の利用場面に近いことです。
    もしここが通らなければ、ソフトとして欠陥があるよね、となります。
    先にテストを書いておけば、後から機能を足しても安心です。
    以前のテストが通るなら、以前の機能は大丈夫だと確認できるからです。

    BDDは、振る舞いを文章で書く感じです

    BDDのBはBehaviour、振る舞いです。
    これは、システムがどう動くかを文章で書いていく考え方なんです。
    たとえば「ログインしたいので、メールアドレスを入力して送信ボタンを押す」みたいな流れですね。
    その文章をコードに落とし込んでいくイメージです。

    BDDでは、シナリオを先に書きます。
    たとえば「10の値を持つオブジェクトに除算する」といったケースです。
    英語のdescribeで前提条件を書いて、whenで操作を書いて、thenで期待結果を書く。
    こうすると、何をテストしているかが見ただけで分かりやすいんですよね。

    Gherkin(ガーキン)という書き方もあります。
    これはGIVEN、WHEN、THENを使って、文章に近い形で書ける方法です。

    非エンジニアにも読みやすいという利点があります。
    ただ、今回はスターターキットとしてシンプルに進めるので、いったん見送る判断になりました。

    なぜ今、テスト基盤が必要なのか

    昔は、テストを毎回書くのはかなり大変でした。
    時間もかかるし、テスト自体のメンテナンスも必要だったからです。

    でも今は生成AIがテストを書くので、かなりスピードが上がっています。
    だからこそ、最初から基盤を作る価値が高いんですよね。

    僕が今回やりたいのは、ATDDとBDDの土台をスターターキットに入れることです。
    新機能開発のときはテスト先行で進められるようにしたい。
    コードや機能をきれいに保ちながら、既存機能が壊れないようにしたい。
    そのために、Claude Codeのベストプラクティスを調べて実装する方針です。

    Claude Codeでどう進めるのか

    今回のプロンプトでは、まずClaudeにベストプラクティスを調べてもらいます。
    そのうえで、実際に使える形に実装していく流れです。
    さらにCLAUDE.mdなどにも追記して、別エージェントからも対応できるようにします。
    つまり、誰が触っても同じルールで動く状態を作りたいわけです。

    テストランナーやサブエージェントも用意します。
    フロント側の単体テストや結合テストにはVitestやPlaywrightを使う想定です。
    E2E、つまり画面をまたいだ一連の動作確認もできるようにします。
    テストヘルパーや型定義、サンプルテストなどもも整えていきます。

    プランファイルの置き場所も見直した話

    途中で思い出したのが、プランファイルの保存場所です。
    これまではルートフォルダに生成されていたので、プロジェクトフォルダに生成するようにしたいのですよね。

    別プロジェクトの設定を参考にして、`.claude/settings.local.json` に書く形です。
    `plansDirectory` を指定すると、そのプロジェクト内に `plans` フォルダが作られます。

    これをやっておくと、別プロジェクトのプランと混ざらないんです。
    後から見返したいときにも、どの計画だったか分かりやすい。
    こういう細かい整理が、地味だけどあとで効いてくるんですよね。
    僕は毎回忘れがちなので、ここもスターターキットに入れたいところです。

    テストは、LLM開発の土台なんです

    最近はハーネスエンジニアリングという考え方もあります。
    これは、モデルそのものだけじゃなく、周辺環境づくりが大事だという話です。
    テストもその一部で、環境として必須だと僕は思っています。
    特にある程度のボリュームで開発するなら、なおさらなんですよね。

    全部を人間が毎回チェックするのは、もうかなり厳しいです。
    だからこそ、テストで品質を担保する必要があります。
    実行に少し時間はかかっても、壊れた場所が分かる安心感は大きいんです。
    モチベーションが落ちないためにも、テスト基盤はかなり重要だと思っています。

    まとめ

    • ATDDは、ユーザーの受け入れ基準を先にテスト化する考え方です

    • BDDは、振る舞いを文章で書いてから実装する考え方です

    • TDDの基本は、レッド、グリーン、リファクタリングの流れです

    • 生成AIを使うと、テスト作成の負担はかなり下げられます

    • 回帰を防ぐためにも、テスト基盤は最初から入れておくのが安心です

    僕は、テストは後回しにしない方がいいと思っています。
    もしあなたがこれからWeb開発やアプリ開発を始めるなら、最初に仕組みを作るのがおすすめです。
    よければこの記事にスキやフォローをもらえるとうれしいです。
    次回も、実際の設計や機能の作り込みを分かりやすくまとめていきます。


    この記事が役に立ったと思ったら、スキやフォローをお願いします!
    次回もわかりやすい技術解説をお届けしますので、お楽しみに。

    Note

    有料マガジン
    https://note.com/aoki_monpro/m/m96ae7a4cccfe


    Udemy講座 生成AIもいくつかあります(NotebookLM, Dify, 画像生成AI, ChatGPTなど)

    udemy講師紹介ページ
    https://www.udemy.com/user/mochaccino/

    udemy講座のクーポン一覧
    https://note.com/aoki_monpro/n/nd695fc29792c


    テイルウインド株式会社
    https://tailwind8.com/

    Youtubeチャンネル
    https://www.youtube.com/@tailwind8

    MENTA
    https://menta.work/plan/19425?ref=mentor_profile

    最後まで記事をお読みいただきありがとうございます❗

    さらなる良記事を執筆するためのモチベーションアップのため、

    よろしければスキ & フォローもお願いいたします😊

    できる限りフォローバックさせていただきます💯
    (競艇・競馬・宝くじなどのギャンプルの方はフォローしませんのであしからず)

     
     
    テイルウインド株式会社 代表取締役 あなたのビジネスにAI/DXで追い風を吹かせます。図面から必要な情報を拾う。2つの動画の差分を検出する。衛星画像で空き地を探す。AI広報担当を作ったりシステム開発まで。お気軽にご連絡ください。 contact@tailwind8.com

    あなたへのおすすめ