AIと図面の版を管理する：Rev Aを発行し、クライアントのコメントを反映し、変わった所を正確に示す

この記事の図と依頼文は、英語で記録したものです。

誰が、何をしたいか

既存ビルの3フロアでオフィスの内装工事を進めるプロジェクトリーダーです。クライアントは発行のたびにコメントを返すので、図面はRev Aで出し、朱書きが戻り、Rev Bで出し直し……と続きます。そのたびに必要なものは同じです。各階の寸法入り平面図、数量（部屋の種類ごとの面積、デスク・椅子・扉の数）、前回から何が変わったかの説明、そして前の版を送ったとおりの姿でいつでも出せること。

この記事では、架空の建物「Marlow House」と架空のクライアント「Fenwick Partners」で、この1サイクルを通しました。プロジェクトリーダーは手で何も描いていません。各手順は自分のAIエージェント（Codex）へのプロンプト1本で、エージェントがブラウザで開いたStudioをMCP経由で操作します。

手元にあったもの

• ブラウザで開いたLaydyne Studioと、MCPでつないだCodex。ここで使った機能はProが要りません。モデリング・検査・図面・配置案・ブラウザ保存・変更履歴はFreeです（Proはシミュレーションの実行、内蔵AI、クラウド保存）。
• 文章の要件：30 × 20 mのフロア3層、階高3.6 m、北の壁際に2基のエレベーター・階段・トイレのコア、各階に欲しい部屋。
• 元になる図面はなし。家具や間仕切りの寸法はエージェントが仮定し、仮定として記録しました。

流れ

あなたはプロンプトを書き、クライアントのコメントを渡します。エージェントはLaydyneの道具を呼び、ファイルを書き、自分の作業を確かめます。Laydyneは配置・保存した版・変更履歴を持ち、図面を描きます。要件からRev Bに添える差分入りPDFまで、1サイクルで11の手順です。

手順

プロンプトは実際に送った英文そのままです。時間とトークン数は、各回のCodex自身の記録（codex exec --json）から取りました。

1. 3つの階を作る

要旨：既存の3フロア（30 × 20 m、階高3.6 m、北側中央にコア）を新しいプロジェクトとして作り、各階の部屋と家具を置き、部屋は種類のタグ付きの区画に。全階をcheck_spaceで検査して直し、2Dで見せ、仮定を説明すること。

I'm the project lead on an office fit-out and I want to manage the drawings in Laydyne. Please set up the project in the Laydyne Studio I have open, as a new project called "Marlow House — office fit-out, levels 1–3". The building is existing: three identical floor plates, 30 m east–west by 20 m north–south, 3.6 m floor to floor. The core is the same on every level, against the north wall in the middle, about 9 × 6 m: two lifts, a stair and toilets. Connect the three levels with the stair and the lifts. […] Level 1: a reception desk facing the entrance, a waiting area with 6 chairs, two 6-person meeting rooms in the south-west corner, an open work area with 24 desks and chairs, and a print/copy point. Level 2: […] 48 desks and chairs in clusters of 6, four meeting rooms […] Level 3: […] 36 desks and chairs, a 14-person boardroom, two 6-person meeting rooms and a quiet room. Enclose the rooms with glazed partitions and give each room a door. Make every room a named zone tagged with its room type […] Run check_space on all levels and fix what it finds, then show me each level in 2D and tell me what you assumed.

エージェントは3階分を1回の変更（apply_changes、先に試行で確認）として書き、階段と2基のエレベーターでつなぎ、全階のcheck_spaceの指摘が0件になるまで直し、答える前に各階の図を見ました。220秒、Laydyneの呼び出し24回。

2. Rev Aを発行する

要旨：今日付の初回提出（コメント依頼）としてRev Aを発行。配置案「Rev A」の保存、ブラウザへの保存、各階1枚の寸法入りPDFとSHA-256、部屋の種類ごとの面積とデスク・椅子・扉の数のCSV、発行台帳ISSUE-REGISTER.md。最後に「シート自体にRev Aと書かれているか」を答えること。

