# Claude Code で FileMaker 開発：DDR で設計を AI に読ませる - 公開日: 2026-09-15 - 更新日: 2026-09-15 - URL: https://systemdesignworks.co.jp/news/filemaker-claude-code-ddr-reading - 発行: 株式会社システムデザインワークス > FileMaker のカスタム App はスクリプトもレイアウトもバイナリの中にあり、そのままでは AI に読ませられません。DDR(データベースデザインレポート)を XML で出力し、FMPSplit で 4,000 個超のファイルに分割して Claude Code に読ませたところ、1,300 本超のスクリプトを持つシステムの調査が「質問すれば返ってくる」形に変わりました。第 1 回では、公式ドキュメントを引く claris-docs プラグイン、DDR の出し方、分割の仕組み、コードリーディングの進め方と、AI に渡す前に確認すべき点を解説します。 こんにちは！システムデザインワークスの山岸です。 FileMaker の開発にも生成 AI を取り入れて、効率を上げたいと考えている方は多いのではないでしょうか。とはいえ FileMaker にはソースコードのファイルがなく、そもそも AI に何を読ませればよいのか、というところで手が止まりがちです。 弊社でも FileMaker のシステム開発・保守を手がけていますが、長年運用されてきた大規模な基幹システムになると、FileMaker Pro の画面からスクリプトを 1 本ずつ開いて追う調査には限界があります。そこで、**Claude Code**（Anthropic 社の AI コーディングツール）に FileMaker を読ませる開発スタイルに切り替えられるか検証しました。 結論から言うと、**AI は FileMaker 開発に活用できます。** 鍵は、設計情報をまるごと XML で書き出す **DDR（データベースデザインレポート）** です。この XML を Claude Code に読ませれば、「この画面のボタンは何をしているか」といった調査が、質問ひとつで返ってきます。 本記事は全 3 回の第 1 回で、設計情報を「読む」ところまでを扱います。 --- **この連載はこんな方に向けて書いています** - FileMaker で業務システムを開発・保守しているエンジニアや、社内の情報システム担当の方 - 引き継いだ FileMaker システムの中身を、効率よく把握したい方 - Claude Code などの生成 AI を FileMaker 開発に取り入れたいが、何から始めればよいか分からない方 FileMaker Pro の基本操作は分かっている前提で書いていますが、主要な用語は本文で一言ずつ補足します。 **Claude Code で FileMaker 開発（全 3 回）** 1. **第 1 回：DDR で設計を AI に読ませる（本記事）** 2. [第 2 回：AI にスクリプトを書かせる](/news/filemaker-claude-code-script-xml) 3. [第 3 回：ODBC で実データを AI に読ませる](/news/filemaker-claude-code-odbc-data) --- ## 背景・課題：FileMaker は「読めない」 FileMaker は、テーブル・画面・スクリプトを 1 つのファイルの中で GUI から組み立てる開発環境です。業務アプリを短期間で作れる強力な道具ですが、引き継ぎや改修の場面では、ほかの開発環境にはない壁があります。 - **ソースコードが存在しない。** スクリプトはスクリプトワークスペースで 1 本ずつ開くしか読む手段がなく、横断検索も限定的です - **画面と処理の結びつきが見えない。** ボタンにどのスクリプトが紐づき、レイアウトにどのトリガーが仕掛けられているかは、オブジェクトを 1 つずつ開いて確かめる必要があります - **AI に渡せない。** Web 開発では当たり前になった「コードベースを AI に読ませて質問する」という進め方が、バイナリの .fmp12 ではそもそも成立しません 参考までに、私たちが扱っている FileMaker システムの一つを DDR の概要から抜き出すと、次の規模になります。 | 要素 | 数 | | --- | --- | | ベーステーブル | 119 | | テーブルオカレンス | 1,136 | | リレーションシップ | 769 | | レイアウト | 488 | | スクリプト | 1,368 | | カスタム関数 | 68 | | 値一覧 | 164 | 長年運用されてきたシステムでは、複数の開発者が手を入れて命名規約が時代ごとに違う、ということも珍しくありません。「この画面で保存ボタンを押すと何が起きるのか」を確かめるだけで、スクリプトを何本も渡り歩くことになります。 Claris 社自身も、生成 AI への対応を公式に進めています。時系列で並べると次のとおりです。 - **数年前から**: 埋め込み（ベクトル化）や RAG のための AI 関数を FileMaker に追加 - **2025 年 12 月**: **Claris MCP** を公開。Claude などの AI アシスタントから FileMaker のレコードを読み書きし、既存のスクリプトを実行できる - **2026 年 5 月**: CEO が[「エージェント型開発」の構想](https://www.claris.com/filemaker/agentic-development/)を発表。Claude Code・Cursor・Codex といった AI コーディングツールから FileMaker のスクリプトやスキーマを直接書けるようにするもので、開発者プレビューは同年夏以降と予告 - **2026 年 6 月**: FileMaker 2026 をリリース。フィールドやテーブルに AI 向けの注釈を付け、自然言語での問い合わせ精度を上げる機能を追加 ただし本記事の執筆時点（2026 年 9 月）では、エージェント型開発の開発者プレビューはまだ公開されておらず、実際に使えるのは出来上がったシステムを AI から「使う」ための仕組みです。スクリプトやレイアウトを AI が読み書きする、つまりシステムを「開発する」ための公式ツールは、まだ手元にありません。本連載で紹介するのは、その空白を FileMaker が元々持っている機能で埋める方法です。公式ツールが出たあとも、DDR・クリップボード・ODBC という出入口の理解は無駄になりません。 ## 取り組みの概要：3 つの道具で「読める」状態を作る やることは単純です。FileMaker の設計情報を **テキスト**にし、AI が扱いやすい粒度に **分割**し、FileMaker の仕様を **公式ドキュメントで裏取り**できるようにする。この 3 点がそろえば、Claude Code は FileMaker でも普通のコードベースと同じように働きます。 ```mermaid flowchart LR A["FileMaker Pro
.fmp12（バイナリ）"] -->|"DDR を XML 形式で出力"| B["DDR XML
約 235MB / UTF-16"] B -->|"FMPSplit で分割（任意・推奨）"| C["約 4,000 個の XML
1 オブジェクト = 1 ファイル"] C --> D["Claude Code
検索・読解・仮説検証"] E["claris-docs プラグイン
公式ヘルプを都度参照"] --> D D --> F["CLAUDE.md（AI への申し送りファイル）
仕様・落とし穴を蓄積"] F --> D ``` 使った道具は次の 3 つです。3 つとも無料で使え（Claude Code 自体の利用料は別です）、Mac 1 台で完結します。 | 道具 | 役割 | | --- | --- | | **DDR（データベースデザインレポート）** | FileMaker Pro 標準機能。テーブル・リレーション・レイアウト・スクリプトなど設計情報を XML で書き出す | | **FMPSplit** | Karsten Wolf 氏が公開している DDR 分割ツール。巨大な XML を 1 オブジェクト 1 ファイルに分ける。必須ではないが、分割すると AI が格段に読みやすくなる | | **claris-docs プラグイン** | Soliant Consulting 社が公開している Claude Code プラグイン。Claris 公式ヘルプをその場で引けるようにする | 前提となる **Claude Code** は、Anthropic 社が提供する、ターミナルで動く AI コーディングツールです。プロジェクトのファイルを読み、コマンドを実行し、ファイルを書き換えることができます。利用には Anthropic のアカウント（Pro / Max / Team / Enterprise の各プラン、または API の従量課金）が必要で、導入手順は[公式ドキュメント](https://code.claude.com/docs/en/quickstart)にまとまっています。本連載はすべて macOS で進めています。 以下、順番に見ていきます。 ## ① claris-docs プラグイン：仕様は記憶ではなく公式ヘルプから引かせる 最初に入れたのが [claris-docs](https://github.com/soliantconsulting/claris-docs) です。FileMaker のコンサルティングで知られる Soliant Consulting 社がコミュニティ向けに公開しているもので、Claris 社の公式プロダクトではありません（MIT ライセンス）。Claude Code のプラグイン機能から 2 コマンドで入ります。 ```typescript /plugin marketplace add soliantconsulting/soliant-public-claude-plugins /plugin install claris-docs@soliant-public-claude-plugins ``` このプラグインの設計思想が気に入りました。ドキュメントの内容を AI に埋め込むのではなく、**公式ヘルプのどのページを読むべきかを案内する「ナビゲーター」**として作られています。FileMaker Pro・Server・WebDirect・Data API・SQL リファレンス・セキュリティガイドなど 17 のスキル（Claude Code に手順を教える単位）があり、質問の種類に応じて該当スキルが起動し、help.claris.com の該当ページをその場で取得して答えます。 なぜこれが重要かというと、AI は FileMaker の細かい仕様を「うっかり思い出す」からです。スクリプトステップの引数や関数の挙動を学習データの記憶から答えると、バージョン違いの古い仕様や、そもそも存在しない選択肢が混ざります。公式ヘルプを毎回読む運用にしておけば、この種のもっともらしい誤りをかなり減らせます。 日本語版 FileMaker を使う方には、ひとつ小技があります。プラグインが案内する URL は英語版ヘルプですが、URL の `/en/` を `/ja/` に置き換えるだけで日本語版ヘルプが取れます。 ```typescript 英語: https://help.claris.com/markdown/en/pro-help/set-variable.md 日本語: https://help.claris.com/markdown/ja/pro-help/set-variable.md ← 「変数を設定」 ``` 日本語版のシステムでは、スクリプトステップ名も関数名も日本語です（`Get ( スクリプト引数 )` のように）。日本語ヘルプを読ませることで、AI が出力する名称がシステム内の表記とそのまま一致するようになります。この置き換えはプロジェクトの `CLAUDE.md`（Claude Code が毎回のセッション開始時に読む申し送りファイル）に 1 行書いておけば、以後は自動で守ってくれます。 ## ② DDR を XML で出し、FMPSplit で分割する ### DDR の出力 DDR は FileMaker Pro の標準機能です。[ツール] メニューの [データベースデザインレポート...] を開き、対象ファイルと [レポートに含める] 要素を選び、[レポート形式] で **XML** を選んで作成します。既定は HTML ですが、公式ヘルプにあるとおり **HTML レポートの情報は XML 版のサブセット**です。AI に読ませる目的なら迷わず XML を選びます。 出力されるのは、概要（Summary）の小さな XML と、設計情報すべてが入った本体の XML です。先ほどの規模のシステムでは本体が **約 235MB**。しかも文字コードは **UTF-16** で書き出されます。 実は、この 1 ファイルのままでも AI に読ませることは不可能ではありません。UTF-8 に変換すれば（`iconv -f UTF-16 -t UTF-8` の 1 行で済みます）全文検索は効きますし、Claude Code は検索で当たりをつけて該当箇所だけを切り出して読む、という動きを自分でやってくれます。ただし 235MB を丸ごと読むことはできないので、質問のたびに「探して、切り出して、読む」を繰り返すことになり、時間もトークン（AI が読み書きする文字量の単位で、料金と処理時間に直結します）もかさみます。 ### FMPSplit で分割すると、AI も人も読みやすくなる そこで私たちは、DDR を分割してから渡すことにしました。必須の工程ではありませんが、やってみると AI の読み方が目に見えて変わったので、おすすめしたい一手間です。 使ったのは [FMPSplit（FileMaker DDR Splitter）](https://github.com/karstenw/FileMaker-DDR-Splitter) です。FileMaker 開発者の Karsten Wolf 氏が公開している Python 製のツールで、macOS 用のアプリ版もあります。DDR を要素ごとに分解し、**1 つのテーブル・1 つのレイアウト・1 つのスクリプトが、それぞれ 1 つの XML ファイル**になります。レイアウトとスクリプトはフォルダ階層と並び順もそのまま再現できます。作者のベンチマークでは 275MB の DDR を 19 秒で分割したとのことで、今回も待ち時間はほぼありませんでした。使い方は、アプリ版なら概要（Summary）の XML を指定するだけ、スクリプト版なら `python3 ddrsplit.py Summary.xml` の 1 行です。UTF-16 のままの DDR をそのまま渡せます。 分割後のディレクトリはこのような構造になります（名称は例です）。 ```typescript Exports/業務システム_fmp12/ ├── Accounts/ 4 ファイル ├── Basetables/ 119 ファイル（ベーステーブルごとにフィールド定義） │ ├── 0000130 mst商品.xml │ └── 0000131 dat受注.xml ├── CustomFunctions/ 68 ファイル ├── CustomMenus/ 25 ファイル ├── CustomMenuSets/ 2 ファイル ├── ExtendedPrivileges/ 7 ファイル ├── Layouts/ 488 ファイル（レイアウトフォルダの階層がそのままディレクトリに） │ └── 00006 0000034 レイアウト/ │ └── 00111 0000957 3.2_受注/ │ └── 00115 0001011 L3.2.1_編集_dat受注.xml ├── Privileges/ 4 ファイル ├── Relationships/ │ ├── Relationship/ 769 ファイル（1 リレーション = 1 ファイル。ファイル名が「左TO---右TO」） │ └── TableList/ 1,136 ファイル（テーブルオカレンス） ├── Scripts/ 1,369 ファイル（1 スクリプト = 1 ファイル。区切り線を含む） │ └── 0001144 2_データ/ │ └── 0001165 2.2_受注/ │ └── 0001210 2.2.4_伝票発行.xml └── ValueLists/ 164 ファイル ``` 合計 4,155 ファイル。ファイル名の先頭には FileMaker 内部の ID が付きます。FileMaker のレイアウト一覧やスクリプトワークスペースを見慣れた方なら、ディレクトリを眺めるだけで構成が思い浮かぶはずです。 分割が効く理由は 3 つあります。 - **AI が「必要な部分だけ」を開ける。** 「受注編集画面の保存ボタン」を調べたいとき、Claude Code はレイアウト名でファイルを特定し、その 1 ファイル（数十 KB）だけを読みます。235MB を探し回る必要がありません - **人間が迷わない。** ディレクトリ構成が FileMaker 内の見た目と一致するので、AI が「このファイルを読みました」と示したときに、人間側もすぐ同じ場所を FileMaker で開けます - **スクリプトがそのまま読める。** 分割されたスクリプトの XML には、スクリプトワークスペースに表示されるのと同じ文（`エラー処理 [ オン ]` のような StepText）が各ステップに入っています。XML に慣れていない人でも、AI の説明と見比べながら読めます ## ③ Claude Code でコードリーディングする 分割された XML と claris-docs がそろえば、あとは Claude Code に質問するだけです。分割先のディレクトリで Claude Code を起動すれば、そのフォルダ全体がプロジェクトとして扱われ、必要なファイルを自分で探して読みます。実際にどう読み解いていくのかを、代表的な 3 つの場面で紹介します（画面名・スクリプト名は実物を伏せた例に置き換えています）。 ### 画面からスクリプトを追う レイアウトの XML には、その画面が使うテーブルオカレンス、配置されたフィールド、ボタンに紐づくスクリプト、そしてスクリプトトリガーがすべて書かれています（この例では画面専用のテーブルオカレンスをレイアウトと同じ名前にしているため、`` の name がレイアウト名と一致しています）。 ```typescript
...