ZedBusabase × Zed

Zedのナレッジベース

Zedはparallel Agent threads、Git worktreeによる分離、edit hunk review、checkpoint restore、MCP toolsを扱えます。Busabaseはthreadを越えて残すべき少数の結果を、証拠と責任ownerを持つreviewed recordへ変換します。

Cross-thread state proposalOwner review待ち
Zed Agent threadから提案された状態を確認するBusabase Inbox
Threadは終了でき、checkpointはfileを戻せます。しかし別teamが何をauthoritativeと扱うべきかは決めません。

5つのeditor surface

Conversation、restore、code review、isolation、shared stateを分ける。

Zedには複数のexecution control surfaceがあります。Task中は連携しますが、retentionとauthorityは異なります。

Surface最適な用途代替できないもの
Agent threadReasoningとtool trajectoryDurable team record
CheckpointMessage境界前のfile stateへ戻すAccepted decision
Change reviewEdit hunkをkeep/rejectCross-system approval
Git worktreeConcurrent repository workを分離Operational ownership
Busabase recordProject/systemを越えるreviewed stateSource code / thread history

Parallel thread topology

1つのprojectに複数のnarrativeがあっても、同じclaimのcurrent stateは1つ。

各Zed threadは固有のagent、context window、conversation historyを持ちます。Summary、compaction、archive、restore、worktree isolationが可能です。生成threadをrepositoryとexternal evidenceに照合してからstable claimを昇格します。

THREAD A

Feature implementation

worktree/feature-a

THREAD B

Regression investigation

worktree/debug

THREAD C

Documentation update

main workspace

01Revision比較
02Conflicting claim解決
03Current owner選定
041つのreviewed stateを提出

Edit reviewはlocal control

Hunkのacceptはcode questionに答え、組織判断には答えない。

Zed review surfaceは変更fileとlineを表示し、hunkごとにkeep/rejectできます。Checkpointはmessage前のcodebaseへ戻せます。その証拠を残し、release readiness、customer impact、migration status、support policyは別にreviewします。

ZED LOCAL

Changed files

Accepted / rejected hunks

Checkpoint boundary

Repository revision

SHARED STATE

Impact claim

Evidence references

Responsible owner

Effective status

Zed diff evidenceに接続されたBusabase review

2つの独立gate

Tool permissionはaction実行を、record reviewは下流での信頼を決める。

Zedはbuilt-in/MCP toolsをconfirm、allow、denyでき、per-tool ruleとterminal hard protectionを持ちます。Tool call成功後もcanonical stateを変えるには証拠と責任reviewerが必要です。

ZED TOOL PERMISSION

Command、edit、fetch、MCP toolを実行してよいか?

BUSABASE RECORD REVIEW

結果を再利用可能な運用上の事実にしてよいか?

3つのAgent path

Native Agent、External Agent、Terminal Threadは同一config contractではない。

Zed AgentはZed-configured MCP serversを利用します。External AgentsはACP転送を受ける場合とnative configを読む場合があります。Terminal ThreadsはCLI/TUI自身のconfigを使います。Toolsとapprovalが同じと仮定せず、実行pathを記録します。

PathMCP / config owner残すevidence
Zed AgentZed settings / Agent ProfileThread、profile、tool calls、revision
External AgentACP forwarding / agent-native configAgent identity、forwarded tools、native session
Terminal ThreadCLI/TUI configurationCommand、environment、repository revision

Decision envelope

元editor sessionなしでreviewできる形に結果をまとめる。

RecordはZed execution artifactを別projectやAgentが使えるstateへ接続します。

state_keyClaimのstable identity
projectZed project / repository
agent_pathZed Agent、External Agent、Terminal Thread
thread_refThreadまたはexported Markdown reference
worktree_revisionExact code state
tool_evidenceCommands、MCP responses、tests、diffs
proposed_stateConcise cross-system outcome
ownerAcceptanceに責任を持つ人
decisionAccepted、conditional、rejected、superseded

Instruction ownership

InstructionsとSkillsは将来のAgent behaviorを形成し、fact databaseにはしない。

Zedはpersonal/project instruction filesをalways-on guidanceに、Skillsをreusable task procedureに使います。Coding conventionとworkflowはそこに置き、evidence-backed product/operation/customer stateはreviewed recordへ保存します。

01

AGENTS.md / project instructions

Always-on behavior / project guidance

02

SKILL.md

On-demand reusable task procedure

03

Busabase

Reviewed claims、decisions、ownership

Connection boundary

接続guideはOAuthとcontext_serversを、このページはhandoff contractを扱う。

Authorization headerなしのremote MCP serverではZedがstandard OAuthを開始します。保守されるguideで設定し、teamが使うAgent path/profileでreadとreview-gated proposalを1回ずつtestします。

実務上の質問

ZedナレッジベースのFAQ

BusabaseはZed threadsを置き換えますか?

いいえ。Threadはworking conversationを保存し、Busabaseはthread、project、toolを越えて残すreviewed outcomeだけを保持します。

Restore Checkpointはapprovalですか?

違います。Fileのlocal restoration boundaryであり、operational claimを承認しません。

全diff hunkをacceptすればcanonicalですか?

いいえ。Editor内でeditを受け入れただけです。Shared stateには別のevidenceとownerが必要です。

全Zed Agent pathが同じMCP configを使いますか?

使いません。Zed Agent、ACP External Agents、Terminal Threadsは異なるconfig boundaryを持ちます。

Project instructionsに変化するbusiness factを保存しますか?

通常は避けます。Behavior guidanceはinstructions、変化するshared factはreviewed recordへ置きます。

1つのcross-thread claimから始める

Editing experienceはZedに任せ、shared stateにreviewable destinationを与える。

Originating threadを越えて残すoutcomeを1つ選び、revision、tool evidence、ownerを関連付け、別projectやAgentが使う前にreviewします。