**`.claude/` フォルダの構成**

- `config.json` ― ユーザー設定や好みを保存します。  
- `history.log` ― すべての対話ログを参照用に記録します。  
- `models/` ― ダウンロード済み Claude モデルと関連メタデータが格納されています。  
- `sessions/` ― アクティブなチャットスレッドなど、臨時セッション情報を保持します。  
- `logs/` ― デバッグやパフォーマンス監視のためのシステムログです。

このようにフォルダ構成を整えることで、Claude AI 環境が円滑に動作し、保守も容易になります。

2026/03/27 23:35

**`.claude/` フォルダの構成** - `config.json` ― ユーザー設定や好みを保存します。 - `history.log` ― すべての対話ログを参照用に記録します。 - `models/` ― ダウンロード済み Claude モデルと関連メタデータが格納されています。 - `sessions/` ― アクティブなチャットスレッドなど、臨時セッション情報を保持します。 - `logs/` ― デバッグやパフォーマンス監視のためのシステムログです。 このようにフォルダ構成を整えることで、Claude AI 環境が円滑に動作し、保守も容易になります。

RSS: https://news.ycombinator.com/rss

要約

Japanese Translation:


サマリー

Postman と Claude Code はともに AI で拡張されたワークフローを管理するための構造化アプローチを提供しますが、対象とするニーズは異なります。

Postman

  • コスト削減分析 を公開し、AI 統合有無で比較した6つの一般的な API 開発パイプラインを提示しています。
  • このレポートはエンジニアリングリードに対して AI ネイティブツール導入の ROI 指標を明確に提供します。

Claude Code

  • .claude
    ディレクトリ
    を構成ファイルの制御センターとして使用し、指示・カスタムコマンド・許可ルール・セッション間メモリを管理します。
    • 二つのレベルがあります:
      プロジェクトレベル
      .claude/
      )– Git にコミットされる。
      グローバル
      ~/.claude/
      )– 個人設定とマシン固有状態を保持します。
  • 最も重要なファイルは
    CLAUDE.md
    です。その内容が対話全体で Claude のシステムプロンプトになります。良いコンテンツにはビルド/テスト/リンティングコマンド、アーキテクチャ決定事項、注意点、インポート規約、およびフォルダ構成が含まれます—理想的には 200 行程度に収める。
    • コミットすべきでない個人調整は
      CLAUDE.local.md
      (git‑ignored)をメインの
      CLAUDE.md
      と同じ場所に作成します。
  • .claude/rules/
    フォルダ
    は指示をフォーカスした Markdown ファイルに分割でき、各ファイルは YAML フロントマターの
    paths
    ブロックで一致するファイルパスにのみ有効化できます。
  • コマンド
    .claude/commands/
    (プロジェクト固有)または
    ~/.claude/commands/
    (グローバル)に格納されます。各 Markdown ファイルが
    /
    コマンドとして名前付きになります(例:
    review.md → /project:review
    )。コマンドは
    !
    構文でシェル出力を埋め込み、
    $ARGUMENTS
    で引数を受け取ります。
  • スキル
    .claude/skills/
    または
    ~/.claude/skills/
    に定義される自律ワークフローです。各スキルには YAML フロントマターを使用して会話が説明と一致した時に自動的にトリガーされる
    SKILL.md
    が付属します。スキルはサポートファイル(例:
    DETAILED_GUIDE.md
    )をまとめることもできます。
  • サブエージェント
    .claude/agents/
    に位置し、各エージェントは Markdown ファイルでシステムプロンプト、ツールアクセス、およびモデル設定を指定します。これによりコードレビューやセキュリティ監査などのタスク用に隔離されたコンテキストが提供されます。
  • settings.json
    は許可および拒否するコマンド/ツール(例:Bash スクリプトを許可、破壊的なシェルコマンドやネットワーク呼び出し、機密ファイルを拒否)を制御します。
    settings.local.json
    を作成すればユーザーごとに上書きが可能で、変更をコミットせずに設定できます。

推奨セットアップの進行

  1. /init
    を実行して初期
    CLAUDE.md
    を生成します。
  2. 生成されたファイルをトリミングし、簡潔に編集します。
  3. 適切な許可/拒否ルールを持つ
    settings.json
    を追加します。
  4. 必須コマンド(例:コードレビュー)を作成します。
  5. 必要に応じて指示を
    .claude/rules/
    に分割します。
  6. 個人設定用のグローバル
    ~/.claude/CLAUDE.md
    を追加します。

