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/router/modules/49-prompt-asset-boost.ps1

View on GitHub
# Prompt Asset Boost Overlay (GPT‑5.2 assisted)
#
# Purpose:
# - When a prompt-template intent is detected, generate a prompts.chat search plan
#   and a small set of "prompt overlay candidates" that the user can confirm
#   and inject into subsequent tool prompts.
#
# Boundaries:
# - Advice-only (never changes selected pack/skill by default).
# - Explicit vibe only by default (requires `$vibe` or `/vibe` prefix).
# - Designed to cooperate with `prompt_overlay_advice` rather than replace it.

function Get-PromptAssetBoostPolicyDefaults {
    return [pscustomobject]@{
        enabled = $false
        mode = "off" # off|shadow|soft|strict
        activation = [pscustomobject]@{
            explicit_vibe_only = $true
        }
        scope = [pscustomobject]@{
            grade_allow = @("M", "L", "XL")
            task_allow = @("planning", "coding", "review", "debug", "research")
        }
        trigger = [pscustomobject]@{
            require_prompt_signal = $true
            require_explicit_intent = $false
            max_queries = 5
            max_candidates = 3
        }
        provider = [pscustomobject]@{
            type = "openai" # openai|mock
            model = "your-model-id"
            base_url = ""
            mock_response_path = ""
            timeout_ms = 9000
            max_output_tokens = 1200
            temperature = 0.2
            top_p = 1.0
            store = $false
        }
        output = [pscustomobject]@{
            max_prompt_chars_per_candidate = 1200
        }
        safety = [pscustomobject]@{
            fallback_on_error = $true
        }
    }
}

function Get-PromptAssetBoostPolicy {
    param([object]$Policy)

    $defaults = Get-PromptAssetBoostPolicyDefaults
    if (-not $Policy) { return $defaults }

    $enabled = if ($Policy.enabled -ne $null) { [bool]$Policy.enabled } else { [bool]$defaults.enabled }
    $mode = if ($Policy.mode) { [string]$Policy.mode } else { [string]$defaults.mode }
    $activation = if ($Policy.activation) { $Policy.activation } else { $defaults.activation }
    $scope = if ($Policy.scope) { $Policy.scope } else { $defaults.scope }
    $trigger = if ($Policy.trigger) { $Policy.trigger } else { $defaults.trigger }
    $provider = if ($Policy.provider) { $Policy.provider } else { $defaults.provider }
    $output = if ($Policy.output) { $Policy.output } else { $defaults.output }
    $safety = if ($Policy.safety) { $Policy.safety } else { $defaults.safety }

    return [pscustomobject]@{
        enabled = $enabled
        mode = $mode
        activation = [pscustomobject]@{
            explicit_vibe_only = if ($activation.explicit_vibe_only -ne $null) { [bool]$activation.explicit_vibe_only } else { [bool]$defaults.activation.explicit_vibe_only }
        }
        scope = [pscustomobject]@{
            grade_allow = if ($scope.grade_allow) { @($scope.grade_allow) } else { @($defaults.scope.grade_allow) }
            task_allow = if ($scope.task_allow) { @($scope.task_allow) } else { @($defaults.scope.task_allow) }
        }
        trigger = [pscustomobject]@{
            require_prompt_signal = if ($trigger.require_prompt_signal -ne $null) { [bool]$trigger.require_prompt_signal } else { [bool]$defaults.trigger.require_prompt_signal }
            require_explicit_intent = if ($trigger.require_explicit_intent -ne $null) { [bool]$trigger.require_explicit_intent } else { [bool]$defaults.trigger.require_explicit_intent }
            max_queries = if ($trigger.max_queries -ne $null) { [int]$trigger.max_queries } else { [int]$defaults.trigger.max_queries }
            max_candidates = if ($trigger.max_candidates -ne $null) { [int]$trigger.max_candidates } else { [int]$defaults.trigger.max_candidates }
        }
        provider = [pscustomobject]@{
            type = if ($provider.type) { [string]$provider.type } else { [string]$defaults.provider.type }
            model = if ($provider.model) { [string]$provider.model } else { [string]$defaults.provider.model }
            base_url = if ($provider.base_url) { [string]$provider.base_url } else { [string]$defaults.provider.base_url }
            mock_response_path = if ($provider.mock_response_path) { [string]$provider.mock_response_path } else { [string]$defaults.provider.mock_response_path }
            timeout_ms = if ($provider.timeout_ms -ne $null) { [int]$provider.timeout_ms } else { [int]$defaults.provider.timeout_ms }
            max_output_tokens = if ($provider.max_output_tokens -ne $null) { [int]$provider.max_output_tokens } else { [int]$defaults.provider.max_output_tokens }
            temperature = if ($provider.temperature -ne $null) { [double]$provider.temperature } else { [double]$defaults.provider.temperature }
            top_p = if ($provider.top_p -ne $null) { [double]$provider.top_p } else { [double]$defaults.provider.top_p }
            store = if ($provider.store -ne $null) { [bool]$provider.store } else { [bool]$defaults.provider.store }
        }
        output = [pscustomobject]@{
            max_prompt_chars_per_candidate = if ($output.max_prompt_chars_per_candidate -ne $null) { [int]$output.max_prompt_chars_per_candidate } else { [int]$defaults.output.max_prompt_chars_per_candidate }
        }
        safety = [pscustomobject]@{
            fallback_on_error = if ($safety.fallback_on_error -ne $null) { [bool]$safety.fallback_on_error } else { [bool]$defaults.safety.fallback_on_error }
        }
    }
}

