@pellux/goodvibes-agent 0.1.116 → 1.0.0

package/src/input/onboarding/onboarding-wizard-operator-steps.ts

@@ -22,7 +22,7 @@ function discoverySample(discovery: AgentBehaviorDiscoverySnapshot | undefined):
     ...discovery.skills.names,
     ...discovery.routines.names,
   ].slice(0, 4);
-  if (names.length === 0) return 'Use /personas discover, /agent-skills discover, and /routines discover after setup to rescan.';
+  if (names.length === 0) return 'Open the Memory & Skills workspace after setup to rescan and import local behavior files.';
   const remaining = discoveryCount(discovery) > names.length ? `, +${discoveryCount(discovery) - names.length} more` : '';
   return `Import candidates: ${names.join(', ')}${remaining}.`;
 }
@@ -35,17 +35,18 @@ export function buildCommunicationStep(): OnboardingWizardStepDefinition {
     description: 'Prepare companion pairing, messaging-channel readiness, notification delivery, and safe outbound communication for day-one Agent use.',
     summaryTitle: 'Communication posture',
     summaryLines: [
-      'Companion chat: paired through connected GoodVibes services',
+      'Companion chat: paired through the connected GoodVibes host',
       'Channel accounts: inspect readiness before using them',
       'Outbound messages: explicit user action only',
     ],
     fields: [
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-communication.companion',
+        action: 'open-agent-workspace:channels',
         label: 'Companion pairing',
-        hint: 'Use /pair from the Agent workspace to pair companion clients through connected GoodVibes services.',
-        defaultValue: 'Pair when ready',
+        hint: 'Open the Channels workspace to pair companion clients and review channel readiness and delivery safety.',
+        defaultValue: 'Open Channels',
       },
       {
         kind: 'status',
@@ -86,11 +87,12 @@ export function buildToolsStep(): OnboardingWizardStepDefinition {
     ],
     fields: [
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-tools.mcp',
+        action: 'open-agent-workspace:tools',
         label: 'MCP connections and tools',
-        hint: 'Use /mcp servers and the Agent workspace Tools area to inspect connected MCP servers, roles, and tool readiness.',
-        defaultValue: 'Inspectable',
+        hint: 'Open the Tools & MCP workspace to inspect connected MCP servers, roles, trust, and tool readiness.',
+        defaultValue: 'Open Tools',
       },
       {
         kind: 'status',
@@ -122,26 +124,27 @@ export function buildAgentKnowledgeStep(): OnboardingWizardStepDefinition {
     id: 'agent-knowledge',
     title: 'Agent Knowledge',
     shortLabel: 'Knowledge',
-    description: 'Agent Knowledge is isolated to the GoodVibes Agent product segment. It never falls back to default Knowledge/Wiki or any non-Agent product segment.',
+    description: 'Agent Knowledge is isolated to the GoodVibes Agent product segment. It never falls back to default knowledge or any non-Agent product segment.',
     summaryTitle: 'Knowledge isolation',
     summaryLines: [
-      'Route segment: /api/goodvibes-agent/knowledge/*',
-      'Default wiki fallback: disabled',
-      'Non-Agent route fallback: disabled',
+      'Route segment /api/goodvibes-agent/knowledge/*',
+      'Default knowledge fallback disabled',
+      'Non-Agent route fallback disabled',
     ],
     fields: [
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-knowledge.route',
+        action: 'open-agent-workspace:knowledge',
         label: 'Isolated Agent Knowledge route',
-        hint: 'Ask, search, status, and ingest use /api/goodvibes-agent/knowledge/* only.',
-        defaultValue: 'Isolated',
+        hint: 'Open the Knowledge workspace for isolated Agent ask, search, status, ingest, and review actions.',
+        defaultValue: 'Open Knowledge',
       },
       {
         kind: 'status',
-        id: 'agent-knowledge.no-default-wiki',
-        label: 'Default Knowledge/Wiki fallback',
-        hint: 'Agent setup and Agent ask/search must not query the default wiki when Agent Knowledge has no answer.',
+        id: 'agent-knowledge.no-default-knowledge',
+        label: 'Default knowledge fallback',
+        hint: 'Agent setup and Agent ask/search must not query the default knowledge when Agent Knowledge has no answer.',
         defaultValue: 'Blocked',
       },
       {
@@ -155,6 +158,52 @@ export function buildAgentKnowledgeStep(): OnboardingWizardStepDefinition {
   };
 }
 
+export function buildResearchStep(): OnboardingWizardStepDefinition {
+  return {
+    id: 'agent-research',
+    title: 'Research and source triage',
+    shortLabel: 'Research',
+    description: 'Prepare read-only web research and source triage. Research runs in the main Agent conversation; durable source storage uses explicit Agent Knowledge ingest.',
+    summaryTitle: 'Research posture',
+    summaryLines: [
+      'Web research: read-only main-conversation requests',
+      'URL inspection: user-directed and visible',
+      'Durable sources: explicit Agent Knowledge ingest only',
+    ],
+    fields: [
+      {
+        kind: 'action',
+        id: 'agent-research.workspace',
+        action: 'open-agent-workspace:research',
+        label: 'Research workspace',
+        hint: 'Open the Research workspace to submit web research, inspect URLs, and decide what belongs in Agent Knowledge.',
+        defaultValue: 'Open Research',
+      },
+      {
+        kind: 'status',
+        id: 'agent-research.read-only',
+        label: 'Read-only web use',
+        hint: 'Search and URL inspection are normal Agent conversation turns. They should not send messages, mutate connected-host state, or perform browser side effects.',
+        defaultValue: 'Serial',
+      },
+      {
+        kind: 'status',
+        id: 'agent-research.knowledge-boundary',
+        label: 'Source-to-knowledge boundary',
+        hint: 'Reviewed sources become durable only through confirmed Agent Knowledge ingest actions. Default knowledge and non-Agent segments are not fallback stores.',
+        defaultValue: 'Explicit ingest',
+      },
+      {
+        kind: 'status',
+        id: 'agent-research.context-references',
+        label: 'Inline URL context',
+        hint: 'Use @https://... in the composer to reference a URL for one turn without ingesting it into Agent Knowledge.',
+        defaultValue: 'Available',
+      },
+    ],
+  };
+}
+
 export function buildLocalStateStep(discovery?: AgentBehaviorDiscoverySnapshot): OnboardingWizardStepDefinition {
   const discoveredCount = discoveryCount(discovery);
   return {
@@ -163,48 +212,163 @@ export function buildLocalStateStep(discovery?: AgentBehaviorDiscoverySnapshot):
     shortLabel: 'Behavior',
     description: discoveredCount > 0
       ? 'Review importable Agent-local behavior files, then create an isolated profile from them or import individual records.'
-      : 'Review the Agent-local behavior model. Memory, personas, skills, routines, and Agent profiles stay local until a stable shared registry exists.',
-    summaryTitle: 'Local Agent state',
+      : 'Review the Agent-local behavior model. Memory, notes, personas, skills, routines, and Agent profiles stay local until a stable shared registry exists.',
+    summaryTitle: 'Agent-local state',
     summaryLines: [
-      'Memory/personas/skills/routines: local Agent registries',
-      `Discovered behavior files: ${discoverySummary(discovery)}`,
-      'Secrets: rejected or stored by secret reference',
-      'Profiles: isolated Agent homes',
+      'Memory/notes/personas/skills/routines use Agent-local registries',
+      `Discovered behavior files ${discoverySummary(discovery)}`,
+      'Secrets are rejected or stored by secret reference',
+      'Profiles use isolated Agent homes',
     ],
     fields: [
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-local-state.memory',
+        action: 'open-agent-workspace:memory',
         label: 'Local memory',
-        hint: 'Use /memory to create, review, stale, search, and delete Agent-local memory records.',
-        defaultValue: 'Local registry',
+        hint: 'Open the Memory & Skills workspace to create, review, stale, search, and delete Agent-local memory records.',
+        defaultValue: 'Open Memory',
       },
       {
-        kind: 'status',
+        kind: 'action',
+        id: 'agent-local-state.notes',
+        action: 'open-agent-workspace:notes',
+        label: 'Scratchpad notes',
+        hint: 'Open the Notes workspace to capture source triage, temporary decisions, and operator handoff without writing memory or Agent Knowledge.',
+        defaultValue: 'Open Notes',
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.note-title',
+        label: 'Initial note title',
+        hint: 'Optional scratchpad note created during setup. Notes are temporary working context, not durable memory or Agent Knowledge.',
+        placeholder: 'First things to remember',
+        defaultValue: '',
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.note-body',
+        label: 'Initial note body',
+        hint: 'Capture temporary setup context, source-triage notes, or user preferences that should be reviewed before promotion.',
+        placeholder: 'Review calendar connection later; user prefers concise daily planning; do not store secrets here.',
+        defaultValue: '',
+        multiline: true,
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.note-tags',
+        label: 'Initial note tags',
+        hint: 'Optional comma-separated tags for the setup note.',
+        placeholder: 'setup, preference',
+        defaultValue: '',
+      },
+      {
+        kind: 'action',
         id: 'agent-local-state.personas',
+        action: 'open-agent-workspace:personas',
         label: 'Personas',
         hint: discovery?.personas.count && discovery.personas.count > 0
-          ? `${discovery.personas.count} persona file(s) are available. Use the Profiles workspace to create a profile from discovered behavior, or preview individual files with /personas discover.`
-          : 'Use /personas to create and activate serial operating modes for the main conversation.',
-        defaultValue: discovery?.personas.count && discovery.personas.count > 0 ? `${discovery.personas.count} discovered` : 'Local registry',
+          ? `${discovery.personas.count} persona file(s) are available. Open the Personas workspace to review, import, activate, or create a profile from discovered behavior.`
+          : 'Open the Personas workspace to create and activate serial operating modes for the main conversation.',
+        defaultValue: discovery?.personas.count && discovery.personas.count > 0 ? `${discovery.personas.count} discovered` : 'Open Personas',
       },
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-local-state.skills',
+        action: 'open-agent-workspace:skills',
         label: 'Skills',
         hint: discovery?.skills.count && discovery.skills.count > 0
-          ? `${discovery.skills.count} skill file(s) are available. Use the Profiles workspace to create a profile from discovered behavior, or preview individual files with /agent-skills discover.`
-          : 'Use /agent-skills and /skills local to manage reusable Agent procedures.',
-        defaultValue: discovery?.skills.count && discovery.skills.count > 0 ? `${discovery.skills.count} discovered` : 'Local registry',
+          ? `${discovery.skills.count} skill file(s) are available. Open the Skills workspace to review, import, bundle, enable reusable procedures, or create a profile from discovered behavior.`
+          : 'Open the Skills workspace to manage reusable Agent procedures.',
+        defaultValue: discovery?.skills.count && discovery.skills.count > 0 ? `${discovery.skills.count} discovered` : 'Open Skills',
       },
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-local-state.routines',
+        action: 'open-agent-workspace:routines',
         label: 'Routines',
         hint: discovery?.routines.count && discovery.routines.count > 0
-          ? `${discovery.routines.count} routine file(s) are available. Use the Profiles workspace to create a profile from discovered behavior, or preview individual files with /routines discover. ${discoverySample(discovery)}`
-          : 'Use /routines for reusable local procedures. Starting a routine prints steps in the main conversation and does not spawn hidden work.',
-        defaultValue: discovery?.routines.count && discovery.routines.count > 0 ? `${discovery.routines.count} discovered` : 'Local registry',
+          ? `${discovery.routines.count} routine file(s) are available. Open the Routines workspace to review, import, start, promote reviewed routines, or create a profile from discovered behavior. ${discoverySample(discovery)}`
+          : 'Open the Routines workspace for reusable local procedures. Starting a routine prints steps in the main conversation; schedule promotion remains explicit.',
+        defaultValue: discovery?.routines.count && discovery.routines.count > 0 ? `${discovery.routines.count} discovered` : 'Open Routines',
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.persona-name',
+        label: 'Initial persona name',
+        hint: 'Optional serial Agent persona created and activated during setup. Leave persona fields blank to skip.',
+        placeholder: 'Household Operator',
+        defaultValue: '',
+        spacerBeforeRows: 1,
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.persona-description',
+        label: 'Initial persona description',
+        hint: 'Describe when this persona should shape the main conversation.',
+        placeholder: 'Handles day-to-day planning, reminders, device checks, and household coordination.',
+        defaultValue: '',
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.persona-body',
+        label: 'Initial persona instructions',
+        hint: 'Tell Agent how to behave when this persona is active.',
+        placeholder: 'Be concise, proactive, and use safe local actions before asking for follow-up details.',
+        defaultValue: '',
+        multiline: true,
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.skill-name',
+        label: 'Initial skill name',
+        hint: 'Optional reusable local procedure created and enabled during setup.',
+        placeholder: 'Daily Briefing',
+        defaultValue: '',
+        spacerBeforeRows: 1,
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.skill-description',
+        label: 'Initial skill description',
+        hint: 'Describe when Agent should use this skill.',
+        placeholder: 'Prepares a concise morning briefing from calendar, tasks, and current priorities.',
+        defaultValue: '',
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.skill-procedure',
+        label: 'Initial skill procedure',
+        hint: 'Write the procedure Agent should reuse in the main conversation.',
+        placeholder: 'Check tasks, summarize important events, identify blockers, and ask only for missing critical inputs.',
+        defaultValue: '',
+        multiline: true,
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.routine-name',
+        label: 'Initial routine name',
+        hint: 'Optional local routine created and enabled during setup. Routines print steps in the main conversation and do not launch hidden jobs.',
+        placeholder: 'Evening Reset',
+        defaultValue: '',
+        spacerBeforeRows: 1,
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.routine-description',
+        label: 'Initial routine description',
+        hint: 'Describe when the routine should be suggested or started.',
+        placeholder: 'Reviews open tasks, tomorrow priorities, and pending approvals before the day ends.',
+        defaultValue: '',
+      },
+      {
+        kind: 'text',
+        id: 'agent-local-state.routine-steps',
+        label: 'Initial routine steps',
+        hint: 'Write the local routine steps. This stays in Agent-local state only.',
+        placeholder: 'Review open tasks; summarize unresolved approvals; list tomorrow priorities; ask what to defer.',
+        defaultValue: '',
+        multiline: true,
       },
     ],
   };
@@ -224,18 +388,20 @@ export function buildAutomationStep(): OnboardingWizardStepDefinition {
     ],
     fields: [
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-automation.local-routines',
+        action: 'open-agent-workspace:routines',
         label: 'Local routine library',
-        hint: 'Use /routines or the Agent workspace to create, review, enable, and start local routines without spawning hidden jobs.',
-        defaultValue: 'Local registry',
+        hint: 'Open the Routines workspace to create, review, enable, and start local routines without hidden jobs.',
+        defaultValue: 'Open Routines',
       },
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-automation.schedule-observability',
+        action: 'open-agent-workspace:automation',
         label: 'Schedule observability',
-        hint: 'Use /schedule list, /schedule reconcile, and automation views to inspect externally owned jobs and runs.',
-        defaultValue: 'Read first',
+        hint: 'Open the Automation workspace to inspect schedules, receipts, reconciliation, externally owned jobs, and runs.',
+        defaultValue: 'Open Automation',
       },
       {
         kind: 'status',
@@ -269,11 +435,12 @@ export function buildVoiceMediaStep(): OnboardingWizardStepDefinition {
     ],
     fields: [
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-voice-media.voice',
+        action: 'open-agent-workspace:voice-media',
         label: 'Voice interaction',
-        hint: 'Use the voice/media workspace and TTS settings to configure spoken responses for the Agent conversation.',
-        defaultValue: 'Optional',
+        hint: 'Open the Voice & Media workspace and TTS settings to configure spoken responses for the Agent conversation.',
+        defaultValue: 'Open Voice',
       },
       {
         kind: 'status',
@@ -303,7 +470,7 @@ export function buildDelegationPolicyStep(): OnboardingWizardStepDefinition {
     summaryLines: [
       'Normal chat: main Agent conversation',
       'Build/fix/review: explicit GoodVibes TUI delegation',
-      'WRFC: only when explicitly requested for build/fix/review',
+      'Delegated review: only when explicitly requested for build/fix/review',
     ],
     fields: [
       {
@@ -314,17 +481,18 @@ export function buildDelegationPolicyStep(): OnboardingWizardStepDefinition {
         defaultValue: 'Serial',
       },
       {
-        kind: 'status',
+        kind: 'action',
         id: 'agent-delegation.build-work',
+        action: 'open-agent-workspace:delegate',
         label: 'Build/fix/review work',
-        hint: 'Use /delegate with the full original task. GoodVibes TUI owns coding execution and WRFC chains.',
-        defaultValue: 'Explicit delegation',
+        hint: 'Open the Delegation workspace for explicit build/fix/review handoff. GoodVibes TUI owns coding execution and delegated review chains.',
+        defaultValue: 'Open Delegation',
       },
       {
         kind: 'status',
-        id: 'agent-delegation.wrfc',
-        label: 'WRFC policy',
-        hint: 'Agent never uses WRFC by default; request it only for explicit build, fix, review, or implementation work.',
+        id: 'agent-delegation.review',
+        label: 'Review policy',
+        hint: 'Agent never requests delegated review by default; request it only for explicit build, fix, review, or implementation work.',
         defaultValue: 'Explicit only',
       },
     ],

package/src/input/onboarding/onboarding-wizard-steps.ts

@@ -1,11 +1,19 @@
 import { REASONING_OPTIONS, HITL_MODE_OPTIONS, GUIDANCE_MODE_OPTIONS, PERMISSION_MODE_OPTIONS, SECRET_POLICY_OPTIONS } from './onboarding-wizard-constants.ts';
 import { modelSelectionLabel, normalizeText } from './onboarding-wizard-helpers.ts';
-import { buildAgentKnowledgeStep, buildAutomationStep, buildCommunicationStep, buildDelegationPolicyStep, buildLocalStateStep, buildToolsStep, buildVoiceMediaStep } from './onboarding-wizard-operator-steps.ts';
+import { buildAgentKnowledgeStep, buildAutomationStep, buildCommunicationStep, buildDelegationPolicyStep, buildLocalStateStep, buildResearchStep, buildToolsStep, buildVoiceMediaStep } from './onboarding-wizard-operator-steps.ts';
 import { listAgentRuntimeProfileTemplates } from '../../agent/runtime-profile.ts';
 import type { OnboardingWizardController } from './onboarding-wizard.ts';
 import type { OnboardingWizardActionFieldDefinition, OnboardingWizardFieldDefinition, OnboardingWizardModelPickerFieldDefinition, OnboardingWizardRadioFieldDefinition, OnboardingWizardRadioOption, OnboardingWizardStepDefinition } from './onboarding-wizard-types.ts';
 import type { OnboardingProviderAccountRecord, OnboardingStep1CapabilityId, OnboardingStep1CapabilityItem } from '../../runtime/onboarding/index.ts';
 
+const DEFAULT_STARTER_TEMPLATE_ID = 'personal-productivity';
+
+function defaultStarterTemplateId(): string {
+  const templates = listAgentRuntimeProfileTemplates();
+  if (templates.some((template) => template.id === DEFAULT_STARTER_TEMPLATE_ID)) return DEFAULT_STARTER_TEMPLATE_ID;
+  return templates[0]?.id ?? 'none';
+}
+
 function buildStarterTemplateOptions(): readonly OnboardingWizardRadioOption[] {
   return [
     {
@@ -30,6 +38,7 @@ export function buildOnboardingWizardSteps(controller: OnboardingWizardControlle
     buildDefaultModelStep(controller),
     buildCommunicationStep(),
     buildToolsStep(),
+    buildResearchStep(),
     buildAgentKnowledgeStep(),
     buildLocalStateStep(controller.runtimeSnapshot?.localBehaviorDiscovery),
     buildAutomationStep(),
@@ -114,10 +123,10 @@ function buildReviewReadinessFields(controller: OnboardingWizardController): rea
     {
       kind: 'status',
       id: 'review.readiness.connection',
-      label: 'Connected services snapshot',
+      label: 'Connected host snapshot',
       hint: collectionIssues > 0
         ? `${collectionIssues} setup snapshot issue(s) need attention before this Agent is day-one ready.`
-        : 'The setup snapshot loaded cleanly from connected GoodVibes services.',
+        : 'The setup snapshot loaded cleanly from the connected GoodVibes host.',
       defaultValue: collectionIssues > 0 ? 'Needs attention' : 'Ready',
       spacerBeforeRows: 1,
     },
@@ -139,14 +148,21 @@ function buildReviewReadinessFields(controller: OnboardingWizardController): rea
       kind: 'status',
       id: 'review.readiness.knowledge',
       label: 'Agent Knowledge segment',
-      hint: 'Ask, search, status, and ingest stay on /api/goodvibes-agent/knowledge/* with no default wiki or non-Agent fallback.',
+      hint: 'Ask, search, status, and ingest stay on /api/goodvibes-agent/knowledge/* with no default knowledge or non-Agent fallback.',
       defaultValue: 'Isolated',
     },
+    {
+      kind: 'status',
+      id: 'review.readiness.research',
+      label: 'Research and source triage',
+      hint: 'Web research and URL inspection stay in the main conversation; durable source storage requires explicit Agent Knowledge ingest.',
+      defaultValue: 'Read-only',
+    },
     {
       kind: 'status',
       id: 'review.readiness.local-behavior',
       label: 'Local behavior library',
-      hint: localBehavior?.detail ?? 'Agent-local memory, routines, skills, and personas remain local until a stable shared registry exists.',
+      hint: localBehavior?.detail ?? 'Agent-local memory, notes, routines, skills, and personas remain local until a stable shared registry exists.',
       defaultValue: localBehavior?.selected ? 'Customized' : 'Starter ready',
     },
     {
@@ -206,13 +222,13 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
     id: 'agent-setup',
     title: 'Agent setup',
     shortLabel: 'Agent',
-    description: 'Set up the Agent operator workspace: local identity, provider access, isolated Agent Knowledge, reusable local behavior, and explicit build delegation.',
+    description: 'Set up the Agent operator workspace with local identity, provider access, isolated Agent Knowledge, reusable local behavior, and explicit build delegation.',
     summaryTitle: 'Agent setup posture',
     summaryLines: [
       'Agent owns the operator TUI and local behavior registry.',
       'Optional starter profile: create an isolated Agent home from setup.',
       'Setup here changes only Agent-owned settings and local state.',
-      `Secret policy: ${controller.getStringFieldValue('agent-setup.secret-policy', secretPolicy)}`,
+      `Secret policy ${controller.getStringFieldValue('agent-setup.secret-policy', secretPolicy)}`,
       collectionIssues > 0 ? `${collectionIssues} setup snapshot issue(s)` : 'Setup snapshot collected cleanly',
     ],
     fields: [
@@ -226,10 +242,10 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
       {
         kind: 'status',
         id: 'agent-setup.connection',
-        label: 'Connected GoodVibes services',
+        label: 'Connected GoodVibes host',
         hint: collectionIssues > 0
           ? `${collectionIssues} setup snapshot issue(s) were reported. Status and doctor commands show connection details.`
-          : 'Agent uses connected GoodVibes services for companion chat, work plans, approvals, automation, and Agent Knowledge.',
+          : 'Agent uses the connected GoodVibes host for companion chat, work plans, approvals, automation, and Agent Knowledge.',
         defaultValue: collectionIssues > 0 ? `${collectionIssues} issue(s)` : 'Connected',
       },
       {
@@ -244,7 +260,7 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
         kind: 'text',
         id: 'agent-setup.profile-name',
         label: 'Create starter profile',
-        hint: 'Optional: enter a new Agent profile name to create an isolated home during setup. Leave blank to keep the current home.',
+        hint: 'Optional Agent profile name creates an isolated home during setup. Leave blank to keep the current home.',
         placeholder: 'research-desk',
         defaultValue: '',
       },
@@ -252,16 +268,24 @@ export function buildAgentSetupStep(controller: OnboardingWizardController): Onb
         kind: 'radio',
         id: 'agent-setup.profile-template',
         label: 'Starter profile template',
-        hint: 'Choose the persona, skills, and routine bundle to seed into the optional new Agent profile.',
+        hint: 'Choose the persona, skills, and routine bundle to seed into the optional new Agent profile. Select No profile only when you intentionally want an empty Agent home.',
         options: buildStarterTemplateOptions(),
-        defaultValue: 'none',
+        defaultValue: defaultStarterTemplateId(),
       },
       {
-        kind: 'status',
+        kind: 'checklist',
+        id: 'agent-setup.profile-default',
+        label: 'Use created profile by default',
+        hint: 'When a starter profile name is provided, make that isolated Agent profile the default for later plain goodvibes-agent runs.',
+        defaultValue: true,
+      },
+      {
+        kind: 'action',
         id: 'agent-setup.profile-guide',
+        action: 'open-agent-workspace:profiles',
         label: 'Profile guidance',
-        hint: 'Use /agent-profile guide after setup to export, customize, import, and launch Agent profiles.',
-        defaultValue: 'Available',
+        hint: 'Open the Profiles workspace to browse starters, export, customize, import, create, and select isolated Agent profiles.',
+        defaultValue: 'Open Profiles',
       },
     ],
   };
@@ -306,8 +330,8 @@ export function buildProviderAccessStep(controller: OnboardingWizardController):
       id: 'providers.subscription-sessions',
       label: 'Subscription sessions',
       hint: [
-        `active: ${formatBoundedList(activeSubscriptionProviders, 'none')}`,
-        `pending: ${formatBoundedList(pendingSubscriptionProviders, 'none')}`,
+        `active ${formatBoundedList(activeSubscriptionProviders, 'none')}`,
+        `pending ${formatBoundedList(pendingSubscriptionProviders, 'none')}`,
       ].join('  '),
       defaultValue: `${activeSubscriptions.length} active / ${pendingSubscriptions.length} pending`,
     },
@@ -323,8 +347,8 @@ export function buildProviderAccessStep(controller: OnboardingWizardController):
       id: 'providers.openai-api-key',
       label: 'OpenAI API key quick start',
       hint: openAiApiKeyConfigured
-        ? 'Optional quick start: an OpenAI API key is already stored. Leave blank to keep it; enter a new key to replace it through the secret manager.'
-        : 'Optional quick start: enter an OpenAI API key now. Other providers can be configured from /secrets, /provider, and the model picker.',
+        ? 'Optional quick start already has an OpenAI API key stored. Leave blank to keep it; enter a new key to replace it through the secret manager.'
+        : 'Optional quick start can store an OpenAI API key now. Other providers can be configured from the Setup workspace, Tools & MCP workspace, and model picker.',
       placeholder: openAiApiKeyConfigured ? 'already configured' : 'sk-...',
       defaultValue: '',
     },
@@ -373,10 +397,10 @@ export function buildProviderAccessStep(controller: OnboardingWizardController):
     description: 'Review provider and model access for the Agent conversation. Credentials stay masked and provider-specific setup remains configurable.',
     summaryTitle: 'Provider access summary',
     summaryLines: [
-      `Default route: ${providerRouteLabel}`,
-      `Provider account routes: ${configuredAccounts.length}`,
-      `Subscription sessions: ${activeSubscriptions.length} active / ${pendingSubscriptions.length} pending`,
-      `Provider credential references: ${providerSecretCount}`,
+      `Default route ${providerRouteLabel}`,
+      `Provider account routes ${configuredAccounts.length}`,
+      `Subscription sessions ${activeSubscriptions.length} active / ${pendingSubscriptions.length} pending`,
+      `Provider credential references ${providerSecretCount}`,
     ],
     fields,
   };
@@ -412,8 +436,8 @@ export function buildDefaultModelStep(controller: OnboardingWizardController): O
     description: 'Choose the default provider, model, and reasoning posture for normal Agent conversation.',
     summaryTitle: 'Default model summary',
     summaryLines: [
-      `Main: ${modelSelectionLabel(controller.modelSelectionState.get('main') ?? primarySelectionField.defaultSelection)}`,
-      `Reasoning: ${controller.getFieldValueLabel(reasoningField)}`,
+      `Main ${modelSelectionLabel(controller.modelSelectionState.get('main') ?? primarySelectionField.defaultSelection)}`,
+      `Reasoning ${controller.getFieldValueLabel(reasoningField)}`,
     ],
     fields: [primarySelectionField, reasoningField],
   };
@@ -427,9 +451,9 @@ export function buildExperienceStep(controller: OnboardingWizardController): Onb
     description: 'Tune the Agent conversation style and approval posture for day-to-day operator use.',
     summaryTitle: 'Experience posture',
     summaryLines: [
-      `Human-in-the-Loop (HITL): ${controller.getStringFieldValue('experience.hitl', controller.runtimeSnapshot?.runtimeDefaults.behavior.hitlMode ?? 'balanced')}`,
-      `Guidance: ${controller.getStringFieldValue('experience.guidance', controller.runtimeSnapshot?.runtimeDefaults.behavior.guidanceMode ?? 'minimal')}`,
-      `Permissions: ${controller.getStringFieldValue('experience.permissions', controller.runtimeSnapshot?.runtimeDefaults.permissionsMode ?? 'prompt')}`,
+      `Human-in-the-Loop (HITL) ${controller.getStringFieldValue('experience.hitl', controller.runtimeSnapshot?.runtimeDefaults.behavior.hitlMode ?? 'balanced')}`,
+      `Guidance ${controller.getStringFieldValue('experience.guidance', controller.runtimeSnapshot?.runtimeDefaults.behavior.guidanceMode ?? 'minimal')}`,
+      `Permissions ${controller.getStringFieldValue('experience.permissions', controller.runtimeSnapshot?.runtimeDefaults.permissionsMode ?? 'prompt')}`,
     ],
     fields: [
       {
@@ -493,11 +517,11 @@ export function buildReviewStep(controller: OnboardingWizardController): Onboard
     description: 'Review the Agent day-one checklist and apply setup directly from the wizard.',
     summaryTitle: 'Agent day-one readiness',
     summaryLines: [
-      `Day-one readiness: ${dayOneReadiness}`,
+      `Day-one readiness ${dayOneReadiness}`,
       unsavedLabel,
       `${controller.buildApplyRequest().operations.length} Agent setting change(s) ready to apply`,
-      feedback ? `Last apply: ${feedback.title}` : 'No apply errors reported',
-      controller.isEditingTextField() ? `Editing: ${controller.editingFieldId}` : 'Ready to apply',
+      feedback ? `Last apply ${feedback.title}` : 'No apply errors reported',
+      controller.isEditingTextField() ? `Editing ${controller.editingFieldId}` : 'Ready to apply',
     ],
     fields: [
       ...feedbackFields,
@@ -505,16 +529,16 @@ export function buildReviewStep(controller: OnboardingWizardController): Onboard
       {
         kind: 'status',
         id: 'review.global-marker',
-        label: 'Agent setup check',
-        hint: 'Opening this wizard marks Agent setup as shown for this user account, so it does not reopen automatically.',
-        defaultValue: 'Already marked as shown',
+        label: 'Agent setup completion',
+        hint: 'Successful apply marks Agent setup complete for this user account, so a bare launch opens the operator workspace next time.',
+        defaultValue: 'Marked after apply',
       },
       {
         kind: 'action',
         id: 'review.apply',
         action: 'apply',
         label: 'Apply Agent settings and verify',
-        hint: 'Persist Agent-owned settings and verify that setup did not request non-Agent entrypoints, default wiki access, or non-Agent knowledge setup.',
+        hint: 'Persist Agent-owned settings and verify that setup did not request non-Agent entrypoints, default knowledge access, or non-Agent knowledge setup.',
         defaultValue: 'Ready',
       },
     ],