# Planning with Files: Manus 방식으로 AI 에이전트 컨텍스트 문제 해결하기

> Clean Markdown view of GeekNews topic #25841. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=25841](https://news.hada.io/topic?id=25841)
- GeekNews Markdown: [https://news.hada.io/topic/25841.md](https://news.hada.io/topic/25841.md)
- Type: news
- Author: [davespark](https://news.hada.io/@davespark)
- Published: 2026-01-15T16:26:55+09:00
- Updated: 2026-01-15T16:26:55+09:00
- Original source: [aisparkup.com](https://aisparkup.com/posts/8340)
- Points: 32
- Comments: 1

## Summary

AI 에이전트의 **컨텍스트 한계**를 극복하기 위한 실용적 접근으로, ‘Planning with Files’는 마크다운 파일 세 개를 통해 에이전트의 기억 구조를 확장합니다. `task_plan.md`, `findings.md`, `progress.md`로 나뉜 이 방식은 목표 유지·정보 축적·오류 기록을 분리해 관리함으로써, 모델이 동일한 실수를 반복하지 않도록 돕습니다. 더 큰 모델보다 **지속 가능한 메모리 관리**가 성능을 좌우한다는 점을 보여주는 사례입니다.

## Topic Body

- **문제 제기**  
  - AI 에이전트(Claude Code, Cursor 등)의 컨텍스트 윈도우 제한으로 장기 작업 시 목표 상실  
  - 초기 지시 잊음 + 동일 오류 반복 발생 (컨텍스트 = 휘발성 RAM)  
  - 파일 시스템을 영구 메모리(디스크)처럼 활용하면 해결 가능  
  
- **Manus의 성공 비결 (역공학)**  
  - 8개월 만에 매출 1억 달러 → Meta에 20억 달러 인수  
  - 핵심: 마크다운 파일을 AI의 **외부 두뇌**로 사용  
  - 주의 조작(attention manipulation) + 에러 기록 유지 → 실패 반복 방지  
  - 에러 복구 능력이 에이전트 성능의 핵심 지표  
  
- **3-파일 패턴 (Planning with Files 핵심)**  
  - `task_plan.md`  
    → 단계별 계획 + 체크박스 진행 상황 관리  
    → 목표를 계속 상기시키는 가장 중요한 파일  
  - `findings.md`  
    → 리서치 결과, 발견 정보, 분석 내용 저장  
  - `progress.md`  
    → 실제 시도한 작업 + 결과 + 모든 에러 기록  
  
- **주요 사용 규칙 4가지**  
  - 반드시 계획부터 task_plan.md에 작성 시작  
  - 동일 주제 조회 2회 이상 → findings.md에 정리·저장  
  - 발생한 모든 에러 반드시 progress.md에 기록  
  - 같은 방식으로 실패 반복 금지 → 접근법 변경 후 재시도  
  
- **실제 적용 방법**  
  - Claude Code에서 플러그인 설치: `/plugin marketplace add OthmanAdi/planning-with-files`  
  - 복잡 작업(3단계 이상, 리서치·리팩토링 필요 시) 자동/수동 실행(`/planning-with-files`)  
  - 효과: AI가 목표 잊지 않고, 오류 반복 현저히 감소  
  
- **핵심 인사이트 & 결론**  
  - AI 에이전트 성능 향상 → 더 큰 모델보다 **효과적인 메모리 관리**가 훨씬 중요  
  - 마크다운 파일 3개만으로도 컨텍스트 엔지니어링 수준 대폭 상승  
  - Planning with Files 플러그인 → Manus 방식 오픈소스 구현 → 누구나 즉시 사용 가능

## Comments



### Comment 49287

- Author: zero0000
- Created: 2026-01-16T08:16:22+09:00
- Points: 1

task_plan.md은 현재 쓰고 있던 방법과 동일하네요. 자동으로 해주면 많이 편하겠어요.