name	memory-bank
description	프로젝트 작업 계획 및 진행 상황을 체계적으로 관리하는 문서 시스템. 작업 시작 전, 작업 중, 작업 완료 후 반드시 사용. PRD 확인, TODO 업데이트, 대작업 폴더 생성 및 관리 시 사용
allowed-tools	Read, Write, Edit, Glob, Bash

Memory Bank - 작업 계획 및 진행 문서 관리

개요

메모리뱅크는 프로젝트의 모든 작업을 체계적으로 기록하고 추적하는 문서 시스템입니다.

디렉토리 구조

__memory-bank/
├── PRD.md                    # 프로젝트 요구사항 문서
├── TODO.md                   # 전체 작업 체크리스트 (폴더별 진행상황)
├── 010-작업명/
│   ├── TASK.md              # 작업 상세 내용
│   └── TODO.md              # 작업별 체크리스트
├── 020-다음작업/
│   ├── TASK.md
│   └── TODO.md
└── ...

핵심 규칙

⚠️ 작업 전후로 반드시 메모리뱅크 확인 및 기록 필수

작업 전: PRD 및 TODO 확인
작업 중: TASK.md 및 TODO.md 실시간 업데이트
작업 후: 완료 상태 체크, 다음 작업 준비

🔴🟢🔵 TODO는 반드시 TDD(Test-Driven Development) 방식으로 작성

RED: 테스트 먼저 작성 (실패 확인)
GREEN: 최소 구현으로 테스트 통과
REFACTOR: 코드 개선 (테스트 유지)

📋 이중 TODO 체크 강제 규칙 ⚠️ 필수

작업 시작 시: 반드시 두 TODO 모두 확인
- __memory-bank/TODO.md (루트 TODO)
- __memory-bank/XXX-작업명/TODO.md (작업 TODO)
TODO 체크 시: 반드시 두 TODO 모두 업데이트
- 작업 TODO에서 항목 체크 → 루트 TODO도 동기화
- 작업 완료 시 → 루트 TODO에서 작업 완료 체크
진행률 업데이트: 항상 양쪽 동기화
- 작업 TODO 진행률 변경 → 루트 TODO "현재 작업" 섹션 업데이트

사용 시나리오

1. 프로젝트 초기화

__memory-bank/ 디렉토리 생성
PRD.md 작성 (프로젝트 요구사항)
TODO.md 작성 (전체 작업 목록)

2. 새로운 대작업 시작

폴더 생성: 010-작업명/ 형식
TASK.md 작성: 작업 목적, 범위, 기술 스택, 구현 방법
TODO.md 작성: 세부 체크리스트
루트 TODO.md에 해당 작업 추가

3. 작업 진행 중

체크리스트 항목 완료 시 체크
새로운 이슈 발견 시 TODO에 추가
중요 결정사항은 TASK.md에 기록

4. 작업 완료

모든 TODO 항목 체크 확인
루트 TODO.md에서 해당 작업 완료 표시
다음 작업으로 이동

Instructions

Step 1: 메모리뱅크 확인 ⚠️ 필수: 두 TODO 모두 읽기

작업 시작 전 반드시:

ls -la __memory-bank/

다음 파일들을 읽어서 현재 상태 파악:

__memory-bank/PRD.md: 프로젝트 목표 확인
__memory-bank/TODO.md: ⚠️ 필수 루트 TODO (전체 진행상황)
해당 작업 폴더의 TASK.md
해당 작업 폴더의 TODO.md: ⚠️ 필수 작업 TODO (세부 체크리스트)

반드시 두 TODO를 모두 읽어야 합니다:

루트 TODO에서 현재 작업의 우선순위와 컨텍스트 파악
작업 TODO에서 구체적인 체크리스트 확인

Step 2: 대작업 폴더 생성 (필요 시)

새로운 대작업 시작 시:

폴더 번호 확인 (마지막 폴더 +10)
폴더 생성: __memory-bank/XXX-작업명/
템플릿 사용하여 파일 생성
서브에이전트 지정: TODO에 담당 에이전트 명시

Step 2.5: 서브에이전트 지정 🤖

각 작업에 적절한 서브에이전트를 지정합니다:

사용 가능한 에이전트:

database-migration: MariaDB → PostgreSQL 마이그레이션 전문
nextjs-developer: Next.js 14 개발 전문
test-writer: TDD 테스트 작성 전문
code-reviewer: 코드 리뷰 및 품질 검증
doc-updater: 메모리뱅크 문서 자동 업데이트

