---
title: 'LLM向けプロンプト直書きを廃止してresources/promptsへ集約する'
state: 'closed'
created_at: '2026-06-10T07:29:13Z'
updated_at: '2026-06-10T09:08:26Z'
assignee: null
queued_by: 'workspace-panel'
queued_at: '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 全体の大規模再設計。
