@unson/brainbase-mcp 0.2.1 → 0.2.2

package/README.md

@@ -28,17 +28,19 @@ npm run onboard:start -- --target codex
 
 `onboard:start`は日本語の初回導入コマンドです。最小ディレクトリだけを作り、本人、プロジェクト、関係者、判断、メール、カレンダー、ドライブ、タスクの事実は、利用者が承認するまで保存しません。通常表示は次の一手だけに絞り、全項目は`--details`で確認できます。
 
-公開CLIをインストール済みなら、次の3ステップです。
+公開CLIをインストール済みなら、次の5ステップです。
 
 ```bash
 brainbase onboard:start --target codex
 # 表示された onboard:seed を確認して実行
-brainbase onboard:demo --scenario "実際に試す依頼"
+brainbase onboard:install --target codex --dry-run
+# 設定を承認・反映し、Codexを再起動
+# 新しいCodexでBrainbaseのget_context/searchを使って実際の依頼を試す
 ```
 
-リポジトリをcloneした場合は、同じ流れを`npm run onboard:start -- --target codex`、表示された`npm run`コマンド、`npm run onboard:demo -- --scenario "実際に試す依頼"`で進めます。
+リポジトリをcloneした場合も、`npm run onboard:start -- --target codex`から同じ順序で進めます。
 
-利用者がBrainbaseの導入を依頼したら、エージェントはチェックリストを返すだけでなく、この公開CLIを実行します。最小文脈を確認し、承認された事実だけを`onboard:seed`で保存し、現実の依頼で`onboard:demo`を実行します。プロンプト、出力、説明し直さずに済んだ前提、まだ終わっていない運用化を分けて示します。`ready: true`、`first_value_demo_ready`、Skillsやルーティンの生成、`onboard:install --dry-run`だけでは導入完了ではありません。
+利用者がBrainbaseの導入を依頼したら、エージェントはチェックリストを返すだけでなく、この公開CLIを実行します。承認された最小文脈を保存し、MCP設定を反映した新しい実エージェントで`get_context`と`search`を使って現実の依頼へ回答します。その実回答を見た本人が「役立った」と判断して初めて初回価値です。`ready: true`、`cli_sample_ready`、CLIの処理時間、合成ペルソナ評価、Skillsやルーティンの生成、`onboard:install --dry-run`だけでは導入完了ではありません。
 
 For a Google Workspace / Google Drive / local-notes setup, pass the known answers and let the command surface what still needs approval:
 
@@ -83,21 +85,22 @@ brainbase onboard:seed \
   --relationship "Key Partner|collaborator|Context you want AI tools to remember"
 ```
 
-Run the first value demo with a real request. This is the onboarding completion signal:
+Optionally preview the saved context locally. This is not an onboarding completion signal:
 
 ```bash
 brainbase onboard:demo --scenario "Draft the first note I should send to Key Partner about Current project"
 ```
 
-`onboard:demo` reads only locally saved, approved facts. It does not call an LLM, hosted backend, or raw source collector. If it returns `ready: true`, the agent still needs to show the try-this prompt, sample result, and plain-language value: the user did not have to explain the saved work premise or person context again.
+`onboard:demo` reads only locally saved, approved facts. It does not call an LLM, an agent, or a hosted backend. Its result is only a preview. Continue through MCP installation, restart the selected agent, make a real request using `get_context` and `search`, and ask the user whether that actual answer was useful.
+
+After the demo, keep onboarding open: the preview is not the first-value gate. Continue until a real agent uses Brainbase and the human user confirms that the result was useful.
 
-After the demo, keep onboarding open until the operationalization checklist is either completed or explicitly deferred:
+After seed, install and verify MCP before asking for the human value judgment:
 
 ```bash
-brainbase onboard:skills --target codex
-brainbase onboard:routines --target codex --cwd /path/to/brainbase
 brainbase onboard:install --target codex --dry-run
 brainbase doctor
