ticket: record new objectives and tickets
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: 'LLM向けプロンプト直書きを廃止してresources/promptsへ集約する'
|
||||
state: 'queued'
|
||||
created_at: '2026-06-10T07:29:13Z'
|
||||
updated_at: '2026-06-10T07:49:23Z'
|
||||
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 全体の大規模再設計。
|
||||
@@ -0,0 +1,32 @@
|
||||
<!-- event: create author: "yoi ticket" at: 2026-06-10T07:29:13Z -->
|
||||
|
||||
## 作成
|
||||
|
||||
LocalTicketBackend によって作成されました。
|
||||
|
||||
---
|
||||
|
||||
<!-- event: intake_summary author: ticket-intake at: 2026-06-10T07:41:49Z -->
|
||||
|
||||
## Intake summary
|
||||
|
||||
既存 Ticket を確認し、`crates/client/src/ticket_role.rs` の `build_launch_prompt` / `TicketIntakeHandoff::append_prompt_lines` / Orchestrator・Coder・Reviewer execution guidance に LLM-facing prompt prose の直書きがあること、および `resources/prompts` 側に既存 prompt catalog があることを確認した。要件・受け入れ条件・非目標は実装判断に十分で、未決定の blocking question はない。readiness: implementation_ready。risk_flags: [prompt-context, runtime-resource, role-launch, override-semantics, workflow-boundary]。実装時は Ticket role launch の semantic を維持し、runtime 値の bounded/sectioned 埋め込みと user override 可能性を壊さず、残す hardcoded 文言が LLM prompt ではない理由を thread/implementation report に記録すること。関連参考: closed `00001KTCDHFPG`（Ticket role config）, closed `00001KSTRAW70`（prompt catalog を使った tool description）, planning `00001KSKBPAXR`（内部 Worker/Pod prompt の将来 Workflow 化）。
|
||||
|
||||
---
|
||||
|
||||
<!-- event: state_changed author: ticket-intake at: 2026-06-10T07:41:49Z from: planning to: ready reason: intake_ready field: state -->
|
||||
|
||||
## State changed
|
||||
|
||||
Intake により要件同期済み。blocking open question はなく、Orchestrator が routing 可能な concrete work item として ready にする。
|
||||
|
||||
---
|
||||
|
||||
<!-- event: state_changed author: workspace-panel at: 2026-06-10T07:49:23Z from: ready to: queued reason: queued field: state -->
|
||||
|
||||
## State changed
|
||||
|
||||
Ticket を `workspace-panel` が queued にしました。
|
||||
|
||||
|
||||
---
|
||||
Reference in New Issue
Block a user