function Test-PromptAssetBoostScope {
    param(
        [object]$Policy,
        [object]$PromptNormalization,
        [string]$Grade,
        [string]$TaskType
    )

    $resolved = Get-PromptAssetBoostPolicy -Policy $Policy
    if (-not $resolved.enabled) {
        return [pscustomobject]@{ enabled = $false; mode = "off"; scope_applicable = $false; reasons = @("policy_disabled") }
    }

    $mode = if ($resolved.mode) { [string]$resolved.mode } else { "off" }
    if ($mode -eq "off") {
        return [pscustomobject]@{ enabled = $false; mode = "off"; scope_applicable = $false; reasons = @("mode_off") }
    }

    $reasons = @()

    if ($resolved.activation.explicit_vibe_only) {
        $prefixDetected = [bool]($PromptNormalization -and $PromptNormalization.prefix_detected)
        if (-not $prefixDetected) {
            $reasons += "explicit_vibe_only"
        }
    }

    if ($resolved.scope.grade_allow.Count -gt 0 -and -not ($resolved.scope.grade_allow -contains $Grade)) { $reasons += "grade_not_allowed" }
    if ($resolved.scope.task_allow.Count -gt 0 -and -not ($resolved.scope.task_allow -contains $TaskType)) { $reasons += "task_not_allowed" }

    $scopeApplicable = ($reasons.Count -eq 0)

    return [pscustomobject]@{
        enabled = $true
        mode = $mode
        scope_applicable = $scopeApplicable
        reasons = @($reasons)
    }
}