Please issue the drawings as Revision A: first issue to the client for comment, dated today. The client is Fenwick Partners (attn. their facilities manager).

1. Save the current layout in Laydyne as a design option called "Rev A".
2. Save the project in the browser, so that we can always go back to exactly what was issued.
3. Produce the drawing set as one PDF with a dimensioned sheet per level (get_view_image with delivery: true, format "pdf", planLayout "sheets"), save it in this folder as MH-FO-RevA.pdf and check its SHA-256.
4. Take off the quantities with get_space_quantities and write MH-FO-RevA-quantities.csv: area per room type for each level and in total, and the number of desks, chairs and doors per level and in total.
5. Start an issue register, ISSUE-REGISTER.md: revision, date, purpose, recipient, each file with its SHA-256, and the Laydyne space hash of what was issued.

Tell me whether the sheets themselves show that they are Revision A.

エージェントは配置を配置案として固定し、ブラウザに保存し、PDF・数量（Rev Aの数量CSV）・台帳を書き、発行した内容の空間ハッシュfnv1a-d542089bを記録しました。最後の問いへの答えは正直に「いいえ」。タイトル欄には日付と空間ハッシュはあっても、「Rev A」とはどこにも書かれていませんでした。

3. シートに版を入れる

この合間にLaydyneを直しました。get_view_imageがrevision {label, date, description, previous}を受け取り、日付の横に「Rev A」と小さな版の表を印字します。モデルは変わりません。そのうえで同じ依頼をエージェントに出しました。

I'd like the sheets themselves to show that they are Revision A. If Laydyne can print the revision in the title block, please re-issue MH-FO-RevA.pdf that way (Rev A, today's date, "First issue for comment"). The model must stay exactly what we issued, so check the space hash against the register, then update ISSUE-REGISTER.md with the new PDF and its SHA-256.

エージェントは新しい項目を自分で見つけ、空間ハッシュがfnv1a-d542089bのままであることを確かめて出し直しました。1回目は記号に「Rev A」を渡したため「Rev Rev A」と印字されました。いまは書き方にかかわらず記号を1回だけ印字します。あわせて、PDFの各階シートにも部屋ごとの面積が載るようにしました。

4. クライアントのコメントを反映する

要旨：1階の会議室間の間仕切りを1.2 m動かして10人用に、受付カウンターをエレベーター向きにして待合を10席に、2階の東側のデスク2島（12台）を6人用会議室2室に、3階のコア南側に電話ブース4台。それ以外は変えず、全階を検査して、変わった階を2Dで見せること。まだ発行しない。

Fenwick Partners have commented on Rev A. Please make these changes in the Laydyne Studio:

1. Level 1: move the partition between the two meeting rooms 1.2 m so that one of them becomes a 10-person room; add chairs to suit.
2. Level 1 reception: turn the reception desk to face the lifts instead of the entrance, and enlarge the waiting area to 10 chairs.
3. Level 2: replace the two desk clusters nearest the east wall (12 desks and chairs) with two 6-person meeting rooms, glazed, each with a door.
4. Level 3: add a row of 4 phone booths along the south wall of the core.

Don't change anything else. Run check_space on all levels, fix any new findings, and show me the changed levels in 2D. Don't issue anything yet. […]

東の壁に同じ距離で並ぶ島が4つあったので、エージェントは北側の2つを選び、それを仮定として書き残しました。各編集を先にプレビューしてから適用し、狭くなった会議室の家具を新しい間仕切りに当たらない向きに回し、全階の指摘0件で終えました。220秒、27回。

5. Rev Bを発行する

要旨：Rev Aと同じ手順で、承認依頼のRev Bを今日付で発行。配置案「Rev B」、ブラウザ保存の置き換え（Rev Aは以前の版として残す）、PDFと数量CSV、台帳への追記。

