HN 日本語サマリー

← 一覧へ戻る
AI・機械学習

Claude Code を製品開発のために整理する方法

How to organize Claude Code for product work (theaithinker.com)

27 pointsby adamfaik12 コメント

要約

この記事は、Claude Code を製品開発で効果的に活用するための実践的なシステムを提案しています。主なポイントは、コードそのものよりも、ファイルやコンテキストの整理が重要であるという点です。具体的には、変更頻度でファイルをソートし、繰り返し作業をスキル化し、修正を一度だけ記録するなどの方法が紹介されています。このシステムは、GitHubで公開されているスターターワークスペースを通じて提供され、技術的な知識がないユーザーでも導入できるよう説明されています。

全文翻訳

Claude Code を製品開発のために整理する方法 スターターワークスペースをダウンロードする。 セットアップスキルを実行する。 変更頻度でファイルをソートする。 繰り返し作業をスキル化する。 すべての修正を一度だけ記録する。 Adam Faik 2026年8月10日 3件の共有 私の製品開発のClaude Codeワークスペースは、ほとんどコードが含まれていないフォルダです。会社に関するすべて(製品、ユーザー、競合他社、私の働き方)を格納するコンテキストフォルダが含まれています。プロジェクトごとに1つのフォルダがあり、タスクは成果物から分離されています。それぞれの繰り返し作業を行うスキルセット(ステータスアップデート、PRDレビュー、面接の要約など)があります。一度フィードバックを与えると、その理由はメモと共にファイルに記録され、二度とそのフィードバックを与えることはありません。 このシステムを設計したのは私ではありません。主に間違った方法を試した結果、たどり着きました。 間違った方法から学んだ教訓が、この記事全体を貫いています。基本的なことを超えると、Claude Codeでの結果は、プロンプトの質ではなく、ファイルの整理の質に依存するようになります。良いプロンプトは1回のセッションを改善しますが、良いファイルはそれ以降のすべてのセッションを改善します。あなたが既に読んだプロンプトチューニングのアドバイスは、ファイルの整理が重要になり始めるまさにその時点で役立たなくなります。 そこで、私のシステムを説明する代わりに、パッケージ化しました。スターターワークスペースはGitHubで公開されています。フォルダ、コンテキストテンプレート、そして1回のセットアップインタビューでパーソナライズされる5つのPMスキルが含まれています。技術者でなくても理解できるように、ツールのインストール方法を含め、すべてのステップが詳しく説明されています。私の例は製品開発の仕事ですが、同じアーキテクチャは、デザインリードの研究ライブラリ、データチームのメトリック定義、創業者向けのすべてフォルダなど、コンテキストが豊富なあらゆる仕事に適合します。 以下がそのルートです。 スイッチ。チャットモードとCoworkが提供できないもの、そしてなぜターミナルがプロダクトマネージャーにとって価値があるのかを示します。 スターターワークスペース。ダウンロードし、1つのセットアップスキルを実行し、実際のタスクを与えます:画面に表示される6つのステップ。 プラクティス。システムを複利的に機能させる6つの動き。それぞれが正確な作業内容と得られる結果を明示します。 リズム。最初の短いプロンプトから2分間のファイル記録習慣まで、システム内での通常のワークデーの様子です。 成果は具体的です。1回のセッションで実行できます:ツールをインストールし、ワークスペースをダウンロードし、セットアップインタビューに答え、最初の実際のタスクを渡します。セッションごとに会社の説明を繰り返す必要がなくなり、行うすべての修正は永続的になります。すべてのステップは以下にあります。 ファイルキャビネットを開く時間です。 チャットモードが提供できないもの おそらく、あなたは今日、Claudeのチャットを通じて製品開発を行っているでしょう。ブラウザタブやデスクトップアプリ、エージェントタスクにはCoworkを使っているかもしれません。それは機能しますが、それがまさに落とし穴です。すべての会話はゼロから始まります。前回アップロードした戦略ドキュメントは消え、あなたが忍耐強く説明したコンテキストは、二度と見つけられないスレッドの中にあり、気に入った出力は会話の中に閉じ込められ、ファイルとして保存されません。チャットは考えるには良い場所ですが、蓄積するには悪い場所です。時折の質問にはそれで十分です。しかし、毎日の製品開発においては、毎朝同じセットアップコストを支払うことを意味します。 Claude Codeは、異なるホームを持つ同じClaudeです。それは、あなたが読み込み、ナビゲートし、書き込むことができるあなたのマシン上のフォルダです。コンテキストは永続的なファイルとして存在します。繰り返し作業は、コマンドで実行できるスキルとして存在します。出力は、スクロールして探すメッセージではなく、あなたが保持するドキュメントとして保存されます。私の日常的な使用では、かつてチャットやCoworkで行っていたすべてが、ここではより良く実行されます。なぜなら、何も二度説明する必要がないからです。これは私自身の仕事からの観察であり、法則ではありませんが、数ヶ月間続いています。 私の仕事を実際に変えた部分は、その下のターミナルです。Claude CodeはコネクタなしでGitHubとネイティブに通信できます。会社のレポジトリを取得してそれについて質問したり、自分の作業をプッシュしたりできます。製品の背後にあるレポジトリを取得して、フィーチャーフラグが実際何をするのか説明するように依頼してください。自分のワークスペースをプライベートレポジトリにプッシュすれば、チームメイトがそれをクローンしてあなたの先行体験を引き継ぐことができます。プロダクトマネージャーにとって、これはコードベースへの直接のラインであり、あなたのシステム全体を共有する方法であり、チャットにはどちらもありません。 誰もあなたに提供しないのは、これらすべてを複利的に機能させるファイルシステムです。Anthropicのベストプラクティスガイドは、その言葉を借りれば、「さまざまなコードベース、言語、環境でClaude Codeを使用するエンジニア向け」に書かれており、エンジニアは構造を無料で入手できます。コードベースは既に整理されたコンテキストです。存在するPMガイド(Sachin Rekhi氏のものが最もよく知られています)は、正しく「すべての製品データとドキュメントをローカルのMarkdownファイルに保存する」ように指示し、その後進みます。どのように整理するのでしょうか?答えがないまま試すと、私が経験したような状態になります。40個のバラバラのファイルと古いセットアップです。スターターワークスペースは、その答えであり、事前に構築されています。セットアップしましょう。 スターターワークスペースから始める スターターワークスペースは、私が自身の製品開発で使用している構造をテンプレートとして整理したものです。フォルダ、ガイド付きプレースホルダー付きのコンテキストファイル、サンプルプロジェクト、そして既にインストールされている5つのスキルが含まれています。すべて無料かつ公開されています:claude-code-pm-starter。6つのステップで、何も無い状態から最初の実際のタスクまで実行できます。どのステップも技術的なバックグラウンドを想定していません。 開始する前に、前提条件が1つあります。Claude Codeを使用するには、有料のClaudeプランが必要です。それ以外はすべて無料であり、インストールする2つのツールを含め、ステップでカバーされています。 ステップ1:VS Codeをインストールする Claude Codeはターミナルで実行されますが、ターミナルだけではプロダクトマネージャーにとって悪い環境です。ファイルが見えません。その解決策はIDEです。IDEは、作業中にフォルダをファイルのパネルとして表示するエディタにすぎません。開発者は一日中IDEを使用しており、あなたはファイルパネルのためだけにそれを借用します。無料の標準であるVS Codeをダウンロードし、他のアプリと同様にインストールします。コードを書くことはありません。左側のパネルでワークスペースが整理されていくのを見るだけです。これはチャットモードが決して提供してくれなかった可視性です。 VS Code:無料であり、その一部しか使用しません。 ステップ2:ワークスペースをダウンロードする リポジトリページを開き、緑色の「Code」ボタンをクリックし、「Download ZIP」を選択します。Gitやアカウントは不要です。解凍して、作業ファイルを保存している場所にフォルダを移動します。このフォルダは、あなたの製品開発の場になるので、後で見つけやすい場所、例えばホームディレクトリの「Work」フォルダなどに選びましょう。 緑色の「Code」ボタン、次に「Download ZIP」。Gitは不要です。 解凍して保存:ワークフォルダ内のスターターフォルダ、準備完了。 ステップ3:VS Codeで開き、ターミナルを右側に配置する VS Codeを開き、「File」>「Open Folder」を選択し、解凍したフォルダを選びます。左側のパネルに、コンテキスト/、プロジェクト/、オペレーション/、スキルなどの全体構造が表示されます。次に、VS Code内で「Terminal」>「New Terminal」でターミナルを開きます。ここで、全体的な感覚を変える小さなトリックがあります。ターミナルパネルのヘッダーを右クリックし、「Move Panel Right」を選択します。左側にファイル、右側にエージェント:コマンドラインのように感じなくなり、ドキュメントの隣に座っている同僚のように感じ始めます。 全体構造がようやく表示されました:スキル、コンテキスト、オペレーション、プロジェクト、そしてマップ。 トリック:パネルを右クリックし、「Move Panel Right」を選択します。 まだClaude Codeを持っていない場合は、公式ガイドから今すぐインストールしてください。それはターミナルに貼り付ける1つのコマンドです。その後、「claude」と入力してEnterキーを押します。Claude Codeはフォルダ内で起動し、マップファイルを読み込み、最初のメッセージからすべての場所を把握します。 左側にファイル、右側にエージェント。 ステップ4:挨拶し、4つのコマンドを学ぶ 初心者の混乱を避けるための1つの区別があります。ターミナルは正確なコマンドを求めますが、Claudeは通常の言語を求めます。claudeを入力する前は、ターミナルと話していました。そこではスペルと構文が重要でした。Claude Codeが実行されている今、あなたはチャットアプリと同じようにClaudeと話しています。ですから、自然な最初のことをしてください:helloと入力し、このフォルダで何が見えるか尋ねてください。それは、あなたのファイルを読んだばかりの同僚のように答えるでしょう。 数個のスラッシュコマンドは、初日に知っておくと便利です。Claude Codeに直接入力します:/model - s