function Get-PromptAssetBoostJsonSchema {
    param(
        [int]$MaxQueries = 5,
        [int]$MaxCandidates = 3,
        [int]$MaxPromptCharsPerCandidate = 1200
    )

    $qMax = [Math]::Max(1, [Math]::Min(8, [int]$MaxQueries))
    $cMax = [Math]::Max(1, [Math]::Min(3, [int]$MaxCandidates))
    $pMax = [Math]::Max(200, [Math]::Min(2000, [int]$MaxPromptCharsPerCandidate))

    return [ordered]@{
        type = "object"
        additionalProperties = $false
        required = @("search_plan", "overlay_candidates")
        properties = [ordered]@{
            search_plan = [ordered]@{
                type = "object"
                additionalProperties = $false
                required = @("queries")
                properties = [ordered]@{
                    queries = [ordered]@{
                        type = "array"
                        maxItems = $qMax
                        items = [ordered]@{ type = "string"; maxLength = 120 }
                    }
                    category_hints = [ordered]@{
                        type = "array"
                        maxItems = 4
                        items = [ordered]@{ type = "string"; maxLength = 40 }
                    }
                    tag_hints = [ordered]@{
                        type = "array"
                        maxItems = 8
                        items = [ordered]@{ type = "string"; maxLength = 40 }
                    }
                    type_hints = [ordered]@{
                        type = "array"
                        maxItems = 4
                        items = [ordered]@{ type = "string"; enum = @("TEXT", "STRUCTURED", "IMAGE", "VIDEO", "AUDIO") }
                    }
                    limit = [ordered]@{
                        type = "integer"
                        minimum = 1
                        maximum = 50
                    }
                }
            }
            overlay_candidates = [ordered]@{
                type = "array"
                maxItems = $cMax
                items = [ordered]@{
                    type = "object"
                    additionalProperties = $false
                    required = @("id", "title", "role", "prompt", "when_to_use")
                    properties = [ordered]@{
                        id = [ordered]@{ type = "string"; maxLength = 24 }
                        title = [ordered]@{ type = "string"; maxLength = 80 }
                        role = [ordered]@{ type = "string"; enum = @("system", "user") }
                        prompt = [ordered]@{ type = "string"; maxLength = $pMax }
                        when_to_use = [ordered]@{ type = "string"; maxLength = 220 }
                        variables = [ordered]@{
                            type = "array"
                            maxItems = 12
                            items = [ordered]@{ type = "string"; maxLength = 40 }
                        }
                        confidence = [ordered]@{
                            type = "number"
                            minimum = 0
                            maximum = 1
                        }
                    }
                }
            }
            confirm_questions = [ordered]@{
                type = "array"
                maxItems = 6
                items = [ordered]@{ type = "string"; maxLength = 140 }
            }
            rationale = [ordered]@{
                type = "string"
                maxLength = 480
            }
        }
    }
}

function New-PromptAssetBoostInputText {
    param(
        [string]$PromptText,
        [object]$PromptNormalization,
        [string]$Grade,
        [string]$TaskType,
        [string]$RouteMode,
        [string]$SelectedPackId,
        [string]$SelectedSkill,
        [object]$PromptOverlayAdvice,
        [int]$MaxQueries,
        [int]$MaxCandidates,
        [int]$MaxPromptCharsPerCandidate
    )

    $normalized = if ($PromptNormalization -and $PromptNormalization.normalized) { [string]$PromptNormalization.normalized } else { $PromptText }

    $facetMatches = $null
    $matchedFacets = @()
    $promptSignalHit = $false
    $docSurfaceHit = $false
    try {
        if ($PromptOverlayAdvice) {
            $promptSignalHit = [bool]$PromptOverlayAdvice.prompt_signal_hit
            $docSurfaceHit = [bool]$PromptOverlayAdvice.doc_surface_hit
            $matchedFacets = @($PromptOverlayAdvice.matched_intent_facets)
            $facetMatches = $PromptOverlayAdvice.facet_matches
        }
    } catch { }

    $ctx = [ordered]@{
        vco = [ordered]@{
            grade = $Grade
            task_type = $TaskType
            route_mode = $RouteMode
            selected_pack = if ($SelectedPackId) { $SelectedPackId } else { "none" }
            selected_skill = if ($SelectedSkill) { $SelectedSkill } else { "none" }
        }
        prompt = [ordered]@{
            original = $PromptText
            normalized = $normalized
        }
        prompt_overlay_signals = [ordered]@{
            prompt_signal_hit = [bool]$promptSignalHit
            doc_surface_hit = [bool]$docSurfaceHit
            matched_intent_facets = @($matchedFacets)
            facet_matches = if ($facetMatches) { $facetMatches } else { [pscustomobject]@{} }
        }
        constraints = [ordered]@{
            max_queries = [int]$MaxQueries
            max_candidates = [int]$MaxCandidates
            max_prompt_chars_per_candidate = [int]$MaxPromptCharsPerCandidate
        }
    }

    $json = ($ctx | ConvertTo-Json -Depth 12 -Compress)

    $text = @()
    $text += "You generate prompts.chat search plans and small prompt overlay candidates."
    $text += "Return ONLY JSON that matches the JSON Schema. No markdown. No extra keys."
    $text += ""
    $text += "Guidelines:"
    $text += "- Queries should be short and directly searchable (keywords, not long sentences)."
    $text += "- Candidates must be safe to inject as a system/user prompt (no tool calls)."
    $text += "- Keep each candidate prompt concise; prefer variables like {project}, {goal}."
    $text += ""
    $text += "Context JSON:"
    $text += $json

    return ($text -join "`n")
}

