Cline 메모리 뱅크

Cline 메모리 뱅크 전체 가이드

빠른 설정 가이드

Cline 메모리 뱅크를 시작하려면 다음을 수행합니다.

1. Cline 설치 또는 열기
2. 사용자 지정 지침 복사 - 아래 코드 블록 사용
3. Cline에 붙여넣기 - 사용자 지정 지침으로 추가하거나 .clinerules 파일에 추가
4. 초기화 - Cline에게 “메모리 뱅크 초기화” 요청

자세한 설정 지침 보기

Cline 메모리 뱅크 사용자 지정 지침 [이것을 복사하세요]

# Cline의 메모리 뱅크

저는 Cline이며, 세션 간에 메모리가 완전히 재설정되는 독특한 특징을 가진 전문 소프트웨어 엔지니어입니다. 이것은 제한이 아니라 완벽한 문서를 유지하도록 이끄는 원동력입니다. 각 재설정 후에는 프로젝트를 이해하고 효과적으로 작업을 계속하기 위해 전적으로 메모리 뱅크에 의존합니다. 모든 작업 시작 시 모든 메모리 뱅크 파일을 읽어야 합니다. 이것은 선택 사항이 아닙니다.

## 메모리 뱅크 구조

메모리 뱅크는 핵심 파일과 선택적 컨텍스트 파일로 구성되며 모두 마크다운 형식입니다. 파일은 명확한 계층 구조로 서로를 기반으로 구축됩니다.

flowchart TD
    PB[projectbrief.md] --> PC[productContext.md]
    PB --> SP[systemPatterns.md]
    PB --> TC[techContext.md]

    PC --> AC[activeContext.md]
    SP --> AC
    TC --> AC

    AC --> P[progress.md]

### 핵심 파일 (필수)
1. `projectbrief.md`
   - 다른 모든 파일을 구성하는 기초 문서
   - 존재하지 않는 경우 프로젝트 시작 시 생성됨
   - 핵심 요구 사항 및 목표 정의
   - 프로젝트 범위에 대한 진실의 원천

2. `productContext.md`
   - 이 프로젝트가 존재하는 이유
   - 해결하는 문제
   - 작동 방식
   - 사용자 경험 목표

3. `activeContext.md`
   - 현재 작업 초점
   - 최근 변경 사항
   - 다음 단계
   - 활성 결정 및 고려 사항
   - 중요한 패턴 및 기본 설정
   - 학습 및 프로젝트 통찰력

4. `systemPatterns.md`
   - 시스템 아키텍처
   - 주요 기술적 결정
   - 사용 중인 디자인 패턴
   - 구성 요소 관계
   - 중요한 구현 경로

5. `techContext.md`
   - 사용된 기술
   - 개발 설정
   - 기술적 제약 조건
   - 종속성
   - 도구 사용 패턴

6. `progress.md`
   - 작동하는 것
   - 빌드해야 할 남은 것
   - 현재 상태
   - 알려진 문제
   - 프로젝트 결정의 진화

### 추가 컨텍스트
다음을 구성하는 데 도움이 될 때 memory-bank/ 내에 추가 파일/폴더를 만듭니다.
- 복잡한 기능 문서
- 통합 사양
- API 문서
- 테스트 전략
- 배포 절차

## 핵심 워크플로

### 계획 모드
flowchart TD
    Start[시작] --> ReadFiles[메모리 뱅크 읽기]
    ReadFiles --> CheckFiles{파일 완료 여부}

    CheckFiles -->|아니요| Plan[계획 만들기]
    Plan --> Document[채팅에 문서화]

    CheckFiles -->|예| Verify[컨텍스트 확인]
    Verify --> Strategy[전략 개발]
    Strategy --> Present[접근 방식 제시]

### 실행 모드
flowchart TD
    Start[시작] --> Context[메모리 뱅크 확인]
    Context --> Update[문서 업데이트]
    Update --> Execute[작업 실행]
    Execute --> Document[변경 사항 문서화]

## 문서 업데이트

메모리 뱅크 업데이트는 다음과 같은 경우에 발생합니다.
1. 새로운 프로젝트 패턴 발견 시
2. 중요한 변경 사항 구현 후
3. 사용자가 **메모리 뱅크 업데이트**를 요청할 때 (모든 파일 검토 필수)
4. 컨텍스트 명확화가 필요할 때

