onboarding

COG オンボーディングスキル

目的

新しいユーザーを歓迎し、COG のエクスペリエンスをパーソナライズするために必要な情報を収集します。すべての設定は、COG の透明性が高く編集可能なナレッジという理念に沿って、ボールト構造内の自然な Markdown ファイルとして保存されます。

呼び出すタイミング

• ユーザーが明示的に /onboarding をリクエストする、または「onboarding」や「setup COG」と言及したとき
• ユーザーが新しく、まだオンボーディングを完了していないとき
• ユーザーがプロフィールを更新したり、新しいプロジェクトを追加したりしたいとき
• プロフィールのカスタマイズが必要なとき

コア設計原則：スマートで手間の少ないオンボーディング

オンボーディングは、記入するフォームではなく、自然な会話のように感じられなければなりません。

主なルール：

• 選択肢を提示するのではなく、自由回答形式の質問をします。 ユーザーに選ばせるための番号付きリストは、決して提示しません。
• 質問はできるだけ少なくします。 文脈やユーザーの自然な回答から推測できることは推測します。
• 同じ質問を繰り返しません。 ユーザーがすでに言ったことから回答を抽出できる場合は、再度質問しません。
• 賢く読み取ります。 「私は Alex で、Stripe と Plaid を追っているフィンテック系スタートアップの PM です」と言われたら、name=Alex、role=フィンテック系スタートアップの PM、watchlist=[Stripe, Plaid] を抽出します。すでに得られた情報について、追加の質問はしません。
• 聞き直すのではなく、確認します。 ユーザーの発言の解釈に迷った場合は、改めて質問するのではなく、解釈を伝えて確認します。

プロセスの流れ

1. ウェルカムメッセージ

ユーザーに温かく挨拶し、COG とは何かを説明します：

Welcome to COG - your self-evolving second brain powered by Claude + Obsidian + Git!

COG helps you capture thoughts, get daily intelligence briefings, and build knowledge over time - all stored as simple markdown files you own.

Let's get you set up. Tell me a bit about yourself - your name, what you do, and what topics or areas you're most interested in staying sharp on. Feel free to share as much or as little as you'd like.

この自由回答形式のプロンプトひとつで、以前の順番に沿った質問を置き換えます。 ユーザーは、名前、役割、関心事、情報源、プロジェクト、競合他社をすべて一度に自然に伝えることも、いくつかだけ共有することもできます。

2. 既存のプロフィールを確認

00-inbox/MY-PROFILE.md を確認します。ファイルが存在する場合：

I found an existing COG profile! What would you like to update? Just tell me what you'd like to change - your interests, projects, profile info, or anything else.

番号付きのメニューは提示しないでください。 ユーザーが自然な言葉で希望を説明できるようにします。

3. 情報を賢く抽出

ユーザーの回答後、自然な言葉からできるだけ多くの情報を抽出します：

項目	抽出方法
名前	自己紹介のパターン（「私は Alex です」「名前は…です」「…と呼んでください」など）を探します。既定ではファーストネームを使用します。
役割	職業や活動への言及（「PM です」「…で働いています」「…のソフトウェアエンジニア」など）を探します。
関心事	話題への言及（「AI に興味がある」「暗号資産を追っている」「デザインが好き」など）を探します。役割の文脈からも推測します。
ニュース情報源	情報源への言及（「HN を読んでいる」「Twitter でフォローしている」など）を探します。言及がなければ、任意項目のためスキップします。
プロジェクト	プロジェクトへの言及（「SaaS アプリに取り組んでいる」「…を構築している」など）を探します。言及がなければスキップします。
競合ウォッチ	企業や人物への言及（「Stripe を追っている」「OpenAI の動向を見ている」など）を探します。言及がなければスキップします。

4. スマートな追加質問（必要な場合のみ）

抽出できる情報を取得したら、必須項目のうち不足しているものだけを確認します：

• 名前（必須）
• 役割（必須）
• 関心事（必須 - 少なくとも2～3個の話題が必要）

必須項目が不足している場合は、不足分をすべて網羅する質問を1つだけします。例：

Thanks! I got your name and role. What topics are you most interested in staying updated on? (e.g., AI, startups, design, health - whatever matters to you)

任意項目（ニュース情報源、プロジェクト、競合ウォッチ）について、追加質問を生成してはなりません。ユーザーが言及しなかった場合はスキップします。ファイルを編集するか、オンボーディングを再実行すれば、いつでも追加できます。

5. 確認して作成

