最初に、この教材が約束しないことから書きます。

この教材は、収益を約束しません。「月◯万円稼げる」「作業時間が◯%減る」といった話は、本文のどこにも出てきません。そうした効果はあなたの案件・単価・スキルに依存するもので、私に約束できる性質のものではないからです。

Brainの教材ページとしては変な書き出しだと思います。ですが、この教材の中身が「AIに任せきりにせず、コントロールを最後まで手放さない」という話である以上、売り方だけ誇張するわけにはいきません。この教材で語る数字は、検証可能な事実と記録上の事実だけです。

著者について

tagcatman と申します。フロントエンドまわりの仕事を10年ほど、フリーランスとしては9年やってきました。LPやコーポレートサイトの制作から、WordPress構築・Shopifyカスタマイズ・MicroCMS案件・Reactでの診断サイトやWebアプリケーション開発まで——受託の現場で求められるまま手を広げてきた結果、気づけばフロントエンドの仕事は一通り経験してきました。

Claude Codeを、Web制作の実案件・Figmaプラグイン開発・PR動画制作まで、制作業のほぼ全域で運用しています。検証可能な実績としては、Figma Communityでプラグイン4本を公開中です（Vertical Text JP / NanameFit / Layer Finder / QR PrevGen）。執筆時点で合計ユーザー数は5,000を超えており、この数字はFigma Communityでプラグイン名を検索すれば、誰でもその時点の実数を確認できます。

※ 本教材は、Anthropic社とは無関係の個人による制作物です。公式・公認・監修といった関係は一切ありません。

この教材は何か

Claude Codeを実案件に投入したとき、品質と進行のコントロールを最後まで手放さないための「仕組み」——私が実運用している .claude 環境（CLAUDE.md / rules / skills の3層）の設計思想・実物テンプレート・運用記録の全公開です。

単発のタスクでは魔法のように見えたClaude Codeが、実案件では崩れていく。AI流のコードが増えるほど自分が修正箇所を見極められなくなり、セッションが切れるたび文脈が消え、伝えたはずの規約の逸脱が納品物に蓄積していく——この「場当たりプロンプトの破綻」に覚えのある方のための教材です。

全体を貫くテーゼは一行です。

AIに書かせるな、"自分の書き方"で書かせろ。

運用の実態をひとつ書いておきます。Skillsが登場し、このワークフローの前身ができた2025年秋頃から、私は業務で基本的にコードを1行も書いていません。それでも納品物の品質のコントロールを失っていないのは、この仕組みが「自分の書き方」を守らせ続けているからです。

同梱のテンプレートは、それ単体でもコピペで導入できます。それでも本文の大半を設計思想と運用記録の説明に割いているのは、テンプレートは思想込みで使ったときに本当の威力を発揮するからです。ファイルだけ配って終わりにしない構成にしています。

手に入るもの

本文・全10章（第0章〜第9章）

第0章 — はじめに（無料公開）
第1章 — なぜ「場当たりプロンプト」は実案件で破綻するのか（無料公開）
第2章 — 全体設計 — CLAUDE.md / rules / skills の3層アーキテクチャ
第3章 — 30分導入ガイド — テンプレパックをコピペで動かす
第4章 — "自分の書き方"をAIに教える — rules のパススコープ設計
第5章 — セッションを跨ぐ — progress / handover / task-manager
第6章 — Figma MCP 実務連携 — カンプからコードへ
第7章 — スキル設計パターン — 自作27スキルから抽出した原則
第8章 — 実録 — Figmaプラグインを企画→リリースした全工程
第9章 — 運用・アップデート・よくある失敗

本文の総量は約6万字（第0〜9章・空白を除く実測で約59,900字）です。各章末にチェックリストが付き、読み物ではなく「手を動かして導入する」構成になっています。

第8章の実録は、開発時の進捗ログ・引き継ぎファイルという一次記録から復元したものです。「着手から審査提出まで半日」「公開申請の翌日に公開確認」といった記録上の事実とあわせて、QRコードの容量オーバーで設計が崩壊した話、5方式を試した位置ずれバグとの3セッション、AIのハルシネーションが信用を損ねかける寸前までいった一件（事故未遂）がルールとして永続化されるまで——失敗の記録を省略せずに載せています。

