archive

archive 스킬 개요

archive가 특히 잘하는 일

archive 스킬은 일회성 세션 지식을 재사용 가능한 프로젝트 메모리로 바꾸고 싶은 팀과 개인 빌더를 위한 도구입니다. 해결 방법이 채팅 기록 속에 묻히도록 두는 대신, 디버깅 해결 내용, 배포 메모, 작업 과정에서 얻은 교훈을 .archive/YYYY-MM-DD/ 아래 구조화된 markdown으로 저장하고, .archive/MEMORY.md에는 가벼운 인덱스를 유지합니다.

archive를 설치하면 잘 맞는 사람

이 archive 스킬은 같은 인프라, CI, 릴리스, 디버깅 문제를 반복해서 다시 보게 되는 사람에게 가장 잘 맞습니다. 다음번에 더 빨리 복구하고 싶다면 특히 유용합니다. 여러 세션에 걸쳐 작업하거나, 여러 에이전트 또는 여러 기여자가 함께 일하면서 “지난번엔 무슨 일이 있었지?”를 공유 기록으로 남겨야 하는 환경이라면 더욱 효과적입니다.

사용자가 실제로 해결하려는 일

사용자에게 필요한 것은 또 하나의 노트 습관이 아닙니다. 중요한 작업이 끝난 직후 고가치 기술 맥락을 확실하게 남기고, 다음번 비슷한 작업이 시작되기 전에 그 맥락을 다시 끌어올릴 수 있는 믿을 만한 방식이 필요합니다. archive는 일반 문서화를 위해 설계된 것이 아니라, 바로 그 워크플로를 중심으로 설계되었습니다.

archive가 일반 프롬프트와 다른 이유

일반 프롬프트로도 AI에게 “우리가 한 일을 요약해”라고 말할 수는 있습니다. 하지만 archive 스킬은 반복 가능한 저장 패턴, 반드시 수행해야 하는 메모리 인덱스 업데이트, 그리고 .archive/MEMORY.md가 있으면 세션 시작 시 자동으로 불러오는 훅까지 포함합니다. 그래서 archive for Knowledge Bases 용도로 실용적입니다. archive는 잊히는 markdown 파일 하나가 아니라, 이후 작업 맥락의 일부가 됩니다.

설치 전 알아둘 핵심 트레이드오프

archive는 의도적으로 단순합니다. 데이터베이스, 벡터 검색, 자동 분류 파이프라인은 제공하지 않습니다. 이 스킬의 가치는 잘 정돈된 파일 구조, 검색 가능한 태그, 메모리 인덱스에서 나옵니다. 팀이 .archive/MEMORY.md를 꾸준히 관리하지 않으면, archive 스킬의 장점 상당 부분이 사라집니다.

archive 스킬 사용 방법

archive 설치 시 먼저 볼 저장소 파일

실무적으로 괜찮은 archive install 경로는 다음과 같습니다.

1. 사용 중인 skills 시스템에 ReScienceLab/opc-skills 저장소의 스킬을 추가합니다.
2. 워크플로 이해를 위해 먼저 skills/archive/SKILL.md를 읽습니다.
3. 아카이브 결과물의 필수 형태를 보려면 skills/archive/references/TEMPLATE.md를 읽습니다.
4. 시작 시 컨텍스트 로딩 방식이 중요하다면 skills/archive/hooks/hooks.json과 skills/archive/hooks/load-memory.py를 확인합니다.
5. 의도된 동작을 최종 확인하려면 skills/archive/.factory-plugin/plugin.json을 봅니다.

지원 파일을 하나만 훑어봐야 한다면 references/TEMPLATE.md를 보세요. “좋은 archive 출력”이 어떤 모습인지 가장 직접적으로 보여줍니다.

archive 스킬이 입력으로 필요로 하는 것

archive 스킬은 다음 정보를 줄 때 가장 잘 작동합니다.

