AIのために、AIを使った、Effect-TSからの脱却〜テストを活用した安全なリファクタリングの進め方〜

2 Copyright © 2025 Bitkey Inc. All right reserved. 0.
初めにナウでイケてるEﬀect-TSをなぜ脱却したのか？どのように脱却したのか？現場の状況や、昨今のAI事情も踏まえて私なりに「考えたこと」「感じたこと」「実践したこと」を共有します Topic ※ 正式名称は「Effect」ですが、「Effect-TS」と表現されることが多いため本発表では「Effect-TS」の表現を用いています

3 Copyright © 2025 Bitkey Inc. All right reserved. ・「AIが書ける」と「何かあった時に人間もかける」は全く別の話
・チーム状況/スキル/志向性にもよるが、私の今のチームからみてEﬀect-TSはSimpleではなかった・AI時代の過渡期である現状においてコストが高くつきすぎるという判断に至った 0. 初めにメッセージ

4 Copyright © 2025 Bitkey Inc. All right reserved. ・「AIが書ける」と「何かあった時に人間もかける」は全く別の話
・チーム状況/スキル/志向性にもよるが、私の今のチームからみてEﬀect-TSはSimpleではなかった・AI時代の過渡期である現状においてコストが高くつきすぎるという判断に至った 0. 初めにメッセージ (Effect-TS使うな！...というわけでなく ) AIもあるし...とりあえず導入してみに合わなかったら脱却すればいいや！ …ってのもアリなのでは？

5 Copyright © 2025 Bitkey Inc. All right reserved. 目次
1. 実現したかったこと、課題感 2. Effect-TSの魅力とは？ 3. 導入時の懸念と出口戦略 4. Effect-TSをなぜ辞めたのか？ 5. Effect-TSをどう脱却したのか？ 6. まとめ

6 Copyright © 2025 Bitkey Inc. All right reserved. 自己紹介
2015.04 2019.05 2020.01 大学(建築学専攻)卒業後、株式会社ワークスアプリケーションズに入社会計システムのソフトウェア開発を担当特に財務会計の仕訳関連ビットキーへ参画 ECサイトの開発 / 保守、社内システムの開発 TaKuTyの開発今のhomehub事業の前身となるResidenceチームに配属。スマートロックを扱う管理画面やバックエンド、スマホアプリの開発に従事 Now homehub事業のプロダクト責任者複雑な事象を読み解いて構造化し、抽象化 / 汎用化できるように設計し、低コストで多くの価値をだせる開発をすることを好む佐藤拓人 Sato Takuto @takuuuuuuu777

7 Copyright © 2025 Bitkey Inc. All right reserved. 自己紹介
Before @TSKaigi 2024 After -25kg 佐藤拓人 Sato Takuto @takuuuuuuu777

実現したかったこと、課題感

実現したかったこと、課題感そもそもなんで、Eﬀect-TSを導入しようとしたのか？ Eﬀect-TSに何を期待していたのか？

実現したかったこと、課題感課題1：エラーハンドリング

実現したかったこと、課題感課題2：モデリングオブジェクト指向でのモデリングが辛い...集約とか... 「どこから整理すれば良いの！？」

実現したかったこと、課題感課題2：モデリング関数型アプローチの可能性出典：Scott Wlaschin 『関数型ドメインモデリング』、 KADOKAWA

実現したかったこと、課題感

Eﬀect-TSの魅力

Effect-TSの魅力 Effect-TS以外の選択肢もある中でなぜEffect-TSを選択したのか？

Eﬀect-TSの魅力 Eﬀect-TSの特徴

Eﬀect-TSの魅力魅力1：依存解決

Eﬀect-TSの魅力魅力2：Description / Run

Eﬀect-TSの魅力魅力3：Functional Core, Imperative Shell

導入時の懸念と出口戦略

導入時の懸念と出口戦略懸念事項 Entity / Value Object 懸念：1 懸念：2

導入時の懸念と対策出口戦略1：境界づけられたコンテキスト内の封じ込めモジュラーモノリスの境界を使い、Eﬀect-TSの適用範囲を物理的に制限

導入時の懸念と対策出口戦略2：レイヤ整理と方針統一各レイヤの実装方針を揃えていたことが、後のAI活用による一括置換を可能にした

導入時の懸念と対策出口戦略3：APIサーフェスの制限多様なAPIの統制コストに対して、利用可能なAPIを事前に制限直接素のEﬀect-TSのライブラリを参照できないようにlinterで制御させて APIを制限したラッパーを介して参照させるように制約を課す

導入時の懸念と対策実際にどこに導入してみたの！？

導入時の懸念と対策

導入時の懸念と対策 homehubは「暮らし」に関わる様々な体験を実現する。その中心にあるのがスマートロック

