rein-openweights/INTENT.md
tegwick ac5407a83e Charter rein-openweights
Agentic tool-use harness for current open-weight models via OpenRouter/
llm-connect, as an alternative to frontier-model-vendor harnesses
(Claude Code, Grok CLI, Codex/GPT CLI). Chartered by glas-harness
ADR-001. Local scaffold only, no Forgejo remote yet.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-26 12:29:06 +02:00

50 lines
2.3 KiB
Markdown

# INTENT
> Why rein-openweights exists, its boundary, and what it must never
> become. Established by glas-harness
> `docs/adr/ADR-001-rein-harness-family.md`.
## Why it exists
Every current agent harness in the ecosystem (Claude Code, Grok CLI,
Codex/GPT CLI) is a frontier-model-vendor harness: it only drives that
vendor's own model. There is no way to run a current open-weight model
through an equivalent agentic tool-use loop (plan → tool call → observe →
repeat, with a bounded tool policy) without building one from scratch per
occasion.
rein-openweights exists to be that harness: one agentic loop, model
supplied via OpenRouter (through `llm-connect`), usable anywhere a
rein-aharness-equivalent session is wanted but a frontier-vendor
dependency is not — cost-sensitive workloads, offline/degraded-network
tolerance, or simply comparing open-weight model capability against
frontier baselines on the same task.
## Governing principle
It is a **rein** — a concrete harness backend under glas-harness's
router, implementing the same harness contract as `rein-aharness`
(session lifecycle, tool dispatch + policy, sandbox consumption via
sand-boxer, State Hub reporting). It does not reimplement any of that
framework machinery itself; glas-harness owns the contract, this repo
owns the open-weight-model-specific agentic loop and tool execution.
## What it must never become
- **Not a model router.** Choosing which OpenRouter model to use for a
given task, pricing, and fallback stays in `llm-connect`. This repo
consumes `llm-connect`, it does not reimplement provider routing.
- **Not a second harness framework.** Session semantics, tool policy
schema, sandbox consumption, and audit reporting are glas-harness's
contract (`GLAS-WP-0001-T01`) — this repo implements it, not forks it.
- **Not a sandbox provisioner.** Isolation comes from sand-boxer via
glas-harness, the same as every other rein.
- **Not tenant-specific logic.** Anything specific to one consumer
belongs in that consumer's configuration, not hardcoded here.
## Status
Charter + local scaffold only. See `workplans/REIN-OW-WP-0001-bootstrap.md`
for the first concrete milestone (minimal tool-use loop against one
OpenRouter open-weight model, same starter tool surface as
rein-aharness's `green-commit-only` profile).