+# restart Codex, use get_context/search for the real request, then ask whether it was useful
 ```
 
 The recommended order is public skills, `ohayo` / `oyasumi` / `retro` routines registered paused or confirmation-gated, real MCP config merge after approving the dry-run snippet, source allowlist / import / candidate review decisions, then `doctor` plus MCP `get_context` / `search` verification from a fresh agent session.

package/dist/cli.js

@@ -256,7 +256,8 @@ async function onboardSeed(parsed, io) {
         '- 同じ文脈は更新しました。既存の別データは削除していません。',
         '',
         '次に実行:',
-        `brainbase onboard:demo --dir ${shellArg(dataDir)} --scenario "保存した文脈を使って、次に進めるメモを作って"`,
+        `brainbase onboard:install --target codex --dir ${shellArg(dataDir)} --dry-run`,
+        '設定を承認・反映してエージェントを再起動した後、実際の依頼でBrainbaseのget_contextとsearchを使います。',
         ''
     ];
     write(io, summary.join('\n'));
@@ -934,10 +935,12 @@ function proposedPersonalOs(os, proposed) {
     return { ...os, ...proposed };
 }
 function usage() {
-    return `最短で試す（3ステップ）:
+    return `初回価値まで（5ステップ）:
   1. brainbase onboard:start --target codex
   2. 表示された brainbase onboard:seed を確認して実行
-  3. brainbase onboard:demo --scenario "実際に試す依頼"
+  3. brainbase onboard:install --target codex --dry-run
+  4. 設定を承認・反映し、Codexを再起動
+  5. 新しいエージェントで実際の依頼を送り、役立ったか本人が判断
 
 使い方:
   brainbase-mcp

package/dist/guided-onboarding.js

@@ -70,6 +70,7 @@ export function buildGuidedFirstRun(input) {
         '--dir', input.dataDir,
         '--scenario', firstValueScenario
     ]);
+    const actualAgentPrompt = `Brainbaseのget_contextとsearchを使い、保存済み文脈を根拠に「${firstValueScenario}」へ回答してください。使った前提と未確認事項を分けてください。`;
     const projectDryRunCommand = project
         ? projectCommand(input.dataDir, project.project.name, input.project, project.project.sources, false)
         : undefined;
@@ -119,44 +120,50 @@ export function buildGuidedFirstRun(input) {
         nextCommands: [
             {
                 id: 'self-seed',
-                title: '最初のデモに必要な最小文脈を正本化する',
+                title: '最初の実利用に必要な最小文脈を正本化する',
                 when: '名前、価値観、最初のプロジェクト、関係者文脈を本人が確認した後',
                 command: selfSeedCommand
             },
+            {
+                id: 'install',
+                title: `${targetLabel(input.target)} 用のMCP設定を実configへmergeする`,
+                when: '最小文脈のseed直後。dry-runを確認し、承認後に実configへ反映する',
+                command: operationalization.pending.find((item) => item.id === 'mcp-config')?.command ?? command(['brainbase', 'onboard:install', '--target', input.target, '--dir', input.dataDir, '--dry-run'])
+            },
+            {
+                id: 'doctor',
+                title: 'doctor と MCP get_context/search で確認する',
+                when: 'MCP設定を実configへmergeし、対象エージェントを再起動した後',
+                command: operationalization.pending.find((item) => item.id === 'verification')?.command ?? command(['brainbase', 'doctor', '--dir', input.dataDir])
+            },
+            {
+                id: 'actual-agent-value',
+                title: '実エージェントで現実の依頼を試し、本人が価値を判断する',
+                when: 'MCP設定反映後の新しいエージェントセッション',
+                command: actualAgentPrompt
+            },
             {
                 id: 'first-value-demo',
-                title: '最初の価値体験を実行する',
-                when: '最小文脈のseed直後。接続診断より先に実行する',
+                title: '必要ならCLI文脈プレビューを見る',
+                when: '実接続前に保存文脈から作れるサンプルだけ確認したい時。完了証拠にはしない',
                 command: demoCommand
             },
             {
                 id: 'skills',
                 title: '公開オンボーディングskillsを配置する',
-                when: 'first value demoを見せた後。agentが次回も同じ運用を辿れるようにする',
+                when: '実エージェントの回答を本人が役立つと確認した後',
                 command: operationalization.pending.find((item) => item.id === 'public-skills')?.command ?? 'brainbase onboard:skills --target codex'
             },
             {
                 id: 'routines',
                 title: 'ohayo / oyasumi / retroを確認付きで登録する',
-                when: 'first value demoを見せた後。最初はPAUSEDまたは確認付きで登録する',
+                when: '初回価値確認後、継続運用が必要になった時',
                 command: operationalization.pending.find((item) => item.id === 'routines')?.command ?? 'brainbase onboard:routines --target codex --cwd <brainbase-checkout>'
             },
-            {
-                id: 'install',
-                title: `${targetLabel(input.target)} 用のMCP設定を実configへmergeする`,
-                when: 'first value demoとskills/routines確認後。dry-runをプレビューにして承認後に実configへ反映する',
-                command: operationalization.pending.find((item) => item.id === 'mcp-config')?.command ?? command(['brainbase', 'onboard:install', '--target', input.target, '--dir', input.dataDir, '--dry-run'])
-            },
-            {
-                id: 'doctor',
-                title: 'doctor と MCP get_context/search で確認する',
-                when: 'MCP設定を実configへmergeし、対象エージェントを再起動した後',
-                command: operationalization.pending.find((item) => item.id === 'verification')?.command ?? command(['brainbase', 'doctor', '--dir', input.dataDir])
-            },
             ...(projectDryRunCommand ? [{
                     id: 'project-dry-run',
                     title: 'プロジェクト登録内容を確認する',
-                    when: '最初のデモ後、プロジェクト詳細を追加したい時',
+                    when: '実エージェントの回答確認後、プロジェクト詳細を追加したい時',
                     command: projectDryRunCommand
                 }] : []),
             ...(projectWriteCommand ? [{
@@ -168,13 +175,13 @@ export function buildGuidedFirstRun(input) {
             {
                 id: 'source-diagnosis',
                 title: 'メール・カレンダー・ドライブ・タスクの接続準備を診断する',
-                when: '最初の価値体験の後、追加文脈が必要だと分かった時',
+                when: '実エージェントの回答を確認した後、追加文脈が必要だと分かった時',
                 command: diagnoseCommand
             },
             {
                 id: 'candidates',
                 title: '候補ファクトをレビュー用に作る',
-                when: '最初のデモ後、聞き取り内容をまだ正本化せずレビュー材料にしたい時',
+                when: '実エージェントの回答を確認した後、聞き取り内容をまだ正本化せずレビュー材料にしたい時',
                 command: command([
                     'brainbase',
                     'onboard:candidates',
@@ -187,16 +194,16 @@ export function buildGuidedFirstRun(input) {
         ],
         approvalGates: [
             'OAuth token、password、API key、refresh tokenはチャットへ貼らない。',
-            '接続診断や候補JSONを初回オンボーディングの完了扱いにしない。最初の価値体験を先に見る。',
+            '接続診断や候補JSONを初回オンボーディングの完了扱いにしない。実エージェントの回答と本人の価値判断を先に確認する。',
             'メール、カレンダー、ドライブ、タスクは最初はmetadata-firstで扱う。',
             'Google Driveとローカルファイルは明示されたfolder allowlistだけを見る。',
             'sources/ と candidates/ は二次材料であり、本人承認前にMCPの正本文脈へ入れない。',
             'プロジェクト、関係者、判断基準はdry-run確認後だけ --write または onboard:seed で正本化する。'
         ],
         completionCheck: [
-            'brainbase onboard:demo が、保存済み文脈を使った自然なプロンプトとサンプル回答を返す。',
-            'ready=true / first_value_demo_ready だけで完了扱いにせず、ユーザーが「説明し直さなくてよい」と分かる回答を見る。',
-            'doctor の valueDemo.ready が true になる。',
+            'CLIサンプルは接続前プレビューであり、初回価値の達成証拠にしない。',
+            '新しい実エージェントがBrainbase MCPのget_context/searchを使って現実の依頼へ回答する。',
+            '実回答を見た本人が役立ったかを判断する。',
             '完了報告には、公開skills、ohayo/oyasumi/retro、MCP実config merge、source allowlist/import/candidate review、MCP get_context/search確認の未完了タスクを必ず出す。',
             `${targetLabel(input.target)} のMCP設定に Brainbase が実登録されている。`,
             '最初のプロジェクトが get_context/search で見える。',
@@ -212,11 +219,11 @@ export function renderGuidedFirstRun(input, format, details = false) {
     if (!details) {
         const next = guide.currentStatus.missing.length > 0
             ? guide.nextCommands.find((item) => item.id === 'self-seed')
-            : guide.nextCommands.find((item) => item.id === 'first-value-demo');
+            : guide.nextCommands.find((item) => item.id === 'install');
         return [
             '# Brainbase 初回オンボーディング',
             '',
-            `- 状態: ${guide.currentStatus.missing.length > 0 ? '最小文脈の保存待ち' : '初回価値を確認できます'}`,
+            `- 状態: ${guide.currentStatus.missing.length > 0 ? '最小文脈の保存待ち' : '実エージェント接続待ち'}`,
             `- データ: \`${guide.dataDir}\``,
             `- 不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.map(canonicalAreaLabel).join('、') : 'なし'}`,
             '',
