Skip to content

foryourhealth111-pixel/Vibe-Skills

Vibe Code Orchestrator (VCO) is a governed runtime entry that freezes requirements, bounds execution, and enforces verification and phase cleanup.

FileKindSize
SKILL.mdskill md17.2 KB
agents/templates/debugger.mdmarkdown323 B
agents/templates/planner.mdmarkdown313 B
agents/templates/reviewer.mdmarkdown331 B
agents/templates/security-reviewer.mdmarkdown341 B
references/change-proof-matrix.mdmarkdown2.6 KB
references/contributor-zone-decision-table.mdmarkdown2.2 KB
references/developer-entry-contract.mdmarkdown2.7 KB
references/fixtures/external-corpus/external-corpus-gate.jsonconfig8.6 KB
references/fixtures/external-corpus/prompt-signals.jsonconfig412.4 KB
references/fixtures/external-corpus/skill-keyword-index.backup.jsonconfig30.6 KB
references/fixtures/external-corpus/skill-keyword-index.candidate.jsonconfig26.5 KB
references/fixtures/external-corpus/vco-suggestions.jsonconfig16.6 KB
references/fixtures/migration-map.jsonconfig7.8 KB
references/fixtures/retro-compare/safety-gate/baseline-cer.jsonconfig294 B
references/fixtures/retro-compare/safety-gate/current-cer.jsonconfig1.1 KB
references/fixtures/retro-compare/safety-gate/delta.jsonconfig1.0 KB
references/fixtures/retro-compare/sample-run/baseline-cer.jsonconfig324 B
references/fixtures/retro-compare/sample-run/current-cer.jsonconfig1.2 KB
references/fixtures/retro-compare/sample-run/delta.jsonconfig1.0 KB
references/fixtures/retro-compare/smoke/baseline-smoke.jsonconfig266 B
references/fixtures/retro-compare/smoke/current-smoke.jsonconfig1.0 KB
references/fixtures/retro-compare/smoke/delta-smoke.jsonconfig1.0 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/cleanup-receipt.jsonconfig1.3 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/governance-capsule.jsonconfig408 B
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/intent-contract.jsonconfig2.2 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/phase-plan-execute.jsonconfig2.4 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/skeleton-receipt.jsonconfig722 B
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/stage-lineage.jsonconfig1.3 KB
references/fixtures/skills-audit/bio-science-problem/bio-science-problem-map.csvother9.2 KB
references/fixtures/skills-audit/bio-science-problem/bio-science-problem-map.jsonconfig18.1 KB
references/fixtures/verify/routing-stability/vibe-routing-stability-gate.jsonconfig24.4 KB
references/index.mdmarkdown1.3 KB
references/proof-bundles/claude-code-managed-closure-candidate/linux-managed-run-01-local-host/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig262 B
references/proof-bundles/claude-code-managed-closure-candidate/manifest.jsonconfig2.6 KB
references/proof-bundles/linux-full-authoritative-candidate/linux-pwsh-run-01-wsl/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig298 B
references/proof-bundles/linux-full-authoritative-candidate/linux-pwsh-run-02-docker/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig298 B
references/proof-bundles/linux-full-authoritative-candidate/manifest.jsonconfig3.3 KB
references/proof-bundles/openclaw-runtime-core-preview-candidate/manifest.jsonconfig1.9 KB
references/release-ledger.jsonlother5.1 KB
scripts/README.mdmarkdown1.7 KB
scripts/bootstrap/one-shot-setup.ps1script797 B
scripts/bootstrap/one-shot-setup.shscript482 B
scripts/bootstrap/scaffold-claude-preview.ps1script875 B
scripts/bootstrap/scaffold-claude-preview.shexecutablescript866 B
scripts/bootstrap/sync-local-compat.ps1script2.6 KB
scripts/common/AntiProxyGoalDrift.ps1script15.1 KB
scripts/common/NodeLaunchWrapper.ps1script13.1 KB
scripts/common/ProcessLedger.ps1script27.1 KB
scripts/common/ProtectedDocumentCleanup.ps1script6.9 KB
scripts/common/README.mdmarkdown1.9 KB
scripts/common/Resolve-VgoAdapter.ps1script4.3 KB
scripts/common/adapter_registry_query.pyexecutablescript3.8 KB
scripts/common/python_helpers.shscript2.8 KB
scripts/common/resolve_vgo_adapter.pyexecutablescript2.4 KB
scripts/common/runtime_contracts.pyscript3.7 KB
scripts/common/vibe-governance-helpers.ps1script75.6 KB
scripts/common/vibe-wave-gate-runner.ps1script28.3 KB
scripts/governance/Invoke-NodeProcessAudit.ps1script3.6 KB
scripts/governance/Invoke-NodeZombieCleanup.ps1script3.7 KB
scripts/governance/README.mdmarkdown5.1 KB
scripts/governance/audit-upstream.ps1script22.7 KB
scripts/governance/export-repo-cleanliness-inventory.ps1script8.6 KB
scripts/governance/install-local-worktree-excludes.ps1script2.0 KB
scripts/governance/invoke-mem0-policy.ps1script1.0 KB
scripts/governance/invoke-openspec-governance.ps1script8.6 KB
scripts/governance/new-origin-record.ps1script3.3 KB
scripts/governance/phase-end-cleanup.ps1script10.7 KB
scripts/governance/publish-absorption-soft-rollout.ps1script3.2 KB
scripts/governance/publish-openspec-soft-rollout.ps1script9.3 KB
scripts/governance/release-cut.ps1script25.1 KB
scripts/governance/set-gsd-overlay-rollout.ps1script3.9 KB
scripts/governance/set-openspec-rollout.ps1script3.1 KB
scripts/governance/sync-bundled-vibe.ps1script20.3 KB
scripts/install/Install-VgoAdapter.ps1script2.0 KB
scripts/install/install_vgo_adapter.pyexecutablescript524 B
scripts/overlay/README.mdmarkdown885 B
scripts/overlay/suggest-browserops-provider.ps1script9.3 KB
scripts/overlay/suggest-overlays.ps1script17.3 KB
scripts/release/build_release_bundle.pyscript6.5 KB
scripts/research/README.mdmarkdown1.1 KB
scripts/research/build-eval-slicing-catalog.ps1script2.6 KB
scripts/research/build-watch-portfolio-review.ps1script3.5 KB
scripts/research/build-xl-operator-checklist.ps1script2.3 KB
scripts/research/extract-prompt-signals.ps1script6.7 KB
scripts/research/generate-vco-suggestions.ps1script9.7 KB
scripts/research/sync-mcp-catalog.ps1script3.5 KB
scripts/research/vibe-adaptive-train.ps1script10.1 KB
scripts/router/README.mdmarkdown1.8 KB
scripts/router/invoke-pack-route.pyscript428 B
scripts/router/modules/00-core-utils.ps1script14.6 KB
scripts/router/modules/01-openai-responses.ps1script17.9 KB
scripts/router/modules/10-observability.ps1script11.7 KB
scripts/router/modules/11-route-probe.ps1script20.7 KB
scripts/router/modules/12-heartbeat.ps1script19.9 KB
scripts/router/modules/19-custom-admission.ps1script16.3 KB
scripts/router/modules/20-routing-rules.ps1script1.7 KB
scripts/router/modules/21-capability-interview.ps1script11.8 KB
scripts/router/modules/22-intent-contract.ps1script18.2 KB
scripts/router/modules/30-openspec.ps1script8.3 KB
scripts/router/modules/31-gsd-overlay.ps1script5.5 KB
scripts/router/modules/32-prompt-overlay.ps1script8.0 KB
scripts/router/modules/33-memory-governance.ps1script5.5 KB
scripts/router/modules/34-data-scale-overlay.ps1script25.8 KB
scripts/router/modules/35-quality-debt-overlay.ps1script13.4 KB
scripts/router/modules/36-framework-interop-overlay.ps1script16.9 KB
scripts/router/modules/37-ml-lifecycle-overlay.ps1script22.4 KB
scripts/router/modules/38-python-clean-code-overlay.ps1script16.2 KB
scripts/router/modules/39-system-design-overlay.ps1script15.5 KB
scripts/router/modules/40-cuda-kernel-overlay.ps1script17.7 KB
scripts/router/modules/42-ai-rerank-overlay.ps1script14.0 KB
scripts/router/modules/43-retrieval-overlay.ps1script22.4 KB
scripts/router/modules/44-dialectic-team-gate.ps1script7.5 KB
scripts/router/modules/44-exploration-overlay.ps1script17.7 KB
scripts/router/modules/45-daily-dialectic-guard.ps1script6.6 KB
scripts/router/modules/47-closure-overlay.ps1script9.2 KB
scripts/router/modules/48-llm-acceleration-overlay.ps1script104.6 KB
scripts/router/modules/49-prompt-asset-boost.ps1script28.3 KB
scripts/router/resolve-pack-route.ps1script4.1 KB
scripts/router/runtime_neutral/custom_admission.pyscript349 B
scripts/router/runtime_neutral/router_contract.pyscript356 B
scripts/ruc-nlpir/preflight.ps1script5.3 KB
scripts/runtime/Freeze-RuntimeInputPacket.ps1script33.0 KB
scripts/runtime/Invoke-AntiProxyGoalDriftCompaction.ps1script551 B
scripts/runtime/Invoke-DeepInterview.ps1script1.1 KB
scripts/runtime/Invoke-PhaseCleanup.ps1script11.1 KB
scripts/runtime/Invoke-PlanExecute.ps1script13.7 KB
scripts/runtime/Invoke-SkeletonCheck.ps1script3.1 KB
scripts/runtime/Invoke-VibeCanonicalEntry.ps1script12.9 KB
scripts/runtime/VibeMemoryActivation.Common.ps1script41.3 KB
scripts/runtime/VibeMemoryBackends.Common.ps1script12.4 KB
scripts/runtime/VibeRuntime.Common.ps1script298.6 KB
scripts/runtime/VibeSkillRouting.Common.ps1script19.0 KB
scripts/runtime/VibeWorkspaceMemory.Common.ps1script6.9 KB
scripts/runtime/Write-RequirementDoc.ps1script23.7 KB
scripts/runtime/Write-XlPlan.ps1script32.3 KB
scripts/runtime/invoke-vibe-runtime.ps1script69.7 KB
scripts/runtime/memory_backend_driver.pyscript14.2 KB
scripts/runtime/skill_authority_driver.pyscript375 B
scripts/runtime/workspace_memory_driver.pyscript24.8 KB
scripts/setup/check-kvm-host-readiness.shscript3.4 KB
scripts/setup/check-windows-eval-iso-readiness.shexecutablescript2.2 KB
scripts/setup/check-windows-proof-vm-state.shexecutablescript2.0 KB
scripts/setup/export-codex-settings-sanitized.ps1script2.6 KB
scripts/setup/fetch-windows11-eval-iso.shexecutablescript4.1 KB
scripts/setup/install-local-vm-host.shexecutablescript1.6 KB
scripts/setup/persist-codex-openai-env.ps1script2.4 KB
scripts/setup/run-windows-proof-vm.shexecutablescript11.4 KB
scripts/setup/send-qmp-boot-keys.pyexecutablescript3.0 KB
scripts/setup/send-qmp-text.pyexecutablescript3.0 KB
scripts/setup/show-windows-proof-media-options.shexecutablescript1.6 KB
scripts/setup/stop-windows-proof-vm.shexecutablescript1.6 KB
scripts/setup/sync-codex-settings-to-user-env.ps1script2.6 KB
scripts/uninstall/Uninstall-VgoAdapter.ps1script1.4 KB
scripts/uninstall/uninstall_vgo_adapter.pyscript526 B
scripts/verify/README.mdmarkdown3.8 KB
scripts/verify/cer-compare.ps1script8.5 KB
scripts/verify/fixtures/README.mdmarkdown1.1 KB
scripts/verify/fixtures/document-cleanup-safety/README.mdmarkdown527 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/.tmp/docs/重庆市永川区技术预见与制度创新项目申报书1-修订版.docxbinary56 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/.tmp/docs/重庆市永川区技术预见与制度创新项目申报书1-补充材料.pdfbinary56 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/docs/重庆市永川区技术预见与制度创新项目申报书1-正式版.docxbinary36 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/.tmp/staging/budget-review.xlsxbinary59 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/.tmp/staging/quarterly-review-deck.pptxbinary60 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/docs/reference-manual.pdfbinary21 B
scripts/verify/fixtures/document-cleanup-safety/non-protected-control/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/non-protected-control/source/.tmp/control.txtmarkdown54 B
scripts/verify/fixtures/llm-acceleration.mock.jsonconfig1.0 KB
scripts/verify/fixtures/pilot-browserops.jsonconfig541 B
scripts/verify/fixtures/pilot-deep-extraction.jsonconfig731 B
scripts/verify/fixtures/pilot-desktopops.jsonconfig587 B
scripts/verify/fixtures/pilot-memory.jsonconfig575 B
scripts/verify/fixtures/pilot-prompt.jsonconfig525 B
scripts/verify/fixtures/process-health/external-node-protected-fixture.jsonconfig345 B
scripts/verify/fixtures/process-health/healthy-managed-fixture.jsonconfig1.1 KB
scripts/verify/fixtures/process-health/managed-completed-alive-fixture.jsonconfig1.2 KB
scripts/verify/fixtures/process-health/managed-stale-fixture.jsonconfig1.1 KB
scripts/verify/fixtures/process-health/no-node-processes-fixture.jsonconfig131 B
scripts/verify/fixtures/prompt-asset-boost.mock.jsonconfig1.2 KB
scripts/verify/gate-family-index.mdmarkdown2.5 KB
scripts/verify/lib/VibeOfflineSkillsAudit.Suites.ps1script11.8 KB
scripts/verify/lib/VibeOfflineSkillsAudit.ps1script12.2 KB
scripts/verify/lib/VibeRouteAudit.Suites.ps1script7.9 KB
scripts/verify/lib/VibeRouteAudit.ps1script5.2 KB
scripts/verify/live-document-gate.pyscript7.6 KB
scripts/verify/probe-scientific-packs.ps1script55.1 KB
scripts/verify/publish-proof.pyscript409 B
scripts/verify/runtime_neutral/README.mdmarkdown2.5 KB
scripts/verify/runtime_neutral/_bootstrap.pyscript321 B
scripts/verify/runtime_neutral/bio_science_pack_consolidation_audit.pyscript421 B
scripts/verify/runtime_neutral/bootstrap_doctor.pyscript494 B
scripts/verify/runtime_neutral/code_quality_pack_consolidation_audit.pyscript717 B
scripts/verify/runtime_neutral/coherence_gate.pyscript529 B
scripts/verify/runtime_neutral/freshness_gate.pyscript494 B
scripts/verify/runtime_neutral/global_pack_consolidation_audit.pyscript635 B
scripts/verify/runtime_neutral/ml_skills_pruning_audit.pyscript574 B
scripts/verify/runtime_neutral/opencode_preview_smoke.pyscript674 B
scripts/verify/runtime_neutral/release_notes_quality.pyscript701 B

