opencode-onboard 0.4.4 → 0.4.7

package/content/DESIGN.md

@@ -1,26 +1,16 @@
-> Execute this command
-
-Analyze the design system of this codebase with the goal of creating a DESIGN.md file in the project root and giving the user a file for easy copy & pasting.
-
-Reference material:
-  Overview : https://stitch.withgoogle.com/docs/design-md/overview/
-  Format   : https://stitch.withgoogle.com/docs/design-md/format/
-  Spec     : https://github.com/google-labs-code/design.md
-
-Examples from the spec repo:
-  https://github.com/google-labs-code/design.md/blob/main/examples/atmospheric-glass/DESIGN.md
-  https://github.com/google-labs-code/design.md/blob/main/examples/paws-and-paths/DESIGN.md
-
-Requirements:
-- Begin with YAML frontmatter containing all structured design tokens
-  (colors, typography, spacing, elevation, motion, radii, shadows, etc.)
-- Follow with free-form Markdown that describes the look & feel and
-  captures design intent that token values alone cannot convey
-- The file must be entirely self-contained, do not reference any
-  files, variables, or paths from the codebase
-- All token values must use valid YAML design token format
-
-If you have access to a running local server or screenshots of the
-product, compare your DESIGN.md against the rendered UI. Revise until
-both the YAML tokens and the written description faithfully capture
-the product's visual identity.
+> NOT GENERATED YET
+>
+> This file has not been populated yet. It is intentionally empty.
+>
+> **If this is a greenfield project** (no UI exists yet): skip this for now.
+> Come back and run `/ob-create-design` once you have a design system, UI components, or styles in place.
+>
+> **If this is a brownfield project** (existing UI/styles): run this command now to generate the design documentation:
+>
+> ```
+> /ob-create-design
+> ```
+>
+> This command analyzes your CSS, Tailwind config, component files, and design tokens,
+> then writes a complete DESIGN.md with structured YAML tokens and written design intent.
+> It is safe to rerun any time your design system changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-onboard",
-  "version": "0.4.4",
+  "version": "0.4.7",
   "description": "Prepare any brownfield codebase for AI agent workflows using OpenCode, OpenSpec, and ensemble orchestration.",
   "keywords": [
     "opencode",

package/src/commands/join.js

@@ -18,7 +18,12 @@ export async function runJoin() {
   const saved = await readOnboardConfig()
   const savedPlatform = saved?.wizard?.platform
   if (savedPlatform) {
-    info(`Detected project platform: ${savedPlatform === 'github' ? 'GitHub' : 'Azure DevOps'}`)
+    const display = savedPlatform === 'github'
+      ? 'GitHub'
+      : savedPlatform === 'azure'
+        ? 'Azure DevOps'
+        : 'None'
+    info(`Detected project platform: ${display}`)
     await checkPlatform(savedPlatform)
   } else {
     const platform = await choosePlatform()

package/src/commands/single.js

@@ -20,7 +20,7 @@ export async function runSingleCommand(command) {
     maxConcurrentAgents: savedWizard?.maxConcurrentAgents ?? 4,
   }
   const platform = savedWizard?.platform
-  const resolvedPlatform = platform === 'azure' || platform === 'github' ? platform : 'github'
+  const resolvedPlatform = platform === 'azure' || platform === 'github' || platform === 'none' ? platform : 'github'
 
   const handlers = {
     clean: async () => {

package/src/presets/models.json

@@ -16,10 +16,10 @@
     "build": {
       "prompt": "Build model:",
       "info": [
-        "BUILD model: used by front-engineer, back-engineer, infra-engineer, quality-engineer, security-auditor.",
+        "BUILD model: used by basic-engineer and any custom engineer created in the project.",
         "Needs to be capable for implementation work. Claude Sonnet, GPT-4o, or equivalent."
       ],
-      "agents": ["front-engineer", "back-engineer", "infra-engineer", "quality-engineer", "security-auditor"]
+      "agents": ["basic-engineer"]
     },
     "fast": {
       "prompt": "Fast model:",

package/src/presets/platforms.json

@@ -33,5 +33,9 @@
         ]
       }
     }
+  },
+  {
+    "value": "none",
+    "name": "None"
   }
 ]

package/src/steps/copy/agents.js

@@ -38,8 +38,23 @@ function renumberSteps(content) {
 
 const PLATFORM_SKILLS_START = '<!-- OB-PLATFORM-SKILLS-START -->'
 const PLATFORM_SKILLS_END = '<!-- OB-PLATFORM-SKILLS-END -->'
+const PLATFORM_MODE_START = '<!-- OB-PLATFORM-MODE-START -->'
+const PLATFORM_MODE_END = '<!-- OB-PLATFORM-MODE-END -->'
+const PLATFORM_WORKFLOW_START = '<!-- OB-PLATFORM-WORKFLOW-START -->'
+const PLATFORM_WORKFLOW_END = '<!-- OB-PLATFORM-WORKFLOW-END -->'
+const PLATFORM_PIPELINE_START = '<!-- OB-PLATFORM-PIPELINE-START -->'
+const PLATFORM_PIPELINE_END = '<!-- OB-PLATFORM-PIPELINE-END -->'
 
 function buildPlatformSkillsSection(platform) {
+  if (platform === 'none') {
+    return [
+      '- Selected platform: `none` (from onboarding platform step).',
+      '- Do NOT load `ob-userstory-gh`, `ob-userstory-az`, `ob-pullrequest-gh`, or `ob-pullrequest-az`.',
+      '- Work only from direct user instructions in the main conversation or from local OpenSpec artifacts.',
+      '- Ignore GitHub/Azure DevOps URL inference unless the user explicitly reconfigures onboarding later.',
+    ].join('\n')
+  }
+
   if (platform === 'azure') {
     return [
       '- Selected platform: `azure` (from onboarding platform step).',
@@ -55,6 +70,176 @@ function buildPlatformSkillsSection(platform) {
   ].join('\n')
 }
 
+function buildPlatformModeSection(platform) {
+  if (platform === 'none') {
+    return 'This project does not use GitHub or Azure DevOps integration. Do not read work items, create PRs, or process PR feedback. Operate only from direct user instructions and local repository context.'
+  }
+
+  return 'This project uses platform-integrated workflow modes described below.'
+}
+
+function buildLeadWorkflowSection(platform) {
+  if (platform === 'none') {
+    return [
+      'When the user gives a task directly in the conversation, **I own the full lifecycle**. I load `ob-global` first, then work from the user request and local repository context. I may use OpenSpec when structured planning helps, but I do not depend on issue links or PR workflows.',
+      '',
+      'Trigger patterns, I recognize ALL of these, exact wording does not matter:',
+      '- User describes a feature, bug, or refactor directly → clarify if needed → optionally run `/opsx-propose` → implement in the main session or `/opsx-apply` as appropriate',
+      '- `implement the plan` / `implement` / `start` / `go` → run `/opsx-apply` against the current OpenSpec change when one exists',
+      '- `just do it` / `quick fix` / `raw conversation` → work directly in the main session without PR or work-item automation',
+      '',
+      '**GitHub Issue URLs, Azure DevOps work item URLs, and PR URLs are NOT automatic triggers in this mode.** Only use platform-specific flows if onboarding is later reconfigured for GitHub or Azure DevOps.',
+    ].join('\n')
+  }
+
+  return [
+    'When the user provides a work item URL or says "implement the plan" or "I\'ve added comments to the PR", **I own the full lifecycle**. I load `ob-global` skill first, then the appropriate userstory skill, and use ensemble tools to coordinate the agent team.',
+    '',
+    'Trigger patterns, I recognize ALL of these, exact wording does not matter:',
+    platform === 'azure'
+      ? '- User pastes or mentions an Azure DevOps URL → load `ob-userstory-az` skill → parse work item → run `/opsx-propose` → confirm with user → run `/opsx-apply` → ship'
+      : '- User pastes or mentions a GitHub Issue URL → load `ob-userstory-gh` skill → parse issue → run `/opsx-propose` → confirm with user → run `/opsx-apply` → ship',
+    '- `implement the plan` / `implement` / `start` / `go` → run `/opsx-apply` → ship',
+    '- `I\'ve added comments to the PR` → read PR comments → fix → update PR',
+    platform === 'azure'
+      ? '- Any Azure DevOps PR URL in a feedback/fix request (e.g. "check comments", "fix PR feedback") → run PR Feedback Loop'
+      : '- Any GitHub PR URL in a feedback/fix request (e.g. "check comments", "fix PR feedback") → run PR Feedback Loop',
+    '',
+    platform === 'azure'
+      ? '**An Azure DevOps URL anywhere in the user\'s message is always a trigger, regardless of surrounding words.**'
+      : '**A GitHub URL anywhere in the user\'s message is always a trigger, regardless of surrounding words.**',
+  ].join('\n')
+}
+
+function buildPipelineSection(platform) {
+  if (platform === 'none') {
+    return [
+      '```',
+      'main session (lead mode)',
+      '  → load ob-global + understand direct user request',
+      '        ↓',
+      '  optional openspec-propose',
+      '  → proposal.md + specs + tasks when structured planning helps',
+      '        ↓',
+      '  [confirm with user when scope needs it]',
+      '        ↓',
+      'basic-engineer + custom-engineer-* (parallel as needed)',
+      '  → claim tasks + load abilities + implement',
+      '        ↓',
+      'main session',
+      '  → verify completion → summarize results to user',
+      '```',
+      '',
+      '### Phase 1, Clarify & Plan',
+      '',
+      '```',
+      '1. Load `ob-global`.',
+      '2. Understand the task directly from the conversation and local repo context.',
+      '3. If the work benefits from explicit specs/tasks, run `/opsx-propose` or create/update OpenSpec artifacts.',
+      '4. Show the plan or intended scope when the work is non-trivial.',
+      '5. If the request is small and clear, implementation can begin directly in the main session.',
+      '```',
+      '',
+      '### Phase 2, Implement',
+      '',
+      '```',
+      '0. Run `/quota` to check remaining budget before spawning, when available.',
+      '1. If using OpenSpec tasks, run `/opsx-apply`.',
+      '   - Step 5b: classify cost tier, announce scope, ask user to confirm if ≥4 tasks.',
+      '   - Lead adds all tasks to board.',
+      '   - When dependencies exist, lead uses multiple `team_tasks_add` waves so later tasks can reference real task IDs returned by earlier waves.',
+      '   - Lead discovers available engineers from `.agents/agents/*.md`, prefers matching custom engineers, then spawns engineers with initial batch of up to 3 tasks each (rolling batch model).',
+      '   - Each engineer claims tasks, implements, completes, messages lead.',
+      '   - Lead assigns next batch (up to 3) to agents that report done. Repeat until board empty.',
+      '   - Lead merges each engineer branch after shutdown, then marks tasks done in tasks.md.',
+      '2. If the task is small and no OpenSpec plan is needed, implement directly in the main session instead.',
+      '3. Verify with tests/build/lint according to task scope.',
+      '```',
+      '',
+      'There is no PR shipping phase and no PR feedback loop in `none` mode. Report completion directly to the user in the main conversation.',
+    ].join('\n')
+  }
+
+  const phase1Line = platform === 'azure'
+    ? '1. Detect URL type → load matching skill (`ob-userstory-az`)'
+    : '1. Detect URL type → load matching skill (`ob-userstory-gh`)'
+  const prFlow = platform === 'azure'
+    ? '3. team_spawn name:devops agent:devops-manager (ship mode)\n   → commit & push → create PR → post comment'
+    : '3. team_spawn name:devops agent:devops-manager (ship mode)\n   → commit & push → create PR → post comment'
+
+  return [
+    '```',
+    'devops-manager (lead mode)',
+    '  → load ob-global + parse work item via skill',
+    '        ↓',
+    '  openspec-propose',
+    '  → proposal.md + specs + tasks',
+    '        ↓',
+    '  [confirm with user]',
+    '        ↓',
+    'basic-engineer + custom-engineer-* (parallel as needed)',
+    '  → claim tasks + load abilities + implement',
+    '        ↓',
+    'devops-manager (ship mode)',
+    '  → verify completion → commit → push → PR → post comment',
+    '```',
+    '',
+    '### Phase 1, Parse & Propose',
+    '',
+    '```',
+    phase1Line,
+    '2. Follow skill steps: fetch issue/work item via CLI, create OpenSpec change',
+    '3. Run /opsx-propose → generates proposal.md, specs/, design.md, tasks.md',
+    '4. Show the plan: change name, total tasks, task list summary',
+    '5. STOP. Ask user: "Ready to implement? (yes/no)", DO NOT proceed until confirmed.',
+    '```',
+    '',
+    '### Phase 2, Implement',
+    '',
+    '```',
+    '0. Run /quota to check remaining budget before spawning.',
+    '1. Run /opsx-apply.',
+    '   - Step 5b: classify cost tier, announce scope, ask user to confirm if ≥4 tasks.',
+    '   - Lead adds all tasks to board.',
+    '   - When dependencies exist, lead uses multiple `team_tasks_add` waves so later tasks can reference real task IDs returned by earlier waves.',
+    '   - Lead discovers available engineers from `.agents/agents/*.md`, prefers matching custom engineers, then spawns engineers with initial batch of up to 3 tasks each (rolling batch model).',
+    '   - Each engineer claims tasks, implements, completes, messages lead.',
+    '   - Lead assigns next batch (up to 3) to agents that report done. Repeat until board empty.',
+    '   - Lead merges each engineer branch after shutdown, then marks tasks done in tasks.md.',
+    '2. Verify with tests/build/lint according to task scope.',
+    '3. Run /quota after all agents are merged.',
+    '```',
+    '',
+    '### Phase 3, Ship',
+    '',
+    '```',
+    prFlow,
+    '4. Wait → team_results → report PR URL to user',
+    '5. team_cleanup',
+    '```',
+    '',
+    '### Phase 4, PR Feedback Loop',
+    '',
+    '```',
+    'When user says "I\'ve added comments to the PR" or asks to fix PR comments from PR URLs:',
+    '1. team_create "pr-feedback-<id>-<random>"',
+    '2. team_tasks_add with at least these lead-managed tasks:',
+    '   - Parse and classify PR feedback (devops-manager)',
+    '   - Implement feedback items (basic-engineer and/or custom engineers)',
+    '   - Verify with tests/build/lint (implementation worker or dedicated verifier if available)',
+    '   - Push updates and post PR replies (devops-manager)',
+    '3. team_spawn devops-manager (feedback mode) with explicit task IDs, then team_message "Start now"',
+    '4. Wait for message → team_results',
+    '5. Add/update implementation tasks on board, then spawn needed engineers in parallel with explicit task IDs + team_message "Start now"',
+    '6. Wait for engineer results → team_shutdown + team_merge per engineer',
+    '7. Run verification tasks (tests/build/lint) and fix blockers if any',
+    '8. team_spawn devops-manager (ship mode) with "push + update PR threads" task ID + team_message "Start now"',
+    '9. Wait → team_results → report what was updated',
+    '10. team_cleanup',
+    '```',
+  ].join('\n')
+}
+
 function replaceBetween(content, start, end, replacement) {
   if (!content.includes(start) || !content.includes(end)) return content
   const pattern = new RegExp(`${start}[\\s\\S]*?${end}`)
@@ -122,13 +307,25 @@ export async function patchAgentsMd(ctx) {
   }
 }
 
-export async function patchDevopsManagerMd(platform) {
-  const devopsPath = path.join(process.cwd(), '.agents', 'agents', 'devops-manager.md')
+export async function patchAgentGuidance(platform, cwd = process.cwd()) {
+  const agentsMdPath = path.join(cwd, 'AGENTS.md')
+  if (await fse.pathExists(agentsMdPath)) {
+    let content = await fse.readFile(agentsMdPath, 'utf-8')
+    content = replaceBetween(content, PLATFORM_WORKFLOW_START, PLATFORM_WORKFLOW_END, buildLeadWorkflowSection(platform))
+    content = replaceBetween(content, PLATFORM_PIPELINE_START, PLATFORM_PIPELINE_END, buildPipelineSection(platform))
+    await fse.writeFile(agentsMdPath, `${content.replace(/\s*$/, '')}\n`, 'utf-8')
+    success(`AGENTS.md patched for platform workflow: ${platform}`)
+  }
+}
+
+export async function patchDevopsManagerMd(platform, cwd = process.cwd()) {
+  const devopsPath = path.join(cwd, '.agents', 'agents', 'devops-manager.md')
   if (!await fse.pathExists(devopsPath)) return
 
-  const resolved = platform === 'azure' ? 'azure' : 'github'
+  const resolved = platform === 'azure' ? 'azure' : platform === 'none' ? 'none' : 'github'
   let content = await fse.readFile(devopsPath, 'utf-8')
   content = replaceBetween(content, PLATFORM_SKILLS_START, PLATFORM_SKILLS_END, buildPlatformSkillsSection(resolved))
+  content = replaceBetween(content, PLATFORM_MODE_START, PLATFORM_MODE_END, buildPlatformModeSection(resolved))
   await fse.writeFile(devopsPath, `${content.replace(/\s*$/, '')}\n`, 'utf-8')
   success(`devops-manager.md patched for platform: ${resolved}`)
 }

package/src/steps/copy/agents.test.js

@@ -0,0 +1,45 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import fse from 'fs-extra'
+import { patchAgentGuidance, patchDevopsManagerMd } from './agents.js'
+
+describe('platform patching', () => {
+  let tmpDir
+
+  beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'agents-patch-test-'))
+  })
+
+  afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true })
+  })
+
+  it('patches AGENTS.md for none mode with raw-conversation workflow', async () => {
+    const source = path.join(process.cwd(), 'content', 'AGENTS.md')
+    const dest = path.join(tmpDir, 'AGENTS.md')
+    await fse.copyFile(source, dest)
+
+    await patchAgentGuidance('none', tmpDir)
+
+    const content = await fse.readFile(dest, 'utf-8')
+    expect(content).toContain('GitHub Issue URLs, Azure DevOps work item URLs, and PR URLs are NOT automatic triggers in this mode.')
+    expect(content).toContain('There is no PR shipping phase and no PR feedback loop in `none` mode.')
+    expect(content).not.toContain('A GitHub or Azure DevOps URL anywhere in the user\'s message is always a trigger')
+  })
+
+  it('patches devops-manager for none mode without platform skills', async () => {
+    const source = path.join(process.cwd(), 'content', '.agents', 'agents', 'devops-manager.md')
+    const dest = path.join(tmpDir, '.agents', 'agents', 'devops-manager.md')
+    await fse.ensureDir(path.dirname(dest))
+    await fse.copyFile(source, dest)
+
+    await patchDevopsManagerMd('none', tmpDir)
+
+    const content = await fse.readFile(dest, 'utf-8')
+    expect(content).toContain('Selected platform: `none`')
+    expect(content).toContain('Do NOT load `ob-userstory-gh`, `ob-userstory-az`, `ob-pullrequest-gh`, or `ob-pullrequest-az`.')
+    expect(content).toContain('This project does not use GitHub or Azure DevOps integration.')
+  })
+})