Please issue Revision B: Fenwick Partners' Rev A comments incorporated, dated today, for approval. Do it the same way as Rev A (see ISSUE-REGISTER.md in this folder): save the layout as design option "Rev B", save the browser project again so that it replaces the saved one and the Rev A save stays as an earlier version, make MH-FO-RevB.pdf and MH-FO-RevB-quantities.csv, and add Rev B to the issue register.

ブラウザ保存を置き換えると、同じプロジェクトの版1としてRev A、版2としてRev Bが残りました。新しい図面のどのシートにも両方の版が並びます（Rev Bの数量CSV）。

6. 変わった所を正確に示す

要旨：送付用に、compare_design_optionsの変更表、階ごとの数量の前後と差（部屋の種類ごとの面積、デスク・椅子・扉・電話ブース）、変わった階ごとに差分を書き込んだ図（get_view_imageのdiff、Rev A→Rev B）をPNGで。同じ差分をブラウザ保存同士でも描き、配置案の比較と一致するか確かめ、MH-FO-RevB-changes.mdにまとめること。

For the Rev B transmittal I need to show the client exactly what changed between Rev A and Rev B:

• compare the two revisions with compare_design_options and give me the change table;
• the quantities before and after: area per room type, desks, chairs, doors and phone booths per level, with the difference;
• for each changed level, the plan with the differences marked (get_view_image with diff from Rev A to Rev B), saved in this folder as PNG.

Also draw the same difference from the browser save of Rev A to the browser save of Rev B and tell me whether it agrees with the design-option comparison. Write it all up in MH-FO-RevB-changes.md.

compare_design_optionsの結果は、部品の追加26・削除12・移動25・変更32（1階8・0・13・19、2階14・12・12・13、3階4・0・0・0）。ブラウザ保存同士でも全階で同じ件数でした。エージェントは細かな点も自分から指摘しました。2階では、比較が削除した作業椅子と追加した会議用椅子を位置で対にして「移動」と数えていますが、実際は削除と追加です。

同じ比較はStudioの画面でも見られます。History → 保存点 → Show on plan。

7. 誰が・いつ・何を変えたか

この手順の前に、プロジェクトリーダーがStudioの画面で区画名「Print / copy」を「Print / copy / post」に手で直しました。

要旨：チームから「誰がいつ何を変えたか」と聞かれたので、変更履歴から、各変更の時刻、経路（Studio画面・MCPのAIエージェント・内蔵AI）、触れた範囲を、Rev A発行前とRev AからRev Bの間に分けて。ブラウザ保存の版と配置案も並べ、HISTORY.mdに書くこと。

Someone on the team asked who changed what on this project and when. From Laydyne's change log, give me the history of the project: when each change was made, whether it came from the Studio screen, an AI agent over MCP or Laydyne's built-in AI, and what it touched, grouped into before Rev A was issued and between Rev A and Rev B (the issue register is ISSUE-REGISTER.md in this folder). Also list the saved versions of the browser project and the design options. Write it to HISTORY.md.

変更履歴は9件。MCP経由のエージェントが8件、Studio画面が1件で、それぞれ時刻、触れた階、追加・削除・変更の件数が残っていました。エージェントは2回の発行を境に分け、手での修正はRev Bの後なので別に挙げました。履歴に「人」が残らないことも、限界として書いています。

8. 発行したとおりのRev Aを開き直す

要旨：明日の打合せで、発行したとおりのRev Aをもう一度見たい。発行時のブラウザ保存から開き、空間ハッシュと数量を台帳と照合し、1階と2階を2Dで見せ、その後Rev Bに戻し、ブラウザ保存の最新版がRev Bのままか確かめること。

In tomorrow's meeting the client wants to look at Rev A again exactly as it was issued. Open Rev A from the browser save we made when we issued it, check that it is the issued Rev A (compare its space hash and quantities with ISSUE-REGISTER.md in this folder), and show me levels 1 and 2 in 2D. Then go back to Rev B as the current work, and make sure the browser project still has Rev B as its latest version.

