Community guides.

Practical guidance from people operating, extending, and contributing to Agent Barn.

How Agent Barn Fits Together

A map of the API, web app, agent runtimes, deployment stack, and the boundaries between them.

Create, Configure, and Run an Agent

Understand agent creation, lifecycle states, configuration updates, safe restarts, and deletion behavior.

Templates, Versions, Overrides, and Skills

Work safely with global templates, organization forks, Agent overrides, immutable versions, and required Skills.

Connect Integrations and Credentials Safely

Choose provider credentials, shared credentials, OAuth access, and least-privilege runtime materialization.

Identity, Organizations, and Tenant Boundaries

Understand login, invitations, organization membership, tenancy, Platform View, and organization switching.

Roles, Permissions, and Agent Access

Use Organization Roles, Agent Access Roles, explicit assignments, and General Access without leaking resources.

Activity, Conversations, and Runtime Telemetry

Understand how runtime messages and tool calls reach the Activity UI and remain scoped to accessible Agents.

Costs and Spend Attribution

Read organization and Agent spend correctly, including attribution, access checks, status labels, and deleted history.

Platform Administration and Oversight

Use Platform View for bounded user, Organization, activity, privilege, and Event Delivery oversight.

API Architecture and Request Boundaries

Follow the route, service, repository, tenancy, transaction, migration, and dependency-injection conventions.

Web App Architecture and Data Flow

Build App Router pages, provider boundaries, schemas, queries, mutations, loading states, and tests consistently.

Runtime Assembly and Deployment

Trace Agent startup, runtime builders, Kubernetes resources, environment isolation, deployments, and monitoring.

Domain Events, Outbox, and Delivery

Add typed business events, transactional Outbox Messages, Event Deliveries, handlers, and safe monitoring.

Backend Code Standards

Apply repository-wide layering, HTTP, schema, authorization, style, review, and definition-of-done rules.

Testing and Verification

Select API, UI, runtime, migration, Kubernetes, and documentation checks that prove the changed contract.

Local Development, Operations, and Releases

Install dependencies, run services, migrate data, deploy safely, operate staging, send email, and monitor the stack.

Coordinate a Multi-PR Epic

Keep cross-ticket delivery state accurate without replacing feature docs, ADRs, or the issue tracker.

Write and Maintain Architecture Decisions

Capture hard-to-reverse technical choices, their trade-offs, consequences, and later supersession.