| name | memo |
| description | 지나가는 메모를 타임스탬프+태그와 함께 축적합니다. 검증 없이 들은 그대로 적기만. 축적되면 다른 스킬에서 횡단 참조. |
| when_to_use | 메모해둬, 이거 적어둬, 들은 것 기록해줘. 검증된 교훈은 pitfall, 문서 반영은 learn. |
| allowed-tools | Read, Write, Glob, Grep, Bash |
역할
"일단 적어두기." 그게 전부다.
들은 얘기, 스쳐 지나간 생각, 누군가의 한마디, 아직 뭔지 모르지만 나중에 중요할 수 있는 것.
검증하지 않는다. 정리하지 않는다. 적고 태그 붙이고 쌓는다.
쌓이면 패턴이 보인다. 그때 /learn, /customer-profile, /product-diagnosis 등으로 승격하면 된다.
/learn과의 차이
| /memo | /learn |
|---|
| 목적 | 일단 적어두기 | 검증하고 문서에 반영 |
| 검증 | [FAIL] 안 함 | [OK] 코드/문서에서 확인 |
| 분량 | 한 줄~세 줄 | 단락~페이지 |
| 소요 시간 | 5초 | 5분~30분 |
| 예시 | "{팀원}이 ~라고 함" | "{도메인} 상태 전이가 X에서 Y를 거쳐 Z로 가는 것을 코드에서 확인하고 biz-rules.md 에 반영" |
외부 데이터 의존
| 데이터 | 경로 | 필수/선택 | 부재 시 동작 |
|---|
| 팀원 매핑 | .local.claude/team.md | 선택 | 사람 태그(@) 생략 |
| 고객사 목록 | .local.claude/customers/*.md | 선택 | 고객사 태그 자동 매칭 생략 |
| 도메인 약어 | CLAUDE.md | 선택 | #도메인 태그 분류 생략 |
| 최근 메모 | .local.claude/memo/*.md (최근 7일) | 선택 | 태그 일관성 점검 생략, 새 태그 그대로 부여 |
부재 시에도 메모 저장은 항상 수행. 태그 자동화 수준만 낮아진다.
모드 판단
| 입력 | 동작 |
|---|
/memo 내용 | 메모 추가 (기본) |
/memo (내용 없이) | 오늘 메모 조회 |
/memo week | 이번 주 메모 조회 |
/memo @사람이름 | 해당 사람 관련 메모 검색 |
/memo #태그 | 해당 태그 메모 검색 |
메모 추가 프로세스
1. 입력 받기
$ARGUMENTS가 메모 내용. 없으면 오늘 메모 조회 모드.
2. 자동 태그 추출
[1M 활용] 다음을 단일 메시지에서 병렬 호출:
- Read:
.local.claude/team.md (닉네임-실명 매핑), CLAUDE.md (도메인 약어)
- Glob:
.local.claude/customers/*.md (고객사 파일명 자동 키워드화)
- Glob:
.local.claude/memo/*.md (최근 7일, 태그 일관성)
메모 내용에서 자동으로 태그를 추출한다.
사람 태그 (@): .local.claude/team.md 의 닉네임-실명 매핑에서 이름 매칭
- "{닉네임A}가 ~"이면
@{닉네임A}
- "{닉네임B}가 ~"이면
@{닉네임B}
- 매칭 안 되면 사람 태그 생략
고객사 태그: .local.claude/customers/ 파일명에서 매칭
- "{고객사}가 ~"이면
#{고객사}
- 자동 매칭: customers/ 디렉터리의 모든 파일명을 키워드로 인식
주제 태그: 키워드 기반 자동 분류
| 태그 | 키워드 예시 |
|---|
#기술 | 코드, 버그, 아키텍처, 리팩토링, 성능, API, DB, 배포 |
#제품 | 기능, 화면, UX, 요청, 개선, 추가 |
#도메인 | 프로젝트 도메인 키워드 (CLAUDE.md 의 도메인 약어 참조) |
#조직 | 팀, 채용, 퇴사, 역할, 프로세스, 회의, 문화 |
#경쟁 | 경쟁사, 비교, 벤치마크, 입찰, 제안 |
#고객 | 고객, CS, 요청, 불만, 피드백 |
#개인 | 커리어, 성장, 고민, 생각 |
여러 태그 해당 시 모두 붙인다. 아무것도 해당 안 되면 #기타.
3. 파일에 저장
파일 경로: .local.claude/memo/YYYY-MM-DD.md
기존 파일이 있으면 append, 없으면 새로 생성.
## YYYY-MM-DD
- **HH:MM** 메모 내용 `@사람` `#태그1` `#태그2`
시간은 현재 시간 기준 (date +%H:%M).
4. 확인 + 스킬 연결 안내
저장 후 한 줄 확인:
[OK] 메모 저장: .local.claude/memo/YYYY-MM-DD.md (오늘 N번째)
축적 패턴이 보이면 (같은 파일에 3건+ 쌓였을 때만) 안내:
- 고객 관련 메모 3건+이면 "고객 메모가 쌓이고 있습니다.
/customer-profile로 정리하면 /product-diagnosis에서 활용됩니다"
- 기술 결정 관련이면 "이 맥락은
/learn으로 검증/문서화할 가치가 있을 수 있습니다"
- 특정 사람 메모 3건+이면 "이 분에 대한 관찰이 쌓이고 있습니다"
강제 아님, 안내만. 대부분의 경우 저장 확인 한 줄로 끝.
조회 모드
오늘 메모 (/memo)
cat .local.claude/memo/$(date +%Y-%m-%d).md 2>/dev/null
없으면 "오늘 메모 없음"
이번 주 메모 (/memo week)
for f in $(ls .local.claude/memo/ 2>/dev/null | tail -7); do
echo "=== $f ==="
done
이번 주 메모를 시간순으로 보여주고, 태그별 요약도 함께:
이번 주 메모 N건:
- @{닉네임A} 3건, @{닉네임B} 2건
- #도메인 4건, #기술 2건, #고객 1건
사람 검색 (/memo @{닉네임})
grep -l "{닉네임}" .local.claude/memo/*.md 2>/dev/null
해당 사람이 언급된 메모만 필터링하여 시간순 표시.
태그 검색 (/memo #고객)
grep -l "#고객" .local.claude/memo/*.md 2>/dev/null
해당 태그가 있는 메모만 필터링.
다른 스킬에서의 참조
이 메모 파일을 읽는 스킬들:
| 스킬 | 참조 방식 |
|---|
/daily 심층분석 | "이번 주 메모에서 반복 패턴" |
/product-diagnosis | 고객/제품 관련 메모 횡단 |
/business-diagnosis | 조직/경쟁 관련 메모 횡단 |
/tech-diagnosis | 기술 결정 맥락 메모 |
/briefing | 메모와 커밋의 교차점 |
파일 저장
Frontmatter (CONTRACT 7-2절 표준, 새 파일 생성 시에만 적용, append 시 기존 frontmatter 유지): category: memo, retention: 14d
저장 경로
.local.claude/memo/YYYY-MM-DD.md: 하루 한 파일, append
- 디렉터리 없으면
mkdir -p로 생성
저장 원칙
- 수정하지 않는다. 과거 메모는 건드리지 않음. append only
- 삭제하지 않는다. 틀린 메모도 기록. 나중에 "이때 이렇게 생각했구나" 맥락
- 구조를 강제하지 않는다. 사용자가 적은 그대로 저장. 태그만 자동 추가
제약조건
- 검증하지 않는다. 들은 그대로 적기만. "이거 맞아?"를 물어보지 않음
- 정리하지 않는다. 카테고리 분류, 우선순위 매기기 안 함. 태그만 자동
- 입력 최소화.
/memo 한 줄 이것만으로 끝나야 함. 후속 질문 하지 않음
- 과거 메모 수정 금지. append only
- 스킬 연결 안내는 3건+ 축적 시에만. 매번 안내하면 피로감
- 민감 메모도 허용. [PRIVATE] 태그 없이 저장. daily에서 민감도 분류
다른 스킬과의 경계
| 질문 | 담당 | 이 스킬에서 |
|---|
| 검증하고 문서에 반영 | /learn | [다루지 않음] (검증 없이 적기만) |
| 하루 끝 회고, 민감도 분류, 심층 분석 | /daily | [다루지 않음] (메모를 심층분석 입력으로 제공) |
| 지나가는 메모를 타임스탬프+태그로 즉시 축적 | 이 스킬 | [핵심] |
검증 시나리오
공통 3블록(빈 / 부분 / 풀 데이터)은 CONTRACT 6-1절 참조.
이 스킬의 고유 실패 시나리오
[데이터 결함] 자동 태그 매칭 실패
- 신호: 메모 내용에서 기존 태그, 프로젝트, 모듈 키워드가 감지되지 않거나 여러 개가 동시 매치되어 모호
- 대응: 수동 태그 질문 (AskUserQuestion) + 기존 태그 목록 제시 + "새 태그 생성" 옵션 허용
[환경/규모] 축적 패턴이 10건 이상
- 신호: 같은 태그/키워드의 메모가 10건 이상 누적되어 산발적 상태
- 대응: 자동 그루핑 제안 ("이 주제 10건을 회고/학습 문서로 묶을 수 있음") +
/learn 또는 /garden 연결 안내