レガシープロジェクトで最大限AIの恩恵を受けられるようClaude Codeを利用する

レガシープロジェクトで  最大限AIの恩恵を受けられるよう Claude Codeを利用する  2025/8/22 dely株式会社橘井貴輝

自己紹介  橘井貴輝（きついたかき）  dely株式会社フロントエンドエンジニア  • 2015年〜営業、SESなどを従事  •
2024年9月〜 delyへ入社  • Vue, React, TypeScript…   

アジェンダ  1. プロジェクト背景  2. Claude Code 選定理由  3. 段階的改善アプローチ  4.
実際の成果と課題  5. まとめ   

プロジェクト背景  技術スタックチーム編成   FE2名、BE1名、Bizメンバー3名  少数精鋭 & チーム内で細かく会話して意思決定するスタイル  • Rails
に依存している Vue2 プロジェクト  • 絶賛リアーキテクト中！！  ◦ React へ移行中  ◦ プロダクト内に Vue, React が共存する 

レガシーコードの現実と課題  直面している問題   • ドキュメントが無い  • 自動テストが無い（フロントエンド）  • 実装後のQAの負荷   
Agentic Code をする以前の問題   -> AIツールを利活用するための土台作りが必要 

Claude Code 選定理由  AIツール活用状況   Claude Code, Devin, Cursor, Gemini
などを社内で利用    なぜ Claude Code ?   • ToDo機能による自律的タスク管理  • コーディング品質の高さ  • Slash commands や Subagent などの体験の良さ  -> 社内でも27名のエンジニアが利用中 

Agentic Codeまでの道のり  理想  Notionチケット -> Claude Code -> AIが実装   
現状の障壁   • チケットの表記揺れ -> AIの精度低下  • ドキュメントの不在 -> コンテキストが不足  • テスト不在 -> 実装時のガードレールが不足  -> 段階的に土台を整備していく 

土台整備の方針  第1フェーズ: ドキュメント整備   • JSDoc充実化  • ユビキタス言語の作成  • Bizメンバーのチケット品質向上 
第2フェーズ: テスト整備   • 自動テスト拡充  ◦ 単体テスト、E2Eテスト...   • TDDの採用  ◦ CLAUDE.md で縛るなど   • Claude Code GitHub Actionsの採用 

実施内容  単純に使ってるコードに対してJSDocを追記するのみ  How  1. グローバルで利用している定義などの命名を洗い出して擦り合わせ  2. 擦り合わせ内容を元にコメント追加作業  3. そのコメントを元に関連するページコンポーネントのメソッドや変数名などに細かくコメント追加作業 
JSDoc充実化 

実施内容  JSDocの内容 + 細かいチューニングを行い、頻出する用語集的なものを作成  実際の例    ユビキタス言語の作成  用語定義エイリアス
使用例表記統一ルールクラシル日本最大級のレシピ動画プラットフォームサービス。... Kurashiru クラシルの月間アクティブユーザー数を集計する。「kurashiru」「KURASHIRU」は「クラシル」に統一。 … レシピ詳細ページ個別のレシピ動画コンテンツを表示するページ。... レシピ詳細、レシピ詳細画面レシピ詳細ページに広告を追加する。「レシピ詳細」、「レシピ詳細画面」は …

Zapierによる自動化（現状）   1. Slackから `添削して https://notion.so/…`   2. Zapierにトリガー&アクションを設定しておき、用語集を元にチケットの添削作業を行わせる 
3. 添削作業の内容に問題がなければ、そのままチケット内容を更新させる  AIによる自動添削機能 

使用しているプロンプトの例（一部抜粋） 

課題  • ユビキタス言語の拡大によるコンテキスト溢れ  • Zapierが辛すぎる (手元で添削作業させるなら一瞬なのに）  対策（模索中）   • 利用ページは頻繁に機能開発をする箇所へ限定する 
• 実際ワークフロー必要？という視点で検討し直す  ◦ BizメンバーがNotionチケットを作成する頻度などを考慮する   ワークフロー自動化における課題 

第2フェーズ   • 自動テスト拡充  • TDDの採用  • Claude Code Github
Actionsの採用  今後の展望 

AIは「銀の弾丸」ではない   • 日々のドキュメント整備など泥臭い作業から全てが始まる  • 進化や移り変わりが激しいので一つのツールに拘る必要がない  まとめ 

• delyではAIによる toC プロダクト開発をしたいエンジニア募集中！  • バックエンドエンジニア、モバイルエンジニア、PdMなど積極募集！  • AIツールの利用料を月額10万円まで補助するAI First制度を整備！  •
興味のある方は「dely エンジニア採用」で検索 🔍  https://delyjp.notion.site/dely-engineer-recruit  エンジニア採用強化中！ 

End 

レガシープロジェクトで最大限AIの恩恵を受けられるようClaude Codeを利用する

レガシープロジェクトで最大限AIの恩恵を受けられるようClaude Codeを利用する

tk1351

Other Decks in Programming

Featured

Transcript