function Invoke-PromptAssetBoostProvider {
    param(
        [object]$PolicyResolved,
        [string]$RepoRoot,
        [string]$InputText,
        [object]$Schema
    )

    $providerType = if ($PolicyResolved -and $PolicyResolved.provider -and $PolicyResolved.provider.type) { [string]$PolicyResolved.provider.type } else { "openai" }

    if ($providerType -eq "mock") {
        $mockRel = if ($PolicyResolved.provider.mock_response_path) { [string]$PolicyResolved.provider.mock_response_path } else { "" }
        if (-not $mockRel) {
            return [pscustomobject]@{
                ok = $false
                abstained = $true
                reason = "mock_missing_path"
                api = "mock"
                latency_ms = 0
                output_text = $null
                error = $null
            }
        }

        $base = if ($RepoRoot) { [string]$RepoRoot } else { "" }
        $path = if ([System.IO.Path]::IsPathRooted($mockRel)) { $mockRel } else { if ($base) { Join-Path $base $mockRel } else { $mockRel } }
        if (-not (Test-Path -LiteralPath $path)) {
            return [pscustomobject]@{
                ok = $false
                abstained = $true
                reason = "mock_file_not_found"
                api = "mock"
                latency_ms = 0
                output_text = $null
                error = $path
            }
        }

        $raw = Get-Content -LiteralPath $path -Raw -Encoding UTF8
        return [pscustomobject]@{
            ok = $true
            abstained = $false
            reason = "mock_ok"
            api = "mock"
            latency_ms = 0
            output_text = $raw
            error = $null
        }
    }

    if ($providerType -ne "openai") {
        return [pscustomobject]@{
            ok = $false
            abstained = $true
            reason = "unsupported_provider"
            api = "none"
            latency_ms = 0
            output_text = $null
            error = $null
        }
    }

    if (-not (Get-OpenAiApiKey)) {
        return [pscustomobject]@{
            ok = $false
            abstained = $true
            reason = "missing_openai_api_key"
            api = "none"
            latency_ms = 0
            output_text = $null
            error = $null
        }
    }

    $model = if ($PolicyResolved.provider.model) { [string]$PolicyResolved.provider.model } else { "your-model-id" }
    $baseUrl = if ($PolicyResolved.provider.base_url) { [string]$PolicyResolved.provider.base_url } else { "" }
    $timeoutMsSafe = [Math]::Max(500, [int]$PolicyResolved.provider.timeout_ms)
    $maxTokens = [int]$PolicyResolved.provider.max_output_tokens
    $temperature = [double]$PolicyResolved.provider.temperature
    $topP = [double]$PolicyResolved.provider.top_p
    $store = [bool]$PolicyResolved.provider.store

    $textFormat = [ordered]@{
        type = "json_schema"
        name = "vco_prompt_asset_boost"
        strict = $true
        schema = $Schema
    }

    $inputItems = @(
        [ordered]@{
            role = "user"
            content = @(
                [ordered]@{
                    type = "input_text"
                    text = $InputText
                }
            )
        }
    )

    $instructions = "Return ONLY JSON that matches the JSON Schema. No markdown. No extra keys."

    $chatResponseFormat = [ordered]@{
        type = "json_schema"
        json_schema = [ordered]@{
            name = "vco_prompt_asset_boost"
            strict = $true
            schema = $Schema
        }
    }

    $chatMessages = @(
        [ordered]@{ role = "system"; content = $instructions },
        [ordered]@{ role = "user"; content = $InputText }
    )

    $preferChat = $false
    if ($baseUrl -and ($baseUrl -notmatch "openai\\.com")) { $preferChat = $true }

    $invokeResponses = {
        $r = Invoke-OpenAiResponsesCreate `
            -Model $model `
            -BaseUrl $baseUrl `
            -InputItems $inputItems `
            -TextFormat $textFormat `
            -Instructions $instructions `
            -MaxOutputTokens $maxTokens `
            -Temperature $temperature `
            -TopP $topP `
            -TimeoutMs $timeoutMsSafe `
            -Store:([bool]$store)
        $r | Add-Member -NotePropertyName api -NotePropertyValue "responses" -Force
        return $r
    }

    $invokeChat = {
        $r = Invoke-OpenAiChatCompletionsCreate `
            -Model $model `
            -BaseUrl $baseUrl `
            -Messages $chatMessages `
            -ResponseFormat $chatResponseFormat `
            -MaxTokens $maxTokens `
            -Temperature $temperature `
            -TopP $topP `
            -TimeoutMs $timeoutMsSafe
        $r | Add-Member -NotePropertyName api -NotePropertyValue "chat_completions" -Force
        return $r
    }

    $providerResult = $null
    if ($preferChat) {
        $providerResult = & $invokeChat
        if (-not ([bool]$providerResult.ok -and (-not [bool]$providerResult.abstained) -and $providerResult.output_text)) {
            $providerResult = & $invokeResponses
        }
    } else {
        $providerResult = & $invokeResponses
        if (-not ([bool]$providerResult.ok -and (-not [bool]$providerResult.abstained) -and $providerResult.output_text)) {
            if ([string]$providerResult.reason -ne "missing_openai_api_key") {
                $providerResult = & $invokeChat
            }
        }
    }

    if (-not $providerResult -or -not [bool]$providerResult.ok -or [bool]$providerResult.abstained -or (-not $providerResult.output_text)) {
        $reason = if ($providerResult -and $providerResult.reason) { [string]$providerResult.reason } else { "provider_abstained" }
        return [pscustomobject]@{
            ok = $false
            abstained = $true
            reason = $reason
            api = if ($providerResult -and $providerResult.api) { [string]$providerResult.api } else { "unknown" }
            latency_ms = if ($providerResult -and $providerResult.latency_ms -ne $null) { [int]$providerResult.latency_ms } else { 0 }
            output_text = $null
            error = if ($providerResult -and $providerResult.error) { [string]$providerResult.error } else { $null }
        }
    }

    return [pscustomobject]@{
        ok = $true
        abstained = $false
        reason = "ok"
        api = if ($providerResult.api) { [string]$providerResult.api } else { "unknown" }
        latency_ms = if ($providerResult.latency_ms -ne $null) { [int]$providerResult.latency_ms } else { 0 }
        output_text = [string]$providerResult.output_text
        error = $null
    }
}