特典: テンプレートパック（.claude 環境一式）

私が実案件で運用している環境を、コピペで導入できる形に整えたものです。導入は3ステップ・目安30分（手順は第3章で1行ずつ案内します）。

CLAUDE.md — 運用ルール本体（ハルシネーション防止・検証優先・編集許可制・コーディングワークフロー。起動時に自動読み込み）
rules/ 3ファイル — SCSS（FLOCSS命名等）/ JavaScript / DOM構造のコーディングルール。対象ファイル編集時に自動適用。※著者の普段のルールの実例で、自分のルールに置き換えて使うのが本来の使い方です
skills/ スキル7本 — claude-fundamental-rules（基本ルール詳細）/ coding-rules（案件固有ナレッジ蓄積）/ progress（進捗管理・引き継ぎ）/ project-start（案件開始セットアップ）/ task-manager（タスク永続管理）/ multi-angle-review（多角的コードレビュー）/ word-variables（用語の短縮辞書）
agents/ サブエージェント定義1本 — debugger（multi-angle-review をプリロードした多角的コードレビュー・デバッグ専門エージェント。multi-angle-review スキルとペアで機能します）

このうち coding-rules は、案件の決定事項をナレッジとして蓄積していく設計です。使い込むほど、Claudeはその案件に特化したClaudeに育っていきます。案件の出だしに必要だったガードレールや補正が、中盤には減っていく——その育て方も本文（第2章・第9章）で扱います。

無料で読める範囲

このページの下に、第0章「はじめに」と第1章「なぜ『場当たりプロンプト』は実案件で破綻するのか」の全文を置いています。購入判断はそれを読んでからにしてください。第1章で挙げる3つの破綻に覚えがなければ、この教材はまだ必要ありません。

向いている人・向いていない人

向いている人

既にWeb制作・コーディングの実務をしている人（フリーランス・制作会社の実装担当）
Claude Codeは触れるが、実案件投入で崩れた経験がある人
自分のコーディング規約・「いつもの書き方」を持っている人

向いていない人（正直に書きます）

プログラミング未経験の方。AIの出力を自分で評価・修正できることが前提のため、運用できません
「AIに全部任せて楽に稼ぎたい」方。本書のテーゼはその正反対です
Claude Codeのインストール・基本操作から知りたい方。入門は公式ドキュメントが最良です

価格と部数の設計

先行50部: ¥9,800
以降、部数に応じて段階的に値上げ（例: 51〜150部 ¥12,800【要決定】）
定価: ¥14,800

先行価格を設ける理由も正直に書きます。発売直後はレビューが0件で、購入者がいちばんリスクを取る時期だからです。その分を価格で先に還元します。値上げは煽りの演出ではなく、上記の段階を事前告知のうえ淡々と実施します。

ここから先は有料部分です。第0章・第1章を読み、3つの破綻に覚えがあり、自分の書き方を持っている方——続きでお待ちしています。

第0章はじめに — 私がClaude Codeで作ってきたもの

この章の内容

0-1. 著者は何者か
0-2. 本書の数字の扱いについて
0-3. 本書で得られるもの
0-4. 対象読者と、向いていない人
0-5. 全体目次

本書は、Claude Codeの入門書ではありません。インストールの方法や基本操作は扱いませんし、「AIで楽に稼ぐ方法」も書いてありません。

扱うのはひとつだけです。Claude Codeを実案件に投入したとき、最後まで品質と進行のコントロールを手放さないための「仕組み」——私が実運用している .claude 環境（CLAUDE.md / rules / skills の3層）の設計思想と実物、そしてその運用記録です。同梱のテンプレートパックを使えば、この環境はあなたのプロジェクトにコピペで導入できます。

0-1. 著者は何者か

tagcatman と申します。フロントエンドまわりの仕事を10年ほど、フリーランスとしては9年やってきました。LPやコーポレートサイトの制作から、WordPressのサイト構築、Shopifyのカスタマイズ、MicroCMSを使った案件、Reactでの診断サイトやWebアプリケーションの開発まで——受託の現場で求められるまま手を広げてきた結果、気づけばフロントエンドの仕事はだいたい一通り経験してきました。教材を書くために現場を離れた人間ではなく、本書に出てくるルールやスキルは、すべて今も自分の案件で動いているものです。

