Auto Memory에서 Skill로: 복잡하게 시작하지 않는 지식 관리 순서

AI에게 프로젝트 규칙을 알려줄 때, 처음부터 Skill 폴더를 크게 설계하면 오히려 느려진다.

더 쉬운 방법은 순서를 지키는 것이다.

먼저 Memory에 쌓고
반복되면 CLAUDE.md/Rules로 올리고
절차가 생기면 Skill로 승격한다

이 글은 이 순서를 독립적인 예시로 설명한다.

한 줄 요약

Memory: 당장 기억시킬 메모
CLAUDE.md / Rules: 반복되는 규칙
Skill: 순서가 있는 작업 절차

핵심은 "처음부터 완벽한 구조"가 아니라 반복되는 것만 위로 올리는 것이다.

1) Memory와 Skill은 역할이 다르다

도구	가장 잘하는 일	언제 쓰면 좋은가
Memory	빠른 기록, 즉시 반영	방금 발견한 패턴을 저장할 때
CLAUDE.md / Rules	공통 규칙 고정	여러 세션에서 반복되는 규칙이 생겼을 때
Skill	단계형 워크플로우 실행	체크리스트/절차를 일관되게 재사용해야 할 때

2) 왜 이 순서가 쉬운가

처음부터 Skill을 만들면 이런 문제가 생긴다.

무엇을 넣어야 할지 아직 모른다
규칙이 금방 바뀌어 다시 뜯어고친다
파일 구조만 커지고 실제 활용은 낮다

반대로 Memory부터 시작하면 실제 사용 데이터가 쌓인다.
그 뒤에 반복 패턴만 골라 올리면 구조가 자연스럽게 정리된다.

3) 독립적인 예시로 보는 승격 흐름

예시 A: 커밋 메시지 언어

처음 상태: 커밋 메시지가 세션마다 한국어/영어로 섞임
Memory 기록: "커밋 메시지는 한국어"
반복됨: 3~4번 같은 지시를 다시 하게 됨
승격: CLAUDE.md의 공통 규칙으로 이동

포인트: 이 경우는 절차가 아니라 단일 규칙이므로 Skill까지 갈 필요가 없다.

예시 B: 패키지 매니저 혼선

처음 상태: 어떤 세션은 npm, 어떤 세션은 bun 사용
Memory 기록: "이 저장소는 bun 사용"
반복됨: 설치/스크립트 실행에서 재발
승격: .claude/rules/tooling.md 같은 주제별 규칙 파일로 분리

포인트: 규칙이 1개에서 5~10개로 늘어나면 Rules를 분리하는 것이 읽기 쉽다.

예시 C: 배포 절차 누락

처음 상태: 배포할 때마다 테스트/헬스체크 순서가 달라짐
필요: 누락 없는 단계형 실행
승격: Skill 생성

deploy Skill 예시
1) 테스트
2) 빌드
3) 배포
4) 헬스체크
5) 롤백 조건 확인

포인트: 순서가 중요한 순간이 Skill로 가는 신호다.

예시 D: 한글 URL 경로 404

처음 상태: 한글 slug 비교에서 간헐적으로 404 발생
Memory 기록: "slug 비교 전에 decodeURIComponent 적용"
재발 방지: dev/troubleshooting 성격의 Skill 또는 Rules에 이동

포인트: 장애 대응 지식은 재발 방지를 위해 구조화해 두는 편이 낫다.

4) 무엇을 언제 올릴지 판단 기준

다음 기준만 기억해도 충분하다.

같은 지시를 3회 이상 반복하면 Memory → CLAUDE.md
CLAUDE.md가 길어져 주제별 탐색이 어려우면 Rules로 분리
규칙이 아니라 "순서"가 필요하면 Skill
예외 처리/체크리스트가 붙기 시작하면 Skill + references

5) 자주 하는 실수

실수 1: 같은 내용을 여러 곳에 중복 저장

Memory와 CLAUDE.md에 같은 규칙이 같이 있으면 충돌이 난다.
승격할 때는 원래 위치에서 지우는 것이 안전하다.

실수 2: 너무 이른 Skill 분리

아직 안정되지 않은 규칙을 Skill로 만들면 유지 비용만 커진다.
먼저 Memory에서 패턴을 확인하자.

실수 3: Skill을 너무 잘게 쪼갬

비슷한 Skill이 많아지면 선택이 어려워진다.
주제/목적이 겹치면 합치는 편이 낫다.

6) 바로 적용하는 2주 플랜

1주차

세션 중 반복되는 지시를 Memory에만 기록
하루 1회, 중복/재발 항목 3개만 체크

2주차

재발 항목을 CLAUDE.md로 이동
주제별로 Rules 1~2개 분리
순서형 작업 1개만 Skill로 승격

작게 시작하면 유지가 쉽고, 실패 비용도 낮다.

정리

지식 관리의 핵심은 도구 선택이 아니라 승격 타이밍이다.

즉시 기록은 Memory
반복 규칙은 CLAUDE.md/Rules
단계형 실행은 Skill

이 순서만 지켜도 "처음부터 과설계"를 피하면서 품질을 빠르게 안정화할 수 있다.