Skip to content

mikeng-io/agent-skills / skills/bridge-commons

bridge-commons

Verified

Shared contract for all bridge adapters — pre-flight SOP, standardized input/output schemas, artifact format, and status semantics. Read by any bridge or orchestrating skill. Not invocable standalone.

FileKindSize
README.mdmarkdown1.8 KB
SKILL.mdskill md30.4 KB
tool-discovery.mdmarkdown9.9 KB
# Bridge Commons

Shared contract for all bridge adapters in the Deep Skills Suite. Defines the pre-flight SOP, input/output schemas, status semantics, and artifact format that every bridge implements.

## Why This Exists

Each bridge adapter (Claude, Gemini, Codex, OpenCode) connects to a different AI runtime with different CLIs and APIs. Bridge-commons provides the shared layer so orchestrating skills only need to know one schema — not four.

## What It Defines

| Section | Purpose |
|---------|---------|
| Pre-flight SOP | Ordered detection steps every bridge follows before executing |
| Timeout estimation | Scope-based formula, no hardcoded values |
| Input schema | `bridge_input` — the standard contract every bridge accepts |
| Output schema | Common report structure every bridge returns |
| Status semantics | `COMPLETED`, `SKIPPED`, `HALTED`, `ABORTED` and when each applies |
| Artifact format | JSONL event log + Markdown summary in `.outputs/bridges/` |
| Error handling | Exit code patterns, timeout handling, parse failure recovery |

## How Bridges Use This

Each bridge's `SKILL.md` references this document. When an orchestrating skill embeds a bridge's instructions into a Task agent prompt, the bridge follows `bridge-commons` for all shared behavior and only adds its own connection-specific logic on top.

```
bridge-commons  ←  defines the contract
bridge-claude   ←  implements it: Task tool → claude CLI → Anthropic API
bridge-gemini   ←  implements it: gemini CLI → SKIPPED
bridge-codex    ←  implements it: MCP → codex exec → SKIPPED
bridge-opencode ←  implements it: HTTP API → opencode run → SKIPPED
```

## Part of

- Deep Skills Suite
- Consumed by: all bridge adapters, `deep-council`
- Depends on: nothing (this is the base layer)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall