Cross-Platform Handling
Route commands through a verified platform or target compatibility adapter.
Tool use
Tool Routing Tables
Map operations to documented tools and permitted alternatives.
Version Check
Compare installed and available versions without blocking unrelated work.
Isolated Review Checkout
Use an isolated checkout and materialize only the deliberate review scope.
Staggered Burst Query + Rate Limits
Limit concurrent queries and apply service-specific backoff.
Reconnaissance-Then-Action
Observe the current state before choosing an action in a dynamic system.
Helper Script as Black Box
Use a trusted helper's documented interface for a complex deterministic operation.
Composio 3-Step SaaS Integration
Discover current actions, verify connection state and then execute a validated call.
Parallel-Safe Step Identification
Parallelize independent reads and sequence mutations with their dependent checks.
Hook-Driven Automation
Respond to configured lifecycle hooks without bypassing an intentional block.
REPL as Tool Composition
Compose documented tool calls with explicit data flow in a programming layer.
Agent-Centric Tool Design Principles
Design tool interfaces around bounded intents, useful evidence and actionable errors.
Marketplace Source-Type Polymorphism (SHA-Pinned)
Pin fetched skill content to an immutable revision or verified content hash.
Capability-Absent Anti-Fabrication Fallback
Report a missing capability and take only a documented fallback.
Capability Smoke-Test Over Presence-Check
Exercise a capability on a small real input before relying on its availability.
Immutable-Slug Identity with Rename Redirect Map
Keep stable identity separate from display labels and map retired names explicitly.
Recover according to failure class
Treat authorization, invalid input, throttling and empty data as different outcomes.
Read fresh version tokens before update
Use the resource’s current concurrency token for a write.
Choose capabilities from current metadata
Discover available identifiers and supported features before selecting a model or voice.
Prove paginated retrieval is complete
Follow each endpoint’s continuation contract and distinguish complete from partial retrieval.
Validate per-item outcomes inside batch success
Inspect nested item results instead of accepting a successful envelope as total success.
Check replace semantics before editing
Choose an update method according to whether it replaces or patches content.
Resolve opaque IDs within their scope
Translate human names into service IDs while retaining parent scope.
Resolve schema references before arguments
Load a referenced schema before constructing tool arguments.
Question-to-signal observability
Choose instrumentation from the questions an operator must answer.
Use a deadline independent of stream activity
Use a total operation deadline as well as inactivity detection so keepalives cannot occupy a worker indefinitely.
Retain full validation beside a compatible schema
Keep the full business validation contract when a host accepts only a reduced schema representation.
Preserve coordinate units through tool handoffs
Carry units, dimensions and origin with positions; normalize mixed coordinate sources before a downstream operation.
Reconnect event streams without gaps
Recover a dropped event stream by overlapping live delivery with history and deduplicating by event ID while checking stop conditions independently.
Validate the whole streamed turn before acting
Gate client-side tool execution on completed generation, strict input parsing and the tool’s validation contract.
Promote opaque actions to typed control points
Expose an action as a typed tool when the harness needs to gate, render, audit or schedule that action specifically.
Wait on a fresh observable predicate
Replace guessed delays with a fresh readiness predicate and a bounded timeout.
Dependency-calibrated verification adapters
Choose verification substitutes according to the dependency controlled by the module.
Keep tool roots separate from project roots
Resolve installed helper code from its skill base while resolving project artifacts from the declared project working directory.
Atomic Budget Admission Before Enqueue
Reserve the permitted budget atomically before accepting expensive queued work.
Deterministic Parse with Uncertain-Case Escalation
Run a deterministic parser first and send only structurally uncertain items for model review.
Identifiable Calibration with a Holdout
Collect enough independent anchors to identify a coordinate transform, then verify it on a separate reference.
Ordered Actions and Final-State Audit
Trace the complete action sequence and verify its final state, including later actions that undo earlier ones.
Evidence Bound to the Same Stable Bytes
Ensure measurements, sizes and digests in an evidence bundle describe the same stable source content.
Process Success and Semantic Completion Handshake
Require both successful process exit and a task-completion record before acknowledging background work.
Structured State and Rendered Evidence
Combine structured application state with rendered evidence when neither alone answers the task.
Validate the Proposed Mutation
Validate the content an operation proposes to write before authorizing that operation.
Isolate Optional Capability Loading Failures
Load optional infrastructure behind the capability boundary and expose its failure honestly.