Claude Codeは、その実務の中心にあります。用途はWeb制作の実案件にとどまらず、Figmaプラグインの開発、リリース用PR動画の制作（Remotionによるコードベースの動画生成）まで、制作業のほぼ全域で運用しています。

検証可能な実績をひとつだけ挙げておきます。Figma Communityで、私は4本のプラグインを公開中です。実績をこのひとつに絞るのは、それ以外の実績が、現場にアサインする形の受託という案件の性質上、公にできないためです。

Vertical Text JP — 日本語テキストの縦書き変換
NanameFit — 回転オブジェクトのバウンディングボックスを見た目を変えずにリセット
Layer Finder — レイヤー名のキーワード検索と一括選択
QR PrevGen — プロトタイプをスマホで実機プレビューするQRコード生成

執筆時点で、4本の合計ユーザー数は5,000を超えています。この数字はFigma Communityでプラグイン名を検索すれば、誰でもその時点の実数を確認できます。本書の第8章では、この4本を企画からリリースまでどう作ったかを、開発時の進捗ログという一次記録から実録で公開します。

0-2. 本書の数字の扱いについて

先に、本書のポリシーを明記しておきます。本書は、収益や時短の効果を約束しません。「この教材で月◯万円」「作業時間が◯%削減」といった話は一切出てきません。そうした効果はあなたの案件・単価・スキルに依存するもので、私に約束できる性質のものではないからです。

代わりに本書が提示するのは、記録上の事実です。たとえば「プラグインの着手から審査提出まで半日だった日がある」「公開申請の翌日に公開が確認された」——これらは開発ログに残っている事実なので書きます。記録にないこと（たとえばユーザー数の推移）は、書きません。教材の中の数字がどこまで信用できるかは、この区別で判断してください。

0-3. 本書で得られるもの

得られるものは3つです。

1. 設計思想。 Claudeへの指示を「寿命」と「適用範囲」で整理し、CLAUDE.md（常時適用の運用ルール）/ rules（自分のコードの癖）/ skills（発動型の手順と案件固有ナレッジ）の3層に振り分けるアーキテクチャ。本書を貫くテーゼは一行です——AIに書かせるな、"自分の書き方"で書かせろ。

2. 実物のテンプレート。 私が実案件で運用している .claude 環境一式を、テンプレートパックとして同梱します。中身は CLAUDE.md、rules 3ファイル（SCSS / JS / DOM構造）、スキル7本（進捗管理・引き継ぎ・タスク管理・多角レビューほか）＋サブエージェント定義1本（多角レビューを装備したデバッグ専門エージェント）。導入は3ステップ・目安30分で、手順は第3章で1行ずつ案内します。

3. 運用の実録。 仕組みは導入した後の運用で決まります。セッションを跨ぐ引き継ぎ、Figma MCPを使ったカンプからのコーディング、スキルの自作パターン、そしてプラグイン4本の開発記録——失敗も含めて、実運用の一次情報を載せます。

3つをこの順で並べたのには理由があります。テンプレートは、ファイルとして渡すことができます。しかし、それが本当の威力を発揮するのは、「なぜこの形なのか」という思想込みで使ったときです。だから本書は、テンプレートの前に設計思想を置き、後ろに運用の実録を置いています。

ひとつ、運用の実態も書き添えておきます。Skillsが登場し、このワークフローの前身ができた2025年秋頃から、私は業務で基本的にコードを1行も書いていません。強調したいのは「楽になった」ことではありません。コードを自分の手で書かなくなってもなお、納品物の品質のコントロールを失っていない——それは、テーゼに沿って組んだこのシステムが「自分の書き方」を守らせ続けているからです。本書で渡すのは、その状態を成立させている仕組みの全体です。

0-4. 対象読者と、向いていない人

本書は既にWeb制作・コーディングの実務をしている人に向けて書いています。フリーランスのコーダー、制作会社の実装担当、入門教材を終えてClaude Codeは触れるようになったが「実案件に入れたら崩れた」経験のある人。自分のコーディング規約（あるいは「いつもの書き方」）を持っている人ほど、本書の中心部分（第4章）が効きます。

