agentleFS
muratgurmuratgur/ordinus/.claude/skills/provider-runtime-adapter/SKILL.md

provider-runtime-adapter

Skill111 starsChanged 5 months agoMITView on GitHub

Design Ordinus provider runtime adapters for local AI CLIs. Use when working on Codex, Claude, or future provider detection, auth status, run lifecycle, process management, cancellation, event parsing, output capture, or provider-neutral runtime interfaces.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 7 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep local AI CLI integrations provider-neutral, observable, and owned by Electron main process.

    line 10
  2. Distinctive:

    Do not implement all concepts until the product flow needs them.

    line 24
  3. Distinctive:

    Run provider processes from Electron main process or a main-owned worker.

    line 28
  4. Distinctive:

    Do not allow renderer to pass arbitrary shell commands.

    line 29
  5. Distinctive:

    Treat Codex and Claude as peers.

    line 32
  6. Very specific:

    When provider state or events are shown in renderer UI, align user-visible statuses and event labels with the status vocabulary in …

    line 33
  7. Distinctive:

    Add the smallest provider-neutral interface needed for that action.

    line 38
  8. Distinctive:

    Run typecheck, lint, build, and a runtime smoke test.

    line 43

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Provider Runtime Adapter

Objective

Keep local AI CLI integrations provider-neutral, observable, and owned by Electron main process.

Adapter Boundary

Provider adapters should hide provider-specific CLI details behind a shared runtime shape. Start with only the methods needed by current product behavior.

Preferred concepts:

  • detect: determine whether the CLI is available.
  • getAuthStatus: report whether the provider appears ready.
  • startRun: launch one user-approved run.
  • cancelRun: stop an active run.
  • parseEvents: normalize stdout/stderr into observable run events when needed.

Do not implement all concepts until the product flow needs them.

Runtime Rules

  • Run provider processes from Electron main process or a main-owned worker.
  • Do not allow renderer to pass arbitrary shell commands.
  • Store run state and events durably only after the run model is intentionally designed.
  • Normalize provider behavior without erasing useful provider-specific diagnostics.
  • Treat Codex and Claude as peers. Do not let the first provider shape the whole architecture.
  • When provider state or events are shown in renderer UI, align user-visible statuses and event labels with the status vocabulary in DESIGN.md.

Workflow

  1. Define the user action that needs provider runtime support.
  2. Add the smallest provider-neutral interface needed for that action.
  3. Implement detection or process behavior in main process.
  4. Validate executable paths, workspace boundaries, and allowed arguments in main.
  5. Stream or record events in a way the UI can explain clearly, using DESIGN.md status language for user-visible states.
  6. Support cancellation before adding more automation.
  7. Run typecheck, lint, build, and a runtime smoke test.

Red Flags

  • Renderer sends raw command strings or CLI args.
  • Provider-specific flags leak into UI state too early.
  • Long-running process state exists only in memory when the UI needs to recover it.
  • A provider integration assumes a single operating system.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.