これらのツールは、Postman の分析でエンジニアリングリードが AI ROI を定量化できる一方、開発者に再現性・バージョン管理されたプロンプトとコマンド構成を提供し、新規採用時のフリクションを低減しつつセキュリティポリシーを強制します。

本文

Postman AI‑ROIガイド

多くのチームは何らかの形でAIを導入していますが、「AIを使う」ことと「AIから測定可能な ROI を得る」こととのギャップは、人々が想像するよりも大きいです。
Postman は、6 つの一般的な API 開発ワークフローに対してコスト削減分析を公開しました。この分析では、プラットフォームに AI が組み込まれた場合と外部で追加された場合の実際の時間・コスト差をベンチマークしています。データ駆動型の短い読み物であり、エンジニアリングリーダーが AI‑ネイティブツールがどこで本当に価値を生むかを主張するのに役立ちます。
ガイドは以下から無料で入手できます → 今日は Postman と提携できたことに感謝します!


Claude Code –
.claude
フォルダーの解説

Claude Code のユーザーは、通常

.claude
フォルダーをブラックボックスとして扱います。存在を知り、プロジェクトルートに出現するのを見たことがあるだけで、内部のファイル一つひとつが何をしているかを開いたり理解したりしたことはほとんどありません。それは大きなチャンス損失です。

.claude
フォルダーは、Claude がプロジェクト内でどのように振る舞うかを制御するコントロールセンターです。次のものが格納されています:

  • あなたの指示
  • カスタムコマンド
  • 許可規則
  • Claude のセッション間メモリ

場所と役割がわかれば、Claude Code をチームに必要な動作を正確に実現できるよう設定できます。

2 つの
.claude
ディレクトリ

