Let's say a small team has given an AI coding tool permission to view GitHub issues, search logs, run tests, and summarize PRs. At first, productivity goes up. This is because it reads the issue, finds related files, runs tests, and even organizes PR descriptions.
But soon new questions arise. You need to decide which logs the AI can read, how much it can auto-correct after a test failure, whether it should stop when creating a migration, and whether it can include internal error information in the PR summary.
At this moment, the development environment is not just an IDE. We get closer to agent runtime, where AI reads context, calls tools, stops at permission boundaries, and leaves execution history and artifacts.
When you think of a development environment, you usually think of an IDE. Tools like VS Code, IntelliJ, WebStorm, and Cursor. This includes terminal, Git, package manager, browser, DB client, and deployment tool.
The center of the existing development environment was people. A human read the code in the IDE, ran commands in the terminal, interpreted the logs, hit the deploy button, and wrote the PR. The coming of AI coding tools shakes up this premise.
MCP is a protocol that allows LLM applications to connect external data and tools in a standardized way. A2A is an open standard designed to enable different AI agent systems to collaborate using a common communication model.
These are the facts that can be confirmed in the official specifications. The interpretation of this article is not to say that MCP and A2A themselves are complete development platforms, but rather to view them as a signal that the development environment is expanding from a bundle of IDE functions to designing an agent execution environment.
| standard | detail |
|---|---|
| Analysis base date | 2026-05-10 |
| Key references | Model Context Protocol Specification, A2A Protocol Specification, OpenAI Agents SDK |
| purpose of writing | Understanding the following structure of AI development tools from a system design perspective |
| key questions | How tool connectivity and multi-agent collaboration change the development environment |
Key takeaways
- MCP is a standardized way to connect LLM applications and external data and tools, with Resources, Prompts, and Tools as key components.
- MCP Prompts explains the structure in which the server provides a prompt template, and the client discovers it and uses it as a user-directed command.
- A2A specification is an open standard for communication and interoperability between independent AI agent systems, and uses concepts such as Agent Card, Task, Message, and Artifact.
- OpenAI Agents SDK Tracing, Guardrails, and Human-in-the-loop show that the agent runtime must include observation, acknowledgment, and verification structures.
- In the future, the development environment is likely to move from a structure where people do everything directly in the IDE to a structure where people design and supervise the agent runtime.
Limitations of IDE-centric development environments
Existing IDEs are a good environment for people to write code. Provides autocompletion, search, refactoring, debugging, test execution, and Git integration. However, the basic premise is still “people-centered.”
This premise is shaken when AI coding tools come in. AI does more than just autocomplete. Explore your code base, modify files, run tests, fix errors, and summarize the results.
[Claude Code official document] (https://code.claude.com/docs/en/best-practices) also describes Claude Code as an agentic coding environment, and explains that when the user explains what they want, Claude explores, plans, and implements it.
Now the development environment must ask these questions:
What files can AI read?What tools can AI invoke?What commands can AI execute?Where do the results created by AI remain as artifacts?How are AI decisions and tool calls traced?At what point should a person sign off?
This question is not sufficiently addressed by IDE features alone. So the necessary concept is agent runtime.
What is agent runtime?
agent runtime is the execution environment required for AI to perform tasks. It's not just code that calls the model API.
agent runtime =Model+ Context+ Tools+ Permissions+ Guardrails+ State+ Tracing+ Artifacts+ Human Approval
Compared to the existing development environment, it is like this.
| division | IDE-centric development | agent runtime-centered development |
|---|---|---|
| main executor | person | Human + AI agent |
| context | read by people | AI reads selectively |
| run tool | Person clicks/executes command | AI tool call |
| authority | By person account | Permission required for each agent |
| verification | human test run | AI execution + human approval |
| record | Git/PR focused | Add trace, tool log, artifact |
| output | code change | code + report + evidence |
agent runtime is “an operating environment that enables AI to do development work.” From this perspective, MCP and A2A are important.
MCP: A standard that connects tools and context
MCP stands for Model Context Protocol. The official specification describes MCP as an open protocol for integrating LLM applications with external data sources and tools.
To put it simply, MCP from a developer's perspective is like this.
Instead of attaching external tools to AI tools in different ways each time,Let's provide context and tools with a common standard.
For example, let's say your AI coding tool needs to use:
GitHub IssueJira Ticketproject documentationDB schemaLog Searchrun testcode searchdeployment status
It would be complicated to attach each tool separately. MCP provides a structure to expose these things in a defined manner between the LLM client and server.
MCP Resources, Prompts, Tools
When looking at MCP from a development workflow perspective, there are three key points:
| MCP Components | meaning | Development workflow example |
|---|---|---|
| Resources | Context and data for AI to reference | README, API schema, logs, issues |
| Prompts | User-selectable task templates | Request code reviews, create tests, summarize PRs |
| Tools | Functions that AI can execute | Search files, run tests, view issues |
Resources
This layer handles the context that AI can read. It's closer to the concept of exposing the necessary data in a structured way, rather than just throwing in the entire code base.
resource://project/architectureresource://project/api-schemaresource://logs/recent-errorsresource://issues/current-sprintresource://docs/coding-convention
Prompts
[MCP's prompt function] (https://modelcontextprotocol.io/specification/2025-11-25/server/prompts) explains the structure in which the server exposes the prompt template to the client and allows the client to discover it and use it by entering arguments.
The development team can use it this way.
/review-api-change/write-regression-test/analyze-prod-log/summarize-pr/refactor-component
Importantly, these commands are not simple prompts but can be tied to your team's work rules.
Tools
The last layer is the functions that the AI can execute.
search_code()read_file()run_tests()query_logs()create_pr_summary()get_issue()
When applied, adding an MCP is about increasing productivity and at the same time designing permissions. Because tools can be external system access or code execution paths, user consent, data privacy, and tool safety must be addressed together.
A2A: Agent-to-Agent Collaboration Protocol
If MCP is closer to connecting AI and tools, A2A is closer to connecting AI to AI.
A2A official specification describes the A2A Protocol as an open standard for communication and interoperability between AI agent systems that are independent and whose internals may be opaque. It also explains that it helps agents securely exchange information to achieve user goals without accessing each other's internal state, memory, or tools.
The core concepts of A2A are:
| concept | meaning |
|---|---|
| Agent Card | Metadata that describes the agent's capabilities, endpoints, and permission requirements. |
| Message | Unit of communication between client and agent |
| Task | A stateful unit of work processed by an agent. |
| Artifact | Output generated as a result of a task |
| Part | Minimum unit of content within a message or artifact |
If you change it to a development workflow, you can see it like this.
- Planner Agent
- Coder Agent
component artifact - Test Agent
test report artifact - Reviewer Agent
review artifact - Release Agent
release note artifact
The reason A2A is important is because in the future, AI work is unlikely to be completed within a single agent.
Core components of agent runtime
If you view the agent runtime as a development environment, you will need the following components:
| component | role |
|---|---|
| Context Manager | Select documents, codes, and logs to give to AI |
| Tool Gateway | Manage which tools AI will call |
| Permission Layer | File/command/external API permission restrictions |
| Guardrail Engine | Blocking dangerous input/output/tool calls |
| State Store | Work status, session, task management |
| Trace Store | Save LLM call, tool call, and approval records |
| Artifact Store | Save output, reports and test results |
| Human Approval UI | Provides human approval/rejection points |
OpenAI Agents SDK Tracing explains that it records LLM generation, tool call, handoff, guardrail, custom event, etc. during agent run. The human-in-the-loop document describes a structure in which run stops when a tool call requests approval and resumes after a person approves or rejects the pending approval.
You can't debug without Trace.Without approval, dangerous execution cannot be prevented.Results cannot be verified without artifacts.
How is the development workflow changing?
The existing development workflow was roughly like this.
Check requirementsto write codeto testto reviewto distribution
When AI agent runtime comes in, the flow changes.
Requirements Agreementto Configure Contextto agent work planto call toolto change codeto automatic verificationto submit evidenceto person approval→ PR merge
| step | Conventional method | agent runtime method |
|---|---|---|
| Requirements | people read and understand | Structured as a work contract |
| Code navigation | person search | Agent explores context |
| avatar | written by person | Agent edits, person reviews |
| test | person running | Run agent + submit results |
| review | Has anyone checked the diff | Check diff + evidence + trace |
| distribution | person running | Execute after approval gate |
The human role does not disappear. You go from being a hands-on implementer to a designer and approver of a work system.
Practical architecture example
Here's a simple agent runtime structure that your team can apply right away:
AI_GUIDE · TASK_CONTRACT · Docs · Logs
Code Search · Test Runner · Issue · Log Query
Allow read/test · Permit write · Block secret/deploy
secret check · dangerous command check · output validation
tool calls · approvals · failures
code diff · VERIFY_REPORT · PR summary
You don't have to build it as a platform from scratch. Initially, you can start with documents and PR templates.
AI_GUIDE.mdTASK_CONTRACT.mdVERIFY_REPORT.mdPR_TEMPLATE.md
Then, in the application step, attach the MCP server, add an acceptance gate, and save the trace.
Starting with at least agent runtime
At a minimum, the agent runtime can be launched with three files, three commands, and three authorization rules rather than a separate platform.
| composition | minimum standards | reason |
|---|---|---|
| file | AI_GUIDE.md,TASK_CONTRACT.md,VERIFY_REPORT.md | Separate context, scope of work, and evidence of completion. |
| command | lint,typecheck,test | Leave evidence of execution before the AI says “done.” |
| Approval Rules | Dependency change, migration, deployment commands | Stop actions that are difficult to reverse or may have operational impacts. |
To put it into perspective, the following is the first step.
minimum_agent_runtime:context:required_files:- AI_GUIDE.md- TASK_CONTRACT.mdtools:allow:- npm run lint- npm run typecheck- npm testrequire_approval:- npm install- npm run db:migrate- npm run deployevidence:required_artifacts:- VERIFY_REPORT.md- PR summary
This alone transforms AI tasks from spontaneous execution in a conversation window to reviewable runtime events.
Security and permission risks
agent runtime is powerful. Being powerful also means being dangerous.
Risks to watch out for are as follows:
| risk | explanation | react |
|---|---|---|
| Secret exposure | .env, token, key access | deny path, secret scanner |
| Execute critical command | Deletion, distribution, migration | approval gate |
| Providing too much context | Unnecessary data exposure | context minimization |
| Invalid tool description | Inconsistency between description and what the tool actually does | Only trusted servers are allowed |
| Save trace sensitive information | Contain confidential information in logs and traces | masking, retention policy |
| Information propagation between agents | Passing sensitive information to another agent | task scope limit |
When designing an agent runtime, a security layer must be included from the beginning.
Design permissions before connecting tools.Create approval conditions before opening permissions.Define prohibited areas before creating approval conditions.
Application roadmap
Step 1: Document-Based Runtime
Initially, a document-based runtime may be sufficient to create a boundary.
AI_GUIDE.mdTASK_CONTRACT.mdVERIFY_REPORT.mdPR_TEMPLATE.md
The goal is to transform AI work from ad hoc tasks in a chat window to reviewable units of work.
Step 2: Limit tools
The tools are then divided by risk.
allowance:- Read files- Code search- lint- typecheck- unit test Approval required:- Edit files- change dependency- Create migration prohibition:- secret access- production distribution- Change DB directly
Step 3: MCP introduction
Separates recurring tool connections to the MCP server.
docs serverissue serverlog servertest servercode search server
At this time, approval conditions for each tool are also designed.
Step 4: Save Trace
The minimum records that should be stored are:
context usedtool calledcommand failedgenerated diffIs it human approved?Verification results
Step 5: Multi-Agent Collaboration
Dividing roles allows for clearer boundaries between tasks and artifacts between agents.
Planner AgentCoder AgentTest AgentReviewer AgentRelease Note Agent
From this stage, concepts like A2A become important. A2A proposes a direction for agents to perform capability discovery, modality negotiation, and collaborative task management without accessing each other's internal tools or memories.
checklist
When designing an agent runtime, check the items below in order:
[ ] Defined the context range that AI can read.[ ] Files and data that AI should not read are defined.[ ] There is a list of tools that AI can call.[ ] The permission level for each tool is defined.[ ] Commands that can be executed without approval are divided into commands that require approval.[ ] Secret, production, and DB changes are blocked by default.[ ] There is a way to record the status of AI tasks.[ ] You can track AI tool calls and failure records.[ ] The results of the work remain as artifacts.[ ] You can check the evidence in PR.[ ] During multi-agent collaboration, task and artifact boundaries are defined.
finish
MCP and A2A are not simply new AI technology keywords.
MCP is a trend that seeks to standardize how AI handles external tools and context. A2A is a trend that seeks to standardize the way AI agents discover each other, exchange tasks, create artifacts, and collaborate.
The directions these two currents point in are clear. A development environment is no longer defined solely by the IDE.
| bundle | Contains elements |
|---|---|
| user work surface | IDE, CLI |
| agent execution side | LLM, MCP Server, Tool Gateway |
| hierarchy of control | Permission Layer, Guardrails, Human Approval |
| observation layer | Trace Store, Artifact Store |
| collaboration layer | A2A Agent Network |
What ties it all together is agent runtime.
Past development environment:A person writes code in an IDE. Current development environment:Humans edit code together with AI. The following development environments:A person designs and supervises the agent runtime.
Developers now need to design not only their code, but also how AI handles the code.
summary card
The essence of this article can be condensed into an execution perspective as follows.
One line summary:After MCP and A2A, the development environment moves to focus on agent runtime rather than IDE. Key concepts:MCP Resources, Prompts, Tools / A2A Agent Card, Task, Message, Artifact Biggest risks:Connect tools first and think about permissions, approvals, and traces later. What to do right now:Separate the list of tools that AI can call from the list of tools that require approval.
댓글
GitHub 계정으로 로그인하면 댓글을 남길 수 있습니다. 댓글은 GitHub Discussions를 통해 운영됩니다.