처음부터 만드는 기본 AI 에이전트: 긴 작업 계획 세우기

Who Should Read

코딩 에이전트에게 긴 작업을 맡기며 계획·todo 도구를 넣을지 고민하는 개발자

Core Mechanics

• 원문 본문은 제공되지 않았다
  • 제목은 '긴 작업 계획(Long Task Planning)'을 다루는 에이전트 튜토리얼임을 알려준다.
  • 본문 내용은 확인할 수 없어 구체적 방법과 수치는 쓰지 않는다.

Community Reactions

• 계획 도구보다 텍스트 계획이 낫더라는 경험
  • AGENTS.md, ./dev/ 계획 파일, todo 도구, sqlite 추적 등 대부분을 써 봤지만 어느 것도 값어치가 없었다는 경험이다.
  • 1년 전엔 모델에 계획을 계속 상기시켜야 했지만 지금은 텍스트만으로 계획을 따라간다고 한다.
• 복잡도별 4단계 운용 방식
  • 그냥 시키기, 계획 세우고 실행하기가 기본 단계다.
  • 계획을 파일로 쓰고 서브에이전트가 검토한 뒤 실행하는 단계가 그다음이다.
  • 감독(supervise) 모드에서 서브에이전트가 phase를 구현하고 handoff.md로 넘기는 방식이 마지막이다.
• scratch pad와 todo 효과를 묻는 의견
  • 같은 데이터가 이미 컨텍스트에 있는데 scratch pad가 왜 필요한지 묻는 의견이 있었다.
  • 최신 모델에선 todo 효과가 줄었을 수 있고 수치로 보고 싶다는 의견이다.
• 튜토리얼 코드가 스크립트 수준이라는 비판에 대한 반론
  • 실제 설계엔 경계, 정책, 에러 처리 지식이 필요해 블로그에선 짧은 실행 스크립트로 단순화할 수밖에 없다는 의견이다.

How to Apply

• 작업 전에 계획 먼저 쓰게 하기
  • 오늘 쓰는 에이전트 시스템 프롬프트에 '작업 전에 계획을 먼저 쓰고 실행하라'는 한 줄을 넣어라.
  • 별도 계획 도구 없이 이 한 줄만으로 결과가 달라지는지 비교하라.
• 계획을 파일로 저장하고 리뷰시키기
  • 복잡한 작업은 계획을 파일에 쓰게 하고 서브에이전트에게 검토시킨 뒤 실행시켜라.
• 긴 작업엔 handoff.md 넘기기
  • 컨텍스트가 길어지는 작업은 phase별로 서브에이전트에 맡기고 handoff.md로 인수인계시켜라.
  • 자주 쓰는 프롬프트는 단축키로 바로 넣게 저장해 둬라.

Try It

# Claude Code나 ChatGPT에 붙여넣기 (댓글 속 운용 방식의 간이 버전)

다음 작업을 진행해줘: {{작업 설명}}

1. 먼저 plan.md에 단계별 계획을 작성해.
2. 서브에이전트(또는 별도 검토 단계)가 plan.md를 검토해 문제점을 알려줘.
3. 검토 반영 후 단계별로 구현해.
4. 컨텍스트가 길어지면 handoff.md에 진행 상황과 남은 일을 적고 이어가.

Terminology

관련 논문

• 모델이 그렇게 좋다면 OpenAI는 왜 회사 100개를 직접 안 차릴까

  HN 댓글 답: 코드는 쉬워도 뭘 만들지 아는 건 별개라 토큰을 판다

• OpenShell: 자율 AI 에이전트를 가두는 NVIDIA의 안전한 샌드박스 런타임

  정책 파일로 에이전트의 파일·네트워크·자격증명 접근을 커널 수준에서 통제한다

• Omnara: Claude Managed Agents의 오픈소스 대안 (셀프호스팅 가능)

  어떤 모델·머신에서도 에이전트를 돌리는 오픈소스 managed agent 플랫폼

• Rust off Rails: 코드 없이 Markdown 60개로 만든 AI 에이전트용 웹 스택

  Markdown 규칙 60개로 에이전트가 Rust 웹앱을 짜게 한다는 프레임워크

• LayerFS: AI 코딩 에이전트를 위한 파일시스템

  에이전트마다 임시 Workspace를 마운트하고 결과만 커밋하는 파일시스템

• Launch HN: Alter (YC S25) – 멀티유저 에이전트용 접근 제어

  에이전트마다 별도 신원·정책·감사로 API 키 공유 문제를 푼다

• Claude로 코드의 공격 표면(attack surface) 줄이기

  Claude로 25개 오픈소스를 분석해 불필요하게 열린 코드 493건을 찾았다

• WhatsApp 도움말 페이지에 숨겨진 LLM 지시문: 규제기관을 추천하지 말라

  WhatsApp 도움말에 화면엔 안 보이는 AI 지시문 102개가 숨어 있었다

Related Resources

• https://medium.com/@rogi23696/build-a-basic-ai-agent-from-scratch-long-task-planning-14e803f9bd6d