• 완료된 작업 또는 발생한 인시던트
• 핵심 결과
• 수행한 주요 단계
• 중요한 명령어, 설정 변경, 코드 결정
• 실패 지점과 최종 해결책
• 카테고리와 예상 태그
• 관련된 이전 archive 항목

이 정보 없이 실행하면 나중에 다시 봐도 도움이 되지 않을 만큼 두루뭉술한 archive가 되기 쉽습니다.

언제 archive를 실행해야 하나

다음과 같은 경우 archive를 사용하세요.

• 배포를 성공적으로 마친 뒤
• 까다로운 디버깅 세션이 끝난 뒤
• 마이그레이션이나 인프라 변경 후
• 큰 기능 개발을 완료한 뒤
• 사용자가 “이거 archive 해줘”라고 요청했을 때

사소한 수정마다 쓸 필요는 없습니다. 이 스킬은 잡음 많은 활동 로그가 아니라, 오래 남길 가치가 있는 학습 내용을 위한 도구입니다.

실무에서 archive 사용이 돌아가는 방식

권장 워크플로는 다음과 같습니다.

1. 관련 과거 작업이 있는지 .archive/MEMORY.md를 확인합니다.
2. .archive/YYYY-MM-DD/를 새로 만들거나 기존 디렉터리를 재사용합니다.
3. 템플릿 구조와 YAML frontmatter를 따라 markdown archive를 작성합니다.
4. .archive/MEMORY.md에 한 줄짜리 인덱스 항목을 추가합니다.
5. related 필드로 관련 항목을 연결합니다.

이 인덱스 업데이트는 형식적인 잡일이 아닙니다. 이후에 빠르게 찾아볼 수 있게 만드는 핵심 단계입니다.

archive 스킬에 더 강한 프롬프트 쓰기

약한 프롬프트:

• “Archive this session.”

더 좋은 프롬프트:

• “Use the archive skill to document today’s ECS deploy issue. Include the IAM permission error, the CloudWatch clue, the exact fix, final deploy status, tags for ecs, iam, deploy, category infrastructure, and add a one-line entry to .archive/MEMORY.md. If a related archive exists, link it.”

이처럼 더 강한 버전은 모델이 실제로 재사용 가능한 결과물을 만들 수 있을 만큼 충분한 구조를 제공합니다.

대략적인 목표를 완전한 archive 요청으로 바꾸는 법

원래 목표가 “배운 걸 저장하자” 수준이라면, 다음처럼 확장해 전달하세요.

• 무슨 일이 있었는지
• 왜 중요했는지
• 무엇이 실패했는지
• 무엇이 해결했는지
• 다음번에는 무엇부터 확인해야 하는지
• 어떤 카테고리에 들어가야 하는지
• 나중에 어떤 태그로 찾게 될지

이 스킬은 서사형 글쓰기보다, 검색과 재조회에 유리한 글쓰기에서 더 큰 효과를 냅니다.

archive 템플릿에서 특히 중요한 필드

references/TEMPLATE.md 기준으로 가장 중요한 필드는 다음과 같습니다.

• tags: grep 기반 검색을 위해
• category: 인덱스 정리를 위해
• related: 시간에 걸친 인시던트 연결을 위해

본문에서 특히 가치가 큰 섹션은 보통 다음입니다.

• Summary
• Issues Encountered & Solutions
• Key Changes

구체적인 수정 내용을 빼면 archive의 실사용 가치는 크게 떨어집니다.

세션 시작 메모리 훅이 사용 방식을 어떻게 바꾸는가

이 훅은 .archive/MEMORY.md 파일이 존재할 때 세션 시작 시 해당 내용을 컨텍스트로 불러옵니다. 즉, archive 스킬은 단순히 기록만 하는 도구가 아닙니다. 이후 회상을 자동으로 개선해 줍니다. 도입 관점에서 보면, 임시 메모 파일 대신 이 스킬을 설치해야 할 가장 강력한 이유 중 하나입니다.

Knowledge Bases용 archive와 팀 메모리

