Prostir

調査記事

コードベースを理解するAI coding Agent

コードベースを理解するAI coding Agent. coding Agentはrepoの最新ルールとevidenceを読み、Gitとtestを置き換えません。

読む前に

公開内容

実行できる設計: コードベースを理解するAI coding Agent.

に最適

仕事や生活の反復タスク1つにprivate Agentを設計する人。

作業が行われる場所

コードベースを理解するAI coding Agent · Knowledge・Memory・tools · MCP · OAuth

01

実際の課題から始める

coding Agentはrepoの最新ルールとevidenceを読み、Gitとtestを置き換えません。

session間でcontextが失われ、大きなルールfileは古くなります。

02

source of truthを選ぶ

sourceにはowner、date、scope、correctionが必要です。Agentはdataを取得しますが、conversationを事実には変えません。

instruction、decision、example、verify commandをversion管理します。

03

Knowledge・Memory・tools

Knowledgeは承認済み資料、User Memoryは限定されたprivate context、toolsは明示的権限でread/writeします。Memoryはauthorityを与えません。

04

clientが変わっても同じAgent

remote MCP endpointはidentity、instructions、accessを維持します。client、account、transport、OAuthが現在対応する場所だけで接続します。

05

境界と結果を検証

通常質問、欠損・古いdata、拒否action、recoveryを試します。完了、修正、安全な拒否、maintenanceを測ります。

coding clientがeditし、diff、test、human reviewを必須にします。

pilot前に、正しい回答5件、曖昧なcase5件、拒否すべきrequest5件を用意します。使用source、提案action、confirmation、実際の結果を記録し、自然なconversationが誤りを隠さないようにします。

source、rule、client、permissionが変わったらAgentを再検証します。自分が所有するdataとinstructionsをexportし、未使用accessを削除し、flowが作業を増やすのではなく減らすと確認できるまで手動経路を残します。

codebase向けでは、Git内のAGENTS、architecture decision、schema、test command、良いdiff例を検索対象にし、branchとcommit時点を回答に残します。Agentが以前のconversationを覚えていても、現在のfileとtest結果より優先しません。変更後はdiff、build、targeted test、expected/actual outputを揃え、reviewerがsourceを開ける状態で判断します。local editやdeployの権限はcoding client側に残し、context Agentへ暗黙に渡しません。

ソリューション

自分で所有し続けられるAIエージェント作成ツール

一つのAgentを管理し、実際の質問で試し、必要な知識と操作だけを接続して、非公開のまま公開するか、別の判断として一般公開を選べます。Prostirがホスティング、本人確認、保護されたアクセス、対応AIクライアントへの提供を担います。

ソリューション

役立つデモを自分のAgentにする

扱う仕事、利用者、必要な情報源、絶対にしてはいけないことを教えてください。正直に検証できる最初の版を一緒に決めます。