入会金0円／契約期間の縛りなし
セミナー開催レポートブログ
Claude Code の出力がぶれる、毎回長いプロンプトを打っている、という悩みの原因は AI の賢さではなく、AI に渡す情報の不足です。仕事ごとにプロジェクトのフォルダを作り、そこに plan.md（目的・誰に・何を）と brand.md（印象・見た目・言葉遣い）を置いておきます。すると「サムネ作って」の6文字のような短い指示でも、企画とブランドに沿った成果物が出てきます。ただし、ファイルを置けば終わりではなく、出力がずれたらファイルを書き直して育てていく使い方が前提です。
2026年6月29日のセミナーでは、デザイナーの講師 Kawai さんが、この2つのファイルの考え方と書き方を、セミナーの告知物を作る例で説明しました。MCP やスキルといった機能の話ではなく、流行が変わっても使える幹の部分の話です。当日は、出力がぶれる原因、フォルダの構成、2つのファイルに書くこと、実際に6文字で作ったデモ、ずれたときの直し方の順に話が進みました。
Claude Code を使っていても、チャット AI の延長で終わっている人は多い、と Kawai さんは話しました。出力がぶれる原因として挙げたのは2つです。
1つ目は枝葉の知識から入っていることです。X で話題になりやすいのは MCP、スキル、フック、サブエージェントといった機能の話ですが、どれも必要になったときに知ればよい枝葉で、根幹ではありません。幹の部分は地味で伸びないので、話す人も少ないそうです。
2つ目は出たとこ勝負になっていることです。うまくいかない原因は、AI の知識不足やモデルの性能ではなく、マニュアルや情報収集が足りていないことがほとんどだと言います。AI はすでに人より賢い場面が多いので、人と同じ情報を渡せていれば、疲れない AI のほうが確実に良い出力を返す、という見方でした。
チャットでの利用は、質問して、回答を読んで、人が確認する流れです。Claude Code のような AI エージェントは、ファイルを読み、編集し、検証して、修正するところまで自分で実行できます。この特徴を生かすために、作業環境ごと渡す、というのが今回の考え方です。
Kawai さんは高速道路にたとえていました。MCP やスキルは途中で立ち寄るサービスエリアのようなもので、Claude Code を最速で走らせるには先に道を作る必要があります。道にあたるのが、目的、読者（ターゲットやペルソナ）、制約（サムネイルなのかスライドなのか、サイズはいくつか）、そして善し悪しを判断する基準です。
Kawai さんは、全ての仕事はプロジェクトだと考えています。会社も、部署も、チームも、1つのタスクもプロジェクトです。そのプロジェクトを具現化したものが、Mac や Windows で作るふつうのフォルダです。
Kawai さんは、所属する SHIFT AI のフォルダを例として見せました。会社の brand.md と plan.md がいちばん上にあり、その下にコミュニティ事業、法人事業、管理部門、マーケティング、開発部門のフォルダが並びます。コミュニティの中には、コンテンツ制作、会員サイトといったチームのフォルダがあり、その一つ一つがプロジェクトです。
記事を1本書くときも同じです。「Claude Code の使い方」という記事を書くなら、その名前のフォルダを作り、何のために、誰のために書くのかを plan.md に、文体やサムネイルの印象を brand.md に書きます。そのフォルダを Claude Code や Codex に渡せば、企画を読んだ状態で記事を書いてくれます。
セミナーでは「ai-seminar」というフォルダを作る例で進みました。中に置くのは plan.md、brand.md、CLAUDE.md（Codex を使うなら AGENTS.md）と、成果物を入れる output フォルダです。
CLAUDE.md は Claude Code が必ず読むファイル、AGENTS.md は Codex が必ず読むファイルです。書き方は、Anthropic の CLAUDE.md の公式ドキュメントと OpenAI の AGENTS.md の公式ドキュメントに案内があります（2026年11月時点）。ここに「最初に plan.md と brand.md を読む」という指示と、作業のルールを書いておきます。Kawai さんの例では、不明点が成果の品質に直結する場合だけ質問する、既存のファイルから判断できることは質問しない、出力ファイルを output フォルダの外に散らさない、といったルールが入っていました。質問されても構わない人は、ルールの部分は書かなくてよいそうです。
任意で置くのが spec.md と customer.md です。spec.md には、サイズやページ数のような、誰が見ても変わらない仕様を書きます。customer.md は、ターゲットの一日の過ごし方や悩みまで深掘りした人物像のファイルで、充実させるほど出力の精度が上がるそうです。
名前の付け方にも注意があります。フォルダ名とファイル名に漢字やひらがな、記号を使うと、Mac と Windows の間で ZIP にして渡したときに文字化けすることがあります。半角英数字と、記号を使うならハイフンかアンダーバーにするのが無難です。
やることは3つです。フォルダとファイルを作る、plan.md を書く、brand.md を書く。これで下準備は終わりです。
当日は手を動かす時間が取れませんでしたが、聞くだけより自分で作るほうが記憶に残るので、メモでも X の投稿でも何か手を動かしてほしい、と Kawai さんは繰り返していました。
plan.md は企画書、要件定義書にあたるファイルです。Kawai さんはゴーギャンの絵「我々はどこから来たのか、我々は何者か、我々はどこへ行くのか」を引いて、まさにその答えを書くファイルだと説明しました。このプロジェクトは何のために存在し、どこへ向かうのか。つまり目的地です。
ビジネスは、現在の状態と理想の状態の差を埋めることで対価をもらう、という前提で考えます。痩せている人がマッチョになりたいなら、目的は「マッチョな状態」、誰には「その人」、何をは「トレーニングと食事の管理」です。
セミナーの例では、ゴールは「入門セミナーに集客して、AI エージェント講座の購買につなげる」。ターゲットは「チャット AI は使っているが、AI エージェントはまだ使えていない」「流行に追いつけていなくて不安」といった悩みで書きます。バリュー（何を）には、「AI エージェント時代は、プロンプト単発より仕事の流れの設計が重要」「最初に作るべきものはツール一覧ではなく自分の業務の棚卸し」といった、意外性のある気づきを置きます。ルールには誇大表現の禁止や初心者向けの表現、開催概要には形式や時間といった事実が入ります。
書くべき項目を自分で埋めきれないときは、ターゲットはどう選べばいいかを AI と対話しながら決めていけばよいそうです。Kawai さんによると、企画や要件定義が書かれていないプロジェクトはほとんどで、複数人で進めるうちに判断軸があいまいになるのはこのファイルがないからです。逆にこのファイルがあれば、新しいメンバーにも、新しい AI にも、渡すだけで判断軸がそろいます。
brand.md はブランドガイドラインにあたるファイルで、どういう印象でこの企画を進めるのか、人格のような部分を書きます。plan.md だけでも動きますが、それだと AI は汎用的なイメージで出してくるので、ほかと似たものになります。X で見かける AI のデザインがどれも似て見えるのは、brand.md や design.md が定義されていないからだ、というのが Kawai さんの見立てです。
目指すのは「トレンドのデザイン」や「モダンなデザイン」ではなく、他と違う印象をどう持たせるかです。マーケティングでいうポジショニングに近く、まだ席が埋まっていないポジションを取る椅子取りゲームだと表現していました。コカ・コーラの例では、赤の色コードが Web でも印刷のインクでも厳密に管理され、シルエットだけで分かるように独自に設計されています。
印象を作る要素として挙げたのは、色、文字、画像、言葉の4つです。
色は形や文字より先に目に入る情報で、誠実さなら紺、情熱や勢いなら赤、楽しさなら黄色やオレンジのように、与えたい印象から選びます。文字は読めるものがいちばん早く目に飛び込んでくるので強く、画像は特に人の顔に注意が向きやすい。言葉は、言葉遣いで印象が大きく変わります。
Kawai さんの brand.md の構成は、コピーライティングとデザインの2つ。コピーライティングには、初心者向けでやさしい、実務寄り、煽りすぎない、といったトーンと、「誰でも月収100万円」系や「AI で完全自動化」の断言といった禁止用語、推奨表現を書きます。
デザインには背景・文字・メインカラー・アクセントカラーの色コード、フォント（例では Noto Sans JP）、日本語を単語の途中で改行しない、といったルールを書きます。
攻めた口調にしたいなら、そう書いてよいそうです。キャラクター設定に近いもので、自分の発信のジャンルで他と被らない口調を定義していきます。色の選び方もセンスではなく、「こういう印象を与えたいが何色がいいか」と AI に聞いてよい、とのことでした。
デモでは SHIFT AI のプロジェクトフォルダを Codex に渡して「サムネ作って」とだけ頼みました。Claude Code でも Codex でも、デスクトップ版でも同じ使い方ができます。
出てきたサムネイルは、SHIFT AI のキーカラーである赤から紫のグラデーションを踏襲し、asset フォルダに入れておいたロゴも配置されていました。続けて「advertise 画像と slide 画像も作って」と頼むと、Meta 広告用の正方形の画像と、スライドも作られました。
フォルダの中は、output の下に advertise、slide、thumbnail のフォルダがあり、それぞれに spec.md が置いてあります。広告なら Meta 広告で 1:1、スライドなら約30枚で 16:9 といった仕様です。CLAUDE.md や AGENTS.md に「各フォルダの中の spec.md があれば必ず読む」と書いてあるので、仕様を読んだ状態で成果物が出てきます。スライドは下が空きすぎる箇所があり、スライド用の定義をまだ詰めていない、と Kawai さんは話していました。
最初は、plan.md に目的・誰に・何を、brand.md に印象・見た目・言葉遣いの3項目ずつで十分です。セミナーで示した例は長めですが、もっと短くてよく、徐々に足していけます。
出力が思っていた見た目と違ったときは、その都度「こういう見た目に直して」と指摘するのではなく、「brand.md を書き換えて」と頼みます。社員のミスを責めずに仕組みを直すのと同じで、AI のミスも plan.md と brand.md の文章を見直したほうが確実に育つ、という考え方です。
スキルが不要という話ではありません。スキルは実行部隊で、プロジェクトのフォルダというガードレールを通ることで出力の質が上がります。Kawai さんは、全ての仕事は「知る」「考える」「行う」の3ステップだと考えています。知るは課題の理解や調査（3C 分析や SWOT 分析のようなリサーチ）、考えるは戦略の立案やアイデア出し、情報設計、行うはデザインや記事、Web アプリを実際に作る実装や実行です。この3つの分野で、それぞれ得意なスキルを登録しておけば大枠は網羅できます。
他人からもらったスキルより、自分の仕事に合わせて育てたスキルのほうが使いこなせる、とも話していました。最初から完璧なものを作るのではなく、出力させて、駄目出しをして、少しずつ育てていくやり方です。
Claude Code×Notion連携｜接続からデータベース作成、ログの再利用までの回でも、スキルを入れて使う手順に触れています。Claude と Codex にスキルを入れて、毎朝9時の自動実行まで組む手順は、6月22日の中級者向けの回で扱いました。AI に渡す情報を整える、という点ではAI疲れを減らす6つの方法｜Claude Codeの並列作業で認知負荷を下げる工夫の回とも地続きです。
plan.md と brand.md のファイル名は、CLAUDE.md に書いてあるのか、という質問には、Claude Code の窓口が CLAUDE.md なので、玄関に何をするべきかを書いてあるイメージだ、と答えていました。Codex を使わない人は AGENTS.md を作らなくてよいそうです。
customer.md の書き方については、商品が決まったら、その商品を届けるべき人のペルソナをかなり具体的に書き、インサイトまで深掘りするのが大事だそうです。年代や家族構成のような表層ではなく、どんなことに悩んでいるのか、夜も眠れないほどで誰にも話せない悩みは何か、を AI に調べさせたり予想させたりします。近くにいる人を思い浮かべると書きやすく、趣味を入れておくと、その人に合わせたたとえ話が出てくるので、より親身に聞いてもらえるとのことでした。
主催の KEITO は、「plan.md、brand.md と聞くと難しそうだが、要件を書いたテキストファイルをフォルダに入れていくだけのこと。当たり前のように思えて、全然やっていなかった」と振り返っていました。
どちらも Markdown 形式のただのテキストファイルです。plan.md は企画書・要件定義書にあたり、目的・誰に・何を・達成した状態・ルールを書きます。brand.md はブランドガイドラインにあたり、与えたい印象、見た目（色・フォント・ロゴ）、言葉遣いを書きます。
Claude Code が必ず読むファイルなので、「最初に plan.md と brand.md を読む」という指示と、作業のルール（質問の仕方、出力ファイルの置き場）を書きます。Codex を使う場合は、同じ内容を AGENTS.md に書きます。
plan.md に目的・誰に・何をの3つ、brand.md に印象・見た目・言葉遣いの3つです。最初は短くてよく、出力がずれたら追記して育てていきます。
その都度「こう直して」と指摘するのではなく、「brand.md を書き換えて」と頼みます。plan.md と brand.md を見直したほうが、次からの出力が確実にそろいます。
避けたほうが無難です。漢字やひらがな、記号を使うと、Mac と Windows の間で ZIP にして渡したときに文字化けすることがあります。半角英数字と、ハイフンかアンダーバーを使います。
使ってよいのですが、順番が後です。スキルは実行部隊で、プロジェクトのフォルダを通すことで出力の質が上がります。他人からもらったスキルより、自分の仕事に合わせて育てたスキルのほうが使いこなせる、と講師は話していました。
ターゲットをより深掘りした人物像です。年代や家族構成のような表層ではなく、どんなことに悩んでいるのか、誰にも話せない悩みは何かまで書きます。AI に調べさせたり予想させたりしてもよく、趣味を入れておくと、その人に合わせたたとえ話が出てきます。
アーカイブ動画はProcevoで見られます
プランは登録のあとに選べます
