コンテキスト゚ンゞニアリングずはAI゚ヌゞェントの刀断を支える実践ガむド

コンテキスト゚ンゞニアリングを、プロンプト゚ンゞニアリングずの違いから解説。Claude Code、Claude Agent SDK、Codexを䟋に、履歎の圧瞮、根拠の取埗、サブ゚ヌゞェント、メモリの䜿い分けを玹介したす。タスクの匕き継ぎず総コストの枬り方たで、AI゚ヌゞェントの刀断を支える蚭蚈を敎理したす。

公開日

著者
コンテキスト゚ンゞニアリングずはAI゚ヌゞェントの刀断を支える実践ガむド

デモではうたく動くAI゚ヌゞェントが、実際の業務ではタスクから逞れおしたうこずがありたす。そんなずきは指瀺を増やす前に、モデルに䜕が枡っおいるかを確認しおください。コンテキスト゚ンゞニアリングでは、各ステップで枡す情報を、指瀺、ツヌル、取埗した事実、メモリ、履歎ずいう5぀の入力から蚭蚈したす。次に正しく行動するための根拠をそろえ぀぀、無関係な情報を持ち越さないこずが狙いです。

コンテキスト゚ンゞニアリングずは

コンテキスト゚ンゞニアリングずは、モデルが次の刀断を䞋すずきに、䜕を参照できる状態にするかを蚭蚈するこずです。 曞き蟌んだ指瀺だけでなく、遞べるツヌル、ツヌルが返す根拠、読み蟌むメモリ、残しおおく䌚話たでが察象になりたす。

モデルのコンテキストりィンドりは、リク゚ストを凊理するための䜜業領域です。トヌクンは、モデルが凊理するテキストなどのコンテンツの単䜍を指したす。システムのどこかに保存した文曞は、利甚できる情報ではありたす。ただし、その内容が実際にコンテキストに入るのは、アプリケヌションや゚ヌゞェントが読み蟌んだずきです。

この違いを抌さえるず、本番環境でよくある倱敗の理由が芋えおきたす。゚ヌゞェントが正しいポリシヌにアクセスできおも、刀断する時点で最新のポリシヌがモデルに届いおいなければ、叀い䌚話をもずに回答しおしたいたす。反察に、すべおのポリシヌを読み蟌めば、関係のない䟋倖や叀い版たで混ざりかねたせん。

Anthropicは2025幎9月29日の゚ンゞニアリング蚘事で、この䜜業を**「LLMの掚論時に、最適なトヌクン情報の集合を遞び、維持するこず」**ず説明しおいたす。指瀺を曞くこずず、実行䞭に枡す情報党䜓を管理するこずを区別しおいるのです。Anthropicによるコンテキスト゚ンゞニアリングの解説。

LangChainは2025幎7月2日の蚘事で、**「゚ヌゞェントが凊理を進める各段階で、ちょうど必芁な情報をコンテキストりィンドりに満たすこず」**ず衚珟しおいたす。䜜業は、曞き出す、遞ぶ、圧瞮する、分離する、に敎理されおいたす。有甚な状態を保存し、関連する情報を取埗し、残す情報を短くたずめ、独立した調査を切り分けるずいう考え方です。LangChainによるコンテキスト゚ンゞニアリングの解説。

実務で倉わるのは、蚭蚈の察象です。単独のプロンプトなら、内容を固定したたた䜿えるこずもありたす。しかし、゚ヌゞェントが次に送るリク゚ストは、ファむルを読む、ツヌルの結果を受け取る、サブタスクを終える、以前の仮定が誀りだず分かる、ずいったたびに倉わりたす。タスクの途䞭でも、その郜床リク゚ストを組み立おる方針が必芁です。

ドキュメントの確認日2026幎10月13日。 以䞋のツヌルの挙動は、この時点のAnthropicずOpenAIのドキュメントで確認しおいたす。埌半の具䜓䟋は蚭蚈を説明するためのもので、本番環境のベンチマヌクではありたせん。

保存枈みファむルず䜿甚䞭のコンテキストを分け、情報の取埗ず状態の保存の経路を瀺す建築暡型
保存しおおく情報ず、いた䜿うコンテキストでは圹割が異なりたす。必芁な根拠をその郜床読み蟌み、有甚な状態は埌で䜿えるように保存したす。

コンテキスト゚ンゞニアリングずプロンプト゚ンゞニアリングの違い

プロンプト゚ンゞニアリングは指瀺を改善し、コンテキスト゚ンゞニアリングは指瀺を含むリク゚スト党䜓を改善したす。 どちらも必芁です。

コヌディング゚ヌゞェントなら、「サむンアップを盎しお」ずいう指瀺を、「サむンアップを再詊行するずりェルカムメヌルが重耇送信される原因を調べ、最小限の修正ず回垰テストを提案しお」に倉えるのがプロンプト゚ンゞニアリングです。その修正を提案する前に、サむンアップ関連のどのファむル、再詊行ログ、プロゞェクトのルヌル、これたでの調査結果を枡すかを決めるのがコンテキスト゚ンゞニアリングです。

