repo-context-packaging

リポジトリのコンテキストをまとめる

リポジトリを、エージェントが推論しやすい、トークン効率に優れた単一のバンドルにまとめます。含めるのは、ツリー、重要なファイル、そして予算を浪費するもの以外です。完全性ではなく、トークンあたりの情報量を重視します。

使用する場面

• レビュー、デバッグ、機能開発のために、エージェントに不慣れなコードベースを把握させる場合。
• リポジトリがコンテキストに収まらない（またはぎりぎり収まる）ため、内容を絞る必要がある場合。
• モデルに貼り付けたり、タスクに添付したりできる、持ち運び可能なスナップショットを作成する場合。

タスクの対象が既知の少数のファイルだけなら、これらを使わず、該当ファイルを直接読みます。

手順

1. まとめる前に構造を把握する

git ls-files | sed 's|/.*||' | sort -u        # top-level layout
git ls-files | wc -l                          # tracked file count
tokei . 2>/dev/null || cloc .                  # size by language

エントリーポイント、主要モジュール、構造を定義する設定など、アーキテクチャの中核を特定します。

2. 容赦なく除外する

ロックファイル、node_modules／vendor／ビルド出力、.git、圧縮・生成されたコード、バイナリ、メディア、スナップショット／フィクスチャ、dist／coverageは含めません。これらは容量の大部分を占めますが、情報量はほとんどありません。

git ls-files \
  | grep -vE '(lock|min\.|\.map$|/dist/|/build/|/vendor/|\.snap$)' \
  | grep -vE '\.(png|jpg|jpeg|gif|pdf|zip|woff2?|ttf|mp4)$'

ツールが使える場合は、npx repomixまたはfiles-to-promptのように、妥当なデフォルト設定で構造化されたバンドルを生成するツールを優先します。除外リストを確認し、うのみにしないでください。

3. 予算に応じて内容を階層化する

1. 必須：ディレクトリツリー、README、主要なエントリーポイント、公開インターフェース／型、重要な設定。
2. 予算に余裕があれば：中核となるビジネスロジックのモジュール。
3. インラインで記載せず要約する：大規模なリーフモジュール、テスト、繰り返しの多いハンドラー → それぞれの目的を1行で記載します。
4. 参照のみ：上記で除外したすべて。

最初にトークン予算を明示し、収まるまで最下位の階層から削ります。

4. バンドルを出力する

# <repo> context bundle

## Structure
<tree, depth-limited>

## Architecture (3–6 sentences: how it fits together, entrypoints, data flow)

## Files
### path/to/file
```<lang>
<contents, or a summary line if tier 3>

省略したもの

<エージェントが見られない内容を把握できるよう、除外したグロブとその理由を記載します>

The "Omitted" section is mandatory: an agent that knows what it's missing asks for it instead of hallucinating it.

## Quality bar

- Fits the stated budget with the architecture summary intact.
- A reader can locate where any feature lives from tree + summary alone.
- Zero generated/lock/binary content inlined.
- Omissions are listed, not silent.

## Anti-patterns

- Dumping every file until truncation eats the important ones.
- Inlining lockfiles or `dist/` "for completeness".
- Tree only, no architecture prose — structure without meaning.
- Silent omission, so the agent confidently reasons about code it never saw.