エージェントはブラウザ保存の版1を開きました。空間ハッシュfnv1a-d542089b、デスク108台・椅子184脚・扉25枚で、台帳と一致。Rev Aのタイトル欄で図を描き、Rev Bを開き直しました。手順7の手直しは失われていません。保存を開くときは、いまの作業を先に別のコピーとして残すためで、エージェントもそう報告しました。80秒、10回。

9. 送付用の差分入りPDFを1つに

要旨：クライアントはPNGのばらばらより1つのPDFがよい。Rev Bの各階シートにRev Aからの変更を書き込み、タイトル欄にRevision B（下にRev A）を入れたMH-FO-RevB-changes.pdfを作り、各シートの凡例がその階の変更と合うか確かめ、台帳のRev Bに追記すること。

The client would rather have one PDF than loose PNGs. Please make MH-FO-RevB-changes.pdf: the Rev B sheets, one per level, with the changes from Rev A marked on each sheet and Revision B in the title block (with Rev A listed below it). Check that each sheet's legend matches that level's changes in MH-FO-RevB-changes.md, then add the PDF and its SHA-256 to the Rev B entry in ISSUE-REGISTER.md.

1回目、エージェントはLaydyneを一度も呼びませんでした。手順6のPNGを自前の道具でPDFにまとめ、Laydyneのタイトル欄の上に自作のタイトル欄を重ねています（"title block added locally"）。LaydyneはPDFの各階シートに差分を描けましたが、道具の説明にそう書かれておらず、各シートの凡例も建物全体の件数でした。両方を直して同じ依頼をすると、今度はLaydyneの1回の呼び出しで差分入りのRev B一式（3ページ）ができ、凡例はそれぞれの階の件数になりました。

結果と数字

Codex（codex-cli 0.160.1、設定どおりモデルgpt-6-astra・推論low）が、各手順を新しいセッションとして、どのリポジトリにも属さない空のフォルダから、ローカルのStudioに対して実行しました。表は記事で示した回です。

• 入力トークンの90.1%はキャッシュです。エージェントは毎回、自分の会話と道具の一覧を読み直します。
• 拒否された6回は何も変えていません。3回はエージェントが並列に呼んでタブが処理中だったため、1回は到達確認の行き先が20件を超えたため、1回は編集が受け付けない項目を使ったため、1回はPDFの2つ目の断片を1つ目の設定を繰り返さずに頼んだためです（このエラー文は、いまは理由を言います）。
• 手順3と9は2回ずつ実行し、表は2回目です。1回目（87秒、およびLaydyneを呼ばずに242秒）は各手順に書きました。

できたもの：PDFの図面一式2つ、数量CSV 2つ、変更報告、送付用の差分入りPDF、発行台帳、プロジェクトの履歴。Rev AとRev Bは、配置案としても、1つのブラウザ保存の2つの版としても残っています。

10月7日の追記：台帳・図番・雲マークがLaydyneに入った

上でエージェントがMarkdownで付けた発行台帳、手で渡していた版の表、図番がないこと、雲マークがないこと。この流れで最初に見えた不足が、プロジェクトの一部になりました。issue_drawingsが発行（版・日付・状態・説明・送付先・送ったファイルとSHA-256・発行した配置）を記録して、そこから図面一式を描き、get_issue_registerが台帳をJSON・CSV・印刷用のページで返します。同じ要件でMarlow Houseを作り直し、同じコメントを反映して、発行はふつうの言葉で頼みました。新しい道具はエージェントが自分で見つけました。

Rev Aを台帳に発行する

要旨：コメント依頼のRev Aを今日付で発行。台帳はLaydyneに記録し、図番はMH-FOで始める。図面一式のPDFを保存してSHA-256を台帳と照合し、数量CSVも作って一緒に記録し、ブラウザに保存する。

Please issue the drawings as Revision A: first issue to the client for comment, dated today. The client is Fenwick Partners (attn. their facilities manager).

Laydyne keeps the project's drawing register, so record the issue there rather than in a separate file, and number the drawings starting with MH-FO. Save the drawing set as one PDF in this folder and check its SHA-256 against the register. Also take off the quantities with get_space_quantities and write MH-FO-RevA-quantities.csv […], and record that file with the issue as well. Save the project in the browser.

