James Ross.

Agent-Ready Knowledge Architecture

I build the systems organisations run AI agents on.

Agents are only as good as the memory they run on and the workspace built around them. I architect that whole layer: the sources of truth, the context budgets, the loops agents run in, and the checks that keep them honest.

Open-source reference architecture Author of Agent-First · first draft complete Doctoral research · trustworthy shared memory for AI agents

01  The work

Most AI adoption stalls because agents have nothing reliable to run on.

The models are strong enough. What's missing is the memory underneath them. An organisation runs on a context layer that mostly isn't in tidy systems: stale documents indistinguishable from current ones, decisions buried in inboxes and chat threads, processes that run on tacit rules nobody wrote down, no source defined as authoritative. Point a capable agent at that and it retrieves confidently from the wrong place.

My work is that layer and the machinery around it. Three things separate a demo from a system an organisation can actually run on. The workspace architecture: the governed memory, roles, task flow, and guardrails a fleet of agents operates inside. The token economics: what a capable agent costs per unit of work, and the orchestration and model-tiering decisions that hold that cost down as usage compounds. And the loop engineering: which work runs unattended, which gets surfaced for human review, and which stays manual. I build all three, on a memory system designed to be read by agents as much as people.

02  Capabilities

Three primary practice areas

Each one runs daily in a production workspace and is documented in the open, pattern by pattern, in a public reference architecture.

01 · Architecture

AI workspace architecture

The full environment a fleet of agents operates in: governed organisational memory, specialised expert roles, task and delegation flow, hook-enforced guardrails, and a self-audit that keeps the whole thing honest. Designed so a small team, or one operator, can run many agents without losing the thread.

Proof in the open: agent-workspace-architecture — a redacted production workspace with 18 expert roles, an adoption guide, and an interactive tour.

02 · Economics

Token & context optimisation

Context is a budget, not a constant. Per-run cost ledgers, budget caps on scheduled agents, cache-aware context design, bounded fan-outs, and tiered model execution: plan at the frontier tier, execute a tier down, review at the top. The discipline that decides whether an agent system stays affordable as usage compounds.

Proof in the open: the reference architecture's token-budget module and its pattern “Context is a budget, not a constant”.

03 · Control

Loop engineering

Which work belongs in an autonomous loop, which gets surfaced for human review, and which stays manual, decided by test rather than enthusiasm. Scheduled lanes with freshness sentinels and a dead-man's switch, delegation queues an operator fills deliberately, and verify-loops that only stop on a checkable condition.

Proof in the open: the reference architecture's loop-selection and delegation-queue patterns, distilled from retiring an always-on agent that a gated queue outperformed.

Backed by

Evaluation & verification

Golden-set regression suites, LLM-judge design, adversarial verification passes, and synthetic canaries in a weekly self-audit. A capability change ships with a measurable signal behind it, or it doesn't ship.

Agent governance & safety

Permission floors, hook-enforced guardrails, untrusted-content handling, credential discipline, action logging, and human-review gates. Autonomy sized to evidence, expanded only by explicit grant.

Knowledge & memory architecture

The practice core: source-of-truth mapping, context packs per workflow, and memory governance with provenance, retention, and typed memory that points at sources instead of copying them.

03  Selected work

Built, not demoed

Open source agent-workspace-architecture →

A redacted, world-readable snapshot of a production agent workspace: eighteen load-bearing patterns, an adoption guide, samples, and an interactive tour. The architecture, inspectable in the open.

Production system A multi-agent workspace on governed organisational memory →

Run daily in production on a designed memory system: persistent cross-session memory with consolidation discipline, a source-of-truth pointer architecture, decision and lesson logs, and an automated self-audit. 18 specialised roles operate over it. The entire architecture is mapped on one page.

Book — first draft complete Agent-First: Re-Architecting Organizational Knowledge for a Workforce of Agents

How organisations re-architect their knowledge and operations for a workforce of agents: the move from scattered documents to a governed memory agents can be trusted to run on.

04  Background

An engineer's discipline, applied to organisational memory

I came to knowledge architecture through data engineering, building production data platforms: cloud data warehouses, ETL pipelines, and the analytics executives actually decide on. Then I went deep on agent systems, building a full multi-agent workspace from the ground up, building and deploying an AI-driven SaaS end-to-end, and formalising the work through doctoral research into how autonomous agents share and govern memory. The two threads meet at the same place: the system of record an organisation runs on, now designed for agents to read as well as people.