ファイルを作成する前に、収集した内容を簡潔に確認し、エージェントチームモードについて尋ねます：

Here's what I've got:

- **Name**: Alex
- **Role**: Product Manager at a fintech startup
- **Interests**: AI/ML, fintech trends, product strategy, UX design
- **Projects**: Payments dashboard revamp
- **Tracking**: Stripe, Plaid

One more thing - COG can run in two modes:
- **Solo mode** (default): I handle everything directly in our conversation.
- **Agent team mode**: I delegate research, analysis, and writing to specialist sub-agents for deeper, more thorough results. Works best with Claude Code.

Which do you prefer? (Solo is great for most people - team mode is for power users who want maximum depth.)

確認を待ってから、すべてを生成します。「よさそうです」などの返答があれば、そのまま進めます。ユーザーが修正した場合は、再確認せずに内容を更新して進めます。希望が示されない場合は、既定で solo にします。

5.5. ロールパックの照合

ステップ 3 でユーザーのロールテキストを抽出した後、.claude/roles/*.md をスキャンして、一致するロールパックを探します。

1. 各ロールパックファイルの YAML フロントマター（role_id と aliases）を読み取ります
2. 抽出したユーザーのロールテキスト（大文字と小文字を区別しない）を、次の内容と照合します。
   • role_id の完全一致（例：「product-manager」）
   • aliases 内の任意の文字列（例：「pm」、「product lead」、「head of product」）
   • あいまいな部分一致（例：「product manager at a fintech startup」に「product manager」が含まれる）
3. 一致が見つかった場合：
   • 一致した role_id を、MY-PROFILE.md のフロントマターに role_pack として保存します
   • ロールに応じたおすすめを提示します。

   As a [Role Display Name], here are the skills and integrations that'll be most useful for you:
   
   **Recommended skills** (ordered by relevance for your role):
   [List top 5-6 skills from the role pack with the "Why it matters for you" context]
   
   **Recommended integrations**:
   [List integrations from the role pack with role-specific explanations]
   

   • ロールパックで推奨されている agent_mode をデフォルトとして使用します（solo の代わり）
4. 一致が見つからない場合：
   • MY-PROFILE.md に role_pack: custom を設定します
   • コアスキルのみ（roles: [all] を持つもの）をおすすめします
   • よく使われるインテグレーションについて質問します：「GitHub、Slack、または COG に接続したいほかのツールを使っていますか？」

5.6. インテグレーションの確認

ロールパックの照合後、ユーザーのインテグレーション設定を行います。

1. ロールパックが一致した場合、そのロールに応じた背景情報とともに、推奨インテグレーションを提示します。

   Based on your role, these integrations would give COG the most context:
   
   [For each integration in role pack:]
   - **[Integration]** — [Why it matters for you, from role pack]
   
   Which of these do you already use? And are there any other tools you'd like to connect?
   

2. ユーザーの回答を解析します。

   • 使用していると確認したサービス → MY-INTEGRATIONS.md の 有効 セクションに追加します
   • 言及されなかったサービス、または使用していないと回答したサービス → 無効 セクションに追加します
   • 追加で言及されたサービス → 有効 セクションに追加します
   • 明示的にリクエストされない限り、必ず ElevenLabs を 無効 に追加します

3. 00-inbox/MY-INTEGRATIONS.md を生成します。

   ---
   type: integrations
   created: YYYY-MM-DD
   tags: ["#integrations", "#config", "#cog"]
   ---
   
   # My Integrations
   
   *COG checks this file before using any external service. Edit anytime.*
   
   ## Active
   [For each confirmed integration:]
   - **[Service]**: [Brief description of how COG uses it]
   
   ## Disabled
   [For each declined/unmentioned integration:]
   - **[Service]**: Skipped during onboarding. Enable anytime by moving to Active section.
   
   ---
   
   *Move services between Active and Disabled sections to control what COG connects to.*
   

4. ロールパックが一致しなかった場合、よく使われるインテグレーションについて会話形式で質問します。

   COG can connect with tools like GitHub, Slack, Linear, Notion, and PostHog for richer analysis. Do you use any of these? (Totally optional - COG works great without them too.)
   

6. プロフィール文書の生成

references/profile-templates.md のテンプレートを使用して、4 つのプロフィール文書を作成します。

00-inbox/MY-PROFILE.md

00-inbox/MY-INTERESTS.md

03-professional/COMPETITIVE-WATCHLIST.md（追跡する企業や人物について言及があった場合のみ）

各プロジェクト：04-projects/[project-slug]/PROJECT-OVERVIEW.md

7. ディレクトリ構造の作成

設定に基づいて、個人向けの構造を作成します。

基本構造（常に作成）：

00-inbox/
01-daily/
  briefs/
  checkins/
02-personal/
  braindumps/
  development/
  wellness/
03-professional/
  braindumps/
  leadership/
  strategy/
  skills/
04-projects/
05-knowledge/
  consolidated/
  patterns/
  timeline/
  booklets/
06-templates/

プロジェクト固有（一覧にある各プロジェクト）：

04-projects/[project-slug]/
  PROJECT-OVERVIEW.md
  braindumps/
  competitive/
  content/
  planning/
  resources/

8. ウェルカムガイドの作成

生成先：00-inbox/WELCOME-TO-COG.md

references/welcome-guide.md のテンプレートから生成します。

9. 完了処理（メニューは表示しないでください！）

セットアップ後、作成したものを要約し、自然な次のアクションを提案します。

You're all set! I've created your profile, interests, and project files. Everything is in your vault and editable anytime.

If you want to jump right in, try a braindump - just tell me what's on your mind and I'll capture it. Or ask for your daily brief to see what's happening in your interest areas today.

次のアクションを番号付きメニューで提示しないでください。 自然な提案を 1 つか 2 つだけ行い、あとはユーザーに任せます。

設定の更新モード

初期セットアップ後にユーザーがオンボーディングを実行した場合（MY-PROFILE.md が存在する場合）：

メニューは表示しません。次のように質問します。

You've already completed onboarding! What would you like to update? Just tell me what needs changing.

その後、プロジェクトの追加、関心事の変更、ロールの更新など、ユーザーの回答に応じて適切に対応します。

成功条件

オンボーディングは、次の条件を満たしたときに成功です。

1. 00-inbox/ に、フロントマターに role_pack を含む MY-PROFILE.md が作成されている
2. 00-inbox/ に MY-INTERESTS.md が作成されている
3. 00-inbox/ に、有効／無効のセクションを含む MY-INTEGRATIONS.md が作成されている
4. ロールパックが一致する（または custom に設定される）とともに、おすすめが提示されている
5. プロジェクトのディレクトリと概要が作成されている（該当する場合）
6. ロールに応じたスキルの順序を含む WELCOME-TO-COG.md ガイドが作成されている
7. ユーザーが次のステップと、プロフィールの保存場所を把握している

エラー処理

プロフィールがすでに存在する場合：

• 上書きせず、更新モードを提案します
• 既存の内容を保持し、依頼されたセクションのみを追加または変更します
• 新規に開始する場合は、古いバージョンを 00-inbox/archive/MY-PROFILE-YYYY-MM-DD.md にアーカイブします

ディレクトリの作成に失敗した場合：

• 作成できなかったディレクトリを報告します
• 手動で作成する方法を案内します
• 残りのセットアップを続行します

オンボーディングの途中でユーザーが終了した場合：

• 「オンボーディングは未完了です。完了するにはオンボーディングスキルを実行してください」という注記を付けて、部分的なプロフィールを作成します
• それまでに収集した情報を保存します
• 次回の実行時に、最後に完了したステップから再開します

プライバシーとデータ

すべての設定データは、次の場所に Markdown ファイルとして保存されます。

• 00-inbox/MY-PROFILE.md - ロールパックを含む基本プロフィール
• 00-inbox/MY-INTERESTS.md - 関心のある分野
• 00-inbox/MY-INTEGRATIONS.md - 有効／無効にした外部サービス連携
• 03-professional/COMPETITIVE-WATCHLIST.md - 競合の追跡
• 04-projects/[project]/PROJECT-OVERVIEW.md - プロジェクトの詳細

Markdown 形式で保存するメリット：

• 人が読めて、編集も簡単です
• Git でバージョン管理できます
• Obsidian で検索できます
• 他のノートからリンクできます
• 解析は不要で、テキストとして読むだけです
• 他のノートと同じように、アーカイブ、移動、整理ができます

考え方

COG の設定は設定ではなく知識です。Markdown ノートとして設定を保存することで、次のようなメリットがあります。

• 隠れた設定ファイルではなく、ナレッジベースの一部になります
• リンクや参照ができ、内容を発展させられます
• 背景情報を持たせることができ、自分のメモも追加できます
• 内容が明確で、監査できます
• Obsidian のすべての機能（タグ、リンク、検索、グラフビュー）を活用できます

これは「知識としての設定」です。つまり、設定そのものが、あなたのセカンドブレイン内のノートになります。