エージェントは先に数量CSVを書き、そのSHA-256を添えてissue_drawingsを1回呼びました。Laydyneはシートに図番を振り（MH-FO-000が図面台帳・シート目録、MH-FO-101〜103が各階）、どのシートにも図番・「Sheet n of 4」・状態・版の表を印字し、4ページのPDFのSHA-256を記録しました。エージェントはPDFの残りの断片を読み、ハッシュを台帳と照合してから保存しました。194秒、Laydyneの呼び出し8回（拒否なし）。

変更に雲マークを付けてRev Bを発行する

要旨：承認依頼のRev Bを同じ送付先に今日付で発行。Rev Aと同じ手順で台帳に記録し、図面一式を保存してSHA-256を照合、数量CSVも記録してブラウザに保存する。Rev Aから何が変わったかが、どのシートでも一目で分かるように。2階のシートを見せる。

Please issue Revision B: Fenwick Partners' Rev A comments incorporated, dated today, for approval, to the same recipient. Do it the same way as Rev A: record it in Laydyne's drawing register, save the drawing set in this folder and check its SHA-256, write MH-FO-RevB-quantities.csv and record it with the issue, and save the browser project. The client should see at a glance on each sheet what changed since Rev A. Show me level 2 of the Rev B set.

LaydyneはRev Bを、Rev Aのときに保管した配置と比べ、版の三角印つきの雲を5つ描きました。1階に3つ（動いた間仕切りと両側の会議室、向きを変えた受付カウンター、広げた待合）、2階に1つ（新しい会議室2室と狭くなった執務エリア）、3階に1つ（電話ブース）です。雲の中には従来の差分の印が残るので、削除して別の部品を足した所と、動かした所の違いは読み分けられます。凡例の下には、移動した椅子のうち12脚はIDでなく位置で対応づけたもので、置き換えの可能性があると書かれます。図番は変わらず、どのシートにもRev Bの下にRev Aが並びます。113秒、Laydyneの呼び出し9回（Rev Bの図面一式、4ページ）。

台帳を読み出す

要旨：台帳はこのフォルダのファイルからではなくLaydyne自体から取り出す。発行ごとの日付・状態・送付先、図番と版、ファイルとSHA-256。Laydyneの台帳をCSVと印刷用のPDFページで保存し、発行した図面一式をLaydyneに描き直させて、手元のPDFがバイト単位で記録どおりか確かめる。

Get the drawing register from Laydyne itself, not from the files in this folder: every issue with its date, status and recipient, the sheets with their drawing numbers and revisions, and the files with their SHA-256. Save Laydyne's register in this folder as CSV and as its printable PDF page (MH-FO-register.csv and MH-FO-register.pdf), and ask Laydyne to draw each issued set again to confirm that the PDF drawing sets in this folder are byte for byte the files it recorded.

「Laydyne自体から」と書かずに頼んだ1回目は、エージェントがフォルダにあるプロジェクトの控え（台帳も入っている）から台帳を組み立て、PDFも自作し、Laydyneを1回も呼びませんでした。上の依頼文では、Laydyneの台帳のCSVとページを保存し、Laydyneは保管した配置から両方の図面一式を描き直しました。発行時に記録したファイルとバイト単位で同じです。83秒、Laydyneの呼び出し9回。

Studioでは、プロジェクト → Drawing issues（図面の発行台帳）に同じ台帳が並び、発行ごとのシートとファイルを確認でき、CSVや印刷用のページで保存し、発行した図面一式を描き直して記録したファイルと同じかを示します。History画面では各発行が戻れる時点として並び、「平面図に表示」で発行した配置から現在の編集内容への差が平面図に出ます。

