Molayo

© 2026 Molayo

GitHub요약2026. 05. 20. 04:14

giraffe-tree/agent-base

요약

이 저장소는 다양한 Code Agent의 소스 코드를 심층 분석하여 아키텍처적 트레이드오프를 이해하도록 돕는 학습 리소스입니다. Agent Loop의 작동 원리부터 Safety, Memory, MCP 등 핵심 엔지니어링 요소들을 여러 프로젝트와 비교 분석하여 제공합니다.

핵심 포인트

  • Agent Loop의 핵심 과정(추론, 도구 호출, 피드백, 재추론)에 대한 심층 이해 제공
  • Codex, Claude Code, SWE-agent 등 주요 프로젝트의 아키텍처 비교 분석
  • Safety, Memory, MCP, Checkpoint 등 엔지니어링적 트레이드오프 사례 연구
  • 자신만의 Agent 시스템 설계 및 개조를 위한 재사용 가능한 참고 자료 역할

“Agent를 사용할 줄 아는 단계”에서 “Agent 아키텍처의 트레이드오프(Trade-off)를 이해하는 단계”로.

본 저장소는 여러 종류의 Code Agent에 대한 **소스 코드 수준의 해체 + 가로 비교(横向对比)**를 다루며, 핵심 목표는 다음과 같습니다:

  • Agent Loop가 어떻게 “추론(Reasoning) -> 도구 호출(Tool Calling) -> 피드백(Feedback) -> 재추론(Re-reasoning)”을 구동하는지 이해
  • 다양한 프로젝트가 Safety, Memory, MCP, Checkpoint 등의 문제에서 어떠한 엔지니어링적 트레이드오프(Trade-off)를 선택했는지 이해
  • 자신만의 Agent 시스템을 설계하거나 개조할 때 재사용 가능한 참고 자료 제공

💡

읽기 권장 사항: Codex부터 시작하세요 (문서가 가장 완전함). 그 후 관심사에 따라 선택하시기 바랍니다. 각 프로젝트는 독특한 아키텍처의 강점을 가지고 있습니다.

|
| 📄 개요 · Agent Loop · Memory |
|
| 📄 개요 · 루프 · Checkpoint |
|
|
|
|

2026-03-31 기준, docs/ 디렉토리의 총 문서 수는 177편입니다:

  • 메인 기술 문서: 118편
  • Questions 특집 문서: 59편
카테고리디렉토리내용
핵심 프로젝트 (7)codex / gemini-cli / kimi-cli / opencode / swe-agent / qwen-code / claude-code각 프로젝트를 통일된 번호 체계(01~13)에 따라 해체
프로젝트 간 비교comm공통 추상화, 아키텍처 비교, ACP, Plan & Execute, 향후 방향
보충 특집cursor / claudeCursor Checkpoint 저장 분석, Claude 메시지 컨텍스트 유지 메커니즘

대부분의 프로젝트는 가로 비교를 용이하게 하기 위해 다음과 같은 메인 라인을 따라 구성되어 있습니다:

번호주제commcodexgemini-clikimi-cliopencodeswe-agentqwen-codeclaude-code
01개요linklinklinklinklinklinklinklink
02CLI 엔트리 / 세션(Session) 관리linklinklinklinklinklinklinklink
03세션(Session) 런타임linklinklinklinklinklinklinklink
04Agent Looplinklinklinklinklinklinklinklink
05도구(Tools) 시스템linklinklinklinklinklinklinklink
06MCP 통합linklinklinklinklinklinklinklink
07메모리 컨텍스트(Memory Context)linklinklinklinklinklinklinklink
08UI 상호작용linklinklinklinklinklinklinklink
09웹 서버(Web Server)linklinklinklinklinklinklinklink
10안전 제어(Safety Control)linklinklinklinklinklinklinklink
11프롬프트(Prompt) 조직-linklinklinklinklinklinklink
12로그 기록 메커니즘linklinklinklinklinklinklinklink
13ACP 통합linklinklinklinklinklinklinklink
디렉토리메인 문서Questions빠른 진입점
comm152개요 / Agent Loop 비교 / ACP란 무엇인가 / ACP 프로젝트 간 비교 / Plan and Execute 비교
...

전체 디렉토리 탐색은 다음을 참조하세요:

_sidebar.md

주제문서 진입점
Tool 병렬 호출 (Tool Concurrency)Codex / Gemini CLI / Kimi CLI / OpenCode / SWE-agent / Claude Code
...
  • 체크포인트 (Checkpoint):
    kimi-cli

/opencode

/swe-agent

/cursor

  • 추론 유지 및 컨텍스트 (Reasoning Preservation & Context):
    gemini-cli

/kimi-cli

/opencode

/swe-agent

/claude

  • 미래 트렌드 (Future Trends):
    제1원리 (First Principles) 관점에서 본 Coding Agent의 미래 돌파구

소스 코드를 대조하며 읽으려면:

git clone https://github.com/openai/codex.git
git clone https://github.com/google-gemini/gemini-cli.git
git clone https://github.com/MoonshotAI/kimi-cli.git
...

시간: 2026-02-22
출처: 각 프로젝트 GitHub 당시 최신 브랜치
방법: 소스 코드 읽기 + 핵심 프로세스 도해 + 프로젝트 간 비교

Issue / PR 제출을 환영합니다:

  • 문서 내 사실 관계 오류 또는 경로 만료 수정
  • 새로운 Questions 특집 추가 (기존 명명 스타일 준수 권장)
  • template/ 하위의 템플릿을 재사용하여 아직 다뤄지지 않은 분석 차원 보완

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0