현재 에이전트 워크플로우를 개선하는 방법
How to improve current agent workflow
핵심 요약
에이전트 워크플로우의 비효율성과 코드 품질 저하 문제를 해결하기 위한 실질적인 개선 방안을 모색합니다.
- 실행 방식 개선 — 한 번에 긴 작업을 수행하는 대신 작은 단위로 나누어 검토하고 진행함.
- 컨텍스트 유지 — 세션마다 새로 시작하지 않고 지속적인 메모리를 활용해 중복 코딩을 방지함.
- 구조적 제어 — 무분별한 도구 추가보다는 명확한 작업 범위 설정과 체크포인트 도입이 중요함.
- 메모리 관리 — 코드 중복과 스파게티 코드를 막기 위해 프로젝트 전체의 아키텍처와 패턴을 기억하는 방식이 필요함.
에이전트/LLM을 사용하는 아이디어를 받아들이는 데 시간이 좀 걸렸지만, 이제는 싸우거나 부정하는 대신 현실을 받아들이기로 했습니다. 그래서 제 워크플로우에 어떻게 녹여내서 뒤처지지 않을지 배우는 게 낫겠다고 생각해요.
현재 저는 opencode를 사용 중이며, 꽤 기본적인 설정(exa 웹 검색, FE 스킬, svelte 스킬 같은 몇 가지 스킬)을 갖추고 있습니다.
하지만 현재 에이전트 엔지니어링 경험은 저격수보다는 산탄총을 쏘는 느낌이 너무 강합니다. 상황이 너무 빨리 통제 불능이 돼요.
제 워크플로우에 필요한 4가지 핵심 영역과 제가 직면한 반복적인 문제들을 정리해 봤습니다.
-
(가장 큰 문제) 실행
Comes down to tighter loop, smaller diffs, more precise execution. Is this purely a prompt issue?
저는 보통 한 번 계획을 세우고 나면 그냥 내버려 둡니다. -
검토
1번과 연결되지만, 현재 자동화된 검토 프로세스가 없습니다. 프로젝트가 커질수록 LOC(코드 라인 수)가 기하급수적으로 증가해서 결국 모든 게 스파게티 코드가 된다는 걸 알게 됐습니다. 처음에는 diff를 따라가기 쉽지만, 결국 모든 기능이 5천 줄의 변경 사항으로 변해버리죠. 코드 중복, 에러 메시지를 처리하기 위한 10개의 약간씩 다른 함수들, 재사용되지 않는 기존 컴포넌트들 때문인데... 이게 에이전트가 실행되기 전의 문제일까요, 후의 문제일까요? -
코드 검색 및 메모리
아마 이 부분이 가장 큰 변화를 가져올 것이고 앞선 문제를 설명할 수 있을 것 같습니다. 저는 보통 기능 하나당 새로운 세션을 시작하는데, 이게 컨텍스트 부족과 비대해짐/반복의 원인일 수 있습니다. 에이전트는 모든 것을 다시 읽고 다시 배워야 하는데, 큰 프로젝트에서는 그냥 읽는 걸 건너뛰고 처음부터 다시 코딩하는 걸 선호하는 것 같아요.
Beyond just an architecture.md, what’s the current standard for project memory + code search. -
오래된 문서
예전에는 context7을 썼는데 사람들이 떠나는 걸 보고 지금은 그냥 web search mcp를 사용합니다. 한동안 이쪽을 안 봤는데, 사람들이 사용하는 더 새롭고 좋은 표준이나 도구가 있나요?
이 문제 대부분이 더 나은 프롬프트나 스킬 문제로 개선될 수 있다는 건 알지만, 좋은 가이드라인을 제공하는 특정 도구에도 관심이 있습니다. 이 모든 걸 마크다운 파일 시리즈로 해결할 수 있을까요?
이미 이 분야를 깊게 파고든 분들께 묻습니다.
어떤 설정이 품질을 가장 크게 개선했나요?
(어떤 하네스를 사용 중인지도 함께 알려주세요.)
도구에 100만 토큰을 쓰지 않으면서도 이런 기능들을 잘 수행하는 아주 최소한의 설정을 원합니다. 5개의 다른 하위 트리에서 작업하는 10개의 하위 에이전트는 필요 없어요. 그냥 제가 통제하고 있다는 느낌을 주는 것이면 충분합니다.
팁 주시면 감사하겠습니다! 감사합니다.