逆に、次の方には向いていません。正直に書きます。

プログラミング未経験の方。 本書はAIの出力を自分で評価・修正できることを前提にしています。コードを読めない状態で本書のシステムを入れても、運用できません
「AIに全部任せて楽に稼ぎたい」方。 本書のテーゼはその正反対です。AIに作業を渡しつつ、判断とコントロールは最後まで人間が持つ、という話しかしていません
Claude Codeのインストールから知りたい方。 セットアップの入門は公式ドキュメントが最良で、本書では扱いません

0-5. 全体目次

本書の全章を、節レベルまで展開した目次として掲げておきます。読み進める途中で現在地を確かめたくなったら、ここに戻ってください。

第0章はじめに — 私がClaude Codeで作ってきたもの（本章）

0-1. 著者は何者か
0-2. 本書の数字の扱いについて
0-3. 本書で得られるもの
0-4. 対象読者と、向いていない人
0-5. 全体目次

第1章なぜ「場当たりプロンプト」は実案件で破綻するのか

1-1. 最初の1週間は、たしかに魔法だった
1-2. AIコーディングの世代 — あなたはいまどこにいるか
1-3. 破綻その1 — 「AI流のコード」が増えるほど、自分が関与できなくなる
1-4. 破綻その2 — セッションが切れるたび、プロジェクトの記憶が消える
1-5. 破綻その3 — 口頭ルールは蓄積しない。逸脱だけが蓄積する
1-6. 3つの破綻に共通する構造 — 解決の方向は「仕組み化」

第2章全体設計 — CLAUDE.md / rules / skills の3層アーキテクチャ

2-1. 出発点 — 指示には「寿命」と「適用範囲」がある
2-2. プロジェクトディレクトリの構え方 — ドキュメント駆動開発が前提
2-3. 3層の全体像
2-4. 第1層 CLAUDE.md — 「常時」守らせる運用ルール
2-5. 第2層 rules/ — 「自分の書き方」を自動適用する
2-6. 第3層 skills/ — 発動型の手順と、案件固有ナレッジの蓄積
2-7. 迷ったときの振り分け基準
2-8. この形にたどり着くまで — 巨大スキル1本からの進化

第3章 30分導入ガイド — テンプレパックをコピペで動かす

3-1. 導入前の状態確認（3分）
3-2. テンプレートパックのコピー（5分）
3-3. CLAUDE.md の自分用カスタマイズ（7分）
3-4. rules/ を「自分の書き方」に書き換える（7分）
3-5. 動作確認（8分）
3-6. うまくいかない時のチェックリスト

第4章 "自分の書き方"をAIに教える — rules のパススコープ設計

4-1. なぜ「AI流のコード」を放置してはいけないのか
4-2. 「自分の癖」を言語化する — 3つの抽出ワーク
4-3. ルールの書き方 3つのコツ
4-4. paths: フロントマターの設計 — どのルールをどこに当てるか
4-5. ルールの育て方 — 規約違反は「言語化漏れ」のシグナル

第5章セッションを跨ぐ — progress / handover / task-manager

5-1. 「あのときは動いていた」— 私の失敗から
5-2. progress スキル — 記録は3つのファイルでできている
5-3. 「区切りごとに更新」を人間が頑張らない — CLAUDE.mdとの接続
5-4. 引き継ぎの実際 — 「handover.mdを読んでください」だけで再開する
5-5. task-manager — タスクの現在地を構造化データで持ち歩く
5-6. 運用感 — 記録はAIに書かせ、人間は区切りを宣言するだけ

第6章 Figma MCP 実務連携 — カンプからコードへ

6-1. Figma MCPで何ができて、何ができないか
6-2. 実運用の全体像 — 「翻訳層」としての figma-variables.md
6-3. なぜ「変数管理」がデザインの意図を伝える手段になるのか
6-4. MCPが使えない案件 — 下限のワークフローから「任せられる範囲」が見える
6-5. プラグイン開発者視点の実務Tips
6-6. まとめ — 任せる範囲を仕組みで区切る