scripts/overlay/suggest-overlays.ps1

View on GitHub
param(
  [Parameter(Mandatory = $true)]
  [ValidateSet('agency', 'gitnexus', 'turix-cua', 'ruc-nlpir', 'vco')]
  [string]$Catalog,

  [Parameter(Mandatory = $true)]
  [string]$Task,

  [ValidateSet('think', 'do', 'review', 'team', 'retro', 'any')]
  [string]$Stage = 'any',

  [int]$TopK = 0,

  [string]$Select = '',

  [switch]$AsJson
)

$ErrorActionPreference = 'Stop'
$script:SelfPath = $PSCommandPath

function Get-VcoRoot {
  return (Resolve-Path (Join-Path $PSScriptRoot '..\..') | Select-Object -ExpandProperty Path)
}

function Normalize-Text([string]$Text) {
  if ($null -eq $Text) { return '' }
  return $Text.ToLowerInvariant()
}

function Test-KeywordHit([string]$NormalizedText, [string]$Keyword) {
  if ([string]::IsNullOrWhiteSpace($Keyword)) { return $false }

  $kw = Normalize-Text $Keyword
  $isShortToken = $kw -match '^[a-z0-9]{1,3}$'
  if (-not $isShortToken) {
    return $NormalizedText.Contains($kw)
  }

  $pattern = "(?<![a-z0-9])$([regex]::Escape($kw))(?![a-z0-9])"
  return [regex]::IsMatch($NormalizedText, $pattern)
}

