yoi/.yoi/tickets/00001KTR6YVDB/item.md

title	state	created_at	updated_at	assignee	queued_by	queued_at
LLM向けプロンプト直書きを廃止してresources/promptsへ集約する	queued	2026-06-10T07:29:13Z	2026-06-10T07:49:23Z	null	workspace-panel	2026-06-10T07:49:23Z

背景

この repository の設計要旨では、プロンプトはすべて resources/prompts に集約することになっている。管理効率・override 可能性・レビュー容易性のため、Rust code や workflow 起動処理に LLM-facing prompt 文言を直書きしてはいけない。

現在、少なくとも Ticket role launch / Intake handoff 周辺では、LLM に渡る generated launch prompt が crates/client/src/ticket_role.rs に直書きされている。例として build_launch_prompt、TicketIntakeHandoff::append_prompt_lines、role-specific execution guidance などが該当する。これらは UI label / notice ではなく model context に入る prompt なので、resources/prompts 管理へ移す必要がある。

この Ticket は Intake 文言だけでなく、LLM に渡る hardcoded prompt prose 全体を audit し、resources/prompts 経由に移すためのものとする。

要件

• LLM-facing prompt 文言を Rust code に直書きしない。
• Ticket role launch prompt の固定文言を resources/prompts 配下へ移す。
  • # Ticket role launch から始まる launch context guidance。
  • Ticket id / language / user instruction / handoff / intent packet / worktree / validation / report expectation の説明文。
  • Intake handoff guidance。
  • Orchestrator / coder / reviewer 向け role execution guidance。
• Intake workflow の本体文言は引き続き .yoi/workflow/ticket-intake-workflow.md を正とし、launch prompt 側には必要最小限の runtime context と参照関係だけを載せる。
• resources/prompts に追加する prompt resource は、用途・入力変数・出力境界が分かる単位に分割する。
• Rust 側は prompt resource を読み込み、必要な runtime 値を安全に埋め込むだけにする。
• prompt resource の読み込みは既存の prompt/resource 管理方針に合わせる。
  • bundled resource として扱うべきものは compile-time embedded resource に含める。
  • user override 可能性を壊さない。
• repository 内の hardcoded LLM-facing prompt prose を audit し、少なくとも既知の Ticket role launch 系はこの Ticket で解消する。
• 残す文言がある場合は、UI 表示文言・diagnostic・protocol literal など、LLM prompt ではない理由を明確にする。
• 将来の再発を防ぐため、可能なら grep しやすい境界・テスト・lint 的な確認を追加する。

受け入れ条件

• crates/client/src/ticket_role.rs から LLM-facing prompt prose の大きな直書きがなくなっている。
• Ticket role launch で LLM に渡る固定 guidance は resources/prompts の prompt resource から組み立てられる。
• Intake handoff の LLM-facing guidance が Rust 直書きではなく prompt resource 管理になっている。
• Orchestrator / coder / reviewer role execution guidance が Rust 直書きではなく prompt resource 管理になっている。
• runtime 値の埋め込みは prompt injection を広げない形で bounded / escaped / sectioned に維持される。
• 既存の Ticket role launch behavior は semantic に維持される。
• resources/prompts 側の resource 名・責務が明確で、後続の文言修正を code edit なしで行える。
• targeted tests が追加・更新され、launch prompt が resource 経由で生成されることを確認している。
• repository audit の結果が Ticket thread または implementation report に記録され、残存する hardcoded LLM-facing prose がない、または非対象理由が明示されている。
• cargo test -p client ticket_role または該当する targeted test が通る。
• target/debug/yoi ticket doctor が通る。

非目標

• TUI の表示ラベル、status line、notice、error diagnostic など、LLM に渡らない UI 文言を resources/prompts に移すこと。
• workflow markdown 本体を resources/prompts に移すこと。project-authored workflow は .yoi/workflow が正である。
• protocol literal、tool name、field name、file path、command name を翻訳・抽象化すること。
• prompt resource system 全体の大規模再設計。