archive for Knowledge Bases 관점에서 보면, .archive/MEMORY.md는 목차이고 날짜별 markdown 파일은 각각의 인시던트 또는 작업 기록입니다. 이 구조는 다음과 같은 경우에 잘 맞습니다.

• 반복적으로 발생하는 운영 이슈
• 놓치기 쉬운 함정이 있는 릴리스 체크리스트
• 환경별 수정 사항
• 후속 영향이 있는 설계 결정

반면, 넓은 범위의 제품 문서나 사용자 대상 매뉴얼에는 덜 적합합니다.

실전 검색 및 조회 워크플로

이 스킬은 가벼운 검색을 명시적으로 지원합니다.

• .archive/MEMORY.md 검토
• grep -ri "keyword" .archive/ 사용

저장되는 내용이 좁고, 기술적이며, 구조화되어 있기 때문에 많은 엔지니어링 팀에는 이것만으로도 충분합니다. 나중에 사람들이 실제로 검색할 태그를 쓰는 것이 중요합니다. 예를 들어 서비스 이름, 에러 문자열, 플랫폼 이름, 컴포넌트 이름이 좋습니다.

archive 스킬 FAQ

이미 노트를 쓰고 있어도 archive를 설치할 가치가 있나?

있습니다. 지금 쓰는 노트가 찾기 어렵거나, 에이전트 컨텍스트에 다시 들어오지 않는다면 특히 그렇습니다. archive 스킬의 장점은 위치, 구조, 인덱싱, 세션 시작 시 메모리 로딩을 표준화해 준다는 데 있습니다.

이 archive 스킬은 초보자도 쓰기 쉬운가?

대체로 그렇습니다. 워크플로 자체는 markdown과 인덱스 파일 하나로 단순합니다. 초보자가 가장 흔히 겪는 위험은 요약을 너무 추상적으로 쓰는 것입니다. 템플릿을 복사해 구체적인 수정 사항, 명령어, 교훈을 채워 넣는 방식으로 시작하면 가장 쉽습니다.

언제 archive를 쓰지 말아야 하나?

다음에는 archive를 사용하지 마세요.

• 사소한 수정
• 일시적인 브레인스토밍
• 장문 문서 작성
• README.md나 runbook처럼 영구적인 저장소 문서에 들어가야 할 지식

정보가 항상 모든 기여자에게 지침이 되어야 한다면, .archive/에만 둘 것이 아니라 표준 문서에 있어야 할 가능성이 큽니다.

archive는 일반 프로젝트 문서와 어떻게 다른가?

일반 문서는 의도된 시스템을 설명합니다. 반면 archive 사용은 작업이나 인시던트 중 실제로 무슨 일이 있었는지를 기록합니다. 실패한 경로, 정확한 해결책, 그리고 보통은 사라져 버리는 맥락까지 담습니다. 즉, 표준 문서를 대체하는 것이 아니라, 과거 운영 경험을 남기는 메모리 레이어입니다.

archive에 특별한 도구가 필요한가?

많지 않습니다. 핵심 형식은 markdown 파일과 .archive/MEMORY.md뿐입니다. 저장소에는 세션 시작 시 메모리를 불러오는 훅도 포함되어 있지만, 그 훅이 없어도 archive 스킬은 규율 있는 저장 패턴으로 충분히 작동합니다.

이 archive 가이드가 다루는 범위는 어디까지인가

이 archive 가이드는 저장소가 실제로 지원하는 범위를 기준으로 합니다. 파일 기반 archive, 인덱싱된 메모리, 단순한 카테고리, 관련 링크, 훅 기반 회상까지는 포함합니다. 하지만 자동 요약 파이프라인, 시맨틱 검색, 외부 지식 베이스 동기화까지 약속하지는 않습니다.

archive 스킬을 더 잘 활용하는 방법

스토리텔링이 아니라 검색 가능성을 기준으로 archive를 작성하기