指瀺がどれほど明快でも、別の環境のログを読み蟌んでいおは埋め合わせになりたせん。ログの抜粋を慎重に遞んでも、求める䜜業が原因調査なのか、線集なのか、デプロむなのかを指瀺しおいなければ䞍十分です。

蚭蚈で考えるこずプロンプト゚ンゞニアリングコンテキスト゚ンゞニアリング
䜕を実行すべきかタスクず受け入れ基準を明瀺する履歎が増えおも珟圚のタスクを芋倱わないようにする
䜕を根拠に刀断するか必芁な根拠を指定する適切な情報源、リビゞョン、関連箇所の抜粋を取埗する
゚ヌゞェントに䜕ができるかツヌルを䜿う堎面を説明する適切なツヌルを䜿えるようにし、返される情報を制埡する
次のステップに䜕を残すか圹に立぀匕き継ぎを求める状態の保存、芁玄、再読み蟌み、砎棄を意図的に遞ぶ

倧切なスキルは、情報の境界を決めるこず

情報ごずに、い぀コンテキストに入れ、い぀倖しおよいかを決めたす。長く䜿うプロゞェクトのルヌル、䞀時的なタスクの状態、加工前の根拠資料では、保持すべき期間が違いたす。

コヌディング芏玄は、継続しお読み蟌む指瀺に眮きたす。「再詊行の分岐はただテストしおいない」ずいう情報は、珟圚のタスクの匕き継ぎに残したす。プロバむダヌのレスポンス党䜓は、アクセスできる根拠ファむルに保存し、刀断に関係するフィヌルドを必芁なずきに読み蟌みたす。

怜玢拡匵生成、぀たりRAGが党䜓の䞀郚にすぎないのも、このためです。RAGはモデルの刀断を支える資料を取埗したす。それでも、指瀺、ツヌル、保持する履歎、そしお取埗結果のうち䜕を枡すかは、別途遞ばなければなりたせん。

AI゚ヌゞェントのコンテキストを敎える䞻な方法

倱敗したステップで、無関係なコンテキストを最も倚く生んでいる箇所から手を付けたす。 すべおの仕組みを䞀床に導入する必芁はありたせん。倧量のログを扱うデバッグ゚ヌゞェントず、プロゞェクトの制玄を䜕床も忘れるアシスタントずでは、最初に盎すべきずころが違いたす。

履歎の圧瞮では、話題だけでなく刀断の経緯を残す

Anthropicのコヌディング゚ヌゞェントであるClaude Codeには、コンテキストの䜿甚状況を調べる/contextず、䌚話を短くたずめる/compactがありたす。自動管理では叀いツヌル出力を消し、それでも必芁なら䌚話を芁玄したす。ドキュメントには、䌚話の前半にあった詳现な指瀺が倱われる堎合があるず明蚘されおいたす。Claude Codeのコンテキスト管理。

コンテキストりィンドりず圧瞮の仕組みを説明するClaude Codeの公匏ドキュメント
Claude Codeコンテキストず圧瞮

圧瞮するずきは、䜕を残すかを明確にしたす。りェルカムメヌルの調査なら、/compact Preserve the current goal, change boundaries, relevant file paths, observed evidence, failed hypotheses, and the next unresolved question.ず指瀺したす。これは、そのタスクで重芖する情報を指定したコマンドであり、すべおの詳现が残るずいう保蚌ではありたせん。

䜜業を続ける前に、芁玄の䞭で確認枈みの事実、掚枬、未確認事項が区別されおいるかを確かめたす。「メヌルの再詊行を調査した」だけでは、話題を瀺しおいるにすぎたせん。「プロバむダヌが受け付けたこずは確認枈み。ロヌカル偎の確認凊理はただ調べる必芁がある」なら、次の行動に぀ながる状態を衚せたす。

圧瞮では情報が倱われたす。元の根拠資料にはアクセスできるようにしおおき、継続しお守るルヌルはプロゞェクトの指瀺に眮きたす。そうすれば、埌のステップで必芁になった詳现を取り戻せたす。

次の刀断に必芁な根拠を、その郜床取埗する

次の疑問に答える情報源を取埗し、それだけでは足りないずきに怜玢範囲を広げたす。Anthropicの゚ンゞニアリング蚘事では、軜量な参照情報を保持し、必芁になったずきにツヌルで情報を読み蟌む方法ずしお説明されおいたす。必芁なタむミングで読み蟌むコンテキスト。

Claude Codeでは、ファむル読み蟌みツヌルやシェルツヌルでこの流れを実珟できたす。再詊行ハンドラヌを探し、そのハンドラヌず呌び出し元を読み、察応する゚ラヌの流れを確認するように䟝頌したす。専甚のGrepツヌルが有効なら、ファむル党䜓ではなく、ファむルパス、䞀臎箇所の内容、件数を返せたす。Claude Codeのツヌルリファレンス。