지정 방법:

# __memory-bank/TODO.md
- [ ] 020-nextjs-setup 🤖 `nextjs-developer, test-writer`
- [ ] 030-database-setup 🤖 `database-migration`

# __memory-bank/020-nextjs-setup/TODO.md
**에이전트**: `nextjs-developer, test-writer`

선택 가이드:

개발 작업: nextjs-developer + test-writer
DB 작업: database-migration
보안/품질: code-reviewer 추가
문서화: doc-updater

Step 3: 작업 문서 업데이트 ⚠️ 필수: 두 TODO 모두 업데이트

작업 중 실시간으로:

TASK.md 업데이트:

구현 방법 상세화
기술 결정 기록
이슈 및 해결방법 기록

작업 TODO.md 업데이트 (먼저):

완료된 항목 체크: - [x]
새로운 항목 추가: - [ ]
진행률 갱신

루트 TODO.md 업데이트 (반드시 동기화):

⚠️ 작업 TODO와 동기화 필수
대작업 진행률 업데이트
"현재 작업" 섹션 갱신
완료된 대작업 체크

동기화 규칙:

작업 TODO에서 체크 → 루트 TODO에 반영
작업 완료 시 → 루트 TODO에서 해당 작업 [x] 체크

Step 4: 작업 완료 확인 ⚠️ 필수: 두 TODO 모두 완료 체크

작업 완료 전:

⚠️ 작업 TODO.md: 모든 항목 [x] 체크 확인
⚠️ 루트 TODO.md: 해당 작업 [x] 체크 확인
두 TODO 동기화 상태 검증
TASK.md에 최종 요약 작성
다음 작업 확인

완료 검증 체크리스트:

작업 TODO 진행률 100%
루트 TODO에서 해당 작업 체크 완료
두 TODO 간 불일치 없음

템플릿

템플릿 파일은 templates/ 폴더에서 확인하세요:

자동화 규칙

Claude는 다음 상황에서 자동으로 메모리뱅크를 확인합니다:

사용자가 새로운 작업 요청 시
"작업 시작", "구현", "개발" 등의 키워드 감지 시
파일 수정 후 TODO 업데이트 필요 시
작업 완료 보고 시

Best Practices

일관된 폴더 번호: 10 단위로 증가 (010, 020, 030...)
명확한 작업명: 한글/영문 모두 가능, 간결하게
실시간 업데이트: 작업 완료 후가 아닌 진행 중 업데이트
상세한 기록: 미래의 자신/팀원을 위한 문서화
체크리스트 세분화: 너무 큰 단위보다는 작은 단위로

예시

프로젝트: NoteAmp 업그레이드

__memory-bank/
├── PRD.md                           # NoteAmp 프로젝트 요구사항
├── TODO.md                          # 전체 작업 체크리스트 (에이전트 지정 포함)
├── 010-nextjs-setup/
│   ├── TASK.md                     # Next.js 프로젝트 초기 셋업
│   └── TODO.md                     # 🤖 nextjs-developer, test-writer
├── 020-database-schema/
│   ├── TASK.md                     # DB 스키마 설계
│   └── TODO.md                     # 🤖 database-migration
└── 030-authentication/
    ├── TASK.md                     # 인증 시스템 구현
    └── TODO.md                     # 🤖 nextjs-developer, test-writer, code-reviewer

서브에이전트 워크플로우

작업 흐름 예시

Phase 1: 기반 구축

1. 020-nextjs-project-setup
   🤖 nextjs-developer: 프로젝트 초기화
   🤖 test-writer: 테스트 환경 구성

2. 030-database-setup
   🤖 database-migration: Neon/Supabase 스키마 생성

3. 040-authentication
   🤖 nextjs-developer: NextAuth.js 구현
   🤖 test-writer: 인증 테스트 작성
   🤖 code-reviewer: 보안 검증

에이전트 협업 패턴

패턴 1: 순차 실행

1. nextjs-developer가 컴포넌트 개발
2. test-writer가 테스트 작성
3. code-reviewer가 리뷰 및 승인

패턴 2: 병렬 실행

nextjs-developer + test-writer 동시 작업 (TDD)
→ code-reviewer 최종 검증

참고

더 자세한 내용은 reference.md를 참조하세요.

memory-bank

Install Skill

SKILL.md