メインコンテンツへスキップ
見出し画像

.claude/フォルダの正しい設計が2.4万人にブックマークされた件。Claude Codeで事業作るなら必読

    こんにちは、Tom(X: @0x__tom)です。

    やばいスレッドが海外でバズってる!

    「Claude Codeプロジェクトのセットアップ方法」という1つのツイートが、Xで12,000いいね、24,000ブックマークを獲得してて、ブックマーク数がいいねの2倍という異常値になってる。

    How to setup your Claude code project?

    TL;DR

    Most developers skip the setup and just start prompting. That's the mistake.

    A proper Claude Code project lives inside a .𝗰𝗹𝗮𝘂𝗱𝗲/ folder. Start with 𝗖𝗟𝗔𝗨𝗗𝗘.𝗺𝗱 as Claude's instruction manual. Split it into a 𝗿𝘂𝗹𝗲𝘀/… https://t.co/fCLQezoww8 pic.twitter.com/X8jT1pgrSX

    — Akshay 🚀 (@akshay_pachaar) March 22, 2026

    ブックマーク率が高いツイートは「後でちゃんと読み返したい実用情報」のサイン。つまり世界中のClaude Codeユーザーが「自分も.claude/フォルダをちゃんと設計しないとヤバい」って気づき始めてる。

    僕はポケモンエージェントを24時間稼働させて事業を自動運転してて、.claude/フォルダの設計が事業の成否を分けるって実感してます。だから今回は、この海外バズスレの内容を自分の実戦経験と重ねながら日本の読者向けに完全解説します。

    結論から言うと、.claude/ フォルダの正しい設計は 「CLAUDE.md → rules → commands → skills → agents」という5段階の成長パスで理解するのが一番わかりやすい。

    順番に話していきますね!

    なぜ .claude/ フォルダが重要なのか

    まず大前提として、多くの開発者はセットアップを飛ばしていきなりプロンプトを書き始めてる。これが最大の失敗。

    Claude Codeが本領発揮するのは、あなたのプロジェクトルールや作業パターンを .claude/ フォルダに設計してから。何もセットアップしてない状態だと、Claude Codeは「いい感じに動く汎用AI」でしかない。

    Claude Codeの基本的な使い方を知らない人は、まずClaude Codeとは?読み方・できること・使い方を完全解説を読んでから戻ってきてほしい。このあとの話が一気に理解できるはず。

    2つの .claude/ フォルダを区別する

    実は .claude/ フォルダは2種類ある。ここを混同すると設計が崩壊する。


    画像
    • プロジェクト内の .claude/ — Git管理対象。プロジェクト固有のルール・ワークフロー。チームメンバーとGit経由で共有される(例: 「このプロジェクトではSupabaseを使う」「テストは必ずVitestで書く」)

    • ユーザーホームの ~/.claude/ — 個人用、共有されない。自分の好み・作業スタイル。全プロジェクトをまたいで適用される(例: 「コメントは日本語で」「コミットは Conventional Commits で」)

    プロジェクト内は「インフラ」、ユーザーホームは「個人設定」。この分離ができてないと、他人のプロジェクトに自分の好みが混ざったり、チーム共有すべきルールが自分のPCにしか残らなかったりする。

    Claude Code公式のドキュメントにも明確に書いてあります。


    画像

    それを踏まえて、本題の成長パスに入ります。

    CLAUDE.md → rules → commands → skills → agents の成長パス

    .claude/フォルダの設計は、いきなり全部作るんじゃなくて段階的に育てるのが正解。


    画像

    Lv.1: CLAUDE.md から始める

    最初は .claude/CLAUDE.md という1ファイルから。これはClaude Codeにとっての取扱説明書。

    プロジェクトの方針、使ってるフレームワーク、コーディング規約、絶対に守ってほしいルールを1ファイルに書く。CLAUDE.mdはセッション開始時に必ず読まれるので、ここに書いてあることは全Claude Codeセッションで有効になる。

    このレベルで大事なのは欲張らないこと。100行以上書くと逆に守られなくなる。まず最重要な3〜5項目だけ書いて、運用しながら育てていく。

    Lv.2: rules/ フォルダに分割する

    CLAUDE.mdが肥大化してきたら、.claude/rules/ フォルダに分割する。

    • rules/typescript.md — TypeScriptのコーディング規約

    • rules/testing.md — テストの書き方

    • rules/database.md — DB設計・マイグレーションのルール

    分割のメリットは、コンテキストを絞れること。「今からDBマイグレーションの作業をする」と指示すれば、Claude Codeは database.md だけを重点的に参照して、他のルールで頭がごちゃつかない。

    Lv.3: commands/ で繰り返し作業を自動化

    プロジェクトで頻繁にやる作業(PR作成、テスト実行、デプロイ等)は .claude/commands/ にスラッシュコマンドとして定義する。

    • /commit — 変更内容を分析して適切なcommit messageを書く

    • /review-pr 123 — PR#123を読んでレビューコメントを書く

    • /deploy staging — ステージング環境にデプロイする

    一度定義すれば、チーム全員が同じ品質でコマンドを使える。Slackbotをチームで共有するのと同じ発想。

    Lv.4: skills/ で文脈発火する自動化を作る

    ここから一気にレベルが上がる。

    .claude/skills/ はClaude Codeが文脈を検知して自動で発火するスキル。スラッシュコマンドと違って、人間が明示的に呼ばなくても、会話の流れから必要なスキルをClaude Codeが自分で判断して読み込む。

    例えば skills/pdf-processor/ を作っておけば、ユーザーが「このPDF読んで」と言った時に、Claude Codeが自動でそのスキルを発動する。

    Lv.5: agents/ で専門サブエージェントを切り分ける

    最終形態。.claude/agents/ にはそれぞれ独立したコンテキストで動くサブエージェントを定義する。

    特定の役割に特化したAIを複数作って、メインのClaude Codeから呼び出す構造。こうすると、メインコンテキストが肥大化せず、各タスクが専門AIに任せられる。

    僕のポケモンエージェントはまさにこの構造。ピカチュウ(記事生成)、ゼニガメ(note投稿)、フシギダネ(はてなブログ投稿)、ヨルノズク(キーワード調査)などを独立したサブエージェントとして定義して、24時間自動で事業を回してる。

    実は僕、この話はずっと前にXでも書いてます👇

    MacBookとMac Miniだけで「7人のAI従業員」を稼働させて10億ドル規模のビジネスを作る動画。彼が動画で言っていることを詳しく解説します👇

    ① 全体像
    ・MacBook → 自分の作業用(デザイン、コード作成)
    ・Mac Mini → 7人のAIエージェントを24時間稼働… https://t.co/MQUuR1CXQ3

    — Tom | ドバイで生成AIやってる人 (@0x__tom) February 10, 2026

    Mac miniで「7人のAI従業員」を24時間稼働させて10億ドルビジネスを作る、みたいな世界が2026年にはもう実用レベル。その仕組みのコアが、この .claude/agents/ 設計なんです。

    この5段階の設計が事業化に直結する理由

    で、ここからが僕が一番伝えたい話。

    この CLAUDE.md → rules → commands → skills → agents の成長パス、実は個人事業を立ち上げる流れと全く同じ構造。

    • Lv.1 CLAUDE.md = 事業の方針書(「何をやる会社か」の一枚ペラ)

    • Lv.2 rules/ = 業務マニュアル(業務ごとに分かれたルールブック)

    • Lv.3 commands/ = 定型業務の標準化(誰がやっても同じ品質でできる手順)

    • Lv.4 skills/ = 自動化された業務プロセス(人間が判断しなくても走る)

    • Lv.5 agents/ = 専門部署(それぞれが独立してタスクをこなす)

    つまりClaude Codeの .claude/ を育てるのは、1人会社の組織設計そのもの。このスキル設計がちゃんとできる人は、個人でも大規模事業を回せる。

    海外で career-ops(Claude Codeで就活を自動化、GitHubで3.3万スター)や、Mercor(21歳3人が同じ構造で1.5兆円企業を作った話)が出てきてる背景も、根っこはここにある。

    このあたりの事業化の話は、僕の無料オプチャでも毎週議論してます。

    実装の第一歩

    今この記事読んでる人の中で、「Claude Code触ってるけど、.claude/フォルダちゃんと設計してない」って人は、以下3ステップでまず始めてみてほしい。

    • ① .claude/CLAUDE.md を作って、プロジェクトの最重要ルールを5行だけ書く

    • ② 1週間運用して、Claude Codeが守らないルールを追記する

    • ③ CLAUDE.mdが30行超えたら、.claude/rules/ に分割する

    ここまでがLv.2までの話。これだけでもClaude Codeの精度は体感で2倍くらい上がります。

    料金プランがよく分からない人はClaude Codeの料金、結局いくらかかるの?で整理してるので併せてどうぞ。

    まとめ

    • 海外で .claude/ フォルダ設計のスレッドが2.4万ブックマーク獲得、実用情報として注目

    • .claude/ フォルダは プロジェクト内 と ユーザーホーム の2種類を区別する

    • 成長パスは CLAUDE.md → rules → commands → skills → agents の5段階

    • この成長パスは 個人事業の組織設計そのもの

    • スキル設計ができる人が、Claude Code時代に個人で事業を回せる

    • 実装の第一歩はCLAUDE.mdを5行で作ることから

    Claude Codeはただのコーディングツールじゃなく、1人で組織を作るためのOS。.claude/フォルダを育てる=自分の「AI会社」を育てるってこと。

    ここまで読んでくれてありがとうございます!

    僕は「.AI(ドットエーアイ)」というAIコミュニティを運営してて、2026年は「Claude Codeで事業を自動運転する」をテーマにしてます。累計2,000名以上が参加中。

    Claude Codeで開発だけじゃなく、事業そのものを自動で回すところまでやりたい人は、ぜひ無料のLINEオプチャに来てください👇

    👉 .AI 無料オープンチャットに参加する

    .AI Timesでは海外のClaude Code活用事例と事業機会を継続的に取り上げてます。Claude Codeの基本は「Claude Code完全ガイド」にまとめてるので併せてどうぞ!

    Tom(@0x__tom)/ .AI 代表


     
     
    ドバイでブロックチェーンと生成AIのスタートアップをやってます。

    あなたへのおすすめ