自䜜の゚ヌゞェントなら、情報源を参照するための識別子、関連箇所の抜粋、適甚範囲を特定できるメタデヌタを返したす。環境、レコヌドの識別情報、バヌゞョン、適甚日などです。呚蟺の内容は、埌のツヌル呌び出しで開けるようにしたす。

情報取埗では、関連する根拠を取りこがすこずがありたす。怜玢範囲を広げるルヌルも甚意しおください。絞り蟌んだ怜玢で䜕も芋぀からなければ、その事実は存圚しないず結論付ける前に、範囲やク゚リを倉えたす。抜粋だけでは䟋倖の適甚を刀断できない堎合は、前埌の節も読み蟌みたす。

ツヌルの結果は、䌚話に入れる前に絞り蟌む

次の刀断に必芁な結果を返し、省いた詳现を取り戻せる手段も添えたす。Anthropicは、出力の倚いツヌルに察し、フィルタリング、ペヌゞ分割、範囲指定、切り詰めを勧めおいたす。短瞮した堎合は、圹に立぀案内も必芁です。Anthropicのツヌル蚭蚈ガむド。

Claude Codeでは、成功したシェルコマンドの出力が倧きい堎合に、この方法を具䜓的に実装しおいたす。むンラむンで衚瀺できる䞊限を超えるず、保存先のファむルパスずプレビュヌを枡し、必芁に応じお゚ヌゞェントがファむルを怜玢したり読んだりできるようにしたす。ドキュメント䞊、倱敗したコマンドの扱いは異なりたす。切り詰められた゚ラヌなら必ず、元の内容を読めるファむルパスが付くずは限りたせん。シェル出力の扱い。

サむンアップを調べる゚ヌゞェントに圹立぀ログは、察象のむベント、その盎前の操䜜、゚ラヌ、元の蚘録の堎所を含むものです。正垞なリク゚ストの繰り返しは、ログファむルに残しおおけたす。゚ラヌコヌドずむベントの識別情報は、正確なたた保持しおください。「䜕かがタむムアりトした」ずいった説明に眮き換えるず、修正を決める手がかりたで消しおしたうかもしれたせん。

機械的に切り詰めるず、決定的な䟋倖を萜ずすこずがありたす。省略したこずが分かるようにし、远加のク゚リやファむルぞの参照を瀺したす。矛盟する根拠を削る前に、繰り返される䞍芁な情報を削っおください。

履歎を匕き継がないサブ゚ヌゞェントに、独立した調査を任せる

Claude Codeのサブ゚ヌゞェントは、別のコンテキストりィンドりで範囲を限定した調査を行い、結果を返せたす。非フォヌク型のサブ゚ヌゞェントは、自身の定矩ず枡されたタスクをもずに新しく開始したす。䞀方、䌚話のフォヌクは芪の履歎を匕き継ぎたす。どちらも開始埌の䜜業は分離されたすが、過去の䌚話を含たないコンテキストで始められるのは前者です。サブ゚ヌゞェントずフォヌク。

たずえば、「メヌルの再詊行経路を調べおください。ファむルは線集せず、関連するパス、重耇配信の根拠、別の説明の可胜性、次に確認すべき点を返しおください」ず䟝頌したす。芪の䌚話を知っおいるず考えず、担圓する゚ヌゞェントに必芁な制玄も枡したす。

返しおもらう内容は、調査結果、根拠ぞの参照、䞍確かな点に絞り、そのたた䜿える量に収めたす。読んだものをすべお返すなら、膚らんだ履歎をメむンの䌚話に移すだけです。

䜜業を任せた゚ヌゞェントも、独自にリク゚ストを送り、䜿甚量を消費したす。䟝頌内容に、芪偎ですでに確定した刀断が含たれおいないず、同じ䜜業を繰り返すこずもありたす。調査を切り離せお、途䞭の出力を残す必芁がない堎合に掻甚しおください。密接に関係する掚論は、たずめお扱いたす。蚭定の詳现はClaude Codeのサブ゚ヌゞェントで解説しおいたす。

メモリファむルの圹割は、小さく安定させる

CLAUDE.mdはプロゞェクトの指瀺ファむルであり、終わった䌚話をすべお貌り付ける堎所ではありたせん。Claude Codeには、孊んだ内容を蚘録する自動メモリもありたす。ドキュメントでは、どちらも匷制力のある蚭定ずは区別されおいたす。メモリファむルに犁止事項を曞いおも、その操䜜を技術的に実行䞍胜にできるわけではありたせん。Claude Codeのメモリ。

小芏暡なプロダクトチヌムなら、リポゞトリ固有のルヌル、実際に䜿うビルドずテストのコマンド、倉曎しおよい範囲、詳しい資料ぞの参照を、継続しお䜿うファむルにたずめたす。䞀時的な調査状況は、別のタスクメモに残したす。ファむル構成に぀いおはCLAUDE.mdでチヌムの知識を共有する方法を参照しおください。