function Read-JsonFile([string]$Path) {
  if (-not (Test-Path -LiteralPath $Path)) {
    throw "JSON file not found: $Path"
  }
  return (Get-Content -LiteralPath $Path -Raw -Encoding UTF8 | ConvertFrom-Json)
}

function Resolve-RepoChildPath([string]$VcoRoot, [string]$RelativePath, [string]$AllowedSubtree) {
  if ([string]::IsNullOrWhiteSpace($RelativePath)) {
    throw "Path is required."
  }

  $repoRoot = [System.IO.Path]::GetFullPath($VcoRoot)
  $allowedRoot = [System.IO.Path]::GetFullPath((Join-Path $repoRoot $AllowedSubtree))
  $resolvedPath = [System.IO.Path]::GetFullPath((Join-Path $repoRoot $RelativePath))
  $allowedPrefix = $allowedRoot.TrimEnd('\', '/') + [System.IO.Path]::DirectorySeparatorChar

  $isAllowed = $resolvedPath.Equals($allowedRoot, [System.StringComparison]::OrdinalIgnoreCase) -or
    $resolvedPath.StartsWith($allowedPrefix, [System.StringComparison]::OrdinalIgnoreCase)

  if (-not $isAllowed) {
    throw "Path escapes allowed subtree '$AllowedSubtree': $RelativePath"
  }

  if (-not (Test-Path -LiteralPath $resolvedPath)) {
    throw "Path not found: $RelativePath"
  }

  return (Resolve-Path -LiteralPath $resolvedPath | Select-Object -ExpandProperty Path)
}

function Resolve-OverlayPath([string]$VcoRoot, [string]$OverlayPath) {
  return (Resolve-RepoChildPath -VcoRoot $VcoRoot -RelativePath $OverlayPath -AllowedSubtree 'references/overlays')
}

function Format-MatchSummary([string[]]$Hits) {
  if ($null -eq $Hits -or $Hits.Count -eq 0) { return 'hits: (none)' }
  $top = $Hits | Select-Object -First 6
  if ($Hits.Count -le 6) { return ('hits: ' + ($top -join ', ')) }
  return ('hits: ' + ($top -join ', ') + " ... +$($Hits.Count - $top.Count)")
}

function Find-OverlayByNumber([object[]]$RecommendedRows, [int]$Number) {
  if ($Number -lt 1 -or $Number -gt $RecommendedRows.Count) { return $null }
  return $RecommendedRows[$Number - 1]
}

function Render-OverlayInjection([string]$VcoRootPath, [object[]]$SelectedOverlays) {
  $parts = New-Object System.Collections.Generic.List[string]
  $parts.Add('--- BEGIN VCO PROMPT OVERLAY (advice-only) ---')

  foreach ($sel in $SelectedOverlays) {
    $overlayFile = Resolve-OverlayPath -VcoRoot $VcoRootPath -OverlayPath ([string]$sel.overlay_path)
    $body = Get-Content -LiteralPath $overlayFile -Raw -Encoding UTF8

    $parts.Add('')
    if ($sel.PSObject.Properties.Name -contains 'provider_id') {
      $parts.Add(("# Overlay: [{0}] {1}" -f [string]$sel.provider_id, [string]$sel.name))
    } else {
      $parts.Add(("# Overlay: {0}" -f [string]$sel.name))
    }
    $parts.Add($body.Trim())
  }

  $parts.Add('')
  $parts.Add('--- END VCO PROMPT OVERLAY ---')
  return ($parts -join "`n")
}

function Build-FamilyCatalogResult {
  param(
    [string]$CatalogId,
    [string]$VcoRoot,
    [object]$Config,
    [string]$TaskText,
    [string]$StageName,
    [int]$RequestedTopK,
    [string]$SelectText
  )

  $maxSelect = 1
  if ($null -ne $Config.max_select -and [int]$Config.max_select -gt 0) {
    $maxSelect = [int]$Config.max_select
  }

  $resolvedTopK = $RequestedTopK
  if ($resolvedTopK -le 0) {
    $resolvedTopK = [int]$Config.top_k
  }
  if ($resolvedTopK -le 0) { $resolvedTopK = 3 }

  $normalizedText = Normalize-Text $TaskText
  $overlayRows = @()

  foreach ($overlay in $Config.overlays) {
    $hits = @()
    foreach ($kw in $overlay.keywords) {
      if (Test-KeywordHit -NormalizedText $normalizedText -Keyword ([string]$kw)) {
        $hits += [string]$kw
      }
    }

    $score = [double]$hits.Count
    if ($StageName -ne 'any' -and $null -ne $overlay.preferred_stages) {
      $preferred = @($overlay.preferred_stages | ForEach-Object { Normalize-Text ([string]$_) })
      if ($preferred -contains (Normalize-Text $StageName)) {
        $score += 0.25
      }
    }

    $department = $null
    if ($overlay.PSObject.Properties.Name -contains 'department') {
      $department = [string]$overlay.department
    }

    $overlayRows += [pscustomobject]@{
      Id = [string]$overlay.id
      Name = [string]$overlay.name
      Department = $department
      Description = [string]$overlay.description
      OverlayPath = [string]$overlay.overlay_path
      PreferredStages = @($overlay.preferred_stages)
      Score = $score
      Hits = $hits
    }
  }

  $hasSignal = ($overlayRows | Where-Object { @($_.Hits).Count -gt 0 } | Measure-Object).Count -gt 0
  if (-not $hasSignal) {
    $fallbackIds = @()
    if ($null -ne $Config.stage_fallbacks) {
      $fallbackIds = @($Config.stage_fallbacks.$StageName)
      if ($fallbackIds.Count -eq 0) { $fallbackIds = @($Config.stage_fallbacks.any) }
    }

    $fallbackSet = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
    foreach ($id in $fallbackIds) { [void]$fallbackSet.Add([string]$id) }

    $overlayRows = $overlayRows | Sort-Object -Property `
      @{ Expression = { $fallbackSet.Contains($_.Id) }; Descending = $true }, `
      @{ Expression = { $_.Score }; Descending = $true }, `
      @{ Expression = { $_.Name }; Descending = $false }
  } else {
    $overlayRows = $overlayRows | Sort-Object -Property `
      @{ Expression = { $_.Score }; Descending = $true }, `
      @{ Expression = { $_.Name }; Descending = $false }
  }

  $recommended = @($overlayRows | Select-Object -First $resolvedTopK)

  $menuLines = New-Object System.Collections.Generic.List[string]
  $menuLines.Add("Results: catalog=$CatalogId recommend $($recommended.Count) overlay(s) (advice-only), stage=$StageName.")
  $menuLines.Add("Options (select up to $maxSelect):")

  for ($i = 0; $i -lt $recommended.Count; $i++) {
    $row = $recommended[$i]
    $scoreText = "score=$([math]::Round($row.Score, 2))"
    $hitText = Format-MatchSummary $row.Hits
    $menuLines.Add(("{0}. {1} - {2} ({3}; {4})" -f ($i + 1), $row.Name, $row.Description, $scoreText, $hitText))
  }

  $menuLines.Add('')
  $menuLines.Add('Usage:')
  $menuLines.Add(("- Suggestions only: powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`" -Catalog {1} -Task `"<text>`" -Stage {2}" -f $script:SelfPath, $CatalogId, $StageName))
  $menuLines.Add(("- Render injection:  powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`" -Catalog {1} -Task `"<text>`" -Stage {2} -Select `"1`"" -f $script:SelfPath, $CatalogId, $StageName))

  $confirmUi = @{
    rendered_text = ($menuLines -join "`n")
    max_select = $maxSelect
    top_k = $resolvedTopK
  }

  $selectedOverlayObjs = @()
  if (-not [string]::IsNullOrWhiteSpace($SelectText)) {
    $tokens = $SelectText -split '[,\s]+' | Where-Object { -not [string]::IsNullOrWhiteSpace($_) }
    $selectedIds = [System.Collections.Generic.List[string]]::new()

    foreach ($t in $tokens) {
      $token = $t.Trim()
      if ($token -match '^\d+$') {
        $row = Find-OverlayByNumber -RecommendedRows $recommended -Number ([int]$token)
        if ($null -eq $row) { throw "Invalid selection number: $token" }
        $selectedIds.Add([string]$row.Id)
        continue
      }

      $match = @($Config.overlays | Where-Object { [string]$_.id -ieq $token } | Select-Object -First 1)
      if ($match.Count -eq 0) { throw "Unknown overlay id: $token" }
      $selectedIds.Add([string]$match[0].id)
    }

    $dedup = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
    foreach ($id in $selectedIds) { [void]$dedup.Add([string]$id) }
    $finalIds = @($dedup)
    if ($finalIds.Count -gt $maxSelect) {
      throw "Too many overlays selected ($($finalIds.Count)); max_select=$maxSelect"
    }

    foreach ($id in $finalIds) {
      $obj = @($Config.overlays | Where-Object { [string]$_.id -ieq $id } | Select-Object -First 1)[0]
      if ($null -eq $obj) { throw "Overlay config not found: $id" }
      $selectedOverlayObjs += $obj
    }
  }

  $result = @{
    version = 1
    catalog = $CatalogId
    task = $TaskText
    stage = $StageName
    top_k = $resolvedTopK
    recommendations = @(
      $recommended | ForEach-Object {
        $payload = @{
          id = $_.Id
          name = $_.Name
          description = $_.Description
          score = [math]::Round($_.Score, 2)
          hits = $_.Hits
          overlay_path = $_.OverlayPath
        }
        if (-not [string]::IsNullOrWhiteSpace($_.Department)) {
          $payload.department = $_.Department
        }
        $payload
      }
    )
    confirm_ui = $confirmUi
  }

  if ($selectedOverlayObjs.Count -gt 0) {
    $result.selected = @($selectedOverlayObjs | ForEach-Object { @{ id = $_.id; name = $_.name; overlay_path = $_.overlay_path } })
    $result.overlay_injection = Render-OverlayInjection -VcoRootPath $VcoRoot -SelectedOverlays $selectedOverlayObjs
  }

  return $result
}

function Build-VcoCatalogResult {
  param(
    [string]$VcoRoot,
    [object]$CatalogConfig,
    [string]$TaskText,
    [string]$StageName,
    [int]$RequestedTopK,
    [string]$SelectText
  )

  $maxSelect = 2
  if ($null -ne $CatalogConfig.max_select -and [int]$CatalogConfig.max_select -gt 0) {
    $maxSelect = [int]$CatalogConfig.max_select
  }

  $resolvedTopK = $RequestedTopK
  if ($resolvedTopK -le 0) {
    $resolvedTopK = [int]$CatalogConfig.top_k
  }
  if ($resolvedTopK -le 0) { $resolvedTopK = 4 }

  $providers = @()
  foreach ($p in $CatalogConfig.providers) {
    $providerConfig = Read-JsonFile (Resolve-RepoChildPath -VcoRoot $VcoRoot -RelativePath ([string]$p.config_path) -AllowedSubtree 'config')
    $priorityBoost = 0.0
    if ($null -ne $p.priority_boost) { $priorityBoost = [double]$p.priority_boost }
    $providers += [pscustomobject]@{
      Id = [string]$p.id
      Name = [string]$p.name
      PriorityBoost = $priorityBoost
      Config = $providerConfig
    }
  }

  $overlayById = [System.Collections.Generic.Dictionary[string, object]]::new([StringComparer]::OrdinalIgnoreCase)
  $overlayRows = @()
  $normalizedText = Normalize-Text $TaskText

  foreach ($provider in $providers) {
    foreach ($overlay in $provider.Config.overlays) {
      $overlayId = [string]$overlay.id
      if ($overlayById.ContainsKey($overlayId)) {
        throw "Duplicate overlay id across providers: $overlayId"
      }

      $hits = @()
      foreach ($kw in $overlay.keywords) {
        if (Test-KeywordHit -NormalizedText $normalizedText -Keyword ([string]$kw)) {
          $hits += [string]$kw
        }
      }

      $score = [double]$hits.Count
      if ($StageName -ne 'any' -and $null -ne $overlay.preferred_stages) {
        $preferred = @($overlay.preferred_stages | ForEach-Object { Normalize-Text ([string]$_) })
        if ($preferred -contains (Normalize-Text $StageName)) {
          $score += 0.25
        }
      }

      $score += [double]$provider.PriorityBoost

      $overlayById[$overlayId] = @{
        provider_id = $provider.Id
        provider_name = $provider.Name
        overlay = $overlay
      }

      $overlayRows += [pscustomobject]@{
        ProviderId = $provider.Id
        ProviderName = $provider.Name
        Id = $overlayId
        Name = [string]$overlay.name
        Description = [string]$overlay.description
        OverlayPath = [string]$overlay.overlay_path
        Score = $score
        HitCount = [int]$hits.Count
        Hits = $hits
      }
    }
  }

  $hasSignal = ($overlayRows | Where-Object { $_.HitCount -gt 0 } | Measure-Object).Count -gt 0
  if (-not $hasSignal) {
    $fallbackIds = @()
    if ($null -ne $CatalogConfig.stage_fallbacks) {
      $fallbackIds = @($CatalogConfig.stage_fallbacks.$StageName)
      if ($fallbackIds.Count -eq 0) { $fallbackIds = @($CatalogConfig.stage_fallbacks.any) }
    }

    $fallbackSet = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
    foreach ($id in $fallbackIds) { [void]$fallbackSet.Add([string]$id) }

    $overlayRows = $overlayRows | Sort-Object -Property `
      @{ Expression = { $fallbackSet.Contains($_.Id) }; Descending = $true }, `
      @{ Expression = { $_.Score }; Descending = $true }, `
      @{ Expression = { $_.Name }; Descending = $false }
  } else {
    $overlayRows = $overlayRows | Sort-Object -Property `
      @{ Expression = { $_.Score }; Descending = $true }, `
      @{ Expression = { $_.Name }; Descending = $false }
  }

  $recommended = @($overlayRows | Select-Object -First $resolvedTopK)
  $menuLines = New-Object System.Collections.Generic.List[string]
  $menuLines.Add("Results: catalog=vco recommend $($recommended.Count) overlay(s) (advice-only), stage=$StageName.")
  $menuLines.Add("Options (select up to $maxSelect):")

  for ($i = 0; $i -lt $recommended.Count; $i++) {
    $row = $recommended[$i]
    $scoreText = "score=$([math]::Round($row.Score, 2))"
    $hitText = Format-MatchSummary $row.Hits
    $menuLines.Add(("{0}. [{1}] {2} - {3} ({4}; {5})" -f ($i + 1), $row.ProviderId, $row.Name, $row.Description, $scoreText, $hitText))
  }

  $menuLines.Add('')
  $menuLines.Add('Usage:')
  $menuLines.Add(("- Suggestions only: powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`" -Catalog vco -Task `"<text>`" -Stage {1}" -f $script:SelfPath, $StageName))
  $menuLines.Add(("- Render injection:  powershell -NoProfile -ExecutionPolicy Bypass -File `"{0}`" -Catalog vco -Task `"<text>`" -Stage {1} -Select `"1,2`"" -f $script:SelfPath, $StageName))

  $confirmUi = @{
    rendered_text = ($menuLines -join "`n")
    max_select = $maxSelect
    top_k = $resolvedTopK
  }

  $selectedOverlayRows = @()
  if (-not [string]::IsNullOrWhiteSpace($SelectText)) {
    $tokens = $SelectText -split '[,\s]+' | Where-Object { -not [string]::IsNullOrWhiteSpace($_) }
    $selectedIds = [System.Collections.Generic.List[string]]::new()

    foreach ($t in $tokens) {
      $token = $t.Trim()
      if ($token -match '^\d+$') {
        $row = Find-OverlayByNumber -RecommendedRows $recommended -Number ([int]$token)
        if ($null -eq $row) { throw "Invalid selection number: $token" }
        $selectedIds.Add([string]$row.Id)
        continue
      }

      if (-not $overlayById.ContainsKey($token)) { throw "Unknown overlay id: $token" }
      $selectedIds.Add([string]$token)
    }

    $dedup = [System.Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
    foreach ($id in $selectedIds) { [void]$dedup.Add([string]$id) }
    $finalIds = @($dedup)
    if ($finalIds.Count -gt $maxSelect) {
      throw "Too many overlays selected ($($finalIds.Count)); max_select=$maxSelect"
    }

    foreach ($id in $finalIds) {
      $meta = $overlayById[$id]
      $o = $meta.overlay
      $selectedOverlayRows += [pscustomobject]@{
        id = [string]$o.id
        name = [string]$o.name
        overlay_path = [string]$o.overlay_path
        provider_id = [string]$meta.provider_id
        provider_name = [string]$meta.provider_name
      }
    }
  }

  $result = @{
    version = 1
    catalog = 'vco'
    task = $TaskText
    stage = $StageName
    top_k = $resolvedTopK
    providers = @($providers | ForEach-Object { @{ id = $_.Id; name = $_.Name } })
    recommendations = @(
      $recommended | ForEach-Object {
        @{
          id = $_.Id
          name = $_.Name
          provider_id = $_.ProviderId
          description = $_.Description
          score = [math]::Round($_.Score, 2)
          hits = $_.Hits
          overlay_path = $_.OverlayPath
        }
      }
    )
    confirm_ui = $confirmUi
  }

  if ($selectedOverlayRows.Count -gt 0) {
    $result.selected = @($selectedOverlayRows | ForEach-Object { @{ id = $_.id; name = $_.name; provider_id = $_.provider_id; overlay_path = $_.overlay_path } })
    $result.overlay_injection = Render-OverlayInjection -VcoRootPath $VcoRoot -SelectedOverlays $selectedOverlayRows
  }

  return $result
}

$vcoRoot = Get-VcoRoot
$catalogSpecs = @{
  'agency' = 'config\agency-overlays.json'
  'gitnexus' = 'config\gitnexus-overlays.json'
  'turix-cua' = 'config\turix-cua-overlays.json'
  'ruc-nlpir' = 'config\ruc-nlpir-overlays.json'
  'vco' = 'config\vco-overlays.json'
}

$config = Read-JsonFile (Resolve-RepoChildPath -VcoRoot $vcoRoot -RelativePath $catalogSpecs[$Catalog] -AllowedSubtree 'config')
$result = if ($Catalog -eq 'vco') {
  Build-VcoCatalogResult -VcoRoot $vcoRoot -CatalogConfig $config -TaskText $Task -StageName $Stage -RequestedTopK $TopK -SelectText $Select
} else {
  Build-FamilyCatalogResult -CatalogId $Catalog -VcoRoot $vcoRoot -Config $config -TaskText $Task -StageName $Stage -RequestedTopK $TopK -SelectText $Select
}

if ($AsJson) {
  $result | ConvertTo-Json -Depth 8
  exit 0
}

Write-Output $result.confirm_ui.rendered_text
if ($result.ContainsKey('overlay_injection')) {
  Write-Output ''
  Write-Output $result.overlay_injection
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall