Skip to content

CLAUDE.mdの@参照を削除してコンテキスト使用量を削減#562

Merged
gn-t-k merged 1 commit intomainfrom
improve/claude/issue-561-20260227-0055
Feb 27, 2026
Merged

CLAUDE.mdの@参照を削除してコンテキスト使用量を削減#562
gn-t-k merged 1 commit intomainfrom
improve/claude/issue-561-20260227-0055

Conversation

@gn-t-k
Copy link
Owner

@gn-t-k gn-t-k commented Feb 27, 2026

Close #561

変更内容

CLAUDE.md の関連ドキュメント参照から @ プレフィックスを削除し、毎回の自動ロードを防ぐ。

  • docs/project/overview.md (~1.1k tokens 削減)
  • docs/architecture-decision-record/overview.md (~2.7k tokens 削減)

必要なコーディングルール(coding-style, error-handling, testing)は @ プレフィックスを維持。

Generated with Claude Code

docs/project/overview.md と docs/architecture-decision-record/overview.md の
@ プレフィックスを削除し、毎回の自動ロードを防ぐ。
必要時にClaudeが自分でファイルを読むため、コンテキスト使用量を~3.8k tokens削減。

Close #561

Co-authored-by: Gentoku Murakami <gn-t-k@users.noreply.github.com>
@gn-t-k gn-t-k marked this pull request as ready for review February 27, 2026 00:59
@gn-t-k gn-t-k enabled auto-merge February 27, 2026 01:00
@claude
Copy link

claude bot commented Feb 27, 2026

ドキュメント更新チェック結果

変更概要

CLAUDE.md の「関連ドキュメント」セクションから @docs/project/overview.md@docs/architecture-decision-record/overview.md@ プレフィックスを削除し、毎回の自動ロードを抑制する変更(2行のみ)。


チェック結果

✅ 更新済み

  • CLAUDE.md: 変更対象ファイル自体が適切に更新されている。変更内容はドキュメントの記述方法(自動ロードの有無)であり、内容の正確性は維持されている。

⚠️ 要確認

  • docs/architecture-decision-record/: このPRで行われた「Claudeのコンテキスト管理方針(どのファイルを常時ロードし、どのファイルは必要時にのみ読むか)」という設計判断はADRに値する可能性がある。ただし、以下の理由でADR不要とも判断できる:

    • 変更がごく小さく、容易に元に戻せる
    • Issue Claude Codeのコンテキスト使用量を最適化する #561 が判断根拠(削減量の定量的分析など)を十分に記録している
    • CLAUDE.md の設定は既存ADRに比べてスコープが小さい(コードアーキテクチャではなくツール設定)

    判断: プロジェクトの意思決定記録ポリシー上、「コードに現れない設計の意思決定はADRに記録」とあるため、Issue Claude Codeのコンテキスト使用量を最適化する #561 をADRとして正式に記録するかどうかをチームで確認することを推奨する。ADRが不要と判断した場合は「更新不要」。


更新不要な項目

  • .claude/rules/*.md: コーディング規約・テストルール・エラー処理ルールへの影響なし
  • docs/project/overview.md: ファイルの内容は変更されていない(参照方法のみ変更)
  • docs/model-based-ui-design/: UI設計への影響なし
  • 各パッケージの README.md / CLAUDE.md: パッケージ固有の変更なし

総評

変更は CLAUDE.md の2行のみで、変更自体がドキュメントの更新である。実質的な情報の欠落はなく、ADRを作成するかどうかの判断を除いてドキュメント更新漏れは検出されなかった。

@gn-t-k gn-t-k merged commit a784169 into main Feb 27, 2026
6 checks passed
@gn-t-k gn-t-k deleted the improve/claude/issue-561-20260227-0055 branch February 27, 2026 01:01
@github-actions
Copy link
Contributor

🗑️ Preview Environment Cleanup

✅ PR #562 のプレビュー環境をクリーンアップしました

結果 件数
削除成功 0
削除失敗 0
合計 0

PRがクローズされたため、関連するデータベースを削除しました。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Claude Codeのコンテキスト使用量を最適化する

1 participant