@plainconceptsplatform/agent-harness 2.0.0 → 2.1.0

package/src/presets/models.json

@@ -1,68 +1,68 @@
-{
-  "costTiers": [
-    { "max": 1, "label": "[$]" },
-    { "max": 10, "label": "[$$]" },
-    { "label": "[$$$]" }
-  ],
-  "providers": [
-    { "value": "opencode", "name": "OpenCode Zen" },
-    { "value": "opencode-go", "name": "OpenCode Go" },
-    { "value": "github-copilot", "name": "GitHub Copilot" },
-    { "value": "anthropic", "name": "Anthropic" },
-    { "value": "google",   "name": "Google" },
-    { "value": "openai",   "name": "OpenAI" },
-    { "value": "deepseek", "name": "DeepSeek" },
-    { "value": "",         "name": "Other (show all)" }
-  ],
-  "roles": {
-    "plan": {
-      "prompt": "Plan model:",
-      "info": [
-        "PLAN: main session: reads issues, writes proposals, coordinates the agent team.",
-        "Needs to be strong. A weak model here will silently skip steps and break the workflow."
-      ],
-      "suggestions": {
-        "opencode":        "opencode/claude-sonnet-4",
-        "opencode-go":     null,
-        "github-copilot":  "github-copilot/claude-sonnet-4.5",
-        "anthropic":       "anthropic/claude-sonnet-4-5",
-        "google":          "google/gemini-2.5-pro",
-        "openai":          "openai/o3",
-        "deepseek":        null
-      }
-    },
-    "build": {
-      "prompt": "Build model:",
-      "info": [
-        "BUILD: engineers: implements code, runs tests, commits.",
-        "Code quality matters here. DeepSeek V4 is outstanding value. Claude Sonnet is the gold standard."
-      ],
-      "suggestions": {
-        "opencode":        "opencode/deepseek-v4-flash",
-        "opencode-go":     "opencode-go/deepseek-v4-pro",
-        "github-copilot":  "github-copilot/claude-sonnet-4.5",
-        "anthropic":       "anthropic/claude-sonnet-4-5",
-        "google":          "google/gemini-2.5-flash",
-        "openai":          "openai/gpt-4.1",
-        "deepseek":        "deepseek/deepseek-v4-pro"
-      },
-      "agents": ["fullstack-engineer"]
-    },
-    "fast": {
-      "prompt": "Fast model:",
-      "info": [
-        "FAST: light commands: /pc-pullrequest, /pc-explore, /pc-archive, status checks.",
-        "No heavy reasoning needed. Cheap and fast is the right call here."
-      ],
-      "suggestions": {
-        "opencode":        "opencode/glm-4.7",
-        "opencode-go":     "opencode-go/qwen3.6-plus",
-        "github-copilot":  "github-copilot/gpt-5.4-nano",
-        "anthropic":       "anthropic/claude-haiku-4-5",
-        "google":          "google/gemini-2.0-flash",
-        "openai":          "openai/gpt-4o-mini",
-        "deepseek":        null
-      }
-    }
-  }
-}
+{
+  "costTiers": [
+    { "max": 1, "label": "[$]" },
+    { "max": 10, "label": "[$$]" },
+    { "label": "[$$$]" }
+  ],
+  "providers": [
+    { "value": "opencode", "name": "OpenCode Zen" },
+    { "value": "opencode-go", "name": "OpenCode Go" },
+    { "value": "github-copilot", "name": "GitHub Copilot" },
+    { "value": "anthropic", "name": "Anthropic" },
+    { "value": "google",   "name": "Google" },
+    { "value": "openai",   "name": "OpenAI" },
+    { "value": "deepseek", "name": "DeepSeek" },
+    { "value": "",         "name": "Other (show all)" }
+  ],
+  "roles": {
+    "plan": {
+      "prompt": "Plan model:",
+      "info": [
+        "PLAN: main session: reads issues, writes proposals, coordinates the agent team.",
+        "Needs to be strong. A weak model here will silently skip steps and break the workflow."
+      ],
+      "suggestions": {
+        "opencode":        "opencode/claude-sonnet-4",
+        "opencode-go":     null,
+        "github-copilot":  "github-copilot/claude-sonnet-4.5",
+        "anthropic":       "anthropic/claude-sonnet-4-5",
+        "google":          "google/gemini-2.5-pro",
+        "openai":          "openai/o3",
+        "deepseek":        null
+      }
+    },
+    "build": {
+      "prompt": "Build model:",
+      "info": [
+        "BUILD: engineers: implements code, runs tests, commits.",
+        "Code quality matters here. DeepSeek V4 is outstanding value. Claude Sonnet is the gold standard."
+      ],
+      "suggestions": {
+        "opencode":        "opencode/deepseek-v4-flash",
+        "opencode-go":     "opencode-go/deepseek-v4-pro",
+        "github-copilot":  "github-copilot/claude-sonnet-4.5",
+        "anthropic":       "anthropic/claude-sonnet-4-5",
+        "google":          "google/gemini-2.5-flash",
+        "openai":          "openai/gpt-4.1",
+        "deepseek":        "deepseek/deepseek-v4-pro"
+      },
+      "agents": ["fullstack-engineer"]
+    },
+    "fast": {
+      "prompt": "Fast model:",
+      "info": [
+        "FAST: light commands: /pc-pullrequest, /pc-explore, /pc-archive, status checks.",
+        "No heavy reasoning needed. Cheap and fast is the right call here."
+      ],
+      "suggestions": {
+        "opencode":        "opencode/glm-4.7",
+        "opencode-go":     "opencode-go/qwen3.6-plus",
+        "github-copilot":  "github-copilot/gpt-5.4-nano",
+        "anthropic":       "anthropic/claude-haiku-4-5",
+        "google":          "google/gemini-2.0-flash",
+        "openai":          "openai/gpt-4o-mini",
+        "deepseek":        null
+      }
+    }
+  }
+}

