FAQ

REPL Works는 무엇인가?

REPL Works는 인간과 AI의 협업을 위한 프로젝트 메모리 시스템입니다.

REPL Works는 AI에게 더 많은 정보를 주는 시스템이 아닙니다.

오히려 AI가 읽어야 할 정보만 남기는 시스템입니다.

사람은 아이디어, 로드맵, 아키텍처, 작업 목록을 구분해서 읽을 수 있습니다. 하지만 AI는 종종 저장소에 있는 모든 문서를 현재 요구사항으로 해석합니다.

REPL Works는 이 문제를 해결하기 위해 Memory Creation과 Memory Consumption을 분리합니다.

사람은 자유롭게 문서를 작성하고 아이디어를 기록합니다.

AI는 오직 명시적으로 허용된 문서만 읽고 작업합니다.

즉, REPL Works는 AI에게 더 많은 정보를 주는 시스템이 아니라, AI가 읽어야 할 정보만 남기는 시스템입니다.

왜 REPL Works가 필요한가?

AI가 잊어버려도 프로젝트는 잊어버리지 않게 만드는 것.

AI는 짧은 작업은 잘 수행합니다.

하지만 프로젝트가 길어질수록 중요한 세부사항을 잊어버리는 경향이 있습니다.

몇 시간 전에는 정확히 이해하고 있던 설계 결정이나 구현 제약 조건을 놓치고, 존재하지 않는 API를 사용하거나 이미 폐기된 방식을 다시 사용하는 경우가 발생합니다.

그 결과 인간은 AI가 작성한 코드를 점점 더 많이 검토해야 하고, 프로젝트가 커질수록 관리 비용이 증가합니다.

REPL Works는 작업에 필요한 기억을 채팅에만 의존하지 않고 프로젝트 안에 저장합니다.

AI는 바뀔 수 있습니다.

하지만 프로젝트의 기억은 유지되어야 합니다.

REPL Works의 목적은 AI를 더 똑똑하게 만드는 것이 아닙니다.

AI가 잊어버려도 프로젝트는 잊어버리지 않게 만드는 것입니다.

REPL Works는 AI와 어떻게 협업하는가?

REPL Works는 하나의 AI에게 모든 것을 맡기지 않습니다.

REPL Works는 생각(Thinking)과 실행(Execution)을 분리합니다.

Discussion AI는 인간과 함께 아이디어를 검토하고, 요구사항을 정리하고, 아키텍처와 작업 계획을 설계합니다.

Execution AI는 그 결과를 바탕으로 구현을 수행합니다.

예를 들어:

Human
  ↕
ChatGPT

  ↓

IDEAS.md
PITCHING_SCRIPT.md
ARCHITECTURE.md
TASKS.md
  ↓
Codex
  ↓
Implementation
  ↓
Human Review
  ↓
Commit

REPL Works는 AI에게 개발을 맡기는 시스템이 아닙니다.

인간과 AI가 함께 생각하고, AI가 구현할 수 있도록 프로젝트의 기억을 관리하는 시스템입니다.

왜 채팅 대신 문서를 사용하는가?

중요한 것은 대화가 아니라 합의된 결과입니다.

AI와의 채팅은 아이디어를 탐색하고 의논하기 위한 공간입니다.

하지만 채팅은 길어질수록 중요한 내용과 중요하지 않은 내용이 섞이게 됩니다.

REPL Works는 채팅에서 결정된 내용을 프로젝트 문서로 정리합니다.

예를 들어:

ChatGPT와 사업 아이디어 논의
↓
IDEAS.md

ChatGPT와 아키텍처 논의
↓
ARCHITECTURE.md

ChatGPT와 작업 계획 논의
↓
TASKS.md

AI는 채팅 기록을 읽는 것이 아니라 이러한 문서를 읽고 작업합니다.

REPL Works의 목적은 대화를 보존하는 것이 아니라, 대화의 결과를 기억으로 남기는 것입니다.

