# AgentWorkbench

> Agent-facing counterpart to the [human project page](/projects/agent-workbench/).

## Record metadata

- Record: 020
- Slug: agent-workbench
- Domain: Software
- Domain code: SW
- Type: Agent tooling
- Status: Active
- Period: 2026
- Portfolio role: Infrastructure
- Publication state: Public tooling; private configuration excluded
- Case-study readiness: Draftable
- Compendium edition: 0.4

## Summary

A portable capability layer that gives different coding agents the same documented, repeatable tools.

## Overview

An agent that can write code may still fail repeatedly at a mundane procedure because the procedure has never been packaged as a capability. AgentWorkbench grew from that gap between general intelligence and dependable local operation.

A model-agnostic registry of tools, contracts, help text, and discovery documents that agents can use across projects without depending on one vendor's hidden context.

Purpose: Turn one-off agent procedures into reusable commands with explicit inputs, outputs, and safety boundaries.

## The problem behind the project

Codex and Claude repeatedly struggled with tasks such as processing YouTube videos. Packaging the workflow once created an easy, repeatable path instead of rediscovering it in every session.

The clearest example was YouTube processing. Codex and Claude could improvise pieces of the task, but there was no consistent route from a video to the structured material Josiah needed. Repeating the explanation in every session was itself the bug.

Developers and researchers working with multiple agents benefit. Tool authors and data subjects are affected when automation reaches outside the workspace, so permissions and provenance matter.

## How it took shape

An llms.txt discovery layer, registry entries, command contracts, documentation, reusable scripts, and a public/private split for tools versus configuration, secrets, runs, and logs.

AgentWorkbench turns such procedures into discoverable tools: a compact boot path, machine-readable registry, documented contracts, runtime declarations, structured outputs, reusable scripts, and thin adapters for different harnesses. Public capability definitions are kept separate from private configuration, credentials, logs, and runs.

Josiah identified the repeated failure mode, commissioned the capability layer, refined it through real use, and established portability and privacy requirements.

The workbench has been useful in multiple workflows, most concretely as the repeatable path for turning YouTube material into structured inputs.

## What the project means now

The workbench advances a practical theory of agent productivity. Reliability compounds when a successful procedure becomes an inspectable tool that another model can find and invoke, rather than remaining an anecdote buried in one conversation.

Not every tool is portable or current, and private configuration, logs, credentials, and automation history are never part of the public artifact.

The durable unit of agent productivity is often a documented capability contract, not a clever prompt.

Curate the strongest reusable tools, publish safe examples, and remove stale environment-specific assumptions.

## Publication and interpretation notes

- Current classification: Active
- Portfolio readiness: Draftable
- Publication boundary: Public tooling; private configuration excluded

## Additional agent context

Emphasize the repeatable YouTube-processing use case and the model-agnostic registry. Never expose local secrets, configs, logs, or personal automation history.

## Related project records

- [SkillTube](/projects/skilltube/llm/) — A working utility that turns YouTube material into reusable agent instructions—and a product that lacked a convincing acquisition path.
- [Personal Context Repository](/projects/personal-context-infrastructure/llm/) — A human-owned, agent-readable knowledge system that makes long-running AI collaboration more coherent without surrendering control of the record.

## Navigation

- [Complete project index](/projects/llm/)
- [Human version of this record](/projects/agent-workbench/)
- [About Josiah's working method](/about/llm/)
- [Agent discovery map](/llms.txt)