It means I bring an engineer's production discipline (version control, testing, provenance, rollback, observability) to a field that is still mostly demos.

  • Doctoral research — trustworthy shared memory for collaborative AI agents (James Cook University, from 2026)
  • Master of Data Science — James Cook University
  • Graduate Diploma in Research Methods — James Cook University

05  How we work together

Engagement models

Every engagement has a defined start, a defined deliverable and a defined end. No retainers, no standing availability, no on-call.

Practices where the firm pays for slow work: architecture and engineering design, planning and development applications, valuation, loss adjusting and claims assessment, accounting compliance, and other professions that quote a fixed fee or a fee per file. Private sector only. Not a fit where the agent would carry professional judgment without the professional's review. Larger estates with one high-value workflow are the Context Architecture Build's buyer.

Agent Workspace Install · four to six weeks, fixed scope

Where most firms start. The operating layer for your specialists' agents, set up in the Microsoft 365 or Google Workspace estate you already run, on model access you hold yourself. Your recurring deliverables built into measured workflows, a value instrument you keep, and a guided six-week program that takes each person from wherever they are with AI to running it without me. A first group of one to three specialists is the usual start. Handed over, with no watching duty afterwards.

Agent Workspace Diagnostic · about two weeks, fixed scope, read-only

For firms already running assistants or agents on client work. A scored assessment across six dimensions, graded from your actual artefacts rather than interviews alone, a prioritised remediation sequence, and a written report with an executive readout. Three lenses, chosen by what you already feel: workspace readiness for teams whose assistants have no durable context, cost per outcome for teams whose token bill is painful and unattributed, or operations assurance for insurers, financial services and health providers that must show what their agents used and who approved what. Nothing is installed. The fee is credited in full against an install or build that starts within 90 days.

Context Architecture Build · eight to twelve weeks, one workflow deep

For one high-value deliverable inside a larger estate. Source register, business glossary, decision memory, context manifests, retrieval rules, output templates, and the evaluation tests that prove your agents use them. Built in your environment, with scope and price fixed at scoping.

Re-tune · scoped to the signal

When the instrument shows drift, or the models underneath you change. A new engagement, bounded like the first. Repeat engagements are welcome. Open-ended obligation is deliberately off the menu.

Guided program or workshop · half a day to six weeks, on request

For a team building this layer itself, or for bringing more people onto an installed workspace. The same program placed by experience level, run on your own deliverables, on site or remotely.

Strategic advisory & mentoring sessions

Short-form architecture and strategy sessions on workspace architecture, token economics, loop engineering, memory governance, and AI-first organisational design — for technical leaders, founders, and architects building this layer inside their organisations.

Every engagement is a fixed fee, stated on its offer sheet. Ask for the pack.

How every engagement runs

  • Bounded scope — one high-pain area at a time (a key-person departure, an onboarding bottleneck, a "nobody can find anything" domain), never "map our whole organisation".
  • Non-extraction by design — analysis computes in your environment and emits derived structure, not content; raw material never leaves your tenant, and the data flow is auditable in your own logs.
  • Auditable over autonomous — anything that runs is transparent, scoped, throttled, and logged, deliberately less autonomous than the technology allows; access expands only by explicit grant.
  • An explicit IP split — findings about your organisation are yours; the generalised methods I arrive with and refine are mine. Written into every engagement, never discovered later.
  • A hand-back clause — if the engagement must end early on either side, all work product to date is delivered within five business days, your systems are left in a working state, and fees settle pro rata against the stages completed.
  • Your model access, your data — you pay the vendor directly for model access under business terms that do not train on your inputs, and I never hold your account or keys. Client data is classed at the start, and a one-page data note records which class goes through which route and where it is processed.

I build the capability, then hand over the keys. The goal is to make the engagement unnecessary, not to create a dependency.

Not a fit: generic ML or analytics builds, staff augmentation, or open-ended on-call retainers. I focus on the knowledge and context layer agents run on, in engagements that ship and end.

06  Work together

Available for select fixed-scope engagements.

Your agents are only as good as the mess they read. If that's the problem worth fixing, get in touch.

Writing Agent-First, a book on re-architecting organisational knowledge for a workforce of agents. Get notified when it ships.