teach-oh

/teach-oh

プロジェクトのコンテキストを収集し、AGENTS.md に書き込みます。プロジェクトに取り組み始めるとき、または戦略、目標、制約が変わったときに実行してください。

使用するタイミング

• 新しいプロジェクトに取り組み始めるとき
• セッションをまたいでコンテキストが失われ続けるとき
• 戦略的な目標や制約が大きく変わったとき

使用しないでください： 作業の途中にいるとき。これはセットアップであり、実作業ではありません。

必要に応じて参照する資料

• AGENTS.md の出力例をユーザーが尋ねた場合に限り、references/examples.md を読み込みます。
• AGENTS.md のコンテキスト案ができた後、ユーザーが OMP または Claude Code のフックやエージェントを任意で導入したい場合に限り、references/install.md を読み込みます。
• RNA のセットアップが必要な場合は、/setup を使用してください。ここにインストールコマンドを直接記載しないでください。

手順

ステップ 1：質問する前に調査する

次の内容を把握できるツールやファイルを確認します。

• 構成と技術スタック
• パッケージ、ビルド、CI の設定
• 既存の AGENTS.md、CLAUDE.md、README、CONTRIBUTING、.oh/、ADR
• パターン、規約、最近のコミット
• 注意が必要な領域や、文書化された制約

調べれば分かる情報は質問しないでください。

ステップ 2：重要なことだけを尋ねる

推測できなかった内容について、的を絞った質問をします。

目的と目標

• このプロジェクトは何を実現しようとしていますか？
• 誰が使いますか？どのような行動の変化があれば成功といえますか？
• 現在の優先事項は何ですか？

戦略上の制約

• どのような制約は決して変えてはいけませんか？
• どのようなトレードオフを意図的に選びましたか？
• 明確に対象外とされているものは何ですか？

意思決定の背景

• ここではどのように意思決定していますか？
• ここでの「完了」とは何を意味しますか？
• どのようなパターンや慣行を守るべきですか？

状況の把握と再設定

• 現状の見立てが現実に合わなくなり、一時停止して捉え直す必要があることを示す兆候は何ですか？
• 誰が、または何が、方針のずれ、異議、立て直し、捉え直しを提起できますか？
• どのような決定では、確定前に異議を出す必要がありますか？
• どのような失敗が起きたら、実行を続けるのではなく立て直しに切り替えるべきですか？
• どのような役割の境界を明確に保つべきですか（実装者、レビュアー、異議を唱える人、ドメインエキスパート、最終決定者）？
• どのような証拠が計画より優先されますか（テスト、ステークホルダーからのフィードバック、運用上の兆候、ドメインの専門知識）？
• セッションをまたいで引き継ぐべき、現場固有のメティスやガードレールは何ですか？

避けるべきこと

• 繰り返してはならない過去の失敗
• 適合しない、魅力的に見えるパターン
• コードベースの注意が必要な領域

ステップ 3：継続的なコンテキスト案を作成する

AGENTS.md への追記または更新を提案します。文書ほど大きくせず、作業コンテキストとして扱いやすい分量にします。

次の内容を含めます。

• ユーザーが OH スキルをリポジトリに記録したい場合は、Open Horizons Framework
• Project Context は必ず含めます：目的、目標、制約、パターン、アンチパターン、意思決定の背景、状況把握の規範

書き込む前に、案を提示してユーザーの承認を得てください。

出力形式

## Teach-OH Summary

### What I Discovered
- Stack: [technologies found]
- Structure: [key patterns observed]
- Existing context: [what docs already exist]
- Current focus: [what recent code/docs imply]

### Questions I Have
1. [Question about aims/strategy]
2. [Question about constraints]
3. [Question about decision practices]

---

After your answers, I'll draft an AGENTS.md section for your approval.

ユーザーの回答後：

## Proposed AGENTS.md Addition

[Draft the requested Open Horizons Framework section, if applicable]

[Draft the Project Context section]

---

**Write to AGENTS.md?** [Yes/No - show what will be added/updated]

完了時の注意事項

AGENTS.md が承認され、書き込まれた後、環境が対応している場合に限り、任意でインストールのサポートを提案します。コンテキストは AGENTS.md に記録します。内容を絞り、目標が変わったとき、制約が変わったとき、またはコンテキストが古く感じられたときに再実行してください。