loggrowing

LLM運用戦略 段階的コンテキスト開示プロトコル v2

LLM運用戦略: 段階的コンテキスト開示プロトコル 完全運用ガイド v4 (Windows 11版)

1. 背景 / 課題

  • 無料枠のLLMプラットフォームでAstroブログの開発支援を受けているが、1セッションあたり「10,000字 × 10回程度」の制限がある
  • 現状は毎回リポジトリ全体や関連ファイルを貼り付けており、ハンドオーバーとコード共有だけで6ターン程度を消費してしまう
  • 本来の修正作業に使えるコンテキストが枯渇し、複雑な変更が完了しないまま制限に到達するケースが増えてきた
  • 本ログの目的: 次回以降、このページ1枚を開くだけで運用が再現できる状態にすること
  • 前提環境: Windows 11 / Astro v7 / Tailwind 未使用 / VS Code + Git + Node.js は導入済み

2. 検討した選択肢

プロトコル設計

  • 案A: 全ファイル貼り付け継続(現状維持) — トークン枯渇が早い
  • 案B: 有料コードエージェント移行 — 個人ブログ規模ではオーバースペック
  • 案C: 段階的コンテキスト開示プロトコル導入(採用)

メタ開発ツール選定

  • 却下: WSL2 導入 — Windowsに常駐、ディスク消費、後から消しにくい
  • 却下: winget で ripgrep/ast-grep 個別導入 — PATH汚染、管理が煩雑
  • 採用: 追加インストールゼロ構成 — gitingest + VS Code標準検索 + Git Bash / PowerShell 標準機能で完結

情報量削減

  • 採用: docs/ とブログ本文の除外 — メモやコンテンツはシステム改修時に不要

3. 決定事項

案C + Windows 11 ノーインストール構成 + 除外パターン運用を採用。

  • 追加コスト・環境汚染ゼロ
  • Git Bash と PowerShell の両方に対応(VS Code のターミナルから選択可能)
  • docs/ および src/content/blog/ を常時除外
  • LLM側から必要情報を要求させることで人間側の判断負荷も削減
  • 差分ベース出力の強制で応答トークンも節約

4. 実装内容: 運用手順の完全ガイド

STEP 0: 事前準備

追加インストール一切不要。以下が既に入っていればOK:

  • Git for Windows(Git Bash 同梱)
  • Node.js(Astro v7 動作に必須)
  • VS Code

VS Code ターミナル切り替え:

Ctrl + @ でターミナル起動
右上の ∨ アイコンから "Git Bash" または "PowerShell" を選択

STEP 1: ツリー抽出(3択)

選択肢A: gitingest(推奨・最速)

ブラウザで URL を書き換えるだけ。

https://github.com/<user>/<repo>
↓
https://gitingest.com/<user>/<repo>