@@ -241,13 +248,13 @@ export function renderGuidedFirstRun(input, format, details = false) {
         `- 正本ファクト書き込み: ${guide.initialized.canonicalFactWrites ? 'あり' : 'なし'}`,
         `- 現在の不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.map(canonicalAreaLabel).join('、') : 'なし'}`,
         '',
-        '## まず試すこと',
+        '## 接続後に実エージェントで試すこと',
         guide.firstValueExperience.title,
         '',
         `- 試すプロンプト: 「${guide.firstValueExperience.tryPrompt}」`,
         `- 期待する価値: ${guide.firstValueExperience.expectedValue}`,
         '',
-        '### サンプル回答',
+        '### 回答イメージ（接続前プレビュー）',
         guide.firstValueExperience.sampleResult,
         '',
         '## まだ残っている運用化',
@@ -266,7 +273,7 @@ export function renderGuidedFirstRun(input, format, details = false) {
             ...section.questions.map((question) => `- ${question}`)
         ]),
         '',
-        '## 接続準備（デモ後の任意ステップ）',
+        '## 追加接続（初回価値確認後の任意ステップ）',
         ...guide.sourceReadiness.flatMap((source) => [
             '',
             `### ${source.title}`,
@@ -300,11 +307,11 @@ function buildJapaneseInterview() {
     return [
         {
             id: 'value_target',
-            title: '最初の価値体験',
+            title: '本人が価値を判断できる最初の実利用',
             questions: [
                 'Codex / Claude Code に毎回説明し直したくない仕事文脈は何ですか？',
                 '今日のオンボーディングで「これは便利」と判断できる実リクエストは何ですか？',
-                '最初のデモは仕事前提、関係者、判断基準、プロジェクトのどれを使えれば成功ですか？'
+                '最初の実回答は仕事前提、関係者、判断基準、プロジェクトのどれを使えれば役立ったと判断できますか？'
             ]
         },
         {
@@ -313,7 +320,7 @@ function buildJapaneseInterview() {
             questions: [
                 'あなたの名前、呼ばれ方、Codex / Claude Code に覚えてほしい仕事上の前提は何ですか？',
                 '判断基準、重視する価値観、避けたい進め方は何ですか？',
-                '最初のデモに必要な関係者は誰で、どういう文脈を覚えておくべきですか？'
+                '最初の実利用に必要な関係者は誰で、どういう文脈を覚えておくべきですか？'
             ]
         },
         {
@@ -329,24 +336,24 @@ function buildJapaneseInterview() {
             id: 'approval',
             title: '正本化の承認',
             questions: [
-                '最初のデモに必要な本人、仕事、関係性の事実をこのままローカル正本に入れてよいですか？',
+                '最初の実利用に必要な本人、仕事、関係性の事実をこのままローカル正本に入れてよいですか？',
                 '候補JSONではなく、会話上の要約として承認できますか？',
                 'まだ正本化しない事実や除外したい文脈はありますか？'
             ]
         },
         {
             id: 'first_value_demo',
-            title: 'デモ確認',
+            title: '実エージェント回答の確認',
             questions: [
-                'seed直後に brainbase onboard:demo を実行し、説明し直しが減ったか確認してください。',
-                'デモが足りない場合、どの文脈が不足していましたか？'
+                'MCP設定反映と再起動後、実エージェントへ現実の依頼を送り、説明し直しが減ったか確認してください。',
+                '実回答が役立たない場合、どの文脈が不足していましたか？'
             ]
         },
         {
             id: 'sources',
-            title: 'デモ後のメール・カレンダー・ドライブ・タスク',
+            title: '初回価値確認後のメール・カレンダー・ドライブ・タスク',
             questions: [
-                '最初のデモ後に追加文脈が必要なら、メールは Gmail / Google Workspace / Outlook / Apple Mail / その他のどれですか？',
+                '初回価値確認後に追加文脈が必要なら、メールは Gmail / Google Workspace / Outlook / Apple Mail / その他のどれですか？',
                 'カレンダーは Google Calendar / Outlook Calendar / Apple Calendar / その他のどれですか？',
                 'ドキュメントは Google Drive / OneDrive / Dropbox / Notion / ローカルフォルダのどこにありますか？',
                 'タスク管理は Notion / Todoist / Linear / GitHub Issues / NocoDB / CSV / カレンダーやメモ散在 / なし のどれですか？',
@@ -381,7 +388,7 @@ function buildFirstValueExperience(projectName, person) {
             '背景説明をもう一度求めず、保存した仕事メモを前提に最初の作業メモを出します。'
         ].join('\n');
     return {
-        title: '最小メモを保存したら、まずこの一問で価値を確認します。',
+        title: '最小メモを保存して接続したら、実エージェントへこの一問を依頼します。',
         tryPrompt,
         expectedValue,
         sampleResult

package/dist/onboarding.d.ts

@@ -160,7 +160,10 @@ export interface ValueDemo {
     valueExplanation: string;
     operationalization: OperationalizationPlan;
     nextStep: string;
-    completionSignal: 'needs_seed' | 'first_value_demo_ready';
+    completionSignal: 'needs_seed' | 'cli_sample_ready';
+    onboardingComplete: false;
+    humanValueStatus: 'not_observed';
+    actualAgentPrompt: string;
 }
 export declare function buildAgentOnboardingProtocol(): AgentOnboardingProtocol;
 export declare function buildValueDemo(input: ValueDemoInput): ValueDemo;

package/dist/onboarding.js

@@ -41,12 +41,12 @@ export function buildAgentOnboardingProtocol() {
             },
             {
                 id: 'first_value_demo',
-                title: 'First value demo',
+                title: 'CLI preview and actual agent value check',
                 questions: [
-                    'Run brainbase onboard:demo with the real request the user chose.',
-                    'Show the try-this prompt, sample result, and what the user did not have to explain again.',
-                    'Treat the useful output, not ready=true or connector readiness, as the onboarding completion signal.',
-                    'After showing the useful output, report the remaining operationalization actions instead of calling onboarding done.'
+                    'Optionally run brainbase onboard:demo to preview which saved context should be used.',
+                    'Install the MCP config after user approval and restart the selected agent.',
+                    'Send the real request through that agent and require get_context/search evidence.',
+                    'Ask the user whether the actual answer was useful. A CLI sample or synthetic evaluator is not onboarding completion.'
                 ]
             },
             {
@@ -72,7 +72,10 @@ export function buildAgentOnboardingProtocol() {
             'brainbase onboard:init',
             'brainbase onboard:seed --name "<name>" --value "<what should not be re-explained>" --project "<current project>" --relationship "<person>|<role>|<context>"',
             'brainbase onboard:projects --name "<project>" --goal "<goal>" --status "<status>" --role "<your role>"',
-            'brainbase onboard:demo --scenario "<real request that should now work>"',
+            'brainbase onboard:install --target codex --dry-run',
+            'Restart the selected agent, then send the real request and require Brainbase get_context/search.',
+            'Ask the user whether the actual answer was useful.',
+            'brainbase onboard:demo --scenario "<optional local preview>"',
             'brainbase onboard:skills --target codex',
             'brainbase onboard:routines --target codex --cwd <brainbase-checkout>',
             'brainbase onboard:install --target codex --dry-run',
@@ -82,10 +85,11 @@ export function buildAgentOnboardingProtocol() {
         completionCheck: [
             'Personal OS directory exists.',
             'The approved self, work, and person context are saved locally.',
-            'brainbase onboard:demo returns a try-this prompt, sample result, and useful answer for the selected real request.',
-            'The user can see what they did not have to explain again.',
+            'The CLI sample, if used, is labeled as a preview rather than an onboarding completion signal.',
             'The completion report lists public skills, ohayo/oyasumi/retro routines, real MCP config merge, source allowlists, and MCP get_context/search verification as unfinished operationalization work.',
             'The selected MCP client has a Brainbase config snippet merged into its real config after user approval.',
+            'A fresh agent session used Brainbase get_context/search for the real request.',
+            'The user personally confirmed that the actual agent answer was useful.',
             'Source diagnosis is optional follow-up work, but source allowlist/import/candidate review must be explicitly completed or deferred.'
         ]
     };
@@ -119,8 +123,9 @@ export function buildValueDemo(input) {
         dataDir: input.os.dataDir,
         firstValueReady: ready
     });
+    const actualAgentPrompt = `Brainbaseのget_contextとsearchを使い、保存済み文脈を根拠に「${scenario}」へ回答してください。使った前提と未確認事項を分けてください。`;
     return {
-        goal: '追加設定へ進む前に、保存した文脈が役立つ回答を一つ確認する。',
+        goal: '実エージェント接続前に、保存した文脈から作れる出力をプレビューする。',
         ready,
         missing,
         scenario,
@@ -145,9 +150,12 @@ export function buildValueDemo(input) {
         valueExplanation,
         operationalization,
         nextStep: ready
-            ? '必要なら --details で、スキル、ルーティン、MCP設定、参照許可、動作確認の残作業を確認します。'
+            ? 'MCP設定を反映して新しいエージェントを開き、実際の回答を確認した後、本人が役立ったかを判断します。'
             : `まず最小文脈を保存します: ${missing.map(missingLabel).join(', ')}。`,
-        completionSignal: ready ? 'first_value_demo_ready' : 'needs_seed'
+        completionSignal: ready ? 'cli_sample_ready' : 'needs_seed',
+        onboardingComplete: false,
+        humanValueStatus: 'not_observed',
+        actualAgentPrompt
     };
 }
 export function buildSourceDiagnosis(input) {
@@ -504,12 +512,12 @@ export function renderValueDemo(input, format, details = false) {
         return `${JSON.stringify(demo, null, 2)}\n`;
     }
     const lines = [
-        '# Brainbase 初回価値デモ',
+        '# Brainbase 文脈プレビュー',
         '',
         demo.goal,
         '',
         `- 状態: ${demo.ready ? '準備済み' : '要設定'}`,
-        `- 完了シグナル: ${demo.completionSignal}`,
+        `- プレビュー状態: ${demo.completionSignal}`,
         `- 不足: ${demo.missing.length === 0 ? 'なし' : demo.missing.map(missingLabel).join(', ')}`,
         '',
         '## 今すぐ試す',
@@ -517,6 +525,7 @@ export function renderValueDemo(input, format, details = false) {
         '',
         '## サンプル結果',
         'これはCLIが保存済み文脈から組み立てたサンプルです。実際のエージェント応答ではありません。',
+        'このサンプルだけでは初回価値の達成になりません。',
         '- 実エージェント接続: 未確認',
         `- 実応答の確認方法: ${demo.realVerification}`,
         '',
@@ -527,9 +536,10 @@ export function renderValueDemo(input, format, details = false) {
         '',
         '## 次に実行',
         demo.ready
-            ? `\`brainbase onboard:demo --dir ${shellArg(input.os.dataDir)} --scenario ${shellArg(demo.scenario)} --details\``
+            ? `\`brainbase onboard:install --target codex --dir ${shellArg(input.os.dataDir)} --dry-run\``
             : `\`brainbase onboard:start --dir ${shellArg(input.os.dataDir)} --target codex\``,
         demo.nextStep,
+        ...(demo.ready ? ['', '## 実エージェントへ送る依頼', demo.actualAgentPrompt, '', '回答後、本人に役立ったかを確認してください。'] : []),
         ''
     ];
     if (details) {
@@ -780,7 +790,7 @@ function buildValueExplanation(input) {
 }
 function buildMissingDemoAnswer(missing) {
     return [
-        'まだ最初の価値体験はできません。',
+        'まだ接続前プレビューを作れません。',
         `足りない最小メモ: ${missing.map(missingLabel).join(', ')}。`,
         'まず、あなたが毎回説明したくないことを一つだけ保存してから、同じプロンプトをもう一度試します。'
     ].join('\n');

package/dist/operationalization.js

@@ -6,12 +6,12 @@ export function buildOperationalizationPlan(input = {}) {
     const skillsTarget = target === 'claude' ? 'claude' : target === 'codex' ? 'codex' : 'portable';
     const routinesTarget = target === 'claude' ? 'claude' : 'codex';
     return {
-        goal: '初回価値を確認した後、必要な運用設定だけを順に完了する。',
+        goal: 'CLIプレビュー後、実エージェントで本人が初回価値を確認するまでを順に完了する。',
         completed: input.firstValueReady
             ? [
                 '承認した最小文脈をローカルへ保存済み。',
-                'doctorで初回価値デモの準備完了を確認可能。',
-                'onboard:demoでプロンプト、サンプル結果、価値の説明を確認済み。'
+                'doctorでCLI文脈プレビューの準備完了を確認可能。',
+                'onboard:demoを実行した場合も、確認できるのはローカルCLIサンプルだけ。'
             ]
             : [
                 'Personal OSの準備を開始済み。'
@@ -59,9 +59,11 @@ export function buildOperationalizationPlan(input = {}) {
             }
         ],
         recommendedOrder: [
-            '対象エージェントへ公開スキルを配置する。',
-            'ohayo / oyasumi / retroを生成し、一時停止または確認付きで登録する。',
             'Brainbase MCP設定を実際のCodex / Claude / CodeCode設定へ反映し、エージェントを再起動する。',
+            '新しいエージェントで現実の依頼を送り、MCP get_contextとsearchを使った実回答を確認する。',
+            '利用者本人に役立ったかを確認する。役立たなければ不足文脈だけを追加して再試行する。',
+            '対象エージェントへ公開スキルを配置する。',
+            '必要になった時だけohayo / oyasumi / retroを確認付きで登録する。',
             '追加文脈が必要な場合だけ参照許可範囲を決め、取込と候補レビューを行う。',
             'doctorを実行し、新しいエージェントセッションでMCP get_contextとsearchを確認する。'
         ],
@@ -72,7 +74,8 @@ export function buildOperationalizationPlan(input = {}) {
             '参照元の取込はローカル優先とし、正本化前にレビューします。'
         ],
         completionCheck: [
-            '利用者が初回価値の出力を確認済み。',
+            '実際のエージェントがBrainbase MCP get_context/searchを使って現実の依頼へ回答済み。',
+            '利用者本人がその回答を役立つと確認済み。',
             '完了報告に残っている運用設定をすべて記載済み。',
             '実設定反映後、対象エージェントからBrainbase MCP get_context/searchを呼び出せる。',
             '参照許可範囲と候補レビューを完了、または明示的に延期済み。'

package/dist/skills.js

@@ -23,21 +23,23 @@ const SKILL_DEFINITIONS = {
             '',
             '## 手順',
             '',
-            '1. 最初に `brainbase onboard:agent` を実行し、メール、カレンダー、ドライブ/ドキュメント、タスク、権限、承認についてエージェントに確認させる。',
-            '2. `brainbase onboard:init` でローカルPersonal OSディレクトリを作成する。',
-            '3. ソースデータを集める前に、ユーザーの回答を使って `brainbase onboard:diagnose-sources` を実行する。',
-            '4. `brainbase onboard:projects` で、現在のプロジェクト名、目的、状態、役割、関係者、許可されたソースをレビュー可能な形にする。',
-            '5. `brainbase onboard:candidates --write`、またはsource import/extractの流れでレビュー候補を作る。',
-            '6. ユーザーが明示的に承認した事実だけを `brainbase onboard:seed`、`brainbase onboard:projects --write`、または `brainbase onboard:apply --write` でcanonical SSOTへ昇格する。',
-            '7. `brainbase onboard:install --target codex|claude|codecode --dry-run` でMCP設定スニペットを生成し、ユーザーに確認してもらう。',
-            '8. 接続済みソースから最初の価値まで進める場合は `brainbase-connected-world-onboarding` Skillを使う。',
+            '1. 最初に、Brainbaseを使って試したい現実の依頼を一つ聞く。',
+            '2. `brainbase onboard:start --target codex|claude|codecode` を実行し、本人、プロジェクト、関係者、判断基準の最小候補を確認する。',
+            '3. ユーザーが明示的に承認した事実だけを `brainbase onboard:seed` で保存する。',
+            '4. `brainbase onboard:install --target codex|claude|codecode --dry-run` でMCP設定を確認し、承認後に実設定へ反映して対象エージェントを再起動する。',
+            '5. 新しい実際のエージェントで、Brainbaseの `get_context` と `search` を使うよう明示して最初の現実の依頼を実行する。',
+            '6. 実回答、使われた保存済み文脈、未確認事項をユーザーへ示し、本人に役立ったかを確認する。ここまでを10分以内の初回価値候補ジャーニーとして測る。',
+            '7. CLIの `onboard:demo` は必要なら接続前のプレビューに使えるが、CLIサンプルは初回価値の達成証拠にしない。',
+            '8. 本人が役立つと確認した後だけ、必要に応じてsource診断、追加候補、Skills、ルーティンへ進む。',
+            '9. 継続利用するプロジェクトの詳細が必要なら、本人確認後に `brainbase onboard:projects --write` で登録する。',
             '',
             '## 安全ルール',
             '',
             `- ${SECRET_RULE}`,
             '- Brainbaseはローカルファーストで扱う。ユーザーが別のローカルパスを明示しない限り、ローカルMCPサーバーと `~/.brainbase/personal-os/` を使う。',
             '- メール、カレンダー、ドライブ、タスク、メモの生データは `sources/` 配下の二次材料として扱う。',
-            '- canonical contextは、ユーザー確認後の `graph.json`、`relationships.json`、`personal-kg.jsonl`、`decisions.jsonl` だけから作る。'
+            '- canonical contextは、ユーザー確認後の `graph.json`、`relationships.json`、`personal-kg.jsonl`、`decisions.jsonl` だけから作る。',
+            '- 終了コード0、`ready: true`、CLIサンプル、合成ペルソナ判定を、人間本人の価値認識に置き換えない。'
         ].join('\n')
     },
     'brainbase-connected-world-onboarding': {

package/dist/tools.js

@@ -124,7 +124,7 @@ export function onboardingStatus(os) {
             ready: valueDemoReady,
             missing,
             command: `brainbase onboard:demo --dir ${shellArg(os.dataDir)} --scenario "<real request>"`,
-            completionSignal: valueDemoReady ? 'first_value_demo_ready' : 'needs_seed'
+            completionSignal: valueDemoReady ? 'cli_sample_ready' : 'needs_seed'
         },
         operationalization,
         counts: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Local-first Brainbase MCP server and personal onboarding kit.",
   "type": "module",
   "license": "MIT",
@@ -61,5 +61,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "6c4069e63aaa4586ac70e41be36ac67ddf2439ba"
+  "gitHead": "de6ebc16b28dd6ac37c05443f0f6fe8b5abd0602"
 }