package/src/steps/copy/agents.js

@@ -1,118 +1,118 @@
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { info, success, warn } from '../../utils/exec.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const agentsContent = await fse.readJson(path.resolve(__dirname, '../../presets/agents-content.json'))
-
-// Steps are matched by their title text, not by exact heading string:
-// heading level (###/####) and step numbers have drifted before and silently
-// broke removal. Matching `^#{3,4} Step N, <title>` survives both.
-const HISTORY_STEP_TITLE = 'Archive project history'
-const CHAIN_STEP_TITLE = 'Chain make commands'
-
-const CHAIN_CONFIRM_LINE = '- ARCHITECTURE.md generated'
-
-function stepHeadingPattern(title) {
-  const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-  return new RegExp(`^#{2,4} Step \\d+, ${escaped}`)
-}
-
-// The step heading is kept and its body replaced with an explicit skip note.
-// Removing the block and renumbering the remaining steps (the old approach)
-// went stale against prose cross-references like "Skip steps 2, 3, and 4";
-// stable numbering plus a visible reason is unambiguous for the agent.
-export function skipStepBlock(content, title, note) {
-  const lines = content.split('\n')
-  const pattern = stepHeadingPattern(title)
-  const start = lines.findIndex(l => pattern.test(l.trim()))
-  if (start === -1) return { content, matched: false }
-
-  let end = lines.length
-  for (let i = start + 1; i < lines.length; i++) {
-    if (lines[i].trim() === '---') { end = i; break }
-  }
-
-  lines.splice(start + 1, end - start - 1, '', `> ${note}`, '')
-  return { content: lines.join('\n'), matched: true }
-}
-
-function removeConfirmLine(content, line) {
-  return content.split('\n').filter(l => l.trim() !== line.trim()).join('\n')
-}
-
-const PLATFORM_WORKFLOW_START = '<!-- PC-PLATFORM-WORKFLOW-START -->'
-const PLATFORM_WORKFLOW_END = '<!-- PC-PLATFORM-WORKFLOW-END -->'
-const PLATFORM_SKILLS_GUIDE_START = '<!-- PC-PLATFORM-SKILLS-GUIDE-START -->'
-const PLATFORM_SKILLS_GUIDE_END = '<!-- PC-PLATFORM-SKILLS-GUIDE-END -->'
-
-function platformContent(platform, key) {
-  const p = agentsContent.platform[platform] ?? agentsContent.platform.github
-  return p[key] ?? ''
-}
-
-function mixedPlatformContent(backlogPlatform, repoPlatform, key) {
-  if (backlogPlatform === repoPlatform) {
-    return platformContent(backlogPlatform, key)
-  }
-  const backlog = agentsContent.platform[backlogPlatform] ?? agentsContent.platform.github
-  const repo = agentsContent.platform[repoPlatform] ?? agentsContent.platform.github
-  const mixed = agentsContent.platform.mixed ?? {}
-  const mixedKey = `${backlogPlatform}-${repoPlatform}`
-  return mixed[mixedKey]?.[key] ?? mixed.default?.[key]?.replace('{backlog}', backlog[key] ?? '').replace('{repo}', repo[key] ?? '') ?? platformContent(repoPlatform, key)
-}
-
-function replaceBetween(content, start, end, replacement) {
-  if (!content.includes(start) || !content.includes(end)) return content
-  const pattern = new RegExp(`${start}[\\s\\S]*?${end}`)
-  return content.replace(pattern, `${start}\n${replacement.trim()}\n${end}`)
-}
-
-export async function patchAgentsMd(ctx) {
-  const obInitSkillPath = path.join(process.cwd(), '.agents', 'skills', 'pc-repo-initialize', 'SKILL.md')
-  if (!await fse.pathExists(obInitSkillPath)) return
-
-  let content = await fse.readFile(obInitSkillPath, 'utf-8')
-  const patches = []
-
-  const skips = [
-    [ctx.hasOpenspec, HISTORY_STEP_TITLE, null,
-      'Skipped during onboarding: this project already had an openspec/ history. Do not archive again; continue with the next step.'],
-    [ctx.hasDesign || ctx.hasArchitecture, CHAIN_STEP_TITLE, CHAIN_CONFIRM_LINE,
-      'Skipped during onboarding: project files already exist. Run /make-architecture or /make-design individually to regenerate.'],
-  ]
-
-  for (const [enabled, title, confirmLine, note] of skips) {
-    if (!enabled) continue
-    const result = skipStepBlock(content, title, note)
-    if (!result.matched) {
-      warn(`pc-repo-initialize SKILL.md step "${title}" not found: template drift? Skipping this patch.`)
-      continue
-    }
-    content = result.content
-    if (confirmLine) content = removeConfirmLine(content, confirmLine)
-    patches.push(`Step "${title}" marked as skipped, file already exists`)
-  }
-
-  if (patches.length > 0) {
-    await fse.writeFile(obInitSkillPath, content, 'utf-8')
-    for (const msg of patches) info(msg)
-    success('pc-repo-initialize SKILL.md patched for existing project state')
-  }
-}
-
-export async function patchAgentGuidance(backlogPlatform, repoPlatform, cwd = process.cwd()) {
-  const agentsMdPath = path.join(cwd, 'AGENTS.md')
-  if (await fse.pathExists(agentsMdPath)) {
-    const repo = repoPlatform ?? backlogPlatform ?? 'github'
-    let content = await fse.readFile(agentsMdPath, 'utf-8')
-    content = replaceBetween(content, PLATFORM_WORKFLOW_START, PLATFORM_WORKFLOW_END, mixedPlatformContent(backlogPlatform, repo, 'workflow'))
-    content = replaceBetween(content, PLATFORM_SKILLS_GUIDE_START, PLATFORM_SKILLS_GUIDE_END, mixedPlatformContent(backlogPlatform, repo, 'skillsGuide'))
-    await fse.writeFile(agentsMdPath, `${content.replace(/\s*$/, '')}\n`, 'utf-8')
-    const label = backlogPlatform === repo ? repo : `${backlogPlatform}→${repo}`
-    success(`AGENTS.md patched for platform workflow: ${label}`)
-  }
-}
-
-
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { info, success, warn } from '../../utils/exec.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const agentsContent = await fse.readJson(path.resolve(__dirname, '../../presets/agents-content.json'))
+
+// Steps are matched by their title text, not by exact heading string:
+// heading level (###/####) and step numbers have drifted before and silently
+// broke removal. Matching `^#{3,4} Step N, <title>` survives both.
+const HISTORY_STEP_TITLE = 'Archive project history'
+const CHAIN_STEP_TITLE = 'Chain make commands'
+
+const CHAIN_CONFIRM_LINE = '- ARCHITECTURE.md generated'
+
+function stepHeadingPattern(title) {
+  const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  return new RegExp(`^#{2,4} Step \\d+, ${escaped}`)
+}
+
+// The step heading is kept and its body replaced with an explicit skip note.
+// Removing the block and renumbering the remaining steps (the old approach)
+// went stale against prose cross-references like "Skip steps 2, 3, and 4";
+// stable numbering plus a visible reason is unambiguous for the agent.
+export function skipStepBlock(content, title, note) {
+  const lines = content.split('\n')
+  const pattern = stepHeadingPattern(title)
+  const start = lines.findIndex(l => pattern.test(l.trim()))
+  if (start === -1) return { content, matched: false }
+
+  let end = lines.length
+  for (let i = start + 1; i < lines.length; i++) {
+    if (lines[i].trim() === '---') { end = i; break }
+  }
+
+  lines.splice(start + 1, end - start - 1, '', `> ${note}`, '')
+  return { content: lines.join('\n'), matched: true }
+}
+
+function removeConfirmLine(content, line) {
+  return content.split('\n').filter(l => l.trim() !== line.trim()).join('\n')
+}
+
+const PLATFORM_WORKFLOW_START = '<!-- PC-PLATFORM-WORKFLOW-START -->'
+const PLATFORM_WORKFLOW_END = '<!-- PC-PLATFORM-WORKFLOW-END -->'
+const PLATFORM_SKILLS_GUIDE_START = '<!-- PC-PLATFORM-SKILLS-GUIDE-START -->'
+const PLATFORM_SKILLS_GUIDE_END = '<!-- PC-PLATFORM-SKILLS-GUIDE-END -->'
+
+function platformContent(platform, key) {
+  const p = agentsContent.platform[platform] ?? agentsContent.platform.github
+  return p[key] ?? ''
+}
+
+function mixedPlatformContent(backlogPlatform, repoPlatform, key) {
+  if (backlogPlatform === repoPlatform) {
+    return platformContent(backlogPlatform, key)
+  }
+  const backlog = agentsContent.platform[backlogPlatform] ?? agentsContent.platform.github
+  const repo = agentsContent.platform[repoPlatform] ?? agentsContent.platform.github
+  const mixed = agentsContent.platform.mixed ?? {}
+  const mixedKey = `${backlogPlatform}-${repoPlatform}`
+  return mixed[mixedKey]?.[key] ?? mixed.default?.[key]?.replace('{backlog}', backlog[key] ?? '').replace('{repo}', repo[key] ?? '') ?? platformContent(repoPlatform, key)
+}
+
+function replaceBetween(content, start, end, replacement) {
+  if (!content.includes(start) || !content.includes(end)) return content
+  const pattern = new RegExp(`${start}[\\s\\S]*?${end}`)
+  return content.replace(pattern, `${start}\n${replacement.trim()}\n${end}`)
+}
+
+export async function patchAgentsMd(ctx) {
+  const obInitSkillPath = path.join(process.cwd(), '.agents', 'skills', 'pc-repo-initialize', 'SKILL.md')
+  if (!await fse.pathExists(obInitSkillPath)) return
+
+  let content = await fse.readFile(obInitSkillPath, 'utf-8')
+  const patches = []
+
+  const skips = [
+    [ctx.hasOpenspec, HISTORY_STEP_TITLE, null,
+      'Skipped during onboarding: this project already had an openspec/ history. Do not archive again; continue with the next step.'],
+    [ctx.hasDesign || ctx.hasArchitecture, CHAIN_STEP_TITLE, CHAIN_CONFIRM_LINE,
+      'Skipped during onboarding: project files already exist. Run /make-architecture or /make-design individually to regenerate.'],
+  ]
+
+  for (const [enabled, title, confirmLine, note] of skips) {
+    if (!enabled) continue
+    const result = skipStepBlock(content, title, note)
+    if (!result.matched) {
+      warn(`pc-repo-initialize SKILL.md step "${title}" not found: template drift? Skipping this patch.`)
+      continue
+    }
+    content = result.content
+    if (confirmLine) content = removeConfirmLine(content, confirmLine)
+    patches.push(`Step "${title}" marked as skipped, file already exists`)
+  }
+
+  if (patches.length > 0) {
+    await fse.writeFile(obInitSkillPath, content, 'utf-8')
+    for (const msg of patches) info(msg)
+    success('pc-repo-initialize SKILL.md patched for existing project state')
+  }
+}
+
+export async function patchAgentGuidance(backlogPlatform, repoPlatform, cwd = process.cwd()) {
+  const agentsMdPath = path.join(cwd, 'AGENTS.md')
+  if (await fse.pathExists(agentsMdPath)) {
+    const repo = repoPlatform ?? backlogPlatform ?? 'github'
+    let content = await fse.readFile(agentsMdPath, 'utf-8')
+    content = replaceBetween(content, PLATFORM_WORKFLOW_START, PLATFORM_WORKFLOW_END, mixedPlatformContent(backlogPlatform, repo, 'workflow'))
+    content = replaceBetween(content, PLATFORM_SKILLS_GUIDE_START, PLATFORM_SKILLS_GUIDE_END, mixedPlatformContent(backlogPlatform, repo, 'skillsGuide'))
+    await fse.writeFile(agentsMdPath, `${content.replace(/\s*$/, '')}\n`, 'utf-8')
+    const label = backlogPlatform === repo ? repo : `${backlogPlatform}→${repo}`
+    success(`AGENTS.md patched for platform workflow: ${label}`)
+  }
+}
+
+

