Claude Code を製品開発のために整理する方法
How to organize Claude Code for product work (theaithinker.com)
要約
この記事は、Claude Code を製品開発で効果的に活用するための実践的なシステムを提案しています。主なポイントは、コードそのものよりも、ファイルやコンテキストの整理が重要であるという点です。具体的には、変更頻度でファイルをソートし、繰り返し作業をスキル化し、修正を一度だけ記録するなどの方法が紹介されています。このシステムは、GitHubで公開されているスターターワークスペースを通じて提供され、技術的な知識がないユーザーでも導入できるよう説明されています。
全文翻訳
Claude Codeをプロダクトワークのために整理する方法
私のプロダクトジョブにおけるClaude Codeワークスペースは、ほとんどコードを含まないフォルダです。そこには、会社、プロダクト、ユーザー、競合他社、そして私の働き方に関するすべてを含むコンテキストフォルダがあります。プロジェクトごとに1つのフォルダがあり、タスクと成果物は分離されています。各スキルは、ステータスアップデート、PRDレビュー、面接の要約など、繰り返し行う作業を1つずつ実行します。一度フィードバックを与えると、その理由とともにファイルに記録され、二度とそのフィードバックを与えることはありません。このシステムを設計したわけではありません。ほとんどは、まず間違えることから始まり、そこからたどり着きました。
間違えることから学んだ教訓が、この記事全体を貫いています。基本的なことを超えると、Claude Codeでの成果は、プロンプトの良し悪しではなく、ファイリングの良し悪しに依存するようになります。 良いプロンプトは1回のセッションを改善しますが、良いファイルはそれ以降のすべてのセッションを改善します。あなたがすでに読んだプロンプトチューニングのアドバイスは、ファイリングが重要になり始めるまさにその地点で役立たなくなります。
そこで、私のシステムを説明する代わりに、パッケージ化しました。スターターワークスペースはGitHubで公開されています。フォルダ、コンテキストテンプレート、そして5つのPMスキルが含まれており、1回のセットアップインタビューでパーソナライズされます。 技術者である必要はありません。ツールのインストール方法を含め、すべてのステップが詳しく説明されています。私の例はプロダクトジョブですが、同じアーキテクチャはコンテキスト依存性の高いあらゆる作業に適用できます。例えば、デザインリードのリサーチライブラリ、データチームのメトリック定義、創業者向けのすべてを格納するフォルダなどです。
以下がそのルートです。
[
[画像: Alt: 手描きの4段階のマップ。ステップ1、スイッチ:チャットバブルがフォルダベースのワークスペースのために残されている。ステップ2、スターターワークスペース:セットアップスキルがコンテキストファイルを埋めるダウンロード済みのフォルダ。ステップ3、実践:システムを複利で増やす6つの動き。ステップ4、リズム:整理されたワークスペースを巡る一日の仕事。]
](https://substackcdn.com/image/fetch/$s_!_aKs!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F45d3febf-7b6f-4074-b6ce-5c3ef9c20523_2816x1536.png)
- スイッチ。 チャットモードとCoworkが提供できないもの、そしてプロダクトマネージャーにとってターミナルがなぜ価値があるのかを示します。
- スターターワークスペース。 ダウンロードし、1つのセットアップスキルを実行し、実際のタスクを与えます。各ステップは画面に表示されます。
- 実践。 システムを複利で増やす6つの動き。それぞれが正確なやるべきことと、それによって得られるものを明示します。
- リズム。 システム内で通常の仕事の一日をどのように過ごすか、最初の短いプロンプトから2分間のファイリング習慣までを示します。
その成果は具体的です。1回のセッションで実行可能になります。ツールをインストールし、ワークスペースをダウンロードし、セットアップインタビューに答え、最初の実際のタスクを渡します。あなたはセッションごとに会社の説明を繰り返す必要がなくなり、行ったすべての修正は永続化されます。 各ステップは以下にあります。
ファイリングキャビネットを開く時間です。
チャットモードが提供できないもの
おそらく、あなたは今日、Claudeのチャットを通じてプロダクトワークを行っているでしょう。ブラウザタブやデスクトップアプリ、エージェンティックなタスクにはCoworkを使っているかもしれません。それは機能しますが、まさにそれが落とし穴です。すべての会話はゼロから始まります。前回アップロードした戦略ドキュメントは消え、あなたが忍耐強く説明したコンテキストは、二度と見つけられないスレッドの中にあり、気に入った出力は会話の中に閉じ込められ、ファイルとして保存されません。チャットは思考するには素晴らしい場所ですが、蓄積するにはひどい場所です。 時折の質問にはそれで十分ですが、毎日のプロダクトワークでは、毎朝同じセットアップコストを支払うことになります。
Claude Codeは、異なるホームを持つ同じClaudeです。それはあなたのマシン上のフォルダであり、Claudeはそれを読み取り、ナビゲートし、書き込むことができます。コンテキストは永続化されるファイルに存在します。繰り返し行う作業は、コマンドで実行できるスキルとして存在します。出力は、探すメッセージではなく、保存しておくドキュメントとして着地します。私の日常的な使用では、かつてチャットやCoworkで行っていたことはすべて、ここでより良く実行されます。なぜなら、何も二度説明する必要がないからです。 これは私自身の仕事からの観察であり、法則ではありませんが、数ヶ月間続いています。
私の仕事を実際に変えた部分は、その下にあるターミナルです。Claude CodeはGitHubとネイティブに通信し、コネクタは不要です。会社のレポジトリを取得して質問に答えたり、あなたの作業をプッシュしたりできます。 あなたのプロダクトの背後にあるレポジトリを取得して、機能フラグが実際には何をするのか説明するように依頼してください。ワークスペースをプライベートレポジトリにプッシュすれば、チームメイトがそれをクローンしてあなたの先行投資を引き継ぐことができます。プロダクトマネージャーにとって、これはコードベースへの直接のアクセスであり、あなたのシステム全体を共有する方法であり、チャットにはないものです。
誰もあなたに提供してくれないのは、これらすべてを複利で増やすためのファイリングシステムです。Anthropicのベストプラクティスガイドは、その言葉を借りれば「エンジニアがさまざまなコードベース、言語、環境でClaude Codeを使用するため」に書かれており、エンジニアは構造を無料で手に入れます。コードベースはすでに整理されたコンテキストです。存在するPM向けのガイド、特に有名なSachin Rekhi氏のものは、「すべてのプロダクトデータとドキュメントをローカルのMarkdownファイルに保存する」ように正しく指示し、その後進みます。どのように整理するのでしょうか?答えなしで試してみてください。私が経験したような、40個のバラバラのファイルと時代遅れのセットアップになります。スターターワークスペースがその答えであり、事前に構築されています。 セットアップしましょう。
スターターワークスペースから始める
スターターワークスペースは、私が自身のプロダクトワークで使用している構造をクリーンアップしてテンプレート化したものです。フォルダ、ガイド付きプレースホルダー付きのコンテキストファイル、サンプルプロジェクト、そしてすでにインストールされている5つのスキルが含まれています。すべて無料かつ公開されています。claude-code-pm-starter。 6つのステップで、何も無い状態から最初の実際のタスクまで進むことができ、どのステップも技術的な背景を想定していません。
[
[画像: 6つの番号付きステップの手描きの水平フロー。ステップ1:VS Codeをインストール。ステップ2:GitHubからワークスペースをZIPとしてダウンロード。ステップ3:ターミナルを右側に配置してVS Codeでフォルダを開く。ステップ4:最初のコマンドを学ぶ。ステップ5:セットアップスキルを実行し、コンテキストファイルを埋める短いインタビューとして表示。ステップ6:実際のタスクを与え、タスクファイルからドラフトされたステータスアップデートとして表示。]
](https://substackcdn.com/image/fetch/$s_!4ps3!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F2ca0d31e-ffb0-463c-b2ba-ec0228360f23_2816x1536.png)
開始前に前提条件を1つ。Claude Codeを使用するには、有料のClaudeプランが必要です。それ以外のすべて、インストールする2つのツールを含め、無料であり、ステップでカバーされています。
ステップ1:VS Codeをインストール
Claude Codeはターミナルで実行されますが、ターミナルだけではプロダクトマネージャーにとって悪い環境です。ファイルが見えません。その修正はIDEです。IDEは、作業中にフォルダをファイルのパネルとして表示するエディターにすぎません。開発者は一日中その中で生活しており、あなたはファイルパネルのためだけにそれを借用します。 無料の標準であるVS Codeをダウンロードし、通常のアプリのようにインストールしてください。コードを書くことはありません。左側のパネルでワークスペースが整理されていくのを見るでしょう。これは、チャットモードがこれまで提供してくれなかった可視性です。
[
[画像: VS Codeのダウンロードページのスナップショットで、ユーザーのオペレーティングシステム用のダウンロードボタンが強調表示されています。]
](https://substackcdn.com/image/fetch/$s_!KCdC!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F1f23c42e-bc65-40a2-9fcb-0ae3e7d9555d_3248x1966.png)
VS Code:無料、そしてその一部しか使いません。
ステップ2:ワークスペースをダウンロード
リポジトリページを開き、緑色のCodeボタンをクリックし、Download ZIPを選択します。gitもアカウントも不要です。解凍して、作業ファイルを保存している場所にフォルダを移動してください。このフォルダは、あなたのプロダクトワークの場所になろうとしています。 なので、後で見つけやすい場所、例えばホームディレクトリのworkフォルダなどを選んでください。
[
[画像: GitHub上のclaude-code-pm-starterリポジトリのスナップショット。緑色のCodeボタンが展開され、ドロップダウンの下部にあるDownload ZIPオプションが強調表示されています。]
](https://substackcdn.com/image/fetch/$s_!NG7z!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd3611772-710a-489f-abc8-9f4cd94c0a8a_3248x1966.png)
緑色のCodeボタン、次にDownload ZIP。gitは不要です。
[
[画像: macOS Finderウィンドウで、Documents内のWorkフォルダにある解凍済みのclaude-code-pm-starter-mainフォルダが表示されています。次の列には、CLAUDE.md、context、LICENSE、operations、projects、README.mdといった内容が表示されています。]
](https://substackcdn.com/image/fetch/$s_!I6BC!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9fcababb-8284-4f75-8bfa-286f309047df_2064x1096.png)
解凍して整理済み:Workフォルダ内のスターターフォルダ、準備完了。
ステップ3:VS Codeで開き、ターミナルを右側に配置
VS Codeを開き、File > Open Folderを選択して、解凍したフォルダを選びます。左側のパネルに全体の構造が表示されます。context/、projects/、operations/、そしてスキルです。次に、Terminal > New TerminalでVS Code内にターミナルを開き、全体の感覚を変える小さなトリックがあります。ターミナルパネルのヘッダーを右クリックしてMove Panel Rightを選択します。左側にファイル、右側にエージェント:コマンドラインという感覚がなくなり、書類の隣に座る同僚のような感覚になります。
[
[画像: VS Codeでスターターワークスペースが開かれています。左側のエクスプローラーパネルには、5つのスキルを含む.claude/skillsフォルダ、そしてcontext、operations、projects、CLAUDE.md、LICENSE、README.mdが表示されています。CLAUDE.mdマップファイルが開かれており、Where things live(物事がどこにあるか)とRules for every session(セッションごとのルール)のセクションが表示されています。]
](https://substackcdn.com/image/fetch/$s_!UeAe!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F604f369a-a060-4b2e-ab55-b293d30d6ec9_3248x1966.png)
全体の構造がようやく表示されました:スキル、コンテキスト、オペレーション、プロジェクト、そしてマップ。
[
[画像: VS Codeでターミナルパネルが下部に開かれています。コンテキストメニューが展開され、Panel Positionが選択されており、Rightオプションが強調表示され、ターミナルがウィンドウの右側に移動しようとしています。]
](https://substackcdn.com/image/fetch/$s_!rMmP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F81f6c603-abfb-4adf-9073-c379b9c12f50_3248x1966.png)
トリック:パネルを右クリックし、Move Panel Right。
まだClaude Codeを持っていない場合は、公式ガイドから今すぐインストールしてください。それはターミナルに貼り付ける1つのコマンドです。その後、claudeと入力してEnterキーを押します。Claude Codeはそのフォルダ内で開始され、マップファイルを読み取り、最初のメッセージからすべてがどこにあるかを知っています。
[
[画像: VS Codeのスナップショット。左側のエクスプローラーパネルには、スターターワークスペースのフォルダ(context、projects、operations、skillsディレクトリ)が表示されています。右側では、ターミナルパネルが垂直位置に移動されており、Claude Codeが実行中で、ウェルカムプロンプトが表示されています。]
](https://substackcdn.com/image/fetch/$s_!3ss8!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa50775f9-eacb-43f6-bd6d-6d6c8095962d_3248x1966.png)
左にファイル、右にエージェント。
ステップ4:挨拶をして、4つのコマンドを学ぶ
1つの区別が、初心者の多くの混乱を救います。ターミナルは正確なコマンドを求めますが、Claudeは通常の言語を求めます。 claudeと入力する前は、ターミナルと話していました。そこではスペルと構文が重要でした。Claude Codeが実行されている今は、チャットアプリと同じようにClaudeと話しています。ですから、自然な最初のことをしてください。挨拶をして、このフォルダで何が見えるか尋ねてください。それは、あなたのファイルを読んだばかりの同僚のように答えるでしょう。
いくつかスラッシュコマンドを知っておくと役立ちます。初日からClaude Codeに直接入力できます。
/model- 現在実行中のClaudeモデルを表示し、切り替えることができます。/effort- Claudeが各回答にどれだけの思考を費やすかを設定します。難しい作業には高い努力、簡単なドラフトには低い努力を。/mcp- Jira、Slack、Confluenceなどのツールへのライブ接続であるMCP(Managed Connections and Processes)をリスト表示し、管理できます。/plugins- プラグインシステムを開きます。これは少し時間をかける価値があります。Claude Codeには、Anthropicのプラグインディレクトリがデフォルトで利用可能であり、マーケットプレイスを追加することもできます。プロダクトマネージャー専用のプラグインが1つあります。pm-skillsは、ディスカバリー、戦略、実行、ローンチにわたる100以上のPMスキルを提供します。そのREADMEには最新のインストール手順があります。pm-executionはPRD、OKR、ロードマップ、レトロスペクティブをカバーし、pm-product-discoveryはインタビューと仮説検証を追加します。9つすべてではなく、あなたの仕事に合った2〜3個をインストールしてください。インストールされた各プラグインは、システムが持つコンテキストです。
[
[画像: VS CodeでClaude Codeが右側のターミナルで実行されています。プラグインパネルがMarketplacesタブで開かれており、公式のAnthropicマーケットプレイスに276個のプラグインが利用可能であることが表示され、追加するためのAdd Marketplaceオプションがあります。]
](https://substackcdn.com/image/fetch/$s_!s2aB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Febd8327d-2659-4edd-a1e7-671fe0fe0244_3248x1966.png)
プラグインパネル:Anthropicのマーケットプレイスがデフォルトで利用可能です。
さらに1つのコントロール、そしてツアーは終了です。Shift+Tabを押して、Claude Codeの3つのモードを切り替えます。
- デフォルトモード:ファイルを操作する前に許可を求めます。
- 自動承認:確認なしで編集を適用します。
- プランモード:覚えておくべきモードです。Claudeは調査し、計画を提案し、あなたが承認するまで何も変更されません。
デフォルトで開始し、大きな作業にはプランモードを使用し、信頼できるようになった作業には自動承認を保存してください。 これら以外のすべてについては、このコミュニティチートシートが私が見つけた最高のワンページリファレンスです。
[
[画像: VS CodeでClaude Codeが実行されているスナップショット。ユーザーはHelloと入力し、Claudeはファイルを読んだばかりの同僚のように応答しました。ワークスペースのフォルダ(安定した知識のためのcontext、アクティブな作業のためのprojects、日付付きのメモのためのoperations)を名前で挙げ、今日何をするか尋ねています。]
](https://substackcdn.com/image/fetch/$s_!AnGU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F93e947cc-f0ef-4dda-b7bd-0047a8455a72_3248x1966.png)
まず挨拶をしてください。コマンドは少し待っても大丈夫です。
ステップ5:セットアップスキルを実行
/setup-workspaceと入力してEnterキーを押します。ワークスペースには、テンプレートをパーソナライズすることだけを目的としたスキルが付属しています。それは、あなたの会社、プロダクト、ユーザー、そしてあなたの働き方についてあなたにインタビューし、コンテキストファイルを埋め、サンプルプロジェクトをあなたの最もアクティブな実際のプロジェクトにリネームします。平易な言葉で答えてください。スキルが記述し、各ファイルを「はい」または「修正」のために表示します。
記憶から答える必要はありません。リンクを貼り付けてください。 あなたのプロダクトの公開サイト、ドキュメントページ、または前のステップでAtlassian MCPを接続した場合は、チームに関するConfluenceページを渡してください。スキルはそれらを読み取り、すでに書かれている内容からコンテキストファイルを構築します。この15分間の作業は、白紙の問題を完全に置き換えます。あなたの具体的な質問は私のものとは少し異なるでしょう。これらのモデルは予測不可能なものです。まだ知らないことは何でもスキップしてください。正直なプレースホルダーは、捏造されたコンテンツよりも優れています。
[
[画像: Claude Codeでセットアップワークスペーススキルがインタビューの途中で実行されているスナップショット。スキルは、スキップが有効な回答である短いインタビューを発表し、会社に関する最初の質問を平易な言葉で尋ねています。ユーザーはリンクを貼り付けた回答を入力しています。]
](https://substackcdn.com/image/fetch/$s_!UqFl!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fef0d9609-b9b6-4657-a849-821acc9bbd21_3248x1966.png)
平易な言葉で答えるか、リンクを貼り付けて読ませてください。
ステップ6:実際のタスクを与える
最初のセッションをセットアップで終わらせないでください。誰かに約束している実際のことを渡してください。/status-updateと入力し、メモリではなくプロジェクトのタスクファイルからアップデートをドラフトするのを見てください。または、実際の成果物を指定してください。
[あなたのプロジェクト]のキックオフブリーフをドラフトしてください。
context/preferences.mdにある私のライティングの好みに合わせてください。結論を出す前に、プロジェクトのtasks.mdにある未解決の質問を確認してください。
あなたらしく聞こえる最初の出力、あなたのプロダクトに関する、あなたのプロジェクトの実際の状態が含まれた出力は、ファイリングが機能する瞬間です。 他に3つのスキルがフォルダにあります。次のドキュメントにハードなレビューをしてもらいたい場合はprd-review、次のユーザーとの会話にはinterview-synthesis、そしてあなたの修正を永続化するfile-feedbackです。
[
[画像: Claude Codeでステータスアップデートスキルが実行されているスナップショット。ワークスペースの状態を読み取ったと報告し、このアップデートは誰向けか尋ね、オーディエンスの選択肢を提供しています:役員またはリーダーシップ、私のマネージャー、クロスファンクショナルチーム、または幅広いステークホルダー。
](https://substackcdn.com/image/fetch/$s_!YnQU!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F3cf34536-d8c6-4c95-a33e-87e154bb4023_3248x1966.png)
スキルはまずワークスペースの状態を読み取り、その後誰向けのアップデートか尋ねます。
それが始まりです。1回のセッションで動作するシステムが完成します。それが複利で増えるのは、どのように情報を与えるかであり、それは6つの実践です。
6つの実践でさらに進む
スターター構造は、私がそれぞれを間違えることから収束した実践をエンコードしています。これらは従うべき方法論ではなく、その場に残り続けた動きです。 以下の各項目は、具体的なやるべきことと、それによって得られるものを明示しています。最初のものがエンジンであり、残りは方向を定めます。
すべてのタスク、毎日使用する
最も高いリターンをもたらす習慣は、最も単純に言えます:すべてに対してワークスペースをデフォルトにする。 タスクが発生するたびに、たとえチャットの方が速く感じても、ワークスペースを開いてClaude Codeで実行してください。新しい種類のタスクの最初の実行は、時間がかかることを認めます。説明し、修正し、調整します。 しかし、すべての説明はファイルに記録されるため、2回目の実行は先行し、3回目はほとんどあなたを必要としません。インターンを教えるようなものです。最初の委任は午後の時間を奪いますが、その後、仕事は完了して戻ってきます。 チャットモードで保持されたタスクはシステムに何も教えませんが、ワークスペースで実行された同じタスクは、繰り返しのたびに利益を生む投資です。
この習慣には締めくくりの動きがあり、それが複利が実際に起こる場所です。タスクが完了し、結果に満足したら、ターミナルを閉じるだけではありません。Claudeに学んだことを記録するように依頼してください。 完了したタスクを、繰り返される場合はスキルに変換し、新しい事実をコンテキストファイルに確認し、途中で行ったフィードバックを好みのファイルに更新します。私はほとんどその言葉で言います。「これで終わりです。これをスキルにして、私がした修正をファイルしてください。」タスクの終わりのその一文は、あなたが使うツールと学習するシステムの違いです。
[
[画像: 同じタスクが3回実行される手描きのループ。最初のパス:長い矢印で、修正と説明がコンテキスト、スキル、好みにファイルされる。2回目のパス:短い矢印、少ない修正。3回目のパス:完了とラベル付けされた短いクリーンな矢印。小さなキャプション:「最初の実行は投資です。」と書かれています。]
](https://substackcdn.com/image/fetch/$s_!plXG!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F6ceac735-4725-4938-90c8-7964d232c09c_2816x1536.png)
ファイルは変化の速さでソートする
整理の質問は私を驚かせました。「これはどのトピックに属するか?」ではありません。「これはどれくらいの速さで変化するか?」です。あなたの仕事のすべてには速度があります。あなたのプロダクトのポジショニングはほとんど動きません。ステータスサマリーは約1週間持続します。チケットキューは時間単位で変化します。変化の速さで物をファイルすれば、古いものが新しいものを装うことはできません。 トピックでファイルすると、古い真実が現在の真実の隣に並び、同じように見えます。
ワークスペースの3つのフォルダは、3つの速度です。 具体的な習慣:次に取る会議のメモは、ファイル名に日付を付けてoperations/に保存し、プロダクトについて繰り返し入力する段落はcontext/product.mdに保存します。メモは書いた日に真実だったので、日付はClaudeが読み取るファイル名に移動します。ポジショニングの段落は、あなたが変更するまで真実なので、すべてのセッションがロードできる場所にあります。プロジェクトはこれら2つの速度の間に位置するため、各プロジェクトフォルダはtasks.mdとbrief.mdを分割します。
3つ目の速度があり、それはすでにあなたが所有しています。
[
[画像: 「時間単位で変化する」から「常に真実」までの手描きの水平スペクトル。速い端には、チケット、分析、Slackを取得するMCP接続があります。中央には、会議のメモやステータスサマリーなどの日付付きファイルがあります。遅い端には、プロダクト、ユーザー、戦略に関する安定したコンテキストファイルがあります。ゾーンの間に警告があります:安定したファイルに貼り付けられたライブデータは古くなります。]
](https://substackcdn.com/image/fetch/$s_!JdWA!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F371dc2ae-09f6-4852-93a2-bac3d2397dac_2816x1536.png)
MCP(ステップ4で説明したライブ接続)はスペクトルの速い端に位置します。これらは時間単位で変化するもの用です。ファイルはゆっくり変化するもの用です。安定した真実をセッションごとに再取得するためにMCPを使用している場合、ファイルがそれを所有すべきです。もしライブデータをコンテキストファイルに貼り付けているなら、MCPがそれを所有すべきです。 もしあなたがPARA(Tiago Forte氏のファイリング方法)を使用したことがあるなら、これはそれに似ていますが、1つの違いがあります。PARAは実行可能性でソートします。なぜなら、人間の失敗モードは行動すべきことを見失うことだからです。このシステムは変化率でソートします。なぜなら、LLMの失敗モードは、自信を持って再利用される古いコンテキストだからです。
Claudeにマップを管理させる
CLAUDE.mdは、すべてのセッションがロードする唯一のファイルです。あなたが誰であるか、どこに何があるか、そして常に適用されるいくつかのルールを示すマップです。正直な実践はこうです:あなたはそれを手でほとんど触りません。 既存のフォルダを整理している場合、またはスターターワークスペースを使用していない場合、/initコマンドがそれを生成します。Claudeはフォルダをスキャンし、マップ自体を書き込みます。それ以降、メンテナンスは副作用として発生します。スキルやコンテキストファイルを追加すると、Claudeはそれに合わせてマップを更新し、あなたの仕事は「はい」と言うだけです。
知っておくべき唯一のことは、なぜマップが小さく保たれるかです。それは関連性がなくてもすべてのセッションにロードされるため、各行はAnthropicのコンテキストエンジニアリングに関する投稿が「アテンションバジェット」と呼ぶものを少し消費します。彼らのドキュメントは200行未満を目標とし、肥大化したファイルはClaudeが実際の指示を無視する原因になると警告しています。マップはポインタであり、ファイルがコンテンツを運びます。知識はcontext/にあり、タスクが必要とする場合にのみロードされます。 このジャストインタイムの原則については、CoworkでチームのためのAIヘルパーを構築する方法で書きました。ここでは、Claudeがあなたのためにそれを適用します。
[
[画像: 手描きの分割画像。左側、打ち消し線付き:すべてのルール、好み、プロダクトの事実が詰め込まれた巨大な手動ページ。右側:3つのジョブがリストされた小さなマップページ、会社、ユーザー、プロジェクトの個別のラベル付きファイルへの矢印があり、それぞれが必要なときにのみロードされます。]
](https://substackcdn.com/image/fetch/$s_!_H1v!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Ff016fbd8-81c1-4148-b510-a0828b0762f9_2816x1536.png)
繰り返し行う作業をスキルに変換する
この実践について、私は数ヶ月間疑念を抱いていました。私の習慣は、繰り返される作業を見るたびに、それがスキルになるかどうかを尋ねることです。そうすれば、一度フィードバックを与えれば、二度とその作業をやり直す必要がなくなります。それは生産的に感じられましたが、スキルとファイルの境界線について、プロダクト担当者向けに書かれたものがないため、それが正しいかどうか確信が持てませんでした。それを決定づけたテスト:名詞はファイルに、動詞はスキルに。 Claudeが知る必要があるのは名詞です。プロダクトの事実、ユーザーセグメント、用語などはcontext/にあります。Claudeが実行する必要があるのは動詞です。ドラフト、レビュー、要約など、それぞれがスキルです。
実際には、スキルは最初の実践の締めくくりの動きから生まれます。タスクを終え、満足したら、Claudeに一緒に行ったことをスキルに変換するように依頼します。 ワークスペースのstatus-updateスキルは、それがどのようなものかを示しています。どこから読み取るか、出力の形状、どのような品質基準をチェックするか。ステップ、品質基準、出力形式:それがスキルがエンコードするものであり、「ロードマップレビューの準備」や「チャーンダイジェスト」は適格ですが、「あの奇妙なエスカレーション」はそうではありません。もし自分でゼロからスキルを構築したい場合は、最初のClaude Codeスキルを構築する方法でステップバイステップで説明しています。
このテストは、物が間違った引き出しに入れられる2つの方法も捕捉します。
[
[画像: 手描きの決定分岐。上部には、「アシスタントが知る必要があるものか、それとも実行する必要があるものか?」という質問があります。知る(know)の分岐は、プロダクトの事実、ユーザーセグメント、用語などのコンテキストファイルにつながります。実行する(do)の分岐は、ステップ、品質基準、出力形式を持つスキルにつながります。2つの不一致が打ち消し線で示されています:事実しか保持しないスキル、コンテキストファイル内のメモとして書かれた手順。]
](https://substackcdn.com/image/fetch/$s_!OW3z!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F268e2f75-4725-4aa2-a14a-c662c56538e4_2816x1536.png)
最初の不一致は、実際には事実のバケットである「スキル」です。スキルの服を着たプロダクトコンテキストで、何も実行しません。それはコンテキストファイルになります。逆は、コンテキストファイル内のメモとして書かれた手順です。例えば、誰も実行できない「レビューの実行方法」という段落です。文書化されているが実行不可能な手順は、結局また説明されることになり、それは全体の目的を損ないます。 それはスキルになります。知る/実行する(know/do)の分割は、ドキュメンテーションの実践が10年間どのように整理されてきたかを示しています(Diátaxisがそれを形式化しています)。スキルは「実行する」側を実行可能にするだけです。
すべての修正を一度だけファイルする
その瞬間はわかっています。Claudeがあなたのステータスアップデートをドラフトし、あなたは一度修正したのと同じフレーズを修正します。私の週ごとの作業を変えたリフレームはこうです:チャットで行われた修正は一時的であり、セッションが終わると消えます。 システムのコンパウンドリターンのすべては、修正を永続化することから来ており、ここで実践は整理から学習へと移行します。
最も簡単なバージョンから始めるのが良いでしょう。そして、この記事で最もリターンの高い編集です。context/preferences.mdを開き、あなたの書き方について3行書きます。文の長さ、ドキュメントの冒頭、禁止する単語など。 それ以降、Claudeがドラフトするすべてのドキュメントは、プレスリリースのようではなく、あなたのライティングの好みに合わせて出力されます。それは1回の修正で、一度ファイルされ、それ以降のすべてに適用されます。私の好みのファイルにある最も古いエントリは、私が二度と与える必要のない修正です。
最初の編集以降のすべてについて、ワークスペースにはファイリングを自動で行うスキルが付属しています。あなたが何かを修正していることに気づいたら、/file-feedbackを実行してください。それは4つの質問で修正をルーティングします。
[
[画像: 手描きのループ。修正がチャットセッションから出て、連続する4つの質問を尋ねるルーターを通過します。一度きりのミスは「放っておく」として横に排出されます。不足している事実はコンテキストファイルに流れます。間違ったプロセスはスキルに流れます。味の問題は、理由のメモとともに好みのファイルに流れます。3つのファイルすべてから、矢印が将来のすべてのセッションにループバックします。]
](https://substackcdn.com/image/fetch/$s_!9FyG!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F4ee23dae-3bd2-499b-99c0-a86de5b74490_2816x1536.png)
一度きりのミスでしたか?放っておきましょう。すべてがファイルに値するわけではありません。事実の不足でしたか?対応するコンテキストファイルまたはプロジェクトのブリーフに保存されます。間違ったプロセスでしたか?修正はスキルに保存され、毎回正しく実行されます。好みでしたか?それは好みのエントリになります。そして、重要な詳細があります:各エントリには、その理由と適用方法の行があり、将来のセッションが盲目的にパターンマッチングするのではなく、エッジケースを判断できるようになります。
ベンダーもほぼ同じ言葉で同意していることがわかりました。Anthropicのメモリに関するドキュメントでは、「Claudeが同じ間違いを2回行った場合」または「前回セッションで入力したのと同じ修正または明確化をチャットに入力した場合」に書き留めるように指示しています。ベストプラクティスガイドは、1行でそのメリットを約束しています:「ファイルは時間の経過とともに価値を増します。」そこで、付箋に貼るならこのバージョンでしょう。そして、あなたのチームに渡す行はこうです:もし2回言ったなら、それはファイルに属します。
推測する前に尋ねる
最後の実践は、あなたのファイルではなく、あなたの頭の中にあるブロッカーを取り除きます。あなたは、技術的すぎる、長すぎる、チュートリアルが必要だ、エンジニアが必要だ、など、手が届かないものだと自分で決めつけていることに気づくでしょう。その動きは、まずClaude Codeに尋ね、その答えに驚かされることです。 私はAWS Amplify(Amazonのアプリ構築・ホスティングサービス)を試したかったのですが、私の反射神経は古いものでした。ガイドラインに従い、ドキュメントを読み、持っていない時間を予算化することです。代わりに、ドキュメントのリンクをClaude Codeに貼り付け、2つのことを依頼しました。サービスをテストするための動作するプロトタイプと、技術者でない人向けに書かれたステップバイステップガイドです。1回のセッションで、実際にリリースできるものと、理解して従えるガイドを手に入れました。 予算化した時間は決して使われませんでした。
同じ反射神経は、新しいツールだけでなく、あらゆる規模で適用されます。40ページの調査レポートを自分で要約する前に、尋ねてください。データに関する質問にアナリストが必要だと決めつける前に、尋ねてください。すべての途中ステップを確認する前に、制約とともにタスク全体を依頼し、代わりに結果を確認してください。最初の5つの実践を通じて構築したシステムは、まさに質問を安価にするものです。 コンテキストはファイルされ、好みは知られており、間違った答えは修正のコストがかかります。そしてシステムはそれを保持します。6つの実践、1つのアーキテクチャ。これがどのように機能するかを見てみましょう。
ワークスペースを通して一日を回す
システム内での一日は、チャットするというよりは、まずファイルを読み取る非常に速い同僚と仕事をするようなものです。
[
[画像: 仕事の一日の手描きのタイムラインストリップ。開始:タスクファイルに状況が書かれているプロジェクトフォルダを開く。日中:目標を名前で示し、ファイルを指し示す短いプロンプト。セッション終了:3つの質問による2分間のファイリング習慣。時々:古いコンテンツを15分間整理する。]
](https://substackcdn.com/image/fetch/$s_!XLdg!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F228dde38-3b62-4bbd-a767-abe696a3426b_2816x1536.png)
セッションは、空白のチャットではなく、プロジェクトフォルダから始まります。VS Codeでワークスペースを開き、ターミナルでclaudeを起動すると、マップがロードされ、すべてのファイルパスが使用可能になります。前のセッションが更新したため、タスクファイルにはすでに状況、ブロックされていること、次に行うことが書かれています。最初のプロンプトは、目標を名前で示し、意図的にファイルを名前で指し示します。ファイリングが増えるにつれて、プロンプトは縮小します。 このシステムでの良いプロンプトは3つの部分からなります。1文での目標、譲れない制約、そして表示する前に確認すべきこと。約100語、しばしばそれ以下です。ステップはスキルにあり、背景はファイルにあり、プロンプトは指示するだけで済みます。より大きな作業のために、私は1つの動きを追加します。Shift+Tabでプランモードに切り替え、何も実行する前に計画を承認します。
すべてをまとめる習慣は、セッションの終わりに2分かかります。そしてfile-feedbackスキルがその大部分を担います。3つの質問:以前に修正したものを修正しましたか?ファイルされていない新しい事実が現れましたか?作業が繰り返されましたか?繰り返しの修正はルーターを通過します。繰り返される作業は次のスキルとしてノミネートされます。 答えが3つの「いいえ」の場合は、儀式をスキップします。これはほとんどのセッションです。
12セッションに1回程度、15分かけて整理しますが、これは最もオプションではない部分だと主張します。古いコンテキストは、欠落したコンテキストよりも悪い。 期限切れの競合他社のメモや時代遅れのポジショニングラインは、Claudeには古く見えません。それは新しい作業に自信を持って織り込まれ、Anthropicのベストプラクティスガイドは同様の警告を含んでいます:2つのルールが矛盾する場合、Claudeはどちらか一方を任意に選択する可能性があります。したがって、日付の付いたものは日付を付け、完了したプロジェクトはアーカイブし、引用されたくないものはすべて削除します。それがシステム全体です。残りはそれを開始することです。
ワークスペースに残りすべてを稼がせる
私にとって変わったのは、Claudeが賢くなったことではありません。それは、私が同じ会話を二度しなくなったことです。かつて私が再入力していた会社の説明はcontext/にあります。かつて私が繰り返していたフィードバックは、スキルと好みのファイルにあります。プロジェクトは中断したところから再開します。システムの真の製品は静かです。 より短いプロンプト、より少ない修正、私の職務記述書の最初からではなく、作業の途中から始まるセッションです。
この形式はプロダクトマネジメントを超えてよく旅行します。ディスカバリー中心のPMは、面接の要約を日付付きの出力としてファイルし、スキルに要約を行わせます。プラットフォームPMの安定したコンテキストは、APIコンシューマーとバージョンポリシーです。創業者は、メトリックファイルから供給されるスキルに投資家向けアップデートを変換します。デザインリードは、レビューごとに再説明するのではなく、批判基準を一度ファイルします。データリードのメトリック定義は、チームメイトのすべてのセッションが読み取るコンテキストファイルになります。異なる仕事、同じ3つの引き出し、同じ習慣。
野心的だと感じるよりも小さく始めてください。スターターワークスペースをダウンロードし、セットアップインタビューを実行し、あなたの書き方に関する3行を追加してください。そして、あなたの次のタスク、そしてその次のタスクを持ってきてください。次にClaude Codeに2回目を伝えていることに気づいたら、それがどこに行くべきか正確にわかるでしょう。 そしてすぐに、それを言った最後の時を覚えていないでしょう。
投稿はありません