메모리
파일시스템 기반 지식 관리 시스템으로, 소스 코드 자체가 메모리입니다. 결정, 패턴, 컨텍스트를 구조화된 마크다운 파일에 저장합니다.
사용 시기
- 아키텍처 결정 기록
- 개발 중 발견한 패턴 문서화
- 어떤 방식으로 구축된 이유에 대한 컨텍스트 저장
- 알려진 문제 및 해결 방법 추적
- API 문서 또는 통합 노트 저장
사용하지 말아야 할 경우
- 임시 디버깅 노트 (대신 주석 사용)
- 작업 추적 (git 이슈나 프로젝트 보드 사용)
핵심 원칙
- 소스 코드가 유일한 진실 공급원
- 지식은 사용되는 곳 가까이에 저장
- 일관성을 위해 구조화된 마크다운 사용
- 파일을 집중적으로 유지 (주제별 하나의 파일)
저장 위치
| 유형 | 위치 | 예시 |
|---|---|---|
| 기술 문서 | docs/technical/ | 아키텍처 결정, 패턴 |
| 기능 문서 | docs/features/ | 기능 명세, 요구사항 |
| API 문서 | docs/api/ | API 계약, 통합 노트 |
메모리 연산
기억하기 (쓰기)
새 지식 저장:
# [주제 제목]
## 컨텍스트
[이것이 존재하는 이유, 해결하는 문제]
## 결정
[결정된 사항과 이유]
## 세부사항
[기술적 세부사항, 코드 예제]
## 참조
- [관련 파일 또는 URL]
---
*생성일: [날짜]*
*최종 업데이트: [날짜]*
회상하기 (읽기)
지식 검색:
docs/디렉토리 구조 확인- 관련 파일 읽기
- 문서 전체에서 키워드 검색
업데이트
기존 지식 수정:
- 기존 파일 읽기
- 관련 섹션 업데이트
- 중요한 변경 사항이 있을 경우 변경 이력에 추가
관련 스킬
| 스킬 | 체인 연결 시기 |
|---|---|
| feature-dev | 개발 중 아키텍처 결정 저장 |
| planning | 향후 참조를 위한 계획 문서화 |