Agentic Coding이란? 기본 개념 확인 및 실전 워크플로우 수칙에 대해 알아보기
2026년 3월 12일Agentic Coding이란 무엇인지? 각 개념을 어떤 경우에 사용할 것인지에 대해 알아봅니다.
나는 코딩을 통해 문제를 해결하는 것을 좋아한다. 하지만 우리 모두는 어떤 문제를 만족스럽게 해결할 만한 시간이 많지 않다는 것도 알고 있다. 그 점에서 이번 프로젝트는 SI에서 Nextjs 첫 프로젝트 반성 및 후기 로 다이어그램을 각 task로 쪼갠 뒤 실제 구현을 맡기고 내가 직접 확인하는 것이었다. 결과는 훌륭했다. 여러 다른 작업들을 병행하면서도 나에게 주어진 작업 역시 끝마칠 수 있었다.
그래서 Agentic 코딩, 정확히는 Claude code로 내가 정확히 무엇을 할 수 있는지 알아보기로 했다. 물론 내가 Agentic coding의 전문가는 아니므로 아직도 각종 용어들 - Tools, MCP Servers, Commands, Subagents 등에 익숙한 것은 아니고 AI slop을 직접 지우거나 환각을 보는 문제를 직접 구현하는 등의 일이 있었지만 점점 나에게 최적화된, 효율적인 워크플로우에 다가가고 있다고 생각한다.
가장 중요한 것은, 이 과정에서 실제로 흥미를 느낀다는 점이다. 그래서 이 블로그 포스트를 쓰고 유지하며 헷갈릴 수 있는 컨셉들을 정리해보려고 생각한다. Agentic coding basic concepts의 관점을 따라 여기서는 세 가지 레이어로 Foundation(agents, models, tools), Extensions(skills, commands, hooks), Integrations(MCP, plugins) 로 나누어서 정리해 보려고 한다.
다른 agentic tool 역시 용어는 다르지만 비슷한 컨셉을 사용하므로 충분히 재사용 할 수 있을 거라고 생각한다.
Foundations
Agentic Coding
AI-assisted coding과 다르게 독립된 역할을 수행하는 AI Agents들이 설계, 코딩, 테스트, 피드백 과정을 수행하고 인간의 개입을 최소화 한다.
Agents
유저가 제공하는 Context를 통해 독립적으로 결정을 내리고 필요한 작업을 수행함. Agentic loop을 통해 주어진 태스크에 필요한 작업을 반복적으로 실시하고 이 과정에서 필요한 권한을 통한 tool 사용을 통해 복잡한 작업을 수행하는데 최적화 되어있음.
Agent loop는 컨텍스트를 이해하고, 작업을 수행하며, 결과를 확인하는 단계로 실행 됨.
Models
에이전트의 under the hood에서 작동하는 LLM. 코드를 이해하고, 테스크 단위로 쪼개 실제로 실행하는 역할을 함.
Tools
에이전트가 태스크를 수행하기 위한 툴. 파일 시스템, 웹 서치, 쉘 커맨드 등을 통해 태스크를 수행하기 위한 필수적인 도구들. 빌트인 툴이 있고 Skill이나 MCP Subagent라는 이름으로 커스텀한 툴을 만들어 줄 수 있음.
Extensions
주어진 빌트인들 외에 어떠한 특정한 작업을 수행하거나 능력을 확장하기 위해 유저가 만드는 레이어.
CLAUDE.md (공용 용어로는 AGENTS.md)
프로젝트 단위나 그 상위 전역 단위에서 에이전트에게 지속되는 지시를 내리기 위한 컨텍스트 파일. official claude code
Commands
/{commands}를 통해 특정한 빌트인 에이전트를 실행하거나 /usage, /clear, /help, 특정한 커스텀 스킬을 로드할 수 있음.
Skills
현재 세션 전체에서 사용되는 지시사항과 워크플로우를 로드하는 파일. Skill은 에이전트가 직접 실행하는 Python, JS, Bash 등 어떤 언어로든 실행 가능한 스크립트를 포함할 수 있으며, 이 실행 결과를 에이전트가 참조해서 태스크를 수행할 수 있다. AGENTS.md는 세션의 시작 시, skill은 에이전트나 유저가 on-demand로 로드한다. Skill은 /explain-code와 같은 슬래시 커맨드로 명시적으로 호출하거나, "이 코드를 설명해줘"처럼 컨텍스트에 따라 자동으로 호출될 수 있다.
Claude에서 Skill은 세 가지 레벨로 로드된다:
- 메타데이터: 시작 시 로드되어 시스템 프롬프트에 포함됨
- 지시사항(SKILL.md): 트리거될 때 로드됨 (모델이 자동으로, 또는 유저가 수동으로)
- 참조(references): 참조될 때만 로드됨
Subagents
독립된 워커 프로세스로 메인 컨텍스트와 분리되어 해당 시점의 컨텍스트를 참조해 자체적인 컨텍스트를 가지고 실행 결과를 요약해서 제공함.
Hooks
워크플로우 자동화를 위한 라이프사이클 이벤트. git hooks와 비슷함.
Integrations
MCP
에이전트가 외부 툴 및 데이터 소스에 접근하기 위한 표준. 여러 종류의 mcp를 만들거나 추가해 에이전트가 데이터베이스에 접근하거나 git에서 액션을 수행하거나 등을 할 수 있다.
Plugins
위 여러 개념들을 한 가지 패키지로 포장해서 deploy 받을 수 있는 개념.
어떻게 워크플로우를 만들 것인가?
- foundation과 빌트인들이 무엇을 할 수 있는지? 무엇에 약한지를 파악하기
- CLAUDE.md와 AGENTS.md에 프로젝트의 특징과 패턴을 기록하기.
- 반복적인 작업에 Skill을 사용하기: 코드 리뷰 패턴, docs 생성, 테스팅...
- 자동화가 필요한 경우 Hook을 사용하기
- 외부 api 연결이나 데이터페이스 연결이 필요한 경우 MCP를 사용하기
- 작업이 복잡하고 메인 컨텍스트를 오염시킬 위험이 있다면 subagent를 사용하기
- 워크플로우를 plugin으로 만들어서 관리하기.
결론
Claude code를 끼얹어 보는 개발 - multistep form 에서 이미 Agentic coding을 경험해 보았다고 생각했지만, 가장 중요한 것은 나에게 맞는 워크플로우를 만들어 적용하는 일이라고 생각한다.