Agent Framework와 무엇이 다른가?

Agent Framework는 AI의 행동을 관리합니다.

REPL Works는 AI의 기억을 관리합니다.

Agent Framework는 AI가 작업을 수행하는 방법을 정의합니다.

반면 REPL Works는 AI가 어떤 기억을 생성하고 소비할지를 정의합니다.

Agent Framework가 실행(Execution)을 담당한다면, REPL Works는 기억(Memory)을 담당합니다.

둘은 경쟁 관계가 아니라 서로 다른 문제를 해결합니다.

왜 Git이 필요한가?

Commit은 코드 저장이 아니라 인간의 승인 기록이다.

REPL Works에서 코드는 AI가 작성하고 인간은 검토하고 승인합니다.

중요한 것은 누가 코드를 작성했는지가 아니라 누가 변경을 승인했는가입니다.

AI
  ↓
Code Proposal
  ↓
Human Approval
  ↓
Commit

AI는 언제든지 코드를 생성할 수 있습니다.

하지만 프로젝트의 상태는 인간이 승인한 변경만으로 정의됩니다.

Commit은 단순한 저장 작업이 아니라 인간의 승인 기록입니다.

Git은 그 승인을 보존하기 위해 필요합니다.

왜 AGENTS.md가 필요한가?

AGENTS.md는 AI에게 무엇을 해야 하는지 알려주는 문서가 아니라, 무엇을 믿어야 하는지 정의하는 문서입니다.

AI는 저장소에 있는 모든 정보를 잠재적인 요구사항으로 해석할 수 있습니다.

AGENTS.md는 AI가 무엇을 읽어야 하고 무엇을 무시해야 하는지를 정의합니다.

REPL Works에서 AGENTS.md의 역할은 AI에게 더 많은 정보를 제공하는 것이 아닙니다.

오히려 AI가 잘못된 정보를 읽지 못하도록 제한하는 것입니다.

즉, AGENTS.md는 프로젝트 설명서가 아니라 AI가 소비할 기억의 경계를 정의하는 문서입니다.

왜 LONG_CONTEXT.md가 필요한가?

채팅 기록은 사라질 수 있지만, LONG_CONTEXT.md는 기억되어야 할 맥락만 남긴다.

사람은 모든 것을 기억하지 않습니다.

시간이 지나면 세부사항은 잊어버리고 중요한 맥락만 장기기억으로 남깁니다.

LONG_CONTEXT.md는 AI를 위한 장기기억입니다.

프로젝트가 끝나거나 중요한 작업이 완료되면 AI는 장기적으로 유지해야 할 맥락만 LONG_CONTEXT.md에 기록합니다.

예를 들어:

• 왜 중요한 결정을 내렸는가
• 어떤 접근을 선택했고 무엇을 포기했는가
• 프로젝트의 핵심 철학은 무엇인가
• 미래의 AI가 반드시 이해해야 하는 맥락은 무엇인가

LONG_CONTEXT.md는 채팅 기록이 아닙니다.

채팅에서 살아남은 기억입니다.

누가 LONG_CONTEXT.md를 작성하는가?

LONG_CONTEXT.md는 AI가 작성하고 인간이 승인하는 프로젝트의 장기기억입니다.

LONG_CONTEXT.md는 사람이 작성하지 않습니다.

AI가 작성합니다.

AI는 작업 내용과 대화를 바탕으로 미래에도 유지되어야 할 기억을 압축합니다.

사람은 그 결과를 검토하고 승인합니다.

AI Memory와 Chat History는 무엇이 다른가?

Chat History는 대화의 기록이다.

Memory는 기억해야 할 것의 기록이다.

Chat History는 대화의 기록입니다.

하지만 기록이 많다고 해서 기억이 되는 것은 아닙니다.

프로젝트가 길어질수록 채팅에는 실험, 시행착오, 잘못된 가설, 중간 결과가 쌓입니다.