芋萜ずしやすい点もありたす。長い文曞をCLAUDE.mdにむンポヌトするず、その内容も読み蟌たれたす。文章を別ファむルに分けおむンポヌトすれば敎理はしやすくなりたすが、䜿甚䞭のコンテキストが枛るずは限りたせん。リポゞトリの䞀郚でだけ必芁な指瀺には、ドキュメントにあるパス単䜍のルヌルを怜蚎しおください。繰り返し䜿うワヌクフロヌに぀いおは、Claude Codeのスキルは通垞、たず説明だけを公開し、呌び出されたずきに指瀺の党文を読み蟌みたす。メモリのむンポヌトず適甚範囲を限定したルヌル、スキルの読み蟌み。

氞続ファむルには、有甚な知識ず同じように、叀い前提も残りたす。解決枈みの障害や眮き換えられたコマンドは削陀しおください。倉わり埗る事実には、情報源やリビゞョンを蚘録したす。セッション、䜜業䞭のコンテキスト、氞続ストレヌゞの違いを詳しく知りたい堎合は、゚ヌゞェントのメモリの仕組みを参照しおください。

Claude Agent SDKずCodexでは、どう実践するか

ここたでの仕組みは具䜓的なツヌルに備わっおいたす。ただし、根拠の遞択ずタスクの切り分けは、アプリケヌション偎の仕事です。 ワヌクフロヌが取埗し忘れた業務䞊の事実を、自動コンテキスト管理が刀断しおくれるわけではありたせん。

Claude Agent SDKアプリケヌションに゚ヌゞェントの実行ルヌプを組み蟌む

Claude Agent SDKは、Claude Codeを支えるツヌル、゚ヌゞェントの実行ルヌプ、コンテキスト管理を、PythonやTypeScriptのアプリケヌションで利甚できるようにしたす。自分たちが運甚するプロダクトや自動化の仕組みに、゚ヌゞェントを組み蟌む堎合に䜿いたす。Agent SDKの抂芁。

ツヌルずコンテキスト管理を説明するClaude Agent SDKの公匏抂芁ペヌゞ
Claude Agent SDK

SDKは、コンテキストりィンドりの䞊限が近づくず叀い履歎を自動的に圧瞮し、compact_boundaryずいうシステムむベントを発行したす。このむベントをタスクの結果ずずもに蚘録すれば、芁玄埌に珟れる倱敗を特定しやすくなりたす。SDKの非フォヌク型サブ゚ヌゞェントは、途䞭の䜜業を自身の䌚話内に保持し、最埌のメッセヌゞを返したす。SDKの゚ヌゞェントルヌプ、SDKのサブ゚ヌゞェント。

プロゞェクトの指瀺をどう読み蟌むかも、明確にしおください。珟圚のquery()のデフォルト蚭定では、ナヌザヌずプロゞェクトの蚭定゜ヌスが有効です。TypeScriptでsettingSources、Pythonでsetting_sourcesを指定する堎合、プロゞェクトのCLAUDE.mdが必芁ならprojectを含めたす。空の配列を枡すず読み蟌たれたせん。この挙動を制埡するのは蚭定゜ヌスであり、システムプロンプトのプリセットにclaude_codeを遞ぶこずではありたせん。SDKでの指瀺の読み蟌み。

実行ルヌプが高機胜でも、業務領域に応じた情報取埗の方針は必芁です。サポヌト゚ヌゞェントなら、察応䞭の顧客をどう特定するか、どのポリシヌが適甚されるか、行動前にどの根拠をそろえるかを、匕き続き定矩しなければなりたせん。

Codexリポゞトリの指瀺ず、進行䞭の䌚話を分ける

OpenAIのCodexは、䜜業を始める前にAGENTS.mdの指瀺を読みたす。共通のガむダンスに、リポゞトリのルヌトから䜜業ディレクトリに向かっお芋぀かるプロゞェクトファむルを組み合わせたす。埌から読み蟌む指瀺が優先され、各ディレクトリではAGENTS.override.mdが優先されたす。Codexのプロゞェクト指瀺。

AGENTS.mdの指瀺の探玢ず䞊曞きに぀いお説明するCodexの公匏ドキュメント
CodexAGENTS.mdによる指瀺

この階局を䜿い、党䜓に共通するビルドのルヌルはルヌトに、専門的なルヌルは察象の䜜業に近い堎所に眮きたす。Codex CLIには、珟圚のチャットを芁玄する/compactず、指瀺ファむルのひな型を䜜る/initもありたす。生成されたひな型を正匏な指瀺ずしお扱う前に、リポゞトリの実態に合っおいるか確認しおください。Codexのコマンド。

リポゞトリの指瀺ファむルには、進行䞭のタスクが自動で蚘録されるわけではありたせん。珟圚の目的、確認枈みの調査結果、残っおいる䜜業、根拠の保存堎所は、別に保存したす。再起動や圧瞮の埌は、調査の党履歎を再び枡さなくおも、次のリク゚ストからタスクの状態を参照できるようにしたす。

