REPO_B Local Bridge Orchestrator
Use this skill to run a manual local-first Agent Bridge workflow in <PRIVATE_REPO_B> and emit validated guidance hints without cloud fallback.
Scope Boundary
- In scope:
/api/agent/*readiness/tasks, bounded file indexing,analyze_filesvalidation, and guidance hint output. - Out of scope:
/api/mcp/*operations andshim.comfy.*diagnostics. - For MCP/Comfy operations, use
$repo-b-mcp-comfy-bridge.
Workflow
- Confirm policy-safe environment (
read_only, fail-closed). - Probe bridge readiness (
/health,/api/agent/capabilities). - Build or refresh bounded metadata index on demand.
- Query candidate files for the selected scope.
- Submit read-only
analyze_filestask (allow_write=false,dry_run=true). - Validate bridge response with strict schema/evidence/confidence gates.
- Emit normalized
guidance_hintsJSON and stop on failures.
Drop-In Hook Files
Copy these files into <PRIVATE_REPO_B> before first run:
assets/repo_b/tools/local_bridge_orchestrator.py->tools/local_bridge_orchestrator.pyassets/repo_b/tools/local_bridge_validate.py->tools/local_bridge_validate.pyassets/repo_b/tools/local_bridge_orchestrator.example.env->tools/local_bridge_orchestrator.example.envassets/repo_b/tests/tools/test_local_bridge_orchestrator.py->tests/tools/test_local_bridge_orchestrator.pyassets/repo_b/tests/tools/test_local_bridge_validate.py->tests/tools/test_local_bridge_validate.py
Required Environment (PowerShell)
$env:REPO_B_LOCAL_ORCH_ENABLED = "1"
$env:REPO_B_LOCAL_ORCH_CONFIDENCE_MIN = "0.85"
$env:REPO_B_LOCAL_ORCH_EVIDENCE_MIN = "2"
$env:REPO_B_LOCAL_ORCH_FAIL_CLOSED = "1"
$env:REPO_B_LOCAL_ORCH_MAX_HINTS = "12"
$env:REPO_B_CONTINUE_BRIDGE_ENABLED = "1"
$env:REPO_B_CONTINUE_MODE = "read_only"
$env:REPO_B_CONTINUE_ALLOWED_ROOTS = "G:\GitHub\<PRIVATE_REPO_B>"
Run Command
Run from <PRIVATE_REPO_B> root:
python tools/local_bridge_orchestrator.py \
--task ticket-123 \
--prompt-file .codex/local_prompts/ticket-123.txt \
--scope connector \
--json-out .codex/local_bridge/ticket-123.json
Usage Guardrails
Use your real usage history before scale-up:
python3 "$CODEX_HOME/skills/usage-watcher/scripts/usage_guard.py" analyze \
--input /path/to/usage.csv \
--window-days 30 \
--format table
python3 "$CODEX_HOME/skills/usage-watcher/scripts/usage_guard.py" plan \
--monthly-budget <credits> \
--reserve-percent 20 \
--work-days-per-week 5 \
--sessions-per-day 3 \
--burst-multiplier 1.5 \
--format table
Authority reminder:
- Treat
http://127.0.0.1:9000/v1andhttp://127.0.0.1:2337/v1as authoritative model lanes. - Treat
http://127.0.0.1:1234/v1only as a non-authoritative operator surface.
References
references/orchestrator-workflow.mdreferences/validation-contract.mdreferences/mx3-phase2-roadmap.md
Loopback
If this lane is unresolved, blocked, or ambiguous:
- Capture current evidence and failure context.
- Route back through
$skill-hubfor chain recalculation. - Resume only after the updated chain returns a deterministic next step.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.