Memory는 중요한 결정, 제약 조건, 설계 원칙, 작업 결과를 정리하고 압축한 것입니다.

즉:

• Chat History = 무엇을 이야기했는가
• Memory = 무엇을 기억해야 하는가

REPL Works는 채팅을 보존하려는 시스템이 아닙니다.

채팅에서 얻은 기억을 보존하려는 시스템입니다.

왜 Markdown을 사용하는가?

기억은 AI에 속하는 것이 아니라 프로젝트에 속한다.

REPL Works에서 기억은 특정 AI나 서비스에 저장되지 않습니다.

기억은 프로젝트에 저장됩니다.

Markdown은 사람이 읽을 수 있고 AI가 읽을 수 있으며 Git으로 관리할 수 있는 가장 단순한 형식입니다.

특별한 데이터베이스나 전용 도구도 필요하지 않습니다.

Markdown을 선택한 이유는 문서 형식 때문이 아니라 기억의 소유권 때문입니다.

AI가 바뀌어도 기억은 유지되는가?

AI는 교체될 수 있지만 프로젝트는 계속된다.

예.

REPL Works에서 기억은 AI가 아니라 프로젝트에 저장됩니다.

Claude로 시작한 프로젝트를 GPT, Gemini, Codex 또는 미래의 다른 AI가 이어받을 수 있습니다.

새로운 AI는 채팅 기록을 알 필요가 없습니다.

프로젝트의 기억을 읽으면 됩니다.

REPL Works는 특정 AI에 종속되는가?

REPL Works는 AI를 위한 시스템이 아니라 프로젝트를 위한 시스템입니다.

아니요.

REPL Works는 특정 AI 모델, 특정 서비스, 특정 Agent Framework에 종속되지 않습니다.

AI는 교체될 수 있습니다.

하지만 프로젝트의 기억은 유지되어야 합니다.

REPL Works의 중심은 AI가 아니라 프로젝트입니다.

REPL Works는 개발에만 사용할 수 있는가?

소프트웨어 개발은 REPL Works의 첫 번째 사용 사례일 뿐이다.

아니요.

REPL Works는 프로젝트 메모리 시스템입니다.

프로젝트가 존재한다면 사용할 수 있습니다.

예를 들어:

소프트웨어 개발

ARCHITECTURE.md
TASKS.md
LONG_CONTEXT.md

책 집필

OUTLINE.md
CHAPTERS.md
LONG_CONTEXT.md

스타트업 운영

STRATEGY.md
TASKS.md
LONG_CONTEXT.md

연구 프로젝트

HYPOTHESIS.md
EXPERIMENTS.md
LONG_CONTEXT.md

중요한 것은 문서 이름이 아니라 Memory Creation과 Memory Consumption 패턴입니다.

REPL Works는 오픈소스인가?

프로젝트의 기억은 특정 AI 서비스에 종속되어서는 안 된다.

예.

REPL Works는 오픈소스 프로젝트입니다.

프로젝트의 기억은 특정 AI 회사나 플랫폼에 종속되어서는 안 된다고 생각합니다.

모든 기억은 Markdown과 Git에 저장됩니다.

따라서 어떤 AI와도 함께 사용할 수 있으며, 언제든지 다른 도구로 이동할 수 있습니다.

REPL Works의 가장 중요한 원칙은 무엇인가?

AI에게 개발을 맡기는 것이 아니라, AI와 함께 생각하고 다른 AI에게 구현을 맡기는 것.

REPL Works는 생각(Thinking)과 실행(Execution)을 분리합니다.

인간은 Discussion AI와 함께 프로젝트를 설계합니다.

Execution AI는 설계된 내용을 구현합니다.

프로젝트의 방향은 토론을 통해 결정되고, 구현은 AI가 수행합니다.

REPL Works는 코딩 자동화 시스템이 아닙니다.

인간과 AI가 함께 생각하고, AI가 구현할 수 있도록 프로젝트의 기억을 관리하는 시스템입니다.