第7章スキル設計パターン — 自作27スキルから抽出した原則

7-1. その前に — 何をスキル化し、何をしなくていいか
7-2. パターン① ラリー形式 — 一括出力せず、確認を挟んで進める
7-3. パターン② 承認ループ — 編集・登録は必ず許可を取ってから
7-4. パターン③ YAMLの description に「発動条件」を書き込む
7-5. パターン④ ナレッジ分離 — SKILL.md は薄く、知識は別ファイルへ
7-6. パターン⑤ Version History — スキルの進化を記録する
7-7. パターン⑥ テンプレ複製型 — 環境構築を「コピー＋穴埋め」にする
7-8. パターン⑦ ワークフロー統合型 — 複数ツールを1本の手順に束ねる
7-9. サブエージェント定義 — 分身に役職を与える（.claude/agents）
7-10. スキルを作る作業も、Claudeにやらせる

第8章実録: Figmaプラグインを企画→リリースした全工程

8-1. なぜWeb制作者がFigmaプラグインを作ったのか
8-2. 実録① Vertical Text JP — 23バージョンの試行錯誤（システム以前）
8-3. 転換点 — ハルシネーション事故未遂が「憲法」になった
8-4. 実録② Layer Finder — 着手から審査提出まで半日
8-5. 実録③ QR PrevGen — 失敗が製品の特徴になった
8-6. 実録④ NanameFit — 5方式の死闘と「消えたコード」
8-7. 4本の記録から抽出できること
実録から得た原則

第9章運用・アップデート・よくある失敗

9-1. システムは「完成」しない
9-2. 全体像の再掲 — 本書のシステムは1枚の表に収まる
9-3. よくある失敗6つ — 全部、私がやったものです
9-4. アップデートへの構え方 — 仕様は変わる前提で組んである
9-5. 結び — コントロールを手放さないこと

各章の末尾には「この章のチェックリスト」が付きます（第0章を除く。第8章のみチェックリストの代わりに「実録から得た原則」を置いています）。

第0章と第1章は無料公開部分です。第1章を読んで「この破綻に覚えがある」と感じた方にだけ、続きをおすすめします。

第1章なぜ「場当たりプロンプト」は実案件で破綻するのか

この章の内容

1-1. 最初の1週間は、たしかに魔法だった
1-2. AIコーディングの世代 — あなたはいまどこにいるか
1-3. 破綻その1 — 「AI流のコード」が増えるほど、自分が関与できなくなる
1-4. 破綻その2 — セッションが切れるたび、プロジェクトの記憶が消える
1-5. 破綻その3 — 口頭ルールは蓄積しない。逸脱だけが蓄積する
1-6. 3つの破綻に共通する構造 — 解決の方向は「仕組み化」

仕組みの話に入る前に、仕組みがない状態で何が起きるかを正確に見ておきます。これは他人の失敗談ではなく、私自身が通った道の記録です。

1-1. 最初の1週間は、たしかに魔法だった

Claude Codeを初めて実務に使ったときの感覚は、いまでも覚えています。「このセクションのレイアウトを組んで」と伝えると、数十秒で動くコードが返ってくる。エラーを貼れば原因を特定し、修正案まで出してくる。単発のタスク——使い捨てのスクリプト、小さな修正、調査——では、ほとんど無敵に見えました。

この初期体験は本物です。本書はそれを否定しません。問題は、この体験から「実案件もこの調子でいける」と推論してしまうことです。単発タスクと実案件には、決定的な違いがあります。実案件は長く続き、何往復もし、最終的な品質の責任を自分が負うという点です。

思いついたことをその場でチャットに打ち込み、必要な資料をその都度貼り付け、出てきたものを使う——本書ではこの運用を「場当たりプロンプト」と呼びます。場当たりは、単発タスクでは最速の方法です。しかし案件が進むにつれて、3つの破綻が構造的に——つまり、あなたの腕前やプロンプトの上手さと無関係に——やってきます。

1-2. AIコーディングの世代 — あなたはいまどこにいるか

破綻の中身に入る前に、地図を1枚置いておきます。「AIにコードを書かせる」と一口に言っても、道具の性質はこの数年で数段階変わってきました。私は次の5段階で整理しています。