flowchart TD
    Start[업데이트 프로세스]

    subgraph Process
        P1[모든 파일 검토]
        P2[현재 상태 문서화]
        P3[다음 단계 명확화]
        P4[통찰력 및 패턴 문서화]

        P1 --> P2 --> P3 --> P4
    end

    Start --> Process

참고: **메모리 뱅크 업데이트**로 트리거될 때 일부 파일에 업데이트가 필요하지 않더라도 모든 메모리 뱅크 파일을 검토해야 합니다. 현재 상태를 추적하므로 activeContext.md 및 progress.md에 특히 중점을 둡니다.

기억하세요: 모든 메모리 재설정 후에는 완전히 새로 시작합니다. 메모리 뱅크는 이전 작업과의 유일한 연결 고리입니다. 제 효과는 전적으로 정확성에 달려 있으므로 정밀하고 명확하게 유지 관리해야 합니다.

Cline 메모리 뱅크란 무엇인가요?

메모리 뱅크는 Cline이 세션 간에 컨텍스트를 유지할 수 있도록 하는 구조화된 문서 시스템입니다. Cline을 상태 비저장 어시스턴트에서 시간이 지남에 따라 프로젝트 세부 정보를 효과적으로 “기억”할 수 있는 영구적인 개발 파트너로 변환합니다.

주요 이점

• 컨텍스트 보존: 세션 간에 프로젝트 지식 유지
• 일관된 개발: Cline과의 예측 가능한 상호 작용 경험
• 자체 문서화 프로젝트: 부수적으로 가치 있는 프로젝트 문서 생성
• 모든 프로젝트에 확장 가능: 모든 크기 또는 복잡성의 프로젝트에서 작동
• 기술 독립적: 모든 기술 스택 또는 언어에서 작동

메모리 뱅크 작동 방식

메모리 뱅크는 Cline 관련 기능이 아니라 구조화된 문서를 통해 AI 컨텍스트를 관리하는 방법론입니다. Cline에게 “사용자 지정 지침 따르기”를 지시하면 메모리 뱅크 파일을 읽어 프로젝트에 대한 이해를 재구성합니다.

파일 이해

메모리 뱅크 파일은 프로젝트에서 만드는 간단한 마크다운 파일입니다. 숨겨지거나 특수 파일이 아니라 사용자와 Cline 모두 액세스할 수 있는 리포지토리에 저장된 일반 문서입니다.

파일은 프로젝트의 전체 그림을 구성하는 계층적 구조로 구성됩니다.

메모리 뱅크 파일 설명

핵심 파일

1. projectbrief.md
   • 프로젝트의 기초
   • 구축 중인 내용에 대한 개략적인 개요
   • 핵심 요구 사항 및 목표
   • 예: “바코드 스캔 기능이 있는 재고 관리용 React 웹 앱 구축”
2. productContext.md
   • 프로젝트가 존재하는 이유 설명
   • 해결 중인 문제 설명
   • 제품 작동 방식 간략히 설명
   • 예: “재고 시스템은 여러 창고와 실시간 업데이트를 지원해야 합니다.”
3. activeContext.md
   • 가장 자주 업데이트되는 파일
   • 현재 작업 초점 및 최근 변경 사항 포함
   • 활성 결정 및 고려 사항 추적
   • 중요한 패턴 및 학습 내용 저장
   • 예: “현재 바코드 스캐너 구성 요소 구현 중, 지난 세션에서 API 통합 완료”
4. systemPatterns.md
   • 시스템 아키텍처 문서화
   • 주요 기술적 결정 기록
   • 사용 중인 디자인 패턴 나열
   • 구성 요소 관계 설명
   • 예: “정규화된 저장소 구조로 상태 관리에 Redux 사용”
5. techContext.md
   • 사용된 기술 및 프레임워크 나열
   • 개발 설정 설명
   • 기술적 제약 조건 기록
   • 종속성 및 도구 구성 기록
   • 예: “React 18, TypeScript, Firebase, 테스트용 Jest”