場所用途
プロジェクトレベル(
./.claude
チーム構成 – Git にコミット。共有ルール、コマンド、ポリシー。
グローバル(
~/.claude/
個人設定と機械固有の状態(セッション履歴、自動メモリ)。

最も重要なファイル:
CLAUDE.md

Claude Code セッションを開始すると、最初に読み込まれるのが

CLAUDE.md
です。システムプロンプトへ直接ロードされ、会話全体で記憶に留まります。

  • 書いた内容Claude が従う
    • 「実装前に必ずテストを書く」→ Claude はそれを行う。
    • 「console.log を使わないで常にカスタムロガーモジュールを使用する」→ Claude は尊重します。

プロジェクトルートに

CLAUDE.md
(一般的な設定)、
~/.claude/CLAUDE.md
にグローバル設定、さらにサブディレクトリ内にフォルダー固有のルール用に置くこともできます。Claude はすべてを読み込み、統合します。

良い CLAUDE.md の書き方

書く理由
ビルド・テスト・リントコマンド(
npm run test
make build
など)
コアワークフロー
アーキテクチャ上の重要決定(例: 「モノレポを Turborepo で使用」)コンテキスト
明らかではない落とし穴(「TypeScript strict mode はオン。未使用変数はエラー」)ミス防止
インポート規則、命名パターン、エラーハンドリングスタイル一貫性
主要モジュールのファイル・フォルダー構成ナビゲーション
書かない理由
linter や formatter の設定に入るもの冗長
リンクできる完全なドキュメントCLAUDE.md をスリムに保つため
理論を説明する長文パラグラフコンテキストを消費

CLAUDE.md
は 200 行以内に抑えましょう。超えるとコンテキストが奪われ、Claude の指示遵守率が低下します。

最小例(約20行) – Claude に必要な情報をすべて提供しつつ、頻繁な確認を不要にします。

個人設定

あなた専用の好み(テストランナーやファイルオープンパターンなど)がある場合は、プロジェクトルートに

CLAUDE.local.md
を作成してください。自動で
.gitignore
されるため、個人設定がリポジトリに入ることはありません。

規則の整理:
.claude/rules/

大きなファイルを一つ持つ代わりに、関心ごとに分割します:

  • api-conventions.md
  • testing.md
  • など

各ファイルは焦点が絞られ、更新しやすいです。YAML フロントマターに

paths
フィールドを追加すると、Claude が該当ファイル(例:
src/api/
src/handlers/
)で作業しているときのみ有効になります。
paths
を持たないルールは無条件で読み込まれます。

コマンド:
.claude/commands/

このフォルダーに入れた Markdown ファイルがスラッシュコマンドになります。

  • review.md
    /project:review
  • fix‑issue.md
    /project:fix‑issue

$ARGUMENTS
を使ってコマンド名後のテキストを渡せます(例:
/project:fix‑issue 234
)。コマンドはコミットされ、チームと共有できます。プロジェクト非依存コマンドは
~/.claude/commands/
に置き、
/user:command-name
として利用します。

スキル

スキルは Claude が自動で呼び出せるワークフローです。

  • 各スキルは独自サブディレクトリに
    SKILL.md
    を持つ。
  • SKILL.md
    は YAML フロントマターで使用条件を記述。
  • スキルは補助ファイル(例:
    DETAILED_GUIDE.md
    )も一緒に配置可能。

個人スキルは

~/.claude/skills/
に置きます。

エージェント:
.claude/agents/

複雑タスク用にサブエージェント人格を定義します:

  • Markdown ファイルが独自システムプロンプト、ツールアクセス、モデル設定。
  • 例:
    code-reviewer.md
    – コードレビューを隔離されたコンテキストウィンドウで実行。

tools
フィールドでエージェントが使用できる操作(Read, Grep, Glob 等)を制限し、
model
フィールドでタスク専用の安価・高速モデルを指定できます。

個人エージェントは

~/.claude/agents/
に配置します。

設定:
.claude/settings.json

Claude が実行できるツール、読み込めるファイル、および特定コマンドを実行する前に確認が必要かどうかを制御します。

  • $schema
    行 → オートコンプリートとインラインバリデーション。
  • 許可リスト(確認不要で実行できる):
    • Bash (
      npm run *
      ,
      make *
      )
    • Git 読み取り専用コマンド (
      git *
      )
    • ファイル操作:Read, Write, Edit, Glob, Grep
  • 拒否リスト(完全にブロック):
    • 破壊的シェルコマンド(
      rm -rf
      等)
    • ネットワークコマンド(
      curl
      等)
    • 機密ファイル(
      .env
      secrets/
      内のもの)

リストに載っていない場合は Claude が実行前に確認を求めます。

個人上書きは

.claude/settings.local.json
を作成。自動で
.gitignore
されます。

グローバルファイル

ファイル用途
~/.claude/CLAUDE.md
個人のコーディング原則、スタイル嗜好など
~/.claude/projects/
プロジェクト別セッション転写と自動メモリ(発見したコマンド、観測されたパターン、アーキテクチャインサイト)
~/.claude/commands/
,
~/.claude/skills/
すべてのプロジェクトで利用可能な個人コマンドとスキル

はじめに

  1. Claude Code 内で
    /init
    を実行 → スタート用
    CLAUDE.md
    が生成。必須項目だけに絞って編集。
  2. .claude/settings.json
    にスタック固有の許可/拒否ルールを設定(例:実行コマンドは許可、
    .env
    の読み取りは禁止)。
  3. よく使うワークフロー用に 1〜2 個のコマンドを作成(コードレビュー、問題修正など)。
  4. CLAUDE.md
    が増えてきたら、指示を
    .claude/rules/
    ファイルへ分割。
  5. グローバル
    ~/.claude/CLAUDE.md
    に個人設定を追加。

これでプロジェクトの 95 % をカバーできます。スキルとエージェントは、再発する複雑なワークフローをパッケージ化したい場合に導入します。


最終的な結論

.claude
フォルダーは Claude に「あなたが誰であり、プロジェクトが何をしているか、どんな規則に従うべきか」を伝えるプロトコルです。定義を明確にすればするほど、Claude を修正する時間が減り、有用な作業に費やせる時間が増えます。

小さく始めて、必要に応じて洗練し、

CLAUDE.md
をプロジェクトのインフラストラクチャとして扱いましょう。適切に設定すれば、毎日利益を生み出します。

読んでいただきありがとうございます!

同じ日のほかのニュース

一覧に戻る →

2026/03/28 17:06

CERN は、リアルタイムで LHC のデータをフィルタリングするために、シリコンへ焼き付けられた小型 AI モデルを利用しています。

## Japanese Translation: CERN(欧州原子核研究機構)は、リニア・ハドロン衝突器(LHC)がリアルタイムで生成する膨大なデータストリームをフィルタリングするために、シリコンチップに焼き付けられたカスタムAIモデルを使用しています。LHCは年間約40,000 エクサバイトのデータを生成し、一時的には数百テラバイト/秒というピーク値に達しますが、分析対象として保持される衝突イベントはわずか0.02%です。このカットを通過するイベントを決定するため、CERN のレベル‑1トリガーは約1,000個のフィールドプログラマブルゲートアレイ(FPGA)を用い、50ナノ秒未満で判断を下さなければなりません。これらのFPGA は AXOL1TL アルゴリズムを実行し、このアルゴリズムは PyTorch や TensorFlow などの人気フレームワークから HLS4ML のようなツールでコンパイルされた非常に小さなニューラルネットに依存しています。FPGA/ASIC ハードウェアは完全なネットワーク層よりも事前計算済みのルックアップテーブルによって支配されており、ほぼ即時に出力を得ることができます。この最初のフィルタ後、25,600 台の CPU と 400 台の GPU を備えたハイレベルトリガーファームがデータをさらに縮小し、1 日あたり約 1 ペタバイトに抑えます。 将来的には、高輝度 LHC(HL‑LHC)が2031 年から開始され、衝突ごとのデータ量が約10 倍になる予定です。CERN はすでに次世代の超コンパクト AI モデルと最適化された FPGA/ASIC デザインを開発しており、この成長に対応できるようにしています。同様の低遅延・リソース効率的な技術は、オートノマス車両、高頻度取引、医用画像診断、航空宇宙分野などでも有用となる可能性があります。

2026/03/28 9:39

エージェントに集中し、ファイルシステムへは干渉しないようにしましょう。

## Japanese Translation: (以下はご提示いただいたテキストの日本語訳です) ``` ## Summary `jai` は軽量なサンドボックスツールで、ユーザーが Codex や Claude などの言語モデルエージェントをフルコンテナイメージを構築せずに実行できるようにします。 - 現在の作業ディレクトリを「jail」として囲み、そのディレクトリ内は完全に書き込み可能にし、他のすべてのファイルを読み取り専用にします。 - ユーザーのホームディレクトリへの変更はコピーオンライトオーバーレイでキャプチャされ、元のファイルは触れられません;`/tmp` と `/var/tmp` はサンドボックス内でプライベートです。 - このツールは単一コマンド(`jai codex`、`lai claude`、または単に `jai`)で起動でき、ユーザー自身の非特権アカウントで実行するか、選択したモードに応じて専用の Jai ユーザーで実行します。 - 三つの隔離モードが利用可能です:**Casual**(弱い機密性、ほとんどのファイルが読み取り可能)、**Strict**(強い機密性、別UIDと隠しホームを使用)、および **Bare Home**(完全な隔離、NFS‑home サポート有効)。 - `jai` はスタンフォード大学 Secure Computer Systems と Future of Digital Currency Initiative のフリーソフトウェアです。Docker を ad‑hoc サンドボックス化に補完しますが、bubblewrap や chroot より軽量であり、より強い隔離を必要とするケースではコンテナや VM に取って代わるものではありません。 ```

2026/03/28 11:17

AMD の Ryzen 9 9950X3D2 Dual Edition は、1枚のチップに合計 208 MB のキャッシュを搭載しています。

## Japanese Translation: **概要:** AMD の新しい Ryzen 9 9950X3D2 デュアルエディションは、以前の X3D モデルで採用されていたハイブリッドキャッシュレイアウトを廃止し、両方のプロセッサダイに 64 MB の 3D V‑Cache を追加しています。各ダイには 16 MB の L2 キャッシュ、32 MB の組み込み L3 キャッシュ、および追加で 64 MB の V‑Cache が備わっており、チップレットペア全体で合計 208 MB のキャッシュが確保されます。既存の X3D チップ(例:7900X3D、7950X3D、9900X3D、9950X3D)では、追加の 64 MB V‑Cache は1つのダイにのみ搭載されています。AMD のドライバソフトウェアはキャッシュ恩恵を受けるワークロードをそのコアへルーティングしますが、このプロセスは一般的には信頼できますが、稀に失敗することがあります。デュアルダイ構成により、すべてのコアが大きなキャッシュプールにアクセスできるようになり、AMD によれば標準の 9950X3D と比べてゲームやその他のキャッシュ依存型アプリケーションで最大10 %の性能向上を実現できます。

**`.claude/` フォルダの構成** - `config.json` ― ユーザー設定や好みを保存します。 - `history.log` ― すべての対話ログを参照用に記録します。 - `models/` ― ダウンロード済み Claude モデルと関連メタデータが格納されています。 - `sessions/` ― アクティブなチャットスレッドなど、臨時セッション情報を保持します。 - `logs/` ― デバッグやパフォーマンス監視のためのシステムログです。 このようにフォルダ構成を整えることで、Claude AI 環境が円滑に動作し、保守も容易になります。 | そっか~ニュース