第1世代（チャット壁打ち） — チャット画面にコードを貼り、直してもらう。AIに見えているのは貼った分だけで、プロジェクトの全体像は見えない
第1.5世代（エディタ補完） — エディタ内で行・関数単位の補完が走る。速いが、視野はカーソル周辺にとどまる
第2世代（コーディングエージェント） — リポジトリ全体を読み、ファイル編集・コマンド実行まで行う。プロジェクト単位でAIが関与できる
第3世代（MCP / Skills） — 外部サービスとの連携（MCP）と、手順・判断基準の移植（Skills）。AIを「自分の分身」に仕立て、特定業務の固有能力を装着できる
第4世代（マルチエージェント / 自律運用） — エージェントがエージェントを率いる。人間の仕事は区切りの宣言と異常検知に寄っていく

第1世代と第1.5世代は、いまも単発の用途では現役です。ただしどちらも、AIの視野が「貼った分」「カーソル周辺」に限られます。プロジェクト全体の文脈を持てない以上、実案件の主力にはなりません。

第2世代——Claude Codeのようなコーディングエージェントの登場が、最初の質的な転換でした。AIがリポジトリ全体を読み、ファイルを編集し、コマンドまで実行する。「コード片を直してもらう」から「プロジェクトにAIが関与する」への変化です。

第3世代が、本書のシステムの起源です。MCPによって、AIはFigma・ブラウザ・データベースといった外部サービスに手が届くようになりました。AIに羽が生えた、というのが私の実感です。そしてSkillsによって、自分の手順や判断基準をファイルとして移植できるようになりました。汎用のAIを「自分の分身」として動かし、必要に応じて特定業務の固有能力を装着する。道具の性質が「賢いアシスタント」から「育てられる作業者」へ変わった段階です。

私自身のワークフローの起源も、ここにあります。Skillsが登場した2025年秋頃、「手順や判断基準をファイルで持たせられるなら、自分の仕事の進め方ごと移植できるのではないか」と考えて作ったのが、本書のシステムの前身です。以来、案件のたびに育て続けて、現在の形に至ります。つまり本書でお渡しするのは、第3世代の到来とともに生まれ、実案件の中で約半年以上鍛えられてきた仕組みです。

そして第4世代——エージェントが複数のエージェントを率いて並行作業し、人間の仕事は「区切りを宣言すること」と「異常に気づくこと」へ寄っていく形——が、本書の主戦場です。業界全体としてはまだ入り口の段階ですが、私の現在の運用はすでにこの形が日常です。コードレビューは同梱スキルの multi-angle-review が複数のサブエージェントを率いて並行実行し、私はラウンドごとの承認と、明らかにおかしい挙動の検知だけを受け持ちます（第7章で扱います）。第3世代で作った「分身」が、第4世代では編成を率いる側に回る——前身から半年あまりの進化は、そのまま世代の階段でした。

この地図を置いた理由は2つあります。第一に、多くの人は、第2世代の使い方のまま第3世代のツールを使っています。実案件に入れて崩れた経験があるなら、それはあなたの壁打ちが下手だからではありません。世代に合った運用をしていないだけです。プロンプトの巧拙の問題ではない——この見立ては、これから見ていく3つの破綻の構造とも一致します。第二に、本書は第3世代に生まれ、第4世代を主戦場とする運用書です。その中身——手順・規約・記録をAIが読めるファイルに固定すること——は、読む主体が1体のエージェントからエージェント群に増えるほど、むしろ効いてきます。土台を整えた人から順に、次の世代へ進めます。

では、世代に合っていない運用——場当たりプロンプト——のまま実案件に入ると、何が起きるのか。3つの破綻を順に見ていきます。

1-3. 破綻その1 — 「AI流のコード」が増えるほど、自分が関与できなくなる

何も指定せずにAIへコーディングを任せると、出てくるのは「AI流」のコードです。誤解のないように言うと、AI流のコードは下手ではありません。動きますし、命名もそれなりに整っています。だから最初は問題に見えないのです。

