62 lines
3.2 KiB
Markdown
62 lines
3.2 KiB
Markdown
# 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 の配送経路
|