除外指定も UI から可能。docs/**, src/content/blog/** を除外設定。

選択肢B: Git Bash(推奨・オフライン時)

Terminal window
# .gitignore 準拠 + docs/ とブログ本文を除外
git ls-files | \
grep -vE '^(docs/|src/content/blog/)' | \
awk -F/ '{
indent=""; for(i=1;i<NF;i++) indent=indent" ";
print indent $NF
}' | \
clip

clip は Windows 標準コマンド(Git Bash からも呼べる)。

選択肢C: PowerShell

Terminal window
git ls-files |
Where-Object { $_ -notmatch '^(docs/|src/content/blog/)' } |
ForEach-Object {
$parts = $_ -split '/'
(' ' * ($parts.Count - 1)) + $parts[-1]
} | Set-Clipboard

STEP 2: 関数シグネチャ抽出(3択)

選択肢A: VS Code の検索(推奨・GUI派向け)

1. Ctrl+Shift+F で検索パネル
2. .* アイコンで正規表現モード有効
3. 検索欄:
^(export\s+)?(async\s+)?(function|class|const\s+\w+\s*=)
4. "files to include":
src/**/*.{ts,tsx,js,astro}
5. "files to exclude":
docs/**, src/content/blog/**, node_modules/**, dist/**, .astro/**
6. 結果を全選択してコピー

選択肢B: Git Bash(推奨・CLI派向け)

Terminal window
# 関数シグネチャ抽出、docs/ とブログ本文を除外
grep -rEn '^(export\s+)?(async\s+)?(function|class|const\s+\w+\s*=)' \
--include='*.ts' --include='*.tsx' --include='*.js' --include='*.astro' \
--exclude-dir=docs --exclude-dir=node_modules --exclude-dir=dist --exclude-dir=.astro \
src/ | \
grep -vE '/content/blog/' | \
clip

選択肢C: PowerShell

Terminal window
Get-ChildItem -Path src -Recurse -Include *.ts,*.tsx,*.js,*.astro |
Where-Object { $_.FullName -notmatch '\\(docs|content\\blog|node_modules|dist|\.astro)\\' } |
Select-String -Pattern '^(export\s+)?(async\s+)?(function|class|const\s+\w+\s*=)' |
ForEach-Object { "$($_.Path):$($_.LineNumber): $($_.Line.Trim())" } |
Set-Clipboard

出力サンプル

src/utils/date.ts:3: export function formatDate(d: Date): string
src/utils/date.ts:12: export function parseDate(s: string): Date
src/components/Header.astro:5: const { title } = Astro.props

Tips: 除外パターンは .llmignore のような外部ファイルに切り出しても良い(gitingest は将来対応予定)。当面は上記コマンドを snippet として VS Code のユーザースニペットに登録しておくと便利。

STEP 3: ワンショット依頼を投入(初回メッセージで全て送る)

以下をそのままコピペする。

# 開発支援プロトコル
あなたは Astro v7ブログ `Parlourite Note` の開発支援AIです。
今のあなたとのChatプラットフォームのトーク制限が厳しいため、9回以内のラリーで下記タスクを完了させます。
userの返答は合計10,000字を越えられません。
以下を厳守してください。
## 環境
- Windows 11 / VS Code (Git Bash + PowerShell 両方利用可)
- Astro v7 (2026/9時点最新版)
- Tailwind 未使用(素のCSS / global.css)
## Parlourite Note について
- 1000の古典ゲームからユーロゲームまでを決定的に記述する
DSL兼webプラットフォームParlouriteの開発技術ブログ
- 本ブログは高級ホテル風のテーマ(parlourite.css)で高機能だがノイズの少ないUXを採用する。(Apple風)
- 技術に対する考察(logs)やADRなどをリンクを付けて管理する
- シンプルで手堅い実装パターンや命名を採用する。可能な限り独自なパターンは実装しない
## コンテキスト節約
1. 推測でコードを書かず、**必要な情報を理由付きで要求**。
- userは字数制限により**上位3つまで**しか返事しない前提で考え、優先度高い物から要求してください。
2. 要求は「ファイル」「特定関数の中身」「抽出コマンド」のいずれでも可
3. 追加が必要なら次のターンで要求可
- 字数制限により返答の途中で途切れる事があります。続きの重要度が低いと判断できたら、「続きは不要」を宣言し、作業を進めてください。
## コード出力
1. ファイル全体の再出力は禁止
2. **diff**を出力
3. 未変更部分は `// ...既存コード...` で省略
4. 変更箇所は関数名や近傍行を最小限含め、位置を特定可能にする
- Ctr+F で検索しやすいワードを含む様にしてください。
## コマンド生成ルール
1. リモートにcommitプッシュ後に対話開始します。破壊的変更可能です。
2. 生成コマンドには「何を抽出するか」を1行で説明
3. Git Bash または PowerShell から実行できるものにする
## 応答フォーマット
### 情報要求時
【理由】短く
【要求】種別(ファイル/関数/コマンド実行結果)
【内容】
### 修正提案時
【理由】短く
【変更対象】ファイルパス
【変更内容】diff または部分コード
---
# 依頼
<やりたいことを2〜4行>
# リポジトリ構造
- ツリーから除外: docs/, src/content/blog/(メモとブログはファイルが多いので共有しない)
```
<STEP 1 で取得したツリー>
```
# 関数シグネチャ一覧
```
<STEP 2 で取得したシグネチャ>
```
上記から、
(a) 追加で必要な情報(ファイル/関数/コマンド)
(b) 現時点で推測できる修正方針
を返してください。
---
# 補足資料
<依頼に対する補足があれば>

STEP 4: LLMの要求に応じて情報提示

要求されたもののみ提示。関数単位で要求されたら該当関数だけ切り出す。

【要求1】`src/utils/date.ts` の `formatDate`
```ts
export function formatDate(d: Date): string {
return d.toISOString().slice(0, 10);
}
```
【要求2】コマンド実行結果
```
<Git Bash / PowerShell の出力>
```

STEP 5: 差分を受領 → 適用 → 検証

【変更対象】src/styles/global.css
【変更内容】
+ .prose table { display: block; overflow-x: auto; }
【理由】表のはみ出し対応

VS Code で該当ファイルを開いて手動反映 → npm run dev で確認。

STEP 6: セッション終了前にログ化(重要な決定時のみ)

logs/YYYY-MM-DD-<slug>.md に記録。

軌道修正ワンライナー

プロトコル違反です。ファイル全体ではなく diff のみで返してください。
また、必要情報は推測せず要求フォーマットに従って明示してください。

5. 検証: 削減効果の見積もり

従来フロー(全ファイル貼り付け + docs/ブログ本文も含む)

ターン内容文字数
1依頼 + 関連ファイル5個 + 記事サンプル12,000
2LLMが全体修正版返却7,000
3追加要望 + 再貼付9,000
合計3ターンで枯渇28,000

v4 プロトコル(除外 + 関数抽出 + ワンショット)

ターン内容文字数
1プロトコル + 依頼 + 絞り込み済みツリー + 関数一覧2,000
2LLMが関数2つの中身要求200
3該当関数のみ提示1,000
4差分返却700
5追加要望400
6差分返却700
合計10ターン以上余裕5,000

従来比 約82%削減(除外効果で v3 よりさらに約10%改善)

定性的効果

  • 人間側: 「どのファイルを渡すべきか」の判断をLLMに委譲、認知負荷が下がる
  • LLM側: docs/ やブログ本文のノイズが無く、システム設計に集中できる
  • 環境: WSL2 や追加ツール導入ゼロ、Windows 11 環境を汚さない
  • 選択肢: Git Bash / PowerShell / VS Code 検索から状況に応じて選べる
  • 保守性: 除外パターンとコマンドを snippet 化すれば、プロジェクトが育っても手順が陳腐化しない

6. 次アクション / 課題

  • v4 プロトコルでモバイル対応(長文字列折り返し・表スクロール)を実施し、実測トークンを記録
  • VS Code ユーザースニペットに STEP 1〜2 のコマンドを登録
  • Astro v7 特有の記法(.astro frontmatter, slot, client directive)に対応した抽出パターンを蓄積
  • gitingest がプライベートリポジトリ + 除外指定で問題なく動くか確認
  • .llmignore 相当のファイルを作成し、除外パターンを一元管理する案を検討
  • 運用が安定したら ADR (R-XXXX) に昇格 → ADR候補
  • 将来 Tailwind 導入する場合の抽出パターン追記(class="..." の網羅)

7. LLMサマリ

無料LLMのトークン制限下で Astro v7 ブログ開発を継続するため、段階的コンテキスト開示プロトコルを v4 (Windows 11 / Git Bash + PowerShell 対応版) に改訂。WSL2 や個別ツール導入を避け、gitingest + VS Code 標準検索 + シェル標準機能のみで完結する追加インストールゼロ構成を維持。docs/ および src/content/blog/ の除外運用を追加し、関数シグネチャ事前抽出とワンショット依頼統合と合わせて従来比約82%のトークン削減を実現。本ページ1枚で運用が完全再現可能。