問題が表面化するのは、書かせたときではなく直すときです。実案件では、初稿の後に修正・追加・クライアント対応が何往復も続きます。その修正の場面で、AI流のコードは「他人のコード」として目の前に現れます。クラス命名の体系が自分と違う。レイアウトの組み方が違う。ファイルの分け方が違う。どこを直せばいいかを毎回読み解くところから始めることになります。

コード量が少ないうちは「読めば分かる」で済みます。しかし案件が進むほどコードベースは自分の知らない書き方で埋まっていき、読み解きのコストは膨らみ続け、やがて「修正箇所をAIに聞かないと自分のプロジェクトを触れない」状態に行き着きます。納品物に最終責任を負うのは自分なのに、その中身を自分の言葉で説明できない。私はこれをコントロールの喪失と呼んでいます。実案件において、これは品質の問題である以前に、職業上の危機です。

念のため付け加えると、「毎回レビューして直せばいい」は答えになりません。AI流のコードのレビューは、毎回が他人のコードレビューです。AIに任せて浮いたはずの時間が、読み解きとレビューに吸われていく。これが破綻その1の正体です。

1-4. 破綻その2 — セッションが切れるたび、プロジェクトの記憶が消える

2つ目は、もっと物理的な破綻です。Claudeの記憶は、セッションの外に持ち出せません。

Claudeが一度に扱えるコンテキストには上限があります。長く作業すれば必ず限界が来て、コンテキストが圧縮されれば細部は失われ、セッションを終了すればすべてが消えます。昨日3時間かけて伝えた案件の背景、一緒に決めた設計方針、「この書き方はNG」と修正させたやり取り——翌朝の新しいセッションのClaudeは、その一切を覚えていません。

場当たり運用での対処は「毎回説明し直す」です。要件をまた貼り、規約をまた伝え、現状をまた要約する。最初の数回はやれます。しかし案件の文脈は進むほど積み上がるので、説明し直しのコストも進むほど膨らみます。やがて説明が雑になり、雑になった分だけAIの出力が文脈を外し、その手直しにまた時間が消える。

私の実例をひとつだけ挙げます。公開中のプラグイン NanameFit の開発中、最大のバグと格闘していた時期の記録に、こんな一行が残っています——「前セッションの途中段階では正常だった（ユーザー証言）。そのときのコードは保存なし」。一度は動いていたのです。しかしセッションが変わった時点で、「動いていたときに何をしていたか」をClaudeは覚えておらず、人間の側にも曖昧な記憶しかない。結果、解決済みだったはずの地点まで、試行錯誤をまるごとやり直しました。セッションは必ず切れます。これは工夫で回避できる類の問題ではなく、前提として設計に織り込むべき制約です（対策は第5章で、この一件の顛末は第8章で扱います）。

補足しておくと、現在はClaude Codeのメモリ機能などで、この問題の一部はカバーできるようになっています。それでも本質は変わりません。前セッションの「分身」を、いかに効率よく新しいセッションに呼び起こすか——問題の核心はそこにあり、機能の進化は手段が増えたという話です。だから本書の対策も、この核心に向けて組んでいます。

1-5. 破綻その3 — 口頭ルールは蓄積しない。逸脱だけが蓄積する

3つ目は、1つ目と2つ目の合わせ技で、いちばん気づきにくい破綻です。

案件には決まりごとが増えていきます。「この案件はタブレットをPC扱いにするのでブレークポイントは1024px」「imgタグに直接スタイルをあてない」「この案件はgulp + EJS」。場当たり運用では、これらをその都度チャットで伝えます。伝えれば、そのセッションの間は守られます。しかし破綻その2で見たとおり、セッションが変わればルールも消えます。チャットでの指示は、蓄積しないのです。

すると何が起きるか。セッションごとに「伝え忘れたルール」が少しずつ破られます。あるセッションでは命名規則が守られ、別のセッションでは破られる。火曜のコードと木曜のコードで単位の書き方が違う。一つひとつは小さな逸脱ですが、納品物の上では一貫性の崩壊として蓄積していきます。しかも逸脱はコードベースに残り続けるので、後から入る修正はその逸脱を「既存の書き方」として踏襲し、崩れが崩れを呼びます。

