Reference · what agent-ready means

What does agent-ready actually look like?

The agentic traffic era has opened — agents now query your systems, compare your products, and execute on behalf of customers without a human in the loop. Owning your external surface is the thesis; this is what it looks like on IBM i — the concrete stack your environment needs before that traffic arrives.

The argument

Agent-ready is not a single thing you turn on. It is five gates an organization opens, in order, before agentic traffic can flow through its systems without breaking. Miss any one layer and you create a failure mode. Build them in the wrong order and the governance layer never catches up to the execution layer.

The IBM i organizations sitting on decades of encoded business logic are closer to agent-ready than most. The hard part — trusted data, object-level security, journaled audit trails, business rules proven at scale — is already built. What's missing is the layer that makes it consumable by an agent. This reference maps the five gates, what each one is, and where IBM i sits in it.

The orchestration was already built. It just needs to be connected — in the right order, with the core protected.
The five gates — agent traffic stops at the first one that isn't open Agent traffic enters at Discovery, which is already open whether or not you governed it. It then meets Comprehension, which most organizations have not built — so the traffic stops there. Beyond it lie Access, Governance and Execution. The gates open in order; the first closed gate is where the sequence ends. AGENT TRAFFIC ENTERS AGENTS ACTING ON YOUR LOGIC GATE 01 Discovery OPEN ALREADY governed or not GATE 02 Comprehension NOT BUILT the wall GATE 03 Access the IBM i bridge GATE 04 Governance non-negotiable GATE 05 Execution the top The sequence ends at the first gate you haven't opened — and for most shops that is the second one, not the fifth.
The five gates · traffic stops at the first one that isn't open
Gate 01DiscoveryYour external surface · live now

"This surface already exists. The only question is whether you've governed it — or left agents to read you on their own terms."

This is your external surface: the outward face agents form their picture of you from. By default your IBM i system has no presence an agent can navigate — no llms.txt, no structured manifest, no declared policy on what an agent may query or invoke. But the surface is not neutral in its absence. Agents still arrive; they simply read you badly, or route to a competitor whose surface is legible. This layer isn't about being found — it's about being correctly and safely represented to a class of reader that already outnumbers humans on the web.

  • Create llms.txt at your domain root declaring agent permissions and your MCP endpoint
  • Update robots.txt to explicitly allow or restrict specific agent crawlers
  • Publish an MCP server manifest — which tools are exposed, what schemas they expect
  • Add Schema.org Organization markup with API contact and capabilities
Gate 02ComprehensionNot built · most shops

"Can an agent understand what you do well enough to act on it correctly?"

The business logic that governs your operations lives in RPG programs and Db2 tables. No agent can read RPG directly. But agentic coding tools can surface that logic into human-readable documentation that becomes the foundation for machine-readable specifications. This is the knowledge-extraction step — and it is where decades of encoded logic becomes an asset an agent can finally reach. It is the work of closing Knowledge Distance on the technology side.

  • Document the Db2 schema — table names, field definitions, relationship maps — in structured form
  • Use agentic coding tools to extract RPG program logic into readable specifications
  • Publish an OpenAPI spec describing your core endpoints
  • Express machine-readable terms and thresholds in JSON-LD
Gate 03AccessThe IBM i bridge

"Can an agent reach the sovereign core — without changing it?"

This is the bridge layer: APIs and the MCP interface that make RPG and Db2 reachable and agent-legible without rewriting the core. The encoded logic stays exactly where it is, protected at the center; the access layer exposes it on terms you define. This is where IBM i's reliability becomes an agentic advantage rather than a constraint.

  • Stand up an MCP interface mapping IBM i programs and queries to agent-callable tools
  • Use a modern data interface to expose Db2 for i safely to the access layer
  • Scope each exposed tool with explicit, least-privilege permissions
  • Keep the core unchanged — reach it, don't rebuild it
Gate 04GovernanceNon-negotiable

"When an agent acts, can you prove what it did — and stop what it shouldn't?"

Governance is the layer that makes everything above it safe, which is why it is built into the foundation rather than bolted on at the end. Every agent action authenticated, permissioned, and logged. Runtime enforcement, deterministic policy, and an audit trail are not features you add later — they are the precondition for letting an agent near the core at all.

  • Authenticate and authorize every agent at the boundary, per tool
  • Enforce deterministic policy at runtime — not just at design time
  • Journal every agent action to an immutable audit trail
  • Build this layer first, so execution never outruns it
Gate 05ExecutionThe top layer

"Can agents do real work — under human governance — at agentic speed?"

With the four layers beneath it in place, agents can execute real work against the systems that run the business — querying, comparing, acting on behalf of customers — while humans govern strategy, judgment, ethics, and escalation. This is human-agentic operation: agents execute, humans govern, the sovereign core stays protected the whole way.

  • Stand agents up thoughtfully, in tandem with organizational readiness
  • Prove on one slice — a pilot or agentic twin — before scaling
  • Keep humans at the points where judgment belongs
  • Scale only as fast as the governance layer can hold
In short

Each one gates the next.

The five gates are not a menu. They are a sequence, and the order is the whole point. Skip a gate or invert the order, and the failure shows up exactly where you can least afford it — at the boundary between an agent and the core that runs your business.

The advantage for IBM i organizations is that the hardest part is already done. The logic exists. The reliability exists. What remains is the reachability — built in, not bolted on.

This page asks whether an agent can reach your logic at all. Its companion asks where the value sits once it can — five layers of the agentic stack, and which one resists commoditization. The agentic stack →

Owning your surface is a thesis that holds for any organization on any platform — the full argument, and why it may need to go first, lives at Pegasus Source. But its deepest layers — edge, governance, and the core an agent must never rewrite — are inseparable from the platform they run on. That is the part that is ours. On IBM i, guarding the surface isn't a set of files bolted to a website; it's object-level security, journaling, and a sovereign core that records every touch, below the application, where getting past the edge buys an attacker far less than it does anywhere else. The thesis is universal. Guarding the perimeter on IBM i is not.

03 / 03  ·  The technology axis  ·  ← 02 The agentic stack  ·  ↑ Back to the map

Own your source. Own your intelligence.