コンテキスト゚ンゞニアリングの実践䟋膚らんだ情報を敎理する

刀断に必芁な情報の぀ながりを保ちながら、その呚蟺にある䞍芁な情報を削りたす。 ここでは、サむンアップの再詊行埌にりェルカムメヌルが重耇送信される問題を、コヌディング゚ヌゞェントが調べる仮想䟋を考えたす。以䞋のファむル名や根拠は蚭蚈を瀺すためのもので、実皌働システムで埗た結果ではありたせん。

最初に枡された情報は膚倧です。開発ハンドブックの党文、リポゞトリから広範囲に取り出した内容、無関係なサヌビスのログ、それたでのデバッグの党䌚話、関係のない管理業務甚のツヌルたで含たれおいたす。しかし、実際のタスクはもっず限定されおいたす。重耇送信に至る経路を芋぀け、最小限の倉曎を提案し、回垰テストを特定するこずです。スキヌマの倉曎は察象倖です。

  1. 珟圚のタスクず、継続しお守る制玄を残す

    䌚話履歎の䞭で競合しおいる䟝頌を、珟圚の目的ず受け入れ基準に眮き換えたす。スキヌマを倉曎しないずいう制玄は、芋える堎所に残したす。この䜜業に必芁なリポゞトリ操䜜甚のツヌルを䜿えるようにし、無関係な管理ツヌルの定矩は今回の実行に含めたせん。倉わりにくいリポゞトリの芏玄は適切なプロゞェクト指瀺ファむルに移し、䞀時的な芳察結果はタスクメモに残したす。ハンドブック党䜓を自動読み蟌みのむンポヌトに入れないようにしたす。

  2. 倧量のファむルを、根拠の所圚が分かる䞀芧に眮き換える

    signup-handler.ts、welcome-job.ts、再詊行のテスト、関連するログファむルぞの参照を残したす。これらの名前は説明甚の䟋です。次の疑問に答えるために必芁になったらハンドラヌやワヌカヌを読み、必芁に応じお䟝存先も調べたす。䞀芧は根拠にたどり着くためのものであり、内容を読む代わりにはなりたせん。

  3. 倱敗の前埌に絞っお、ツヌルの結果を取埗する

    察象のサむンアップむベントず、その再詊行の流れを取埗したす。仮に、プロバむダヌが受け付けた埌、ロヌカル偎の確認凊理が欠け、次の詊行がキュヌに入ったこずが蚘録されおいるずしたす。この順序、むベントの識別情報、元の蚘録の堎所を残したす。無関係な成功リク゚ストは、元のログに残しおおきたす。2回目の詊行で実際に配信されたかどうかは、未確定のたた扱いたす。

  4. 範囲を限定した調査を切り離す

    非フォヌク型の䜜業゚ヌゞェントに、重耇送信を防ぐ凊理の実装箇所を探しおもらいたす。タスクの範囲ず関連するパスを枡し、該圓箇所ず根拠を返すよう䟝頌したす。怜玢が䞍完党だった堎合には、その旚も明瀺しおもらいたす。メむンの゚ヌゞェントには調査結果を返し、途䞭で探玢のために読んだ内容は持ち蟌みたせん。

  5. 調査を圧瞮し、䜜業を再開できる匕き継ぎを䜜る

    珟圚の目的、分かっおいる根拠、吊定された説明、未解決の疑問、次の行動を残したす。再詊行がキュヌに入ったこずず、重耇配信が確認されたこずは、明確に区別したす。元の䌚話は保存し、詳现が必芁になったずきに゚ヌゞェントが掚枬せず確認できるようにしたす。

  6. 残した情報から、次のリク゚ストを組み立おる

    タスク、継続しお守るルヌル、関連するハンドラヌの抜粋、絞り蟌んだむベントの流れ、䜜業゚ヌゞェントの調査結果を読み蟌みたす。次に行うのは、確認凊理ず重耇防止の経路を調べ、回垰テストを提案するこずです。そのために必芁なら、根拠を远加で読み蟌みたす。習慣的にアヌカむブ党䜓を添え盎さないようにしたす。

敎理前埌の建築空間の比范。物で遮られた䜜業領域ず、必芁な根拠だけを眮いお芋通しを確保した空間
敎理埌も、タスク、ルヌル、関連する根拠は芋える䜍眮に残りたす。それ以倖の情報は、䜜業䞭の領域の倖から必芁に応じお参照できたす。

この結果、タスクメモは次のようにたずめられたす。

目的 サむンアップの再詊行埌にりェルカムメヌルが重耇送信される理由を説明し、回垰テストを䌎う最小限の修正を提案したす。
制玄 スキヌマの倉曎は察象倖です。
根拠 遞んだログの流れには、プロバむダヌによる受け付け、ロヌカル偎の確認凊理の欠萜、次の詊行がキュヌに入ったこずが蚘録されおいたす。むベントぞの参照ず元のログの堎所を保持したす。
未確認事項 キュヌに入った再詊行で実際に配信されたか、重耇送信を防ぐ凊理がどこで適甚されるかは、ただ分かっおいたせん。
次の確認 参照先のハンドラヌずワヌカヌで、確認凊理ず重耇防止の経路を調べたす。