좋은 archive 결과물은 나중에 빠르게 훑어볼 수 있어야 합니다. 미래의 독자가 문제, 해결책, 핵심 명령어를 곧바로 찾을 수 있는 위치에 배치하세요. 다듬어진 서사보다, 직설적이고 검색 가능한 기록이 더 가치 있습니다.

사람들이 실제로 검색할 태그를 쓰기

좋은 태그:

• 서비스 또는 도구 이름
• 정확한 서브시스템 이름
• 배포 플랫폼 이름
• 에러 키워드
• 영향받은 환경 이름

나쁜 태그:

• issue, work, update 같은 모호한 단어

이 부분은 archive 사용 품질을 크게 끌어올리는 가장 레버리지가 큰 개선점 중 하나입니다.

MEMORY.md를 형식적인 파일이 아니라 실제로 쓸모 있게 만들기

약한 인덱스 항목:

• “Fixed deployment issue”

강한 인덱스 항목:

• “ECS deploy failed due to missing IAM permission for secret access; resolved by updating task role policy”

인덱스는 다음에 어떤 archive를 열어야 할지 판단하는 데 도움을 줘야 합니다.

이후 판단에 영향을 주는 실패 시도도 함께 남기기

팀이 올바른 해결책 전에 두 번 잘못된 수정을 시도했다면, 같은 낭비를 반복하지 않도록 그 내용도 포함하세요. archive 스킬이 표준 문서보다 강한 지점이 바로 여기입니다. 의미 있는 막다른 길까지 보존할 수 있습니다.

더 나은 archive 결과를 원하면 입력부터 더 좋게 준비하기

스킬에 archive를 요청하기 전에 다음을 모아두세요.

• 정확한 에러 문구
• 관련 명령어
• 변경된 파일이나 설정
• 최종적으로 검증된 상태
• 왜 최종 수정이 효과가 있었는지

이런 세부 사항은 이후 재사용성과 검색 가능성을 실질적으로 높여 줍니다.

archive 스킬 사용에서 자주 생기는 실패 패턴

대표적인 문제는 다음과 같습니다.

• .archive/MEMORY.md 업데이트 누락
• 너무 일반적인 태그
• 불명확한 카테고리
• 운영 세부사항 없는 요약
• 이전 인시던트와 연결되지 않은 archive 항목

대부분의 부실한 archive 결과는 템플릿 자체보다 입력이 불완전해서 생깁니다.

첫 archive 초안 뒤에 한 번 더 다듬기

첫 초안 작성 후에는 다음을 점검하세요.

• 사람들이 예상할 검색어로 이 항목을 찾을 수 있는가?
• 요약에 결과와 원인이 함께 드러나는가?
• 핵심 명령어 또는 설정 변경이 포함되어 있는가?
• 미래의 에이전트가 무엇부터 시도해야 할지 알 수 있는가?
• 더 오래된 관련 항목과 연결해야 하는가?

짧게 한 번만 더 손봐도 archive 품질은 크게 올라갑니다.

영구 문서를 대체하지 말고 archive와 함께 쓰기

세션을 통해 영구적으로 남겨야 할 규칙이 드러났다면, canonical doc도 함께 업데이트하세요. archive 스킬은 사건 단위 지식을 보존하는 역할이어야지, 중요한 팀 가이드가 오직 그 안에만 남는 구조가 되어서는 안 됩니다.

명확한 팀 트리거로 archive 도입 효과 높이기

팀은 archive를 언제 남길지 명시적인 트리거를 정해 둘 때 더 좋은 결과를 얻습니다. 예를 들면 다음과 같습니다.

• 예상치 못한 문제가 있었던 모든 프로덕션 배포
• 해결책이 자명하지 않았던 모든 인시던트
• 모든 마이그레이션
• “다음에도 보게 저장해 둬”라는 모든 사용자 요청

이렇게 하면 archive를 잡음으로 채우지 않으면서도 충분히 가치 있게 유지할 수 있습니다.