package/src/steps/copy/copy.test.js

@@ -11,6 +11,7 @@ vi.mock('../../utils/copy.js', () => ({
 }))
 
 vi.mock('./agents.js', () => ({
+  patchAgentGuidance: vi.fn(),
   patchAgentsMd: vi.fn(),
   patchConcurrency: vi.fn(),
   patchDevopsManagerMd: vi.fn(),
@@ -21,7 +22,7 @@ vi.mock('./skills.js', () => ({
 }))
 
 import { copyContent } from '../../utils/copy.js'
-import { success, error } from '../../utils/exec.js'
+import { error } from '../../utils/exec.js'
 import { copyContentStep } from './index.js'
 
 describe('copyContentStep()', () => {
@@ -47,7 +48,6 @@ describe('copyContentStep()', () => {
       'github',
       {}
     )
-    expect(success).toHaveBeenCalledWith('Files copied to project root')
   })
 
   it('calls copyContent with azure platform', async () => {
@@ -63,6 +63,19 @@ describe('copyContentStep()', () => {
     )
   })
 
+  it('calls copyContent with none platform', async () => {
+    copyContent.mockResolvedValue(undefined)
+
+    await copyContentStep('none')
+
+    expect(copyContent).toHaveBeenCalledWith(
+      expect.stringContaining('content'),
+      process.cwd(),
+      'none',
+      {}
+    )
+  })
+
   it('calls process.exit(1) when copyContent throws', async () => {
     copyContent.mockRejectedValue(new Error('disk full'))
 

package/src/steps/copy/index.js

@@ -3,7 +3,7 @@ import path from 'path'
 import { fileURLToPath } from 'url'
 import { copyContent } from '../../utils/copy.js'
 import { error, header, success } from '../../utils/exec.js'
-import { patchAgentsMd, patchConcurrency, patchDevopsManagerMd } from './agents.js'
+import { patchAgentGuidance, patchAgentsMd, patchConcurrency, patchDevopsManagerMd } from './agents.js'
 import { installSkills } from './skills.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -23,6 +23,7 @@ export async function copyContentStep(platform, ctx = {}) {
       roots: ctx.sourceRoots || [dest],
     }, { spaces: 2 })
     await patchDevopsManagerMd(platform)
+    await patchAgentGuidance(platform)
     await patchAgentsMd(ctx)
     await patchConcurrency(ctx)
     await installSkills()

package/src/steps/metadata/index.js

@@ -18,11 +18,12 @@ async function detectOpencodeVersion() {
   }
 }
 
-export async function writeOnboardConfig(data) {
-  header('Step 10, Writing onboarding metadata')
-
-  const opencodeVersion = await detectOpencodeVersion()
-  const target = path.join(process.cwd(), '.opencode', 'opencode-onboard.json')
+export async function writeOnboardConfig(data) {
+  header('Step 10, Writing onboarding metadata')
+
+  const opencodeVersion = await detectOpencodeVersion()
+  const cwd = data.cwd ?? process.cwd()
+  const target = path.join(cwd, '.opencode', 'opencode-onboard.json')
 
   const payload = {
     schema: 1,

package/src/steps/metadata/metadata.test.js

@@ -25,17 +25,14 @@ import fse from 'fs-extra'
 import { writeOnboardConfig } from './index.js'
 
 describe('writeOnboardConfig()', () => {
-  let tmpDir, originalCwd
+  let tmpDir
 
   beforeEach(() => {
     vi.clearAllMocks()
     tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'metadata-test-'))
-    originalCwd = process.cwd()
-    process.chdir(tmpDir)
   })
 
   afterEach(() => {
-    process.chdir(originalCwd)
     fs.rmSync(tmpDir, { recursive: true, force: true })
   })
 
@@ -55,6 +52,7 @@ describe('writeOnboardConfig()', () => {
       fastModel: 'fast-model',
       optionalTools: ['rtk'],
       cavemanGuidance: true,
+      cwd: tmpDir,
     })
 
     expect(fse.ensureDir).toHaveBeenCalled()
@@ -70,7 +68,7 @@ describe('writeOnboardConfig()', () => {
   it('detects opencode version from CLI', async () => {
     execa.mockResolvedValue({ exitCode: 0, stdout: '2.0.0', stderr: '' })
 
-    await writeOnboardConfig({ platform: 'github', sourceMode: 'current', sourceRoots: [] })
+    await writeOnboardConfig({ platform: 'github', sourceMode: 'current', sourceRoots: [], cwd: tmpDir })
 
     const call = fse.writeJson.mock.calls[0]
     const payload = call[1]
@@ -80,7 +78,7 @@ describe('writeOnboardConfig()', () => {
   it('handles missing opencode gracefully', async () => {
     execa.mockResolvedValue({ exitCode: 1, stdout: '', stderr: '' })
 
-    await writeOnboardConfig({ platform: 'github', sourceMode: 'current', sourceRoots: [] })
+    await writeOnboardConfig({ platform: 'github', sourceMode: 'current', sourceRoots: [], cwd: tmpDir })
 
     const call = fse.writeJson.mock.calls[0]
     const payload = call[1]
@@ -90,10 +88,20 @@ describe('writeOnboardConfig()', () => {
   it('includes note field', async () => {
     execa.mockResolvedValue({ exitCode: 0, stdout: '1', stderr: '' })
 
-    await writeOnboardConfig({ platform: 'github', sourceMode: 'current', sourceRoots: [] })
+    await writeOnboardConfig({ platform: 'github', sourceMode: 'current', sourceRoots: [], cwd: tmpDir })
 
     const call = fse.writeJson.mock.calls[0]
     const payload = call[1]
     expect(payload.note).toContain('Informational file only')
   })
-})
+
+  it('persists none as an explicit platform mode', async () => {
+    execa.mockResolvedValue({ exitCode: 0, stdout: '1', stderr: '' })
+
+    await writeOnboardConfig({ platform: 'none', sourceMode: 'current', sourceRoots: [], cwd: tmpDir })
+
+    const call = fse.writeJson.mock.calls[0]
+    const payload = call[1]
+    expect(payload.wizard.platform).toBe('none')
+  })
+})

package/src/steps/models/write.js

@@ -11,8 +11,21 @@ export async function writeModelToAgent(agentFile, modelId) {
   await fse.writeFile(agentFile, updated, 'utf-8');
 }
 
-export async function writeModelsToConfigs({ planModel, buildModel, fastModel, agentsDir, preset }) {
-  for (const name of preset.roles.build.agents) {
+async function listBuildAgentNames(agentsDir, preset) {
+  const fastAgents = new Set(preset.roles.fast.agents)
+  const configuredBuildAgents = preset.roles.build.agents
+  const discovered = await fse.pathExists(agentsDir)
+    ? (await fse.readdir(agentsDir))
+      .filter(name => name.endsWith('.md'))
+      .map(name => path.basename(name, '.md'))
+      .filter(name => !fastAgents.has(name))
+    : []
+
+  return [...new Set([...configuredBuildAgents, ...discovered])]
+}
+
+export async function writeModelsToConfigs({ planModel, buildModel, fastModel, agentsDir, preset, cwd = process.cwd() }) {
+  for (const name of await listBuildAgentNames(agentsDir, preset)) {
     const file = path.join(agentsDir, `${name}.md`);
     if (await fse.pathExists(file)) {
       await writeModelToAgent(file, buildModel);
@@ -28,7 +41,7 @@ export async function writeModelsToConfigs({ planModel, buildModel, fastModel, a
     }
   }
 
-  const opencodeJsonPath = path.join(process.cwd(), '.opencode', 'opencode.json');
+  const opencodeJsonPath = path.join(cwd, '.opencode', 'opencode.json');
   if (await fse.pathExists(opencodeJsonPath)) {
     const config = await fse.readJson(opencodeJsonPath);
     config.model = buildModel;
@@ -36,7 +49,7 @@ export async function writeModelsToConfigs({ planModel, buildModel, fastModel, a
     success(`default model -> ${buildModel} (written to .opencode/opencode.json)`);
   }
 
-  const ensembleJsonPath = path.join(process.cwd(), '.opencode', 'ensemble.json');
+  const ensembleJsonPath = path.join(cwd, '.opencode', 'ensemble.json');
   if (await fse.pathExists(ensembleJsonPath)) {
     const ensemble = await fse.readJson(ensembleJsonPath);
     delete ensemble.defaultModel;