teach-maestro

BOOTSTRAP — 最初に実行するコマンド

これは Maestro のエントリーポイントです。ほかのすべての Maestro コマンドが依存するコンテキストファイル .maestro.md を作成します。ほかに準備することはありません。これが準備そのものです。

---

このプロジェクトの AI ワークフローの構成を把握するため、体系的な聞き取りを行います。会話形式で進めつつ、詳しく確認してください。

聞き取り項目

各セクションの質問をひとつずつ行い、回答を待ってから次に進んでください。

セクション 1 — モデルとプロバイダー

• 使用している AI モデルは何ですか？（例：GPT-4、Claude、Gemini、ローカルモデル）
• API を直接使っていますか、それともフレームワーク経由ですか？（例：LangChain、LlamaIndex、独自のもの）
• コンテキストウィンドウのサイズはいくつですか？

セクション 2 — ワークフローのアーキテクチャ

• 現在のワークフローの概要を説明してください（入力されるものと、出力されるもの）。
• 複数のエージェントやステップがありますか、それとも単一エージェントのシステムですか？
• エージェントが利用できるツールや関数は何ですか？

セクション 3 — 品質と評価

• 現在、出力品質をどのように評価していますか？
• テストケースやゴールデン例はありますか？
• 最もよく発生する失敗パターンは何ですか？

セクション 4 — 制約

• コストに関する制約はありますか？（リクエストあたり、1日あたりの予算）
• レイテンシの要件はありますか？（リアルタイム、バッチ、非同期）
• コンプライアンス要件はありますか？（HIPAA、GDPR、SOC2 など）

セクション 5 — 優先事項

• 次の項目を重要度の高い順に並べてください：品質、速度、コスト、安全性
• 解決したいワークフロー上の最大の問題は何ですか？

出力形式

すべての回答を集めたら、次の .maestro.md ファイルを生成してください。

# Maestro Workflow Context
Generated: [date]

## Models & Providers
[answers from section 1]

## Workflow Architecture
[answers from section 2]

## Quality & Evaluation
[answers from section 3]

## Constraints
[answers from section 4]

## Priorities
[answers from section 5, with ranked priorities]

このファイルをプロジェクトのルートに .maestro.md として保存してください。

コンテキストの網羅性

セクション	状態	欠けている場合の影響
モデルとプロバイダー	?	コマンドが使用中のスタックに合わせたアドバイスを提供できません
ワークフローのアーキテクチャ	?	コマンドが複雑さを評価できません
品質と評価	?	/iterate と /evaluate の効果が低下します
制約	?	/guard と /accelerate で制限を設定できません
優先事項	?	すべてのコマンドが一般的なガイダンスを既定で提供します

聞き取りチェックリスト

• 5 つすべてのセクションについて質問し、回答を得た
• 回答が具体的である（曖昧ではない）
• .maestro.md ファイルを生成して保存した
• 生成されたコンテキストが正確であることをユーザーが確認した

推奨される次のステップ

.maestro.md を作成したら、ワークフローのベースラインのヘルスチェックとして /diagnose を実行してください。

絶対にしないこと：

• 質問を省略すること — 下流のコマンドにはすべてのセクションが重要です
• 推測すること — 不明な点があれば質問してください
• 確認せずに既存の .maestro.md を上書きすること