yoi/docs/plan/workflow.md

Workflow の方針

Context

Workflow は制約付きの強制的な作業フロー。/<slug> で明示的に呼び出し、依存 Knowledge を context に inject してから実行する。Knowledge（#<slug>）は docs/plan/memory.md 側で定義。

決定事項

呼び出しと依存

• 呼び出し: /<slug>
• 名前空間はフラット、slug は kebab-case（小文字英数とハイフン）
• frontmatter requires: [knowledge-slug, ...] で依存 Knowledge を slug 参照
• 実行時は依存 Knowledge 本文を context に inject してから Workflow 本文を実行

呼び出し制御フラグ

フラグ	意味	デフォルト
auto_invoke	description が LLM context に載り、LLM が自発的に呼べる	OFF
user_invocable	ユーザーが /<slug> で明示的に呼べる	ON

auto_invoke の ON 化は人間の判断、または consolidation からの offer 経由のみ。同じ制御は Knowledge 側（memory.md）でも採用。

格納先とファイル形式

• .yoi/workflow/<slug>.md（ファイル名 = slug がそのまま識別子、name field は持たない）
• .yoi/memory/ は session-derived state 専用、Workflow は配置しない
• frontmatter + Markdown 本文
• frontmatter フィールド: description, auto_invoke, user_invocable, requires

生成・更新ポリシー

Workflow は人間が書く、または consolidation が offer して人間が承認する。自動書き込みは禁止:

• consolidation（memory.md 参照）の write tool schema に workflow カテゴリを含めないことで構造的に担保
• 新規作成 / 手順追加・更新は Event::Notification で提案し、人間承認で反映

Offer 契機

consolidation が以下を検出した場合、Client に Notification を投げる:

• 再利用価値ある手続きの Workflow 化（新規作成）
• 既存 Workflow への改善提案（手順追加・更新）
• auto_invoke ON 化（頻繁に user_invoke されているものを検出）

Scope 外

恒久除外（本設計方針として採用しない）

• Workflow の自律生成（offer までで留める。LLM が勝手に新規 Workflow を生成する経路は設けない）

将来検討（運用で必要性が見えたら追加）

• DSL 化や step 粒度の制約 — 初期は Markdown 本文そのまま実行
• Workflow 実行中の中断・再開・トランザクション管理
• 品質検証フロー: empirical prompt tuning pattern（docs/ref/memory-systems.md §6）相当の新規 subagent 試走 + 構造化報告を Workflow に適用。判定対象は本文の不明瞭点・裁量補完・要件達成率。Knowledge 単体の検証は設けず、requires 経由で Workflow から使われる前提で間接回収。SKILL 的用途（Workflow 経由しない #knowledge）は人間レビューに委ねる

関連

• memory.md: Knowledge 定義、extract/consolidation、Offer の配送経路