function Get-PromptAssetBoostAdvice {
    param(
        [string]$PromptText,
        [object]$PromptNormalization,
        [string]$PromptLower,
        [string]$Grade,
        [string]$TaskType,
        [string]$RouteMode,
        [string]$SelectedPackId,
        [string]$SelectedSkill,
        [object]$PromptOverlayAdvice,
        [object]$PromptAssetBoostPolicy,
        [string]$RepoRoot
    )

    if (-not $PromptAssetBoostPolicy) {
        return [pscustomobject]@{
            enabled = $false
            mode = "off"
            scope_applicable = $false
            enforcement = "none"
            reason = "policy_missing"
            preserve_routing_assignment = $true
            should_apply_hook = $false
            prompt_signal_hit = [bool]($PromptOverlayAdvice -and $PromptOverlayAdvice.prompt_signal_hit)
            explicit_intent = [bool]($PromptOverlayAdvice -and @($PromptOverlayAdvice.matched_intent_facets).Count -gt 0)
            recommended_skill = $null
            confirm_required = $false
            search_plan = $null
            overlay_candidates = @()
            provider = [pscustomobject]@{
                ok = $false
                abstained = $true
                reason = "policy_missing"
                api = "none"
                latency_ms = 0
                error = $null
            }
        }
    }

    $resolved = Get-PromptAssetBoostPolicy -Policy $PromptAssetBoostPolicy
    $scope = Test-PromptAssetBoostScope -Policy $resolved -PromptNormalization $PromptNormalization -Grade $Grade -TaskType $TaskType

    if (-not [bool]$scope.enabled -or -not [bool]$scope.scope_applicable) {
        return [pscustomobject]@{
            enabled = $false
            mode = [string]$scope.mode
            scope_applicable = $false
            enforcement = "none"
            reason = if ($scope.reasons -and $scope.reasons.Count -gt 0) { ($scope.reasons -join ",") } else { "outside_scope" }
            preserve_routing_assignment = $true
            should_apply_hook = $false
            prompt_signal_hit = [bool]($PromptOverlayAdvice -and $PromptOverlayAdvice.prompt_signal_hit)
            explicit_intent = [bool]($PromptOverlayAdvice -and @($PromptOverlayAdvice.matched_intent_facets).Count -gt 0)
            recommended_skill = $null
            confirm_required = $false
            search_plan = $null
            overlay_candidates = @()
            provider = [pscustomobject]@{
                ok = $false
                abstained = $true
                reason = "outside_scope"
                api = "none"
                latency_ms = 0
                error = $null
            }
        }
    }

    $mode = [string]$scope.mode
    $promptSignalHit = [bool]($PromptOverlayAdvice -and $PromptOverlayAdvice.prompt_signal_hit)
    $explicitIntent = [bool]($PromptOverlayAdvice -and @($PromptOverlayAdvice.matched_intent_facets).Count -gt 0)

    $triggerReasons = @()
    if ([bool]$resolved.trigger.require_prompt_signal -and (-not ($promptSignalHit -or $explicitIntent))) {
        $triggerReasons += "missing_prompt_signal"
    }
    if ([bool]$resolved.trigger.require_explicit_intent -and (-not $explicitIntent)) {
        $triggerReasons += "missing_explicit_intent"
    }

    if ($triggerReasons.Count -gt 0) {
        return [pscustomobject]@{
            enabled = $true
            mode = $mode
            scope_applicable = $true
            enforcement = "advisory"
            reason = ($triggerReasons -join ",")
            preserve_routing_assignment = $true
            should_apply_hook = $false
            prompt_signal_hit = $promptSignalHit
            explicit_intent = $explicitIntent
            recommended_skill = $null
            confirm_required = $false
            search_plan = $null
            overlay_candidates = @()
            provider = [pscustomobject]@{
                ok = $false
                abstained = $true
                reason = ($triggerReasons -join ",")
                api = "none"
                latency_ms = 0
                error = $null
            }
        }
    }

    $enforcement = "advisory"
    $reason = "soft_advisory"
    switch ($mode) {
        "shadow" {
            $enforcement = "advisory"
            $reason = "shadow_advisory"
        }
        "soft" {
            $enforcement = "advisory"
            $reason = "soft_advisory"
        }
        "strict" {
            $enforcement = "required"
            $reason = "strict_required"
        }
        default {
            $enforcement = "advisory"
            $reason = "unknown_mode_advisory"
        }
    }

    $recommendedSkill = "prompt-lookup"
    $shouldApplyHook = $true

    if ($mode -eq "shadow") {
        return [pscustomobject]@{
            enabled = $true
            mode = $mode
            scope_applicable = $true
            enforcement = $enforcement
            reason = $reason
            preserve_routing_assignment = $true
            should_apply_hook = $shouldApplyHook
            prompt_signal_hit = $promptSignalHit
            explicit_intent = $explicitIntent
            recommended_skill = $recommendedSkill
            confirm_required = $false
            search_plan = $null
            overlay_candidates = @()
            provider = [pscustomobject]@{
                ok = $false
                abstained = $true
                reason = "shadow_mode_no_provider"
                api = "none"
                latency_ms = 0
                error = $null
            }
        }
    }

    $maxQueries = [Math]::Max(1, [Math]::Min(8, [int]$resolved.trigger.max_queries))
    $maxCandidates = [Math]::Max(1, [Math]::Min(3, [int]$resolved.trigger.max_candidates))
    $maxPromptChars = [Math]::Max(200, [Math]::Min(2000, [int]$resolved.output.max_prompt_chars_per_candidate))

    $schema = Get-PromptAssetBoostJsonSchema -MaxQueries $maxQueries -MaxCandidates $maxCandidates -MaxPromptCharsPerCandidate $maxPromptChars
    $inputText = New-PromptAssetBoostInputText `
        -PromptText $PromptText `
        -PromptNormalization $PromptNormalization `
        -Grade $Grade `
        -TaskType $TaskType `
        -RouteMode $RouteMode `
        -SelectedPackId $SelectedPackId `
        -SelectedSkill $SelectedSkill `
        -PromptOverlayAdvice $PromptOverlayAdvice `
        -MaxQueries $maxQueries `
        -MaxCandidates $maxCandidates `
        -MaxPromptCharsPerCandidate $maxPromptChars

    $provider = Invoke-PromptAssetBoostProvider -PolicyResolved $resolved -RepoRoot $RepoRoot -InputText $inputText -Schema $schema

    $searchPlan = $null
    $candidates = @()
    $confirmQuestions = @()
    $rationale = $null

    if ([bool]$provider.ok -and $provider.output_text) {
        try {
            $obj = ($provider.output_text.Trim() | ConvertFrom-Json)
            if ($obj -and $obj.search_plan) { $searchPlan = $obj.search_plan }
            if ($obj -and $obj.overlay_candidates) { $candidates = @($obj.overlay_candidates) }
            if ($obj -and $obj.confirm_questions) { $confirmQuestions = @($obj.confirm_questions) }
            if ($obj -and $obj.rationale) { $rationale = [string]$obj.rationale }
        } catch {
        }
    }

    $cleanCandidates = @()
    foreach ($c in @($candidates | Select-Object -First $maxCandidates)) {
        if (-not $c) { continue }
        $prompt = if ($c.prompt) { [string]$c.prompt } else { "" }
        if ($prompt.Length -gt $maxPromptChars) { $prompt = $prompt.Substring(0, $maxPromptChars) }
        if (-not $prompt.Trim()) { continue }

        $cleanCandidates += [pscustomobject]@{
            id = if ($c.id) { [string]$c.id } else { "candidate_{0}" -f ($cleanCandidates.Count + 1) }
            title = if ($c.title) { [string]$c.title } else { "Prompt Candidate {0}" -f ($cleanCandidates.Count + 1) }
            role = if ($c.role) { [string]$c.role } else { "system" }
            prompt = $prompt.Trim()
            when_to_use = if ($c.when_to_use) { [string]$c.when_to_use } else { "" }
            variables = if ($c.variables) { Get-ArraySafe -Value $c.variables } else { Get-ArraySafe -Value $null }
            confidence = if ($c.confidence -ne $null) { [double]$c.confidence } else { 0.55 }
        }
    }

    $confirmRequired = ($cleanCandidates.Count -gt 0)

    return [pscustomobject]@{
        enabled = $true
        mode = $mode
        scope_applicable = $true
        enforcement = $enforcement
        reason = if ([bool]$provider.ok) { $reason } else { "provider_abstained" }
        preserve_routing_assignment = $true
        should_apply_hook = $shouldApplyHook
        prompt_signal_hit = $promptSignalHit
        explicit_intent = $explicitIntent
        recommended_skill = $recommendedSkill
        confirm_required = $confirmRequired
        search_plan = $searchPlan
        overlay_candidates = @($cleanCandidates)
        confirm_questions = @($confirmQuestions | Where-Object { $_ } | Select-Object -First 6)
        rationale = if ($rationale) { $rationale.Trim() } else { $null }
        provider = [pscustomobject]@{
            ok = [bool]$provider.ok
            abstained = [bool]$provider.abstained
            reason = [string]$provider.reason
            api = [string]$provider.api
            latency_ms = [int]$provider.latency_ms
            error = if ($provider.error) { [string]$provider.error } else { $null }
        }
    }
}
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