この回は実行時の設定のモデルgpt-6.1-sol（推論medium）で動かしたので、時間は上の表とそのまま比べられません。発行の手順そのものは、呼び出しとコマンドが減りました。Rev Bは、エージェントが台帳をMarkdownで付けていたときの呼び出し13回・シェルのコマンド25回に対し、呼び出し9回・コマンド8回でした。拒否された1回は、以前と同じ到達確認の行き先20件超えです。台帳の読み出しではシェルのコマンドが50回あり、大半はPDFのbase64の断片をファイルに書き写すものでした。

まだできないこと

• 台帳は記録するだけで、送りはしません。 送付先は自由な文字で、Laydyneからメールや共有はしません。描き直した図面一式が記録したファイルとバイト単位で同じなのは、描画のコードが同じ間だけです。凡例の文言を直した後は、Rev Bの描き直しは記録したファイルと一致しなくなりました（Rev Aは一致）。送ったファイルは手元に残してください。台帳にはそのSHA-256が残ります。
• 完全な監査記録。 変更履歴に残るのはStudio・MCPのエージェント・内蔵AIという経路で、人の名前はありません。各件は階と件数で、どの部品のどの項目かは書かれません。手での修正の中身は、エージェントが保存済みのRev Bと比べて突き止めました。以前の版を開くと、履歴はその版の履歴になり、後の記録は開く前に残したコピーの中にだけ残ります。
• 別のPCとの版の共有。 ブラウザ保存はそのブラウザに直近5版、配置案は1プロジェクト10案まで。クラウド保存はMCPから使えないので、同僚がRev Aを開くには、プロジェクトファイルを送る必要があります。
• 雲マークは印を囲む長方形です。 1.2 m以内の印は1つの雲にまとめ、外形が変わった部屋は部屋全体を囲むので、大きな部屋の小さな変更でも雲は大きくなります。近くの似た部品に置き換えた所はいまも「移動」と出ます。位置で対応づけた移動の件数は凡例の下に出るようになりました。
• 一度付けた名前は残る。 手順1でエージェントが階名を「Level 1 — first issue」としたため、後のシートにもそのまま出ます。エージェント向けの手引きに、版の言葉を名前に入れないよう加えました。
• 再読込後のHistory画面。 ブラウザのタブを再読込すると、プロジェクトを保存するか開き直すまで、History画面にブラウザ保存の版が出ません。
• 面積は描いた外形から出したものです。法規の確認はしておらず、エージェントが仮定した寸法は実測するまで仮定です。

試してみる

発行したモデルをStudioで開くか、編集用のRev Bプロジェクトをダウンロードできます。上の台帳を使った通し直しで保存した最終モデルの配布用コピーで、図面の発行台帳と発行時の配置も入っています。工程シナリオはありません。現行の読み込みに合わせて未使用のロボットの行き先だけ通れる位置へ調整し、オフィスの配置・発行時のモデル・図面のSHA-256は元のままです。

Laydyne Studioを開いてAIをMCPでつなぎ、次のように始めてください。

Use the Laydyne tools on the Studio I have open. Build [your floors and rooms], with every room a named zone tagged with its type, run check_space on all levels and fix what it finds. Then issue it as Revision A in Laydyne's drawing register (issue_drawings: for comment, to [recipient], with the quantities CSV you write from get_space_quantities and its SHA-256), save the drawing set it returns and check its SHA-256, and save the project in the browser. When I send comments, apply only those and issue Rev B the same way, with the changes clouded against Rev A. At the end, give me the register as CSV (get_issue_register).

日本語で頼む場合の例：

開いているStudioをLaydyneの道具で編集してください。[階と部屋の要件]を作り、部屋は種類のタグ付きの区画にして、全階をcheck_spaceで検査して直してください。次にRev AとしてLaydyneの図面台帳に発行してください（issue_drawings：コメント依頼、送付先は[相手]、get_space_quantitiesから作った数量CSVとそのSHA-256も記録）。返ってきた図面一式を保存してSHA-256を確かめ、ブラウザにも保存してください。コメントを送ったらその分だけ直し、同じ手順でRev Aからの変更に雲マークを付けてRev Bを発行し、最後に台帳をCSVでください（get_issue_register）。