package/src/steps/copy/commands.js

@@ -1,91 +1,91 @@
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { success } from '../../utils/exec.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-const _archive = {
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/az.md'), 'utf-8'),
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gh.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gl.md'), 'utf-8'),
-  none: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/none.md'), 'utf-8'),
-}
-
-const _ship = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/az.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gl.md'), 'utf-8'),
-}
-
-const _review = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/az.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gl.md'), 'utf-8'),
-}
-
-const _backlog = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/az.md'), 'utf-8'),
-  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/jira.md'), 'utf-8'),
-}
-
-// Evidence comments target the backlog platform (where the issue/work-item lives).
-const _evidence = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/az.md'), 'utf-8'),
-  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/jira.md'), 'utf-8'),
-}
-
-// relativePath is POSIX-style relative to the project root; commands live in
-// .opencode/commands/, skill-backed procedures (plan-archive, ops-ship) in
-// .agents/skills/<name>/SKILL.md.
-function patchFile(relativePath, startMarker, endMarker, content, platform, cwd = process.cwd()) {
-  const targetPath = path.join(cwd, ...relativePath.split('/'))
-  if (!fse.pathExistsSync(targetPath)) return
-
-  let fileContent = fse.readFileSync(targetPath, 'utf-8')
-  if (!fileContent.includes(startMarker) || !fileContent.includes(endMarker)) return
-
-  const pattern = new RegExp(`${startMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
-  fileContent = fileContent.replace(pattern, `${startMarker}\n${content.trim()}\n${endMarker}`)
-  fse.writeFileSync(targetPath, `${fileContent.replace(/\s*$/, '')}\n`, 'utf-8')
-  success(`${relativePath} content injected for platform: ${platform}`)
-}
-
-export async function patchArchiveCommand(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? platform.backlogPlatform ?? 'github') : platform
-  const replacement = _archive[repoPlatform]
-  if (!replacement) return
-  patchFile('.agents/skills/pc-plan-archive/SKILL.md', '<!-- PC-PLATFORM-ARCHIVE-START -->', '<!-- PC-PLATFORM-ARCHIVE-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsShip(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
-  const replacement = _ship[repoPlatform]
-  if (!replacement) return
-  patchFile('.agents/skills/pc-ops-ship/SKILL.md', '<!-- PC-PLATFORM-SHIP-START -->', '<!-- PC-PLATFORM-SHIP-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsReview(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
-  const replacement = _review[repoPlatform]
-  if (!replacement) return
-  patchFile('.opencode/commands/ops-review.md', '<!-- PC-PLATFORM-REVIEW-START -->', '<!-- PC-PLATFORM-REVIEW-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsBacklog(platform, cwd = process.cwd()) {
-  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
-  const replacement = _backlog[backlogPlatform]
-  if (!replacement) return
-  patchFile('.opencode/commands/ops-backlog.md', '<!-- PC-PLATFORM-BACKLOG-START -->', '<!-- PC-PLATFORM-BACKLOG-END -->', replacement, backlogPlatform, cwd)
-}
-
-export async function patchOpsEvidence(platform, cwd = process.cwd()) {
-  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
-  const replacement = _evidence[backlogPlatform]
-  // browser/none have no CLI to post with: leave the markers empty (the skill skips commenting).
-  if (!replacement) return
-  patchFile('.agents/skills/pc-ops-evidence/SKILL.md', '<!-- PC-PLATFORM-EVIDENCE-START -->', '<!-- PC-PLATFORM-EVIDENCE-END -->', replacement, backlogPlatform, cwd)
-}
-
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { success } from '../../utils/exec.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const _archive = {
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/az.md'), 'utf-8'),
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gh.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gl.md'), 'utf-8'),
+  none: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/none.md'), 'utf-8'),
+}
+
+const _ship = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/az.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gl.md'), 'utf-8'),
+}
+
+const _review = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/az.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gl.md'), 'utf-8'),
+}
+
+const _backlog = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/az.md'), 'utf-8'),
+  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/jira.md'), 'utf-8'),
+}
+
+// Evidence comments target the backlog platform (where the issue/work-item lives).
+const _evidence = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/az.md'), 'utf-8'),
+  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/jira.md'), 'utf-8'),
+}
+
+// relativePath is POSIX-style relative to the project root; commands live in
+// .opencode/commands/, skill-backed procedures (plan-archive, ops-ship) in
+// .agents/skills/<name>/SKILL.md.
+function patchFile(relativePath, startMarker, endMarker, content, platform, cwd = process.cwd()) {
+  const targetPath = path.join(cwd, ...relativePath.split('/'))
+  if (!fse.pathExistsSync(targetPath)) return
+
+  let fileContent = fse.readFileSync(targetPath, 'utf-8')
+  if (!fileContent.includes(startMarker) || !fileContent.includes(endMarker)) return
+
+  const pattern = new RegExp(`${startMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
+  fileContent = fileContent.replace(pattern, `${startMarker}\n${content.trim()}\n${endMarker}`)
+  fse.writeFileSync(targetPath, `${fileContent.replace(/\s*$/, '')}\n`, 'utf-8')
+  success(`${relativePath} content injected for platform: ${platform}`)
+}
+
+export async function patchArchiveCommand(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? platform.backlogPlatform ?? 'github') : platform
+  const replacement = _archive[repoPlatform]
+  if (!replacement) return
+  patchFile('.agents/skills/pc-plan-archive/SKILL.md', '<!-- PC-PLATFORM-ARCHIVE-START -->', '<!-- PC-PLATFORM-ARCHIVE-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsShip(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
+  const replacement = _ship[repoPlatform]
+  if (!replacement) return
+  patchFile('.agents/skills/pc-ops-ship/SKILL.md', '<!-- PC-PLATFORM-SHIP-START -->', '<!-- PC-PLATFORM-SHIP-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsReview(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
+  const replacement = _review[repoPlatform]
+  if (!replacement) return
+  patchFile('.opencode/commands/ops-review.md', '<!-- PC-PLATFORM-REVIEW-START -->', '<!-- PC-PLATFORM-REVIEW-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsBacklog(platform, cwd = process.cwd()) {
+  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
+  const replacement = _backlog[backlogPlatform]
+  if (!replacement) return
+  patchFile('.opencode/commands/ops-backlog.md', '<!-- PC-PLATFORM-BACKLOG-START -->', '<!-- PC-PLATFORM-BACKLOG-END -->', replacement, backlogPlatform, cwd)
+}
+
+export async function patchOpsEvidence(platform, cwd = process.cwd()) {
+  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
+  const replacement = _evidence[backlogPlatform]
+  // browser/none have no CLI to post with: leave the markers empty (the skill skips commenting).
+  if (!replacement) return
+  patchFile('.agents/skills/pc-ops-evidence/SKILL.md', '<!-- PC-PLATFORM-EVIDENCE-START -->', '<!-- PC-PLATFORM-EVIDENCE-END -->', replacement, backlogPlatform, cwd)
+}
+