Agent Apps — Specification
The complete technical reference for Agent Apps. Each section is a standalone document.
| Section | Description |
|---|---|
| Overview | Abstract, naming conventions, definitions |
| Conventions | Directory structure, import rules, module boundaries, skill design conventions |
| Patterns | Glob patterns, path expressions, $-prefix convention |
| Tools | Tool interface, metadata, argument passing, tool formats |
| Resolution | Tool resolution, caching, programmatic tools, search path |
| Context | The context object, manager methods, target, serialization |
| Orchestration | Invocation model, middleware chain, execution flow, error handling |
| Pipeline | The standard pipeline, default.skill.md, phase sentinels |
| Configuration | Cascade, authority, public/private, merge strategies, string interpolation, paths |
| Bootstrap | The one builtin |
| Agent | Agent architecture, code execution, tool discovery, persistent mode, providers |
| Events & Hooks | Event bus, hooks API, debug, profile |
| MCP | MCP bridging, elicitation |
| CLI | Commands, flags, overrides, environment variables |
| Design & Extensibility | Extensibility, security, design principles, runtime resolution |
See also: Skills Reference · The Hub