これに気づいた人が次にやるのは、たいてい「全部書いた巨大な指示書を毎回読み込ませる」ことです。私もやりました。これは半分だけ正しく、新しい問題を2つ連れてきます。まず、読み込ませる指示を忘れたセッションでは全ルールが無効になる。次に、運用ルールもコーディング規約も案件固有の決定事項も1か所に混在するため、ファイルは太り続け、すでに寿命の切れたルールが残り、関係ない場面でも全文が読み込まれ、本当に守ってほしいルールが埋もれていく。指示には「寿命」と「適用範囲」という性質の違いがあり、それを無視して1枚に書くこと自体が次の破綻の種になります（この整理が第2章の主題です）。

1-6. 3つの破綻に共通する構造 — 解決の方向は「仕組み化」

並べてみると、3つの破綻は同じ構造をしています。

AI流コード — 失われるもの: 修正の見極めとコントロール／原因: 「自分の書き方」を毎回口頭で伝えている（または伝えていない）
文脈喪失 — 失われるもの: プロジェクトの記憶／原因: 記憶をセッションの中にしか置いていない
規約逸脱の蓄積 — 失われるもの: 納品物の一貫性／原因: ルールをチャットという揮発する場所に置いている

共通点は明白です。渡すべき情報を、毎回その場で、揮発する場所（チャット）に渡している。 AIの性能の問題でも、プロンプトの巧拙の問題でもありません。だから解決の方向も、「もっと上手いプロンプトを書く」ではありません。毎回伝えるべきことを、AIが自動で読む場所にファイルとして固定する——つまり仕組み化です。

具体的には、こうなります。自分のコードの癖は、対象ファイルを扱うとき自動で適用されるルールファイルに固定する（破綻その1への対策）。プロジェクトの記憶は、AI自身に進捗ファイルとして書き残させ、次のセッションで読ませる（破綻その2への対策）。常時守るべき運用ルールは、起動時に自動で読み込まれる場所に置き、案件固有の決定事項は案件と一緒に捨てられる場所に蓄積する(破綻その3への対策)。

この「固定する場所」の設計図が、CLAUDE.md / rules / skills の3層アーキテクチャです。私はこれを理屈から導いたのではなく、3つの破綻を順番に食らいながら、対策を1つずつ足していった結果としてこの形に着地しました。次の第2章で、その全体設計——なぜ3層なのか、それぞれの層に何を置き、何を置いてはいけないのか——を説明します。

この章のチェックリスト

「場当たりプロンプト」が単発タスクでは最速で、実案件では破綻する理由を説明できる
AIコーディングの世代整理（第1〜第4世代）で、自分のいまの運用がどの世代にあたるかを言える
破綻その1: AI流のコードが「直すとき」に他人のコードになり、進むほどコントロールを失う構造を理解した
破綻その2: セッションの記憶は持ち出せず、必ず消えることを前提として受け入れた
破綻その3: チャットの指示は蓄積せず、逸脱だけが納品物に蓄積することを理解した
「巨大な指示書1枚」が解決にならない理由（読み込み忘れ・寿命と適用範囲の混在）を説明できる
解決の方向が「上手いプロンプト」ではなく「AIが自動で読む場所への固定＝仕組み化」だと理解した

レビュー特典

本教材のレビューを投稿してくださった方に、特典として導入チェックリスト拡張版（30分導入の完全チェックリスト、Markdown/PDF）をお渡しします。導入前の確認から、30分導入の全手順、導入後1週間の運用、月次メンテナンスまでを、本文の参照章節付きのチェックボックス形式にまとめたものです。

受け取り方法: レビュー投稿後、X（@tagcatman1）のDMへレビュー画面のスクリーンショットを送付してください。確認のうえ、特典の配布リンクを返信します
良い評価をお願いするものではありません。率直な感想で構いません。

紹介について

本教材はアフィリエイト報酬を50%に設定しています。紹介してくださる場合のお願いはひとつだけです——本教材が約束していないこと（収益・時短の保証）を、紹介文で約束しないでください。「誰でも」「絶対」「月◯万」といった表現を使った紹介を確認した場合、以後の承認をお断りすることがあります。教材の信頼性は紹介文も含めて成立すると考えています。