摘要:これは、2026年六月にサイトのブランドtokensをClaude Designへつないだ作業ノートだ。残したいのは、同期範囲、権限、成果の確認についての判断である。当時の画面、コマンド、プランを、今日の固定の操作案内とは扱えない。デザイン資料の取り込みも、すべての成果がブランドに合っていることを意味しない。
処理の途中、ターミナルの権限確認を見つめ、Enterの上で指を止めた。同期したいのは色、フォント、間隔だけなのに、画面には関係なさそうなサブディレクトリが出ていた。
そのとき、まず止まり、何をしようとしているのかを読むことにした。
この経験を残すのは、ツールが実行できるかと、自分が実行を許すべきかは別の問題だからだ。一つのコマンドで代わりに済ませられる判断ではない。
デザイン資料をつないでも、成果は照合する
Claudeは2026年6月17日の製品記事で、デザインシステムの取り込みとdesign-syncを紹介し、既存のデザイン資料を仕事の流れにつなぐ方法を説明している。私が魅力を感じたのは、毎回口頭でブランドを説明するだけでなく、生成のより具体的な根拠を渡せることだった。
ただし、仕様を読んだことは、結果の正しさの保証ではない。色に根拠があっても使う場面を誤るかもしれないし、フォントの情報があっても、階層、間隔、読みやすさが適切とは限らない。
取り込みはデザインの根拠を与えるが、成果物は一項目ずつ照合する必要がある。
自分のサイトで、この接続がどこまでできるかを試したかった。本稿が記録するのは、あの仕事の範囲であって、すべてのプロジェクトとの互換性テストではない。
当時の入口を、永久の製品境界にしない
あのときはClaude Codeで同期を実行し、別にデザインの作業画面で内容を見た。当時の私のやり方は説明できるが、Designを使えるのはCodeだけだとか、Chatは永久に関われないとは言えない。
今回の改訂で見た公式の入門文書には、会話、Artifacts、Claude CodeなどからDesignを使えること、プラン内の他の利用と使用量を共有することが説明されている。元の記事の「独立した週間枠があり、ChatやCodeに影響しない」は、現在のルールとしては残せない。
当時の操作と、現在の製品説明は分けて読む必要がある。
個別のアカウントで使えるという約束でもない。実際に始める前には、自分のプラン、管理設定、ツールの版、現在の画面を確認する必要がある。この経験を再現するために、古いコマンドをそのまま使う必要はない。
何を移すかを決めてから、コマンドの動きを見る
当時はブランドtokensだけを同期した。色、フォント、間隔などの基礎仕様で、完全なコンポーネントは移さなかった。元のノートには十ファイルと、validateがexit 0を返した結果がある。それらはあの作業で残った結果であり、今回の改訂で再実行したわけではない。
あのAstroプロジェクトでは、コンポーネントの同期を今回の交付に含めず、範囲を小さくした。Claude Designが永久にAstroを支援しないという公式な結論ではないし、tokens-onlyなら誤りがないという保証でもない。
同期範囲を先に明確にすれば、確認で何を調べるべきかが分かる。
新しいプロジェクトを開くことも選んだ。サイト専用の資料を、共用する可能性のある既存のデザインシステムに混ぜたくなかったからだ。あの状況での私の選択であり、全員が採るべき唯一の方法ではない。
元の原稿に出てくる/update、/design-sync、tokens-onlyの選択肢、.design-sync/は、当時の作業ノートの名前として読むべきだ。ツールは変わるので、やり直す際は、その時点の説明を別に読む必要がある。
権限の画面では、動作とパス全体を見る
当時、関係のないworkerサブディレクトリが出た理由を、作業ディレクトリの選択までたどった。それはあの切り分けでの理解であって、似た表示の原因がすべて同じとは限らない。
続けて使える方法は、許可の範囲と目の前の要求を照合することだ。どの資料を読み、どのファイルを変え、外部へ接続するのか。許可は今回限りか、その後も有効なのか。
コマンド名だけでは、読み取りだけで書き込まないとは証明できない。
例えばsedの動作は、すべての引数と組み合わせ方による。>があるときだけ書き込みが起きるわけでもない。サンドボックスは特定の境界を提供できるが、「サンドボックスの中」というだけで、すべてのデータへのアクセスや動作が適切だとは判断できない。
画面上の範囲が、理解している必要を超えていたら、まず質問するか範囲を狭めたい。判断するのは実際の動作であって、ツールが自信を見せているかどうかではない。
双方の記憶より、ファイルを読む
同期の途中、私はブランド資料がsrc/にあると思っていたが、当時ツールはpublic/styles/に出所を見つけた。自分の記憶が修正された経験として残すのであって、今日のすべてのサイトの版で同じパスを使うべきだという意味ではない。
重要なのは、どちらが正確に覚えていたかではなく、ファイルへ戻って照合したかだ。ファイルを読んだあとも、今回使うべき版と出所なのかを確認する必要がある。存在するだけで最終的な根拠にはできない。
その場でファイルを見つけたあとも、用途と版を確認する必要がある。
公開方法にも同じ原則が当てはまる。当時はコードをプッシュすれば自動でデプロイされると思っていたが、あとでプロジェクトのルールへ戻って調べた。バージョンの同期とサイトの本番公開は、別々に確認する必要がある結果だ。
exit 0が答えるのは、その確認で調べたことだけ
validateのexit 0は、あの時点のルールに従って、その確認を通過したことを示せる。意味は実際の確認内容によるので、デザインシステム全体が正しいという意味へ直接広げることはできない。
当時は別にCoworkを開き、元の資料と同期後の内容を使って、色などの項目を比較した。元のノートにある確認の分担だ。別のウィンドウに替えただけで、自然に独立した判断になるわけではない。確認する側には、元の資料が見え、基準が分かる必要がある。実行者と同じ盲点を持つ可能性もある。
第二の目の価値は、根拠と基準を改めて照合することにある。
実行者の自己確認も役に立つ。重要な交付には、制作に参加していない役割のレビューを加えると、別の確認の角度が得られる。「自分で自分を調べるのは、確認していないのと同じ」とは、もう言わない。
また、今回はtokensだけを比較した。生成されたすべての画面、コンポーネント、モバイル表示、アクセシビリティが通過したという意味ではない。確認では、何を確かめ、何がまだ対象外かを説明するべきだ。
コミット、同期、公開には、それぞれ終点がある
元のノートには、コミット、ミラーの整合、forceを使わなかったという締めくくりがある。当時のバージョン管理の説明であって、サイトの内容が公開済みである証拠にはならない。任意の作業ディレクトリからmainへ直接プッシュする手順にすべきでもない。
現在のこのサイトの共通ルールでは、mainへ入れる変更は主チェックアウトで統合し、そこでgit syncを使って同期する。デプロイは別に定めた手順で行う。同期が成功したあとも、本番ドメインが実際に提供する内容を確認する必要がある。
版の保存、ミラーの同期、サイトの公開は、それぞれ確認する必要がある。
読者は私のツールの組み合わせをそのまま写す必要はない。より持ち帰る価値があるのは、交付範囲を先に決め、それに合った確認と公開の方法を選ぶことだ。
押す前に、何を許可するかを知る
この経験から、三つをより大切にするようになった。範囲を先に明確にし、出所をその場で照合し、基準に従って結果を確かめる。誤りが起きない保証ではないが、一度の「完了」を理解し、確認しやすくしてくれる。
これは、多モデルとの協働やセンスと判断力について考えてきたことにもつながる。すべての実行を任せれば終わりではなく、目的、権限、結果をつなげることだ。
次に確認画面が出たときも、まず問いたい。今回、具体的に何を動かすことを許可するのか。


💬 コメント
読み込み中...