6. progress.md
   • 작동하는 것과 빌드해야 할 남은 것 추적
   • 기능의 현재 상태 기록
   • 알려진 문제 및 제한 사항 나열
   • 프로젝트 결정의 진화 문서화
   • 예: “사용자 인증 완료, 재고 관리 80% 완료, 보고 시작 안 함”

추가 컨텍스트

다음을 구성하는 데 필요할 때 추가 파일을 만듭니다.

• 복잡한 기능 문서
• 통합 사양
• API 문서
• 테스트 전략
• 배포 절차

메모리 뱅크 시작하기

처음 설정

1. 프로젝트 루트에 memory-bank/ 폴더를 만듭니다.
2. 기본적인 프로젝트 개요를 준비합니다(기술적이거나 비기술적일 수 있음).
3. Cline에게 “메모리 뱅크 초기화”를 요청합니다.

프로젝트 개요 팁

• 간단하게 시작하세요. 원하는 만큼 상세하거나 개략적일 수 있습니다.
• 가장 중요한 것에 집중하세요.
• Cline이 공백을 채우고 질문하는 데 도움을 줄 것입니다.
• 프로젝트가 발전함에 따라 업데이트할 수 있습니다.

Cline과 함께 작업하기

핵심 워크플로

계획 모드

전략 토론 및 개략적인 계획을 위해 이 모드에서 시작합니다.

실행 모드

구현 및 특정 작업 실행에 이 모드를 사용합니다.

주요 명령어

• “사용자 지정 지침 따르기” - Cline에게 메모리 뱅크 파일을 읽고 중단한 부분부터 계속하도록 지시합니다(작업 시작 시 사용).
• “메모리 뱅크 초기화” - 새 프로젝트 시작 시 사용합니다.
• “메모리 뱅크 업데이트” - 작업 중에 전체 문서 검토 및 업데이트를 트리거합니다.
• 현재 필요에 따라 계획/실행 모드를 전환합니다.

문서 업데이트

메모리 뱅크 업데이트는 다음과 같은 경우 자동으로 발생해야 합니다.

1. 프로젝트에서 새로운 패턴을 발견한 경우
2. 중요한 변경 사항을 구현한 후
3. **“메모리 뱅크 업데이트”**로 명시적으로 요청하는 경우
4. 컨텍스트를 명확히 해야 할 때

자주 묻는 질문

메모리 뱅크 파일은 어디에 저장되나요?

메모리 뱅크 파일은 일반적으로 memory-bank/ 폴더에 있는 프로젝트 리포지토리에 저장된 일반 마크다운 파일입니다. 숨겨진 시스템 파일이 아니라 프로젝트 문서의 일부로 설계되었습니다.

사용자 지정 지침을 사용해야 하나요, 아니면 .clinerules를 사용해야 하나요?

두 가지 방법 모두 작동합니다. 기본 설정에 따라 다릅니다.

• 사용자 지정 지침: 모든 Cline 대화에 전역적으로 적용됩니다. 모든 프로젝트에서 일관된 동작을 유지하는 데 좋습니다.
• .clinerules 파일: 프로젝트별로 다르며 리포지토리에 저장됩니다. 프로젝트별 사용자 지정에 좋습니다.

두 가지 방법 모두 동일한 목표를 달성합니다. 선택은 메모리 뱅크 시스템을 전역적으로 적용할지 로컬로 적용할지에 따라 달라집니다.

컨텍스트 창 관리

Cline과 함께 작업하면 컨텍스트 창이 결국 가득 찹니다(진행률 표시줄 참고). Cline의 응답 속도가 느려지거나 대화의 이전 부분에 대한 참조가 덜 정확해지면 다음을 수행해야 합니다.

1. Cline에게 **“메모리 뱅크 업데이트”**를 요청하여 현재 상태를 문서화합니다.
2. 새 대화/작업을 시작합니다.
3. 새 대화에서 Cline에게 **“사용자 지정 지침 따르기”**를 요청합니다.

이 워크플로는 컨텍스트 창이 지워지기 전에 중요한 컨텍스트가 메모리 뱅크 파일에 보존되도록 하여 새 대화에서 원활하게 계속할 수 있도록 합니다.

메모리 뱅크를 얼마나 자주 업데이트해야 하나요?

