> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ベストプラクティス

> Waker 設計、対話のコツ、WakerFlow の利用、コスト最適化に関する実用的なアドバイス。

このページでは、QoderWake で効率的に作業するためのノウハウを、Waker 設計、対話のコツ、WakerFlow のオーケストレーション、コスト最適化の 4 つの観点からまとめています。

## Waker 設計

* **単一責務**:各 Waker は明確な専門領域を持つべきであり、責務が広範になりすぎないようにします。たとえば「セキュリティ監査の専門家」は「フルスタックエンジニア」よりも優れています。
* **Identity は具体的に**:役割の位置づけ、専門的背景、能力の境界を明確にします。
* **Persona は一貫させる**:安定したコミュニケーションスタイルを定義し、Waker の挙動を予測可能にします。
* **Bible は簡潔に**:最も重要なルールと知識だけを載せ、情報過多による注意散漫を避けます。
* **Skill は厳選する**:必要な技能だけをインストールし、判断の負担を減らします。

## 対話のコツ

* タスクの目標と期待する成果物の形式を明確に記述します。
* 作業ディレクトリを活用して、Waker に正しいプロジェクトコンテキストを提供します。
* 複雑なタスクはステップに分けて提示し、段階的に Waker を導いて完了させます。
* ファイルアップロード機能を活用して参考資料を提供します。
* グループ協働を活用し、複数の専門 Waker で複雑な問題を協力して処理します。

## WakerFlow の利用

* シンプルなフローから始め、ロジックが正しいことを確認してから複雑なパターンを追加します。
* Phase の数は 3〜5 個に抑えます。
* schema を使用して worker の出力形式を制約します。
* 重要な意思決定ポイントでは `askUser` ノードを使用します。
* まずシンプルな worker でフローを通してから、徐々に複雑さを増やします。

## コスト最適化

* シンプルなタスクには軽量モデルを、複雑な推論には高度なモデルを使用します。
* 緊急でないタスクは低ピーク時に実行するよう調整します。
* `parallel` 内のタスク数は適度に(3〜5 個)し、リソースの奪い合いを避けます。
* Memory を活用して Waker に頻用パターンを覚えさせ、繰り返しの説明を減らします。