Hacker Newsが見た `.claude` フォルダ、Claude Code運用を repo に持ち込む構成

Hacker News で何が注目されたか

今週の Hacker News では、.claude フォルダを実務目線で分解したガイドが広く共有された。要点は、このディレクトリが Claude Code project の local control plane として機能するということだ。毎回同じ prompt を組み立て直すのではなく、team は instruction、command、reusable workflow を repo 内に保存し、コードと一緒に version control できる。これにより model の振る舞いは一時的な chat のコツではなく、レビュー可能な運用資産になる。

記事は project レベルの .claude/ と home directory の ~/.claude/ を分けて説明している。前者にはその repo 固有のルールや実行方針を置き、後者には複数 project で共有する default を置く。この分離があることで、組織共通の習慣と repo ごとの例外を一つの長い prompt に押し込めずに済む。

なぜこの構成が重要か

中心になるのは CLAUDE.md だ。ガイドではこれを session 開始時に読み込まれる memory file と位置づけ、architecture 原則、test 方針、naming rule、delivery constraint などの持続的な指示をここに置く。その上で .claude/rules/ は instruction を関心ごとごとに分割し、.claude/commands/ は繰り返し作業を slash command に変える。.claude/skills/ は multi-step workflow を再利用可能な単位にまとめ、.claude/agents/ は独自の prompt と tool preference を持つ specialist subagent を定義する。

この点が Hacker News で響いたのは、prompt craft を個人の勘ではなく repository design の一部として扱っているからだ。engineering team にとっては onboarding がしやすくなり、review 対象が明確になり、code review や incident response、release prep のような定型作業を毎回説明し直さずに済む。

次に見るべき点

もちろん運用上の利点がある一方で、新しい governance の課題も生まれる。global rule と project rule の precedence が曖昧だったり、古い command や rule が溜まったりすると、agent の挙動はかえって読みにくくなる。今回の HN で見えた大きな流れは、AI coding workflow が単なる chat session ではなく、構成可能な developer system として扱われ始めたことだ。これからの焦点は prompt を書くかどうかではなく、それをどう構造化し、監査し、保守するかに移っている。