導入時の懸念と対策 homehubは「暮らし」に関わる様々な体験を実現する。その中心にあるのがスマートロックスマート化できる場所共⽤部多様な解錠⽅法スマートアクセス専有部スマートサービス暮らしサービス ‧家事代⾏ ‧ペットシッター ‧ベビーシッター ‧クリーニング ‧宅配 ‧⾷材配送 ‧飲料⽔配送 ‧集荷 ‧ライフライン料⾦共通 ‧外部サービス連携 ‧ID連携 ‧データ連携 homehubビジネスエンジン ‧賃料 ‧管理費 ‧請求‧⽀払い ‧未収⾦の料⾦計算 ‧会計連携 ‧決済連携（クレジット‧請求書‧⼝座振込）スマートフォンアプリ顔認証 ‧WEB会議 ‧議事録 ‧録画 ‧アジェンダ ‧出⽋管理 ‧議案作成 ‧投票 / 集計 WEBカンファレンスデジタル申請スマートファシリティ ‧居住者情報 ‧転居届け ‧駐輪場 ‧駐⾞場 ‧⼊居契約 ‧宅配ボックス ‧宅配ロッカー ‧TVスティック ‧IoTリモコン ‧キーボックス ‧配信 ‧掲⽰板 ‧ファイル共有 ‧イベント ‧アンケートコミュニティポータル共⽤施設管理‧運営⾒守り‧駆けつけ ‧施設予約 ‧備品予約 ‧レセプション ‧スマートキー連携 ‧デジタル決裁 ‧WEB会議ブース ‧bitbutton ‧リモート通知 ‧リモート解錠 ‧駆けつけ連携 ‧異常検知 ‧外部システム連携 ‧有⼈チャット ‧チャットボット ‧お知らせ ‧アンケート ‧FAQ ‧グループチャット ‧LINE連携コミュニケーション管理員業務DX 内⾒効率化 ‧点検 ‧報告 ‧スマートキー解錠 ‧リモート解錠 ‧チャット ‧物件管理 ‧内⾒予約 ‧スマートキー連携 ‧ワンタイムパス ‧遠隔解錠 ‧キーボックス ‧外部連携テンキーカードキー遠隔解錠

導入時の懸念と対策 homehubは「暮らし」に関わる様々な体験を実現する。その中心にあるのがスマートロックスマート化できる場所共⽤部多様な解錠⽅法スマートアクセス専有部スマートサービス暮らしサービス ‧家事代⾏ ‧ペットシッター ‧ベビーシッター ‧クリーニング ‧宅配 ‧⾷材配送 ‧飲料⽔配送 ‧集荷 ‧ライフライン料⾦共通 ‧外部サービス連携 ‧ID連携 ‧データ連携 homehubビジネスエンジン ‧賃料 ‧管理費 ‧請求‧⽀払い ‧未収⾦の料⾦計算 ‧会計連携 ‧決済連携（クレジット‧請求書‧⼝座振込）スマートフォンアプリ顔認証 ‧WEB会議 ‧議事録 ‧録画 ‧アジェンダ ‧出⽋管理 ‧議案作成 ‧投票 / 集計 WEBカンファレンスデジタル申請スマートファシリティ ‧居住者情報 ‧転居届け ‧駐輪場 ‧駐⾞場 ‧⼊居契約 ‧宅配ボックス ‧宅配ロッカー ‧TVスティック ‧IoTリモコン ‧キーボックス ‧配信 ‧掲⽰板 ‧ファイル共有 ‧イベント ‧アンケートコミュニティポータル共⽤施設管理‧運営⾒守り‧駆けつけ ‧施設予約 ‧備品予約 ‧レセプション ‧スマートキー連携 ‧デジタル決裁 ‧WEB会議ブース ‧bitbutton ‧リモート通知 ‧リモート解錠 ‧駆けつけ連携 ‧異常検知 ‧外部システム連携 ‧有⼈チャット ‧チャットボット ‧お知らせ ‧アンケート ‧FAQ ‧グループチャット ‧LINE連携コミュニケーション管理員業務DX 内⾒効率化 ‧点検 ‧報告 ‧スマートキー解錠 ‧リモート解錠 ‧チャット ‧物件管理 ‧内⾒予約 ‧スマートキー連携 ‧ワンタイムパス ‧遠隔解錠 ‧キーボックス ‧外部連携テンキーカードキー遠隔解錠スマートロックを解錠するためのテンキーを発行する機能でEffect-TSを導入

Eﬀect-TSをなぜ辞めたのか？

Eﬀect-TSをなぜ辞めたのか？運用で見えてきた課題約2年弱の運用 (2024年3月〜2025年12月) を経て、課題が顕在化

