RaidGuild Cohort
Back to wiki

Wiki page

Agent-First Design

Agent-first design is an approach to product and workflow design where software experiences account for AI agents as users, intermediaries, or collaborators. It emphasizes structured context, tool affordances, permissions, observability, and human control rather than only screen-based human interaction.

ReviewedConfidence: mediumpublic

Agent-first design is an approach to product and workflow design where software experiences account for AI agents as users, intermediaries, or collaborators. It emphasizes structured context, tool affordances, permissions, observability, and human control rather than only screen-based human interaction.

The term is still emerging. It should not be treated as a settled design discipline with one accepted definition. It is better understood as a practical design question: what changes when an agent, rather than a person clicking through a screen, reads context, selects tools, performs actions, or mediates a user's intent?

Background

Traditional human-computer interaction focuses on how people interact with computer systems. Software-agent concepts describe programs that act on behalf of users or other programs. Current LLM-based agent systems combine pieces of both: they interact with people, call tools, retrieve context, and may coordinate multiple steps across systems.

The fireside session that seeded this page discussed agent-first design in the context of agentic companions and trusted agents that mediate between users and external systems. Those examples should remain high-level until public-use permission and product details are verified.

From Human Interfaces To Agent-Mediated Interaction

A screen-based interface assumes a human can see available options, interpret labels, and decide what to do next. An agent-mediated interface must also expose enough structured information for an AI system to understand what actions exist, what context is relevant, and what boundaries apply.

This does not remove the human from the design problem. People still need control, feedback, and calibrated trust. Human-AI interaction guidelines and people-centered AI design remain relevant because the agent's behavior must be understandable and correctable.

Core Design Concerns

Agent-first design usually includes several concerns:

- Context: what information the agent can retrieve and how freshness or authority is represented.

- Tools: what actions the agent can take and how those actions are described.

- Permissions: which actions require approval or are unavailable to the agent.

- State: what the agent remembers during a task and what becomes durable record.

- Feedback: how humans inspect, correct, approve, or interrupt agent behavior.

- Safety: how the system handles malicious instructions, untrusted content, and unintended tool use.

Tool And Context Interfaces

Modern agent frameworks often expose tools, resources, schemas, traces, guardrails, and handoffs. The Model Context Protocol is one example of a standard interface for connecting AI applications to tools, data sources, and workflows. Agent SDKs expose similar design concerns through tools, state, guardrails, and tracing.

These technical interfaces shape product design. If an agent can call a tool, the tool name, input schema, permissions, and error behavior become part of the user experience, even when the user never sees them directly.

Permissions And Guardrails

Agent-first design requires explicit trust boundaries. Some actions can be automated. Others should require review. Guardrails can operate before an agent acts, after an agent produces output, or around tool calls.

Permission design should be specific. It is not enough to say an agent can access a system. The design should specify what the agent can read, what it can write, what requires approval, and how failures are surfaced.

Security Implications

Agentic systems can expand the attack surface of software. Risks include prompt injection, untrusted content influencing actions, excessive permissions, insecure tool use, and hidden state changes. Security references for LLM and agentic applications should inform agent-first design from the beginning rather than being added after a workflow is already live.

Patterns And Examples

Useful patterns include tool manifests, scoped context bundles, approval gates, visible traces, reversible actions, and clear handoffs between human and agent work. In content systems, this can mean designing records, wiki pages, briefs, and artifacts so agents can retrieve them accurately and humans can inspect the path from source to output.

Open Questions

- Is agent-first design best defined as design for agents, design with agents, or design around agent-mediated users?

- Which existing interface patterns are still sufficient, and which need new conventions for agent-readable context and action?

- How should products expose agent behavior to humans without overwhelming them?

Related Topics

- Source Of Truth For Agentic Organizations

- AI Scope Creep And Optimal Stopping

- Agent-Ready Command Surfaces

- Agent-Oriented Developer Workflows

- Multi-Agent Memory

Key Claims

Agent-first design accounts for AI agents as intermediaries, collaborators, or action-taking users.

session source pack; model context protocol intro; openai agents sdk guide

Human-AI interaction guidance remains relevant because humans still need control, feedback, correction, and calibrated trust.

microsoft human ai guidelines; google pair guidebook

Tools, resources, schemas, guardrails, tracing, and handoffs are contemporary implementation surfaces for agent-first systems.

model context protocol intro; mcp tools spec; openai agents sdk guide; openai agents guardrails; openai agents tracing

Agent-first systems require security review around tool use, permissions, and autonomous or semi-autonomous action.

owasp agentic top 10; owasp llm top 10

Source Sessions

Open Questions

  • Should the page define agent-first design as design for agents, with agents, or around agent-mediated users?
  • Which Portal pages should be related topics versus body references?
  • Can the Fuzzy companion be mentioned beyond high-level session context?

Prompts

No prompts have been added yet.

Further Reading

Microsoft Guidelines for Human-AI Interaction

Open link

Anthropic Building Effective AI Agents

Open link

OWASP Top 10 for Agentic Applications

Open link

Papers

No papers have been added yet.

Tools

Model Context Protocol

OpenAI Agents SDK

OpenAI Agents SDK guardrails

OpenAI Agents SDK tracing

Tool schemas

Approval gates

Related Topics

Source Of Truth For Agentic OrganizationsAI Scope Creep And Optimal StoppingAgent-Ready Command SurfacesAgent-Oriented Developer WorkflowsAgent Role OrchestrationMulti-Agent MemoryAI As Production Tool

Possible Topics

No possible topic links have been recorded.

Source Artifacts

No source artifacts have been linked yet.

Related Posts

No related posts have been linked yet.

Related Projects

No related projects have been linked yet.

Related Threads

No related threads have been linked yet.

Related Profiles

No related profiles have been linked yet.

Related Activity

No related activity has been linked yet.