중요한 이정표나 방향 변경 후 메모리 뱅크를 업데이트합니다. 활발한 개발의 경우 몇 세션마다 업데이트하면 도움이 될 수 있습니다. 모든 컨텍스트가 보존되도록 하려면 “메모리 뱅크 업데이트” 명령을 사용합니다. 그러나 Cline이 메모리 뱅크를 자동으로 업데이트하는 것을 알 수 있습니다.

이것이 Cline 이외의 다른 AI 도구에서도 작동하나요?

예! 메모리 뱅크 개념은 문서 파일을 읽을 수 있는 모든 AI 어시스턴트와 함께 작동할 수 있는 문서 방법론입니다. 특정 명령어는 다를 수 있지만 컨텍스트를 유지하는 구조화된 접근 방식은 여러 도구에서 작동합니다.

메모리 뱅크는 컨텍스트 창 제한과 어떤 관련이 있나요?

메모리 뱅크는 필요할 때 효율적으로 로드할 수 있는 구조화된 형식으로 중요한 정보를 저장하여 컨텍스트 제한을 관리하는 데 도움이 됩니다. 이렇게 하면 중요한 정보를 사용할 수 있도록 하면서 컨텍스트 팽창을 방지합니다.

메모리 뱅크 개념을 코딩이 아닌 프로젝트에 사용할 수 있나요?

물론입니다! 메모리 뱅크 접근 방식은 책 쓰기에서 이벤트 계획에 이르기까지 구조화된 문서의 이점을 누릴 수 있는 모든 프로젝트에 작동합니다. 파일 구조는 다를 수 있지만 개념은 여전히 강력합니다.

이것이 README 파일을 사용하는 것과 다른가요?

개념은 유사하지만 메모리 뱅크는 AI 세션 전체에서 컨텍스트를 유지하도록 특별히 설계된 보다 구조화되고 포괄적인 접근 방식을 제공합니다. 단일 README가 일반적으로 다루는 범위를 넘어섭니다.

모범 사례

시작하기

• 기본적인 프로젝트 개요로 시작하여 구조가 발전하도록 합니다.
• Cline이 초기 구조를 만드는 데 도움을 주도록 합니다.
• 워크플로에 맞게 필요에 따라 파일을 검토하고 조정합니다.

진행 중인 작업

• 작업하면서 패턴이 자연스럽게 나타나도록 합니다.
• 문서 업데이트를 강요하지 마십시오. 유기적으로 이루어져야 합니다.
• 프로세스를 신뢰하십시오. 시간이 지남에 따라 가치가 복합적으로 증가합니다.
• 세션 시작 시 컨텍스트 확인을 확인합니다.

문서 흐름

• projectbrief.md가 기초입니다.
• activeContext.md가 가장 자주 변경됩니다.
• progress.md가 이정표를 추적합니다.
• 모든 파일이 종합적으로 프로젝트 인텔리전스를 유지 관리합니다.

자세한 설정 지침

사용자 지정 지침(전역)

1. VSCode를 엽니다.
2. Cline 확장 프로그램 설정 ⚙️을 클릭합니다.
3. “사용자 지정 지침”을 찾습니다.
4. 이 가이드 상단에서 전체 메모리 뱅크 지침을 복사하여 붙여넣습니다.

.clinerules(프로젝트별)

1. 프로젝트 루트에 .clinerules 파일을 만듭니다.
2. 이 가이드 상단에서 메모리 뱅크 지침을 복사하여 붙여넣습니다.
3. 파일을 저장합니다.
4. Cline은 이 프로젝트에서 작업할 때 이러한 규칙을 자동으로 적용합니다.

기억하세요

메모리 뱅크는 Cline이 이전 작업과 연결되는 유일한 고리입니다. 그 효과는 전적으로 명확하고 정확한 문서를 유지하고 모든 상호 작용에서 컨텍스트 보존을 확인하는 데 달려 있습니다.

자세한 내용은 Cline 메모리 뱅크에 대한 당사 블로그를 참조하십시오.

---

Cline 메모리 뱅크에 기여하기

이 가이드는 Cline 및 Cline Discord 커뮤니티에서 유지 관리합니다.

• nickbaumann98
• Krylo
• snipermunyshotz

---

메모리 뱅크 방법론은 AI 컨텍스트 관리에 대한 개방형 접근 방식이며 다양한 도구 및 워크플로에 적용할 수 있습니다.