Eﬀect-TSをなぜ辞めたのか？課題1：学習の難しさ自分でコーディングするより、AIに書かせることが主流である現代。思考体系(関数型、遅延評価)の変化の追従がつらいそもそもチームのスキルとしても関数型に知見はなく手続型に慣れ親しんでいる状態だった

Eﬀect-TSをなぜ辞めたのか？課題1：多様なAPIと統制の難しさ「依存の解決」においてもいくつかの概念や方法があるなぜ複数の方法があるのか？どう使い分ければ良いか腹落ちした状態で理解するのはコスト高い...

Eﬀect-TSをなぜ辞めたのか？課題3：AIの成果物をチーム内でレビューしきれない手続型と比べて親しみのない表現が多数発生して、確認に時間がかかる providerServiceで何してる？ catchTagって何してるの？ catchTagが最適？ pipeのネストは意図通り？

Eﬀect-TSをなぜ辞めたのか？課題4：チーム内で自力で修正できない「AIが書ける」と「何かあった時に人間もかける」は全く別の話コーディングする機会が減った現状で、自力で修正できる状態になるのはコストが高く、優先度も上げられなかった

Eﬀect-TSをなぜ辞めたのか？課題4：チーム内で自力で修正できない特に型の整合性を保つのが結構大変...

Eﬀect-TSをなぜ辞めたのか？課題4：チーム内で自力で修正できない・「AIが書ける」と「何かあった時に人間もかける」は全く別の話・チーム状況/スキル/志向性にもよるが、私の今のチームからみてEﬀect-TSはSimpleではなかった・AI時代の過渡期である現状においてコストが高くつきすぎるという判断に至った

Eﬀect-TSをなぜ辞めたのか？移行先：シンプルな自作 Result 型 neverthrow等の既存ライブラリも検討していたが、すでに他のmoduleでも活用していたシンプルな自作Result型を流用

Eﬀect-TSをどう脱却したのか？

Eﬀect-TSをどう脱却したのか？移行戦略大前提：「変更を加える前に、まず既存の挙動を保証するテストを書く」基本方針：・テストを活用する・AIを活用する課題・対象が全般的にEﬀect依存の実装やIFとなっているためやりづらい... 出典：Michael Feathers 『レガシーコード改善ガイド』、翔泳社

Eﬀect-TSをどう脱却したのか？移行戦略 EffectのIFを前提にした既存テスト

Eﬀect-TSをどう脱却したのか？移行戦略中身はEffectの実装で IFをResult型に変換する

Eﬀect-TSをどう脱却したのか？移行戦略 ResultのIFのテストに修正する

Eﬀect-TSをどう脱却したのか？移行戦略 Effectの実装に依存しないように修正 Effectの実装への依存をなくす

Eﬀect-TSをどう脱却したのか？移行戦略 Effectの実装を削除する

Eﬀect-TSをどう脱却したのか？移行戦略

Eﬀect-TSをどう脱却したのか？実践

Eﬀect-TSをどう脱却したのか？実践：Repository (IF)

Eﬀect-TSをどう脱却したのか？実践：Repository (Impl)

Eﬀect-TSをどう脱却したのか？実践：Service

Eﬀect-TSをどう脱却したのか？実践：複数Error

Eﬀect-TSをどう脱却したのか？実践：Entry Peint (依存解決)

学び

学び大変だったこと・Eﬀect-TSの思想は個人的には好みではあるが、学習コストは思ったより高かった・個人ならともかく、チームで運用していくのは結構パワーかけないと難しい良かったこと・コードベース全体に浸透するライブラリでも、工夫とAI活用でスムーズに脱却できた・出口戦略を設計しておけば、今まで以上に気軽に試せる時代になってきている気づき・モデリングの課題に対しては、関数型を徹底しなくてもEvent Sourcingで十分改善が見込める大変だったこと / 良かったこと

学び学び・自身が「コーディング」する時間が減った今、「(なんとなく)わかる」と「使いこなせる」の差が広がり　やすく、意欲的でないと解消が難しくなってきている。だからこそ、チームの認知負荷を上げてしまう施　策には慎重を期すべき・AIに振り回されずAIを受け入れられる状態とするために、「Easy (便利だが複雑)」より「Simple (単純)」を選ぶ比重を高めても良いように感じる学び

AIのために、AIを使った、Effect-TSからの脱却 〜テストを活用した安全なリファクタリ...

AIのために、AIを使った、Effect-TSからの脱却 〜テストを活用した安全なリファクタリングの進め方〜

More Decks by 株式会社ビットキー / Bitkey Inc.

Other Decks in Technology

Featured

Transcript

AIのために、AIを使った、Effect-TSからの脱却〜テストを活用した安全なリファクタリ...

AIのために、AIを使った、Effect-TSからの脱却〜テストを活用した安全なリファクタリングの進め方〜