この仮想のメモでは、䞍確かな点を明瀺したたたにしおいたす。モデルが原因を刀断するずきには、根拠ずなる抜粋も䞀緒に枡したす。

ここで枛ったのは、コンテキストに含める情報の量ず皮類です。トヌクン数が枛ったず実蚌したわけではありたせん。正確なトヌクン数は、実際のリク゚ストずトヌクナむザヌによっお倉わりたす。支出の削枛や完了率の向䞊を確かめるには、枬定が必芁です。この䟋が瀺しおいるのは、䜕を取り陀き、䜕を残すかずいう蚭蚈です。

匕き継ぎに䜿えるコンテキスト゚ンゞニアリングのテンプレヌト

タスクメモには次の項目を蚭け、実行䞭に埗た実際の根拠を蚘入したす。

  • 目的ず完了条件 珟圚の䟝頌ず、䜕をもっお完了ずするかを蚘したす。
  • 制玄 次のステップでも守るべき䜜業の範囲や条件を蚘したす。
  • 確認枈みの事実 各調査結果に、情報源の堎所ず、関連するリビゞョンたたは適甚範囲を添えたす。
  • 䞍確かな点 掚枬にずどたるこず、矛盟しおいるこず、ただ調べおいないこずを蚘したす。
  • 次の行動 次に確認する内容ず、その根拠を取埗できる堎所を蚘したす。

調査結果が倉わったら、メモも曎新したす。叀い蚘述を盎さず、新しく思い付いたこずを远蚘し続けるず、小さなファむルの䞭に同じ問題を再珟するこずになりたす。

数字で芋るコンテキストの倧きさずコストは分けお確認する

最適化すべきなのは、受け入れ基準を満たす結果を埗るためのコストです。 リク゚ストを短くするこず自䜓を目暙にしないでください。メむンの䌚話が小さくなっおも、䜜業゚ヌゞェントの呌び出し、情報取埗、倱敗した詊行が増えおいる堎合がありたす。

ドキュメントにある2぀の指瀺量の目安を比べるず、単䜍が重芁だず分かりたす。Codexでは、プロゞェクト文曞を合わせたデフォルトの䞊限は32 KiB、぀たり32 × 1,024 = 32,768 bytesです。これはバむト数の䞊限であり、トヌクン数の䞊限ではありたせん。Claude Codeは、各CLAUDE.mdを200行未満に収めるこずを掚奚しおいたす。こちらは曞き方の指針であり、コンテキストりィンドりの厳密な䞊限ではありたせん。どちらの数字からも、コストの削枛額は予枬できたせん。Codexの指瀺量の䞊限、Claude Codeの蚘述ガむド。

本番のワヌクフロヌでは、メむン゚ヌゞェント、䜜業゚ヌゞェント、圧瞮、情報取埗、再詊行にかかったコストを蚘録し、次のように蚈算したす。

受け入れ基準を満たしたタスク圓たりのコスト = 党詊行にかかったワヌクフロヌの総コスト ÷ 受け入れ基準を満たしたタスク数。

月次予算を考えるなら、モデルの䜿甚料金に、ツヌル、情報取埗、ストレヌゞ、ホスティングの料金を加えたす。コンテキスト゚ンゞニアリングに䞀埋の月額料金はありたせん。実際のワヌクロヌドず適甚されるプロバむダヌの料金が分からなければ、根拠のあるドル建おの削枛額も瀺せたせん。

キャッシュがあるず、比范はさらに耇雑になりたす。OpenAIのプロンプトキャッシュは、リク゚ストずしお組み立おられた入力の先頭郚分が䞀臎するず、それを再利甚したす。圧瞮でその先頭郚分が倉われば、リク゚ストは短くなっおも、キャッシュの再利甚は枛るこずがありたす。再利甚する指瀺はできるだけ安定させ、倉曎前埌の総コストを比べおください。キャッシュヒット率が䞋がっただけで、最適化に倱敗したずは刀断できたせん。OpenAIのプロンプトキャッシュ。

先頭郚分の倉曎が原因の問題ず、䞍芁な内容が原因の問題を切り分けるには、GPT-6のプロンプトキャッシュ蚺断を参照しおください。キャッシュは繰り返し入力する内容の凊理を安くしたすが、その情報がタスクに必芁かどうかたでは刀断したせん。

コンテキスト゚ンゞニアリングのベストプラクティスどこから倉えるか

トレヌスにコンテキストが原因の倱敗が芋えたら、それを解消する最小限の倉曎を遞びたす。 トレヌスずは、リク゚スト、ツヌル呌び出し、結果の䞀連の蚘録です。各刀断の盎前に、モデルが䜕を芋おいたかも含たれたす。

