8.3 KiB
作成
LocalTicketBackend によって作成されました。
Plan
Intake refinement
既存 Ticket 本文・thread・artifacts を確認した。artifacts はなく、thread は作成イベントのみ。
Readiness
- readiness: implementation_ready
- open_questions: なし
- risk_flags: [worktree-layout, ticket-backend, panel-launcher, prompt-workflow-guidance, authority-boundary, merge-completion, cleanup]
Orchestrator / Reviewer focus
- Orchestrator の
pwd、Ticket backend root、original workspace root、implementation worktree root を混同しないこと。 - implementation branch に orchestration branch の Ticket churn を混ぜないこと。
- merge-ready dossier は停止点ではなく checkpoint とし、standing merge authority・reviewer approval・safe target workspace・未解決 human gate なしが揃う場合だけ merge / validation / close or done / cleanup まで進めること。
resources/prompts/*、.yoi/workflow/*、Panel/role launcher の実装が相互に矛盾しないこと。- filesystem Ticket backend 前提の運用分離であり、Git 外 Ticket store 移行や push 自動化は非目標として維持すること。
Validation focus
- targeted tests または workflow-level validation で cwd/backend/root 分離を確認すること。
target/debug/yoi ticket doctorを通すこと。- コード・runtime resource・prompt 変更が含まれるため、完了前に
nix build .#yoiを通すこと。
Intake summary
既存 Ticket 00001KTTB479X は実装・レビュー可能な粒度まで要件化済み。目的は Orchestrator を専用 orchestration worktree で実行し、implementation worktree は original workspace root 配下の sibling .worktree/<ticket> に作る運用・実装・prompt/workflow guidance を整えること。blocking open question はなし。主な risk flags は worktree-layout, ticket-backend, panel-launcher, prompt-workflow-guidance, authority-boundary, merge-completion, cleanup。Orchestrator は cwd/backend/root 分離、orchestration Ticket churn の混入防止、merge-completion authority 条件、prompt/workflow 整合性を重点確認して routing できる。
State changed
Intake refinement により、本文・thread・artifacts を確認し、blocking open question がない implementation_ready Ticket と判断した。ユーザーが panel で queue した後、Orchestrator が routing できる状態にする。
State changed
Ticket を workspace-panel が queued にしました。
State changed
Queue acceptance: unrelated dirty code/profile diffs were identified as stale reverted reviewer-blocker changes from the prior Ticket and were restored before acceptance. The remaining dirty state is this Ticket's workspace-panel queue update. Relation query has no blockers, orchestration-plan query has no existing records, and the Ticket is implementation_ready with explicit requirements for orchestration worktree / original workspace root / merge-completion guidance. Implementation side effects may proceed after this recorded acceptance.
Plan
Routing decision: implementation_ready
Reason:
- Ticket is
queued; user/panel authorized routing and user has given standing authorization to continue through merge-completion when reviewer approval and safety conditions hold. - Relation query has no blockers and orchestration-plan query has no existing records.
- Workspace dirty state was checked. Stale bad role-profile diffs from the previous Ticket were restored; remaining dirty state was this Ticket's queued update.
- Ticket body and Intake refinement contain concrete requirements, acceptance criteria, non-goals, validation focus, and risk flags.
Evidence checked:
- Ticket body/thread/artifacts.
TicketRelationQuery: no blockers.TicketOrchestrationPlanQuery: no records before this routing pass.- Workspace/worktree/branch state: main worktree only before acceptance.
- Visible Pods: no active implementation child Pods.
IntentPacket:
- Intent: make Orchestrator execution and implementation worktree creation explicitly distinguish orchestration worktree cwd/ticket backend from the original workspace root and target merge workspace.
- Binding decisions / invariants: filesystem Ticket backend remains; no Git-external Ticket store; main workspace draft Tickets must not be implicit Orchestrator queue; implementation worktrees are siblings under original workspace root
.worktree/<ticket>and must not be nested under Orchestrator cwd; implementation branches must not include orchestration Ticket churn; prompt/workflow guidance must not reintroduce dossier stop when standing merge authority/safe target/reviewer approval/no human gate are present. - Requirements / acceptance criteria: record design/implementation policy; update Panel/launcher/workflow/prompt guidance as needed; testable handling of Orchestrator cwd, Ticket backend root, original workspace root, implementation worktree root, target workspace/branch, and cleanup policy;
target/debug/yoi ticket doctor; code/runtime resource/prompt changes requirenix build .#yoibefore completion. - Implementation latitude: exact naming/reuse policy for orchestration worktrees and exact split between docs, prompts, workflow text, and launcher code can be chosen if the invariants and tests are met.
- Escalate if implementation requires changing Ticket storage backend authority, introducing push automation, or weakening merge/reviewer/safe-workspace checks.
- Validation: focused tests for launcher/worktree context and prompt/workflow text where practical,
cargo fmt --check,git diff --check,target/debug/yoi ticket doctor, andnix build .#yoi.
Implementation report
Implementation report
Branch/worktree: orchestrator-worktree-layout / .worktree/orchestrator-worktree-layout
Commit:
834caba2 feat: track orchestration workspace roots
Summary:
- Added
docs/design/orchestrator-worktree-layout.mdto record the four-root model:role_workspace_root,original_workspace_root,implementation_worktree_root, andmerge_target_workspace_root. - Extended
TicketRoleLaunchContext/TicketRoleLaunchPlanwith original/target workspace roots and derived implementation worktree root. - Orchestrator launch prompts now emit a
Workspace routing contextsection so the model-visible task can distinguish the role runtime/Ticket backend root from original implementation and merge target roots. - Updated Orchestrator worktree-routing and merge-completion prompt resources so implementation worktrees are created under the recorded original workspace root and merge/cleanup runs against the recorded target workspace, not accidental process cwd.
- Updated
worktree-workflowto use<original-workspace-root>/.worktree/<task-name>andgit -C <original-workspace-root> ...instead of assuming the Orchestrator cwd is the repository root. - Adjusted client Ticket-role prompt tests to cover workspace routing context and standing merge-completion authority behavior.
Validation run in branch:
cargo fmt --checkpassed.cargo test -p client ticket_role --libpassed (18 passed).git diff --checkpassed./home/hare/Projects/yoi/target/debug/yoi ticket doctorpassed.nix build .#yoipassed.
Notes:
- Panel/workspace orchestration can later populate
original_workspace_rootandtarget_workspace_rootwhen launching an Orchestrator from a dedicated worktree. This branch adds the plan/prompt plumbing and workflow policy without changing Ticket storage backend authority or introducing Git-external project records.