Claude CodeとNotionを活用した開発フロー

Transcript

1. Claude CodeとNotionを活用し た開発フロー 2025/07/27 AI CRAFT Hacks Niigata x DERTA Gig
2. 自己紹介 • 竹内謙太 • 薬剤師エンジニア • 新潟市出身、新潟市在住 • 東京のIT企業所属 • 美術品のネット販売を行う「小山美術」で副業 ◦ ヤフオクでWISHというショップ名で美術品を毎週 300~400点ほど出品 ◦ 今日はこっちの事例紹介です
3. 今日お話しすること 1. Notionにおけるタスク管理方法 2. Claude CodeとNotionを連携して実装する方法
4. • 小山美術の状況 ◦ エンジニア社員: 0名 ◦ 開発は副業メンバー 2名のみ ▪ 開発時間が限られている • 結果として... ◦ 基本機能追加にリソースを当て、細かい不具合改善が後回しに ◦ 非エンジニアの要望が溜まるだけ ▪ 要望出しても改善されないので、段々要望も出なくなる ◦ ビジネスへの影響も 背景と課題
5. 従来の課題詳細 • リソース不足 ◦ 副業メンバーの稼働時間に依存 ◦ 優先度の高いタスクで手一杯 • コミュニケーションギャップ ◦ 非エンジニアからの要望が技術的に曖昧 ◦ 要件定義に時間がかかる • 小さな改善の積み残し ◦ UIの微調整 ◦ エラーメッセージの改善 ◦ 使い勝手の向上
6. 解決策の全体像 • Notionで要望を構造化（非エンジニア） ◦ JIRAやGitHub Issueは非エンジニアに馴染みがないので NG ◦ Notionでデータベースとタスクテンプレートを用意 ◦ テンプレートに沿って内容を埋めていく • Claude Codeが自動実装（エンジニア） • レビュー＆デプロイ（エンジニア）
7. Notionのタスクテンプレート • カテゴリ毎にテンプレート化 ◦ 機能追加、機能改善、不具合等 ◦ 不具合テンプレートの例 ▪ 何が起きている？ ▪ いつから？ ▪ どうやったら起きる？ ▪ 本来どうなるべき？ ▪ 困っていること ▪ 追加情報
8. 1. Notionと連携するCLIスクリプトを用意（Claude Claudeで実装） 2. notionのタスク内容をclaudeに渡して実装 3. 実装が完了したらPR作成し、notionにPRリンクを記載 4. 完了したらマージしてnotionのステータスを更新 連携方法の工夫 • MCPではなくスクリプトを独自実装 ◦ タスク内容を型定義で管理 ◦ 最小限の権限で安全に運用 ◦ GitHub等の他サービスとの連携も考慮 Claude CodeとNotionの連携
9. Claude Code導入時のポイント 1. テスト環境の整備から開始 ◦ 単体テストやE2Eテストを実装し、CIでチェック ◦ テストカバレッジ: 必須90%、推奨95% 2. 安全なアーキテクチャへの移行 ◦ DDD（ドメイン駆動設計）を採用済み ◦ Claude Codeでオニオンアーキテクチャに移行 3. Notionテンプレートの改善 ◦ 段階的に項目を最適化し、具体例も豊富に用意 4. 運用ルール ◦ 小さなタスクから開始し、成功体験を積み重ねる
10. 現在の課題 • まだ複雑な機能追加は難しい • ドキュメント不足でAIにコンテキストを正しく伝えられない ◦ 開発はAIに任せて、その間にドキュメント整備 今後の展望 • エンジニア不在でも修正可能な世界への挑戦 ◦ Slackと連携し、Claude Codeをクラウド上で実行 ◦ 自動でPR作成＋PR環境を提供 ◦ 非エンジニアがPR環境で動作確認→承認で本番反映 ▪ （あれ、これdevinなのでは？） 課題と今後の展望
11. 今後の展望（続き） • OSSや便利ツールの積極的な活用 ◦ sub agents ▪ https://zenn.dev/tacoms/articles/552140c84aaefa ◦ SuperClaude ▪ https://dev.classmethod.jp/articles/claude-code-superclaude/ ◦ AWS Kiroは乗り遅れたので早く使いたい • AI開発 ◦ AIをアプリケーションに組み込みたい ◦ LangChain系？ADK？懇親会でおすすめ教えてください 課題と今後の展望
12. まとめ • Notion × Claude Codeでの開発 ◦ エンジニアのリソースが限られる中でも開発が進むように整備 ◦ 細かい改善を迅速にする ◦ 主要機能の開発に集中できる ◦ 将来的にはエンジニア不在でも開発できる世界へ 「AIは開発を代替するのではなく、 開発への参加障壁を下げるツール」 • 非エンジニアでも機能開発ができます