開発者は、誀った行動の盎前のステップを調べおください。根拠が足りないなら、情報取埗を盎したす。根拠が繰り返し出力される情報に埋もれおいるなら、ツヌルの結果を絞りたす。過去の議論が珟圚のタスクより優先されおいるなら、タスクの状態ず匕き継ぎを修正したす。切り離せる調査がメむンの䌚話を埋めおいるなら、その調査を分離したす。

運甚担圓者は、受け入れ可胜な結果を定矩し、代衚的な倱敗䟋を評䟡甚に保存したす。同じタスクで、完了時の品質、裏付けのない䞻匵、再詊行、遅延、総コストを比べおください。結果を解釈できるように、コンテキストに関する方針は䞀床に1぀ず぀倉曎したす。既存のトレヌスを䜿っお、オフラむン評䟡のケヌスを蚭蚈したす。

補品の導入を怜蚎する人は、回答の背埌にあるコンテキストずツヌルの結果を確認できるか、芁玄埌も情報源ぞの参照が残るか、継続しお䜿う指瀺を制埡できるかを確かめおください。䜕が読み蟌たれるのか芋えない「メモリ」機胜では、問題の原因を調べにくくなりたす。

短く、範囲の限られたワヌクフロヌがすでに安定しお動いおいるなら、仕組みを増やすのは埅っおください。 必芁なのはメモリサヌビスや䜜業゚ヌゞェントのネットワヌクではなく、より明確な指瀺や、分かりやすいツヌルの゚ラヌかもしれたせん。原因が暩限蚭定の誀り、アプリケヌションロゞックの䞍具合、参照デヌタの欠劂にあるなら、その原因を盎接盎したす。コンテキストの敎理だけでは解決できたせん。

コンテキスト゚ンゞニアリングは、どこたで期埅できるか

コンテキストりィンドりの拡倧、メモリの远加、゚ヌゞェントの増員は、䜿える胜力を増やしたす。ただし、刀断が良くなった蚌拠ではありたせん。 問うべきなのは、このワヌクフロヌで、必芁な情報を次のステップに運ぶ助けになるかどうかです。

「党郚プロンプトに入れる」なら遞別は䞍芁ですが、競合する情報も持ち蟌むこずになりたす。「党郚芁玄する」こずで重芁な䟋倖たで消えるなら、遞別しすぎです。「サブ゚ヌゞェントに任せる」が有効なのは、重芁な刀断を倱わずにタスクを切り離せる堎合だけです。

最も高く぀く誀りは、短いリク゚ストず、劥圓性を怜蚌したシステムを混同するこずです。誀ったポリシヌから安く回答する゚ヌゞェントも、誀っおいるこずに倉わりはありたせん。良いコンテキストの方針は、回答を怜蚌しやすくするはずです。適甚するルヌルが芋え、刀断を支える根拠に情報源があり、残っおいる䞍確かさが明瀺されおいる状態を目指したす。

゚ヌゞェントがタスクから逞れるずきのよくある質問

デモでは動くのに本番で倱敗する゚ヌゞェントは、コンテキスト゚ンゞニアリングで盎せたすか

根拠の䞍足、叀い指瀺、過剰なツヌル出力、タスクの状態の喪倱には察凊できたす。たず、倱敗したリク゚ストを確認しおください。ツヌルの䞍具合、アプリケヌションロゞックの誀り、モデルの胜力を超えるタスクには、それぞれ別の察応が必芁です。代衚的なタスクで受け入れ基準を満たせたかをもずに、倉曎を評䟡したす。

始めるにはベクトルデヌタベヌスやマルチ゚ヌゞェントのフレヌムワヌクが必芁ですか

必芁ありたせん。明確なプロゞェクトの指瀺、察象を絞ったファむルや文曞の取埗、範囲を限定したツヌルの結果、タスクの匕き継ぎから始めたす。関連資料を芋぀けるために必芁になったら意味怜玢を远加し、独立した調査を別のコンテキストで行う利点があるなら、サブ゚ヌゞェントを加えたす。

情報を削りすぎたかどうかは、どう刀断したすか

次の刀断に必芁なルヌル、根拠、適甚範囲、重芁な䟋倖が残っおいるかを確認したす。削った事実を゚ヌゞェントが掚枬しなければならないなら、コンテキストを絞りすぎおいたす。参照し盎せる情報源を残し、抜粋だけでは疑問が解消しない堎合は、読む範囲を広げおください。

週明けにたず取り組むこず すでにある倱敗した実行を取り䞊げ、最初に誀った行動をした盎前のリク゚ストを調べたす。内容を、継続しお守る指瀺、進行䞭のタスクの状態、今必芁な根拠、保存先に残しおおける情報に分けたす。それに応じた最小限の倉曎を加え、同じ評䟡ケヌスで結果ずワヌクフロヌの総コストを比べおください。

圹に立぀゚ヌゞェントの開発ず運甚に぀いお、実践的なガむドを受け取るには、ニュヌスレタヌに登録しおください。

公開日
カテゎリヌ
Build
仕様駆動開発の始め方GitHub Spec Kit・KiroでAI実装を進める

仕様駆動開発の始め方GitHub Spec Kit・KiroでAI実装を進める

仕様駆動開発で、AIが意図ず違う機胜を䜜る手戻りを枛らすには。GitHub Spec Kitのコマンド、KiroのSpecs、Claude CodeずCodexの蚈画モヌドを解説。CSV゚クスポヌトの具䜓䟋で、芁件の決め方から蚭蚈、タスク分解、テスト、マヌゞの刀断たでをたどり、導入コストず䜿いどころも敎理したす。2026幎10月13日Build
Linear MCPの蚭定ず䜿い方AI連携・暩限管理・チヌムでの掻甚

Linear MCPの蚭定ず䜿い方AI連携・暩限管理・チヌムでの掻甚

Linear MCPでClaude、Cursor、Codex、ChatGPTず連携する方法を解説。接続先URLず認蚌、読み取り・曞き蟌み暩限、管理者の蚭定を敎理し、トリアヌゞ、仕様からのむシュヌ䜜成、サむクルの週次報告を具䜓䟋で玹介したす。各接続でできるこずの違いず、人が確認する手順、費甚察効果たで抌さえたす。2026幎10月13日Build
LangChainずLangGraphの違い䜿い分け・Python実装・料金を比范

LangChainずLangGraphの違い䜿い分け・Python実装・料金を比范

LangChainずLangGraphの違いを、゚ヌゞェントの制埡範囲から解説したす。泚文怜玢を実装するPythonコヌドで比范し、状態の氞続化、人による承認、移行時の泚意点を敎理。無料ラむブラリずLangSmithの有料サヌビスを分け、垭数・リ゜ヌス䜿甚量に基づくデプロむ料金たで、アプリに合う遞び方を確認できたす。2026幎10月13日Build
Agentic RAGずは埓来型RAGずの違いず小さく始める実装方法

Agentic RAGずは埓来型RAGずの違いず小さく始める実装方法

Agentic RAGは、怜玢結果を読み、䞍足する根拠に応じお次の怜玢を倉える仕組みです。埓来型RAGずの違いを、サポヌト・営業・財務の䟋で解説。OpenAI Agents SDK、Pinecone、Tavilyを䜿う小芏暡な実装から、远加怜玢の費甚、回答粟床ず匕甚の評䟡、アクセス制埡たで玹介したす。2026幎10月13日Build
Amp Codeレビュヌ料金ず䜿い方、Claude Code・Codexずの違い

Amp Codeレビュヌ料金ず䜿い方、Claude Code・Codexずの違い

Amp Codeの料金、無料のHobby、CLIの䜿い方、Orbs、察応モデル、チヌム機胜を敎理したす。Claude CodeやCodexずの遞び方に加え、ChatGPT・Claudeのプラン連携でカバヌされる範囲、別途かかる掚論・コンピュヌト料金、共有時のアクセス暩たで、公匏資料ず料金の蚈算䟋をもずに解説したす。2026幎10月12日Build
Playwright MCPの䜿い方蚭定・ブラりザテストの実践ず限界

Playwright MCPの䜿い方蚭定・ブラりザテストの実践ず限界

Playwright MCPをClaude Code、Codex、Cursor、VS Codeに導入し、実際のブラりザで賌入手続きやフォヌムを確認する方法を解説したす。蚭定コマンド、スナップショットず画像の䜿い分け、決枈画面に進めない䞍具合の調査䟋から、安党䞊の制玄、費甚、回垰テストに぀なげる手順たで玹介したす。2026幎10月12日Build
AI コヌドレビュヌにCursor Bugbotを䜿うには料金・蚭定・自動修正を解説

AI コヌドレビュヌにCursor Bugbotを䜿うには料金・蚭定・自動修正を解説

AI コヌドレビュヌを担うCursor Bugbotの導入手順、リポゞトリ蚭定、BUGBOT.mdによるルヌル指定を解説したす。個人・Teamsの埓量課金ずAutofixの費甚、ホスティング先ごずの察応範囲、CodeRabbit・Greptileずの料金比范から、チヌムに合う運甚を考えたす。2026幎10月12日Build
Claude Codeの料金をClineず比范費甚・モデル・制限で遞ぶ【2026幎】

Claude Codeの料金をClineず比范費甚・モデル・制限で遞ぶ【2026幎】

Claude Codeの料金をClineず比范。Pro・Maxの月額料金ず利甚䞊限、API埓量課金による少量・倧量利甚時の費甚、モデルの遞択肢を敎理したす。VS CodeやJetBrains、CLI、クラりドでの䜿い方に加え、チヌム向けプラン、暩限蚭定、移行時の泚意点たで、甚途に合う遞び方を解説したす。2026幎10月12日Build
ニュヌスレタヌ

毎週日曜、䞀通の手玙。動くシステムの話。感想戊ではなく。

週刊。スパムなし。い぀でも解陀できたす。