Community코딩 & 개발github.com

context-curation-base

회고/계획 수립 후 프로젝트 파일 컨텍스트를 체계적으로 정리하는 프레임워크입니다. 주간/월간 회고 후 또는 컨텍스트가 부풀어올랐다고 느껴질 때 트리거됩니다.

context-curation-base란 무엇인가요?

이 스킬은 AI 어시스턴트(Claude Code, Cursor 등)가 프로젝트 파일의 컨텍스트를 효율적으로 관리할 수 있도록 설계된 '컨텍스트 큐레이션' 프레임워크입니다. 주간/월간 회고 및 계획 수립이 완료된 후, 또는 컨텍스트가 과도하게 부풀어올랐다고 느껴질 때 트리거됩니다. '프랙탈 압축' 패턴을 따라 요약 수준이 올라감에 따라 하위 수준의 원본 데이터를 아카이빙합니다. 아카이빙 전에는 참조 문서에 추출 가능한 데이터(진행률, 프로토콜 변경사항 등)를 먼저 접어넣고(fold), 이후 주 단위 애드endum을 본 문서에 압축(compress)합니다. 모든 결정은 사용자의 최종 확인을 거치며, 각 시간 단위별로 최소 하나의 문서를 유지하는 원칙을 따릅니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZachBeta/claude-as-coach/tree/main/skills/context-curation-base

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

컨텍스트 큐레이션 스킬

생성일: 2026년 1월 19일 월요일
업데이트일: 2026년 1월 20일 화요일
목적: 회고/계획 수립 세션 후 프로젝트 파일 컨텍스트를 체계적으로 관리하는 프로세스
상태: 실험적


개요

컨텍스트 큐레이션은 "프랙탈 압축" 패턴을 따릅니다. 각 요약 수준은 이전 수준의 원시 입력을 아카이빙 가능하게 만듭니다. 아카이빙하기 전에 추출 가능한 데이터를 애드endum이나 참조 문서에 접어넣습니다.

트리거 구문:

  • "context curation"
  • "clean up project files"
  • "archive old summaries"
  • "what can we remove"

압축 계층 구조

일일 요약 → 주간 회고 → 월간 회고 → 분기 회고 → 연간 회고
다음 완료 후...다음을 아카이빙할 수 있음...
일일 요약해당 일의 원시 대화 로그
주간 회고해당 주의 일일 요약
월간 회고해당 월의 주간 회고
분기 회고해당 분기의 월간 회고
연간 회고해당 연도의 분기 회고

원칙: 각 세분화 수준에서 최소 하나의 복사본을 유지합니다.


최소 보존 기준

각 세분화 수준에서 최소 하나의 문서를 유지합니다:

수준최소 보존 대상
일간가장 최근 요약 1-2개
주간이번 주 계획 + 가장 최근 회고
월간이번 달 계획 + 가장 최근 회고
분기이번 분기 계획 + 가장 최근 회고
연간올해 계획 + 가장 최근 회고

원칙: 압축 후에도 각 시간 척도에서 최근 상태를 볼 수 있는 능력을 유지합니다.


아카이브 전 접기

일일 요약을 아카이빙하기 전에 참조 문서에 유지되어야 할 데이터를 추출합니다.

추출할 항목

  • 정량적 진행 상황 (횟수, 시간, 측정값, PR)
  • 프로토콜 변경 또는 발견 사항
  • 추적 항목의 상태 업데이트
  • 확인된 추가 사항 (새로운 안전식품, 새로운 동작 등)

추출 위치

데이터를 축적하는 참조 문서의 애드endum 파일:

  • Reference-Doc.md → Reference-Doc-Addendum-YYYY-MM-DD-to-DD.md
  • 날짜 범위는 주간 회고 기간과 일치
  • 예시: Training-Log-Addendum-2026-02-16-to-22.md

간단한 상태 변경을 위한 직접 업데이트:

  • 단일 값 변경은 기본 문서에 직접 적용 가능
  • 수준 진행, 상태 전환 등

애드endum 명명 패턴

{Reference-Doc}-Addendum-YYYY-MM-DD-to-DD.md

날짜 범위는 처리 중인 주간 회고와 일치합니다.

애드endum 압축 시기

주간 큐레이션 중 애드endum을 기본 문서로 접습니다:

  1. 애드endum 내용 검토
  2. 기본 문서의 적절한 섹션에 통합
  3. 기본 문서의 수정일 업데이트 (예: **Updated:** 2026-02-23)
  4. 업데이트된 문서를 프로젝트에 저장 (이전 버전 대체)
  5. 처리된 애드endum 아카이브

수정일이 중요한 이유: Claude가 참조 문서의 아티팩트를 생성할 때 수정일이 어떤 버전이 최신인지 명확히 합니다. 이전 버전은 프로젝트에서 아카이브/제거할 수 있습니다.

참조 문서 버전 관리

파일명에 날짜 포함 (정기 개정에 선호):

  • Identity-Ecosystem-2025-12.md → Identity-Ecosystem-2026-03.md
  • 새 버전 생성 시 이전 버전 아카이브

내용에 업데이트 포함 (점진적 업데이트용):

  • 동일 파일명 유지, 내부 **Updated:** YYYY-MM-DD 업데이트
  • 애드endum이 작은 변경 사항을 접을 때 작동

파일 카테고리

항상 유지 (참조 문서)

"롤업"되지 않고 지속적인 참조 가치가 있는 문서:

  • 프로토콜 문서 (훈련 계획, 영양 가이드라인, 회복 루틴)
  • 프레임워크 문서 (목표 계층 구조, 진행 상황 추적 시스템)
  • 컨텍스트 문서 (현재 상태, 배경 정보)
  • 연구 계획 (진행 중인 조사 스레드)

현재 계층 유지

각 시간 척도에서 가장 최근 문서:

  • 이번 주 계획 + 가장 최근 주간 회고
  • 이번 달 계획 + 가장 최근 월간 회고
  • 가장 최근 일일 요약 1-2개 (현재 대화에 연결)

아카이브 후보

내용이 상위 수준 요약에 합성된 문서:

  • 주간 회고에 포함된 일일 요약 (추출 완료 후)
  • 월간 회고에 포함된 주간 회고
  • 과거 주간 계획 (실행 완료, 회고 완료)
  • 과거 월간 계획 (월간 회고가 결과를 포착한 후)
  • 처리된 애드endum (기본 문서에 접힘)
  • 이전 버전의 참조 문서 (업데이트된 버전으로 대체됨)

프로세스

1. 시간 경계 식별

어떤 회고가 방금 완료되었습니까?

  • 주간 회고 → 해당 주의 일일 요약을 아카이빙할 수 있음
  • 월간 회고 → 해당 월의 주간 회고를 아카이빙할 수 있음

2. 일일 요약에서 추출 가능 데이터 검토

아카이빙할 일일 요약을 스캔하여:

  • 참조 문서에 속하는 정량적 데이터
  • 프로토콜 변경 또는 확인 사항
  • 지속되어야 할 진행 마커

3. 애드endum으로 추출

추출 가능한 데이터가 있는 각 참조 문서에 대해:

  • 이번 주에 대한 애드endum 파일 생성 또는 추가
  • 명명 규칙 사용: {Reference-Doc}-Addendum-YYYY-MM-DD-to-DD.md

4. 애드endum을 기본 문서로 압축

이전 주의 애드endum이 존재하는 경우:

  • 애드endum 내용 검토
  • 기본 문서의 적절한 섹션에 통합
  • 아카이빙 대상으로 애드endum 표시

5. 아카이브 후보 목록 작성

프로젝트 파일을 빠르게 검토:

  • 참조 문서: 목록 작성, 유지 확인, 최신 상태 확인
  • 현재 계층: 각 척도에서 가장 최근 문서 식별
  • 아카이브 후보: 이유와 함께 목록 작성

형식:

**EXTRACT - 이번 주 일일 요약에서:**
- [파일]: "[데이터]" → [애드endum 파일]

**COMPRESS - 접을 준비가 된 애드endum:**
- [애드endum 파일] (N 항목) → [기본 문서]

**KEEP - 참조 문서:**
- [파일] - [명확하지 않은 경우 간단한 이유]

**KEEP - 현재 계층:**
- [파일] - [해당 계층: 일간/주간/월간]

**REFRESH - 오래되었을 수 있음:**
- [파일] - [업데이트가 필요할 수 있는 이유]

**ARCHIVE - [회고 이름]에 접힘:**
- [파일]
- [파일]

갱신 트리거 (참조 문서는 아카이빙되지 않지만 오래될 수 있음):

  • 시간 기반: 마지막 업데이트가 30일 이상 경과
  • 이벤트 기반: 주요 이정표, 수준 변경, 프로토콜 전환
  • 내용 기반: 정보가 최근 요약/회고와 모순됨

6. 사용자 확인 및 아카이브

사용자가 다음과 같이 반응합니다:

  • ✓ (추천 동의)
  • ✗ (특정 파일 유지/재고)
  • 추가 컨텍스트 ("X도 아카이브" 또는 "실제로 Y는 유지, 이유는...")

그런 다음 사용자가:

  • 데이터를 애드endum으로 추출
  • 애드endum을 기본 문서로 압축
  • 아카이브된 파일을 프로젝트에서 제거

엣지 케이스

명확히 포함되지 않은 파일

특정 기간의 회고가 누락되었거나 불완전한 경우:

  • 적용 범위가 확보될 때까지 하위 수준 문서 유지
  • 예: 12월 월간 회고가 해당 주를 명확히 포함하지 않는 경우 11주 회고 유지

업데이트가 필요한 참조 문서

일부 "참조" 문서는 오래될 수 있음:

  • 훈련 계획 → 체력 수준 변화에 따라 업데이트
  • 장비/기어 목록 → 요구 사항 변화에 따라 업데이트
  • 목표 프레임워크 → 주요 이정표 전환 후 업데이트

아카이브 대신 갱신 플래그를 지정합니다.

혼합 요약

일일 요약이 여러 날에 걸쳐 있는 경우 (날짜 누락 또는 결합 입력으로 인해):

  • 주간 회고가 해당 기간을 포함한 후에도 아카이브
  • 혼합 자체는 회고에 포착됨
  • 아카이빙 전에 정량적 데이터 추출

추출 가능 데이터 없음

일일 요약에 추출할 정량적/프로토콜 데이터가 없는 경우:

  • 추출 단계 건너뛰기
  • 아카이빙으로 바로 진행
  • 회고 합성으로 충분함

결정 원칙

  1. 아카이브 전에 접기: 소스를 제거하기 전에 영구 데이터 추출
  2. 의심스러우면 유지: 나중에 항상 아카이빙 가능
  3. 압축은 신호를 보존: 상위 수준 합성이 중요한 것을 포착
  4. 컨텍스트는 유한: 프로젝트 파일은 대화 품질에 영향
  5. 최근 > 오래됨: 과거 문서보다 최근 문서 유지 선호
  6. 참조 > 시간적: 참조 문서가 요약보다 수명이 김

예시 세션

Rob의 달리기 프로젝트, 8주차 회고 후:

Claude: 컨텍스트 큐레이션을 시작하겠습니다. 먼저 아카이빙 전에 추출할 데이터가 있나요?

**EXTRACT - 이번 주 일일 요약에서:**
- Summary-02-16: "3.1mi at 9:45 pace" → Training-Log-Addendum-2026-02-16-to-22.md
- Summary-02-18: "New stretching routine working well" → Recovery-Protocol-Addendum-2026-02-16-to-22.md
- Summary-02-20: "PR: 5K in 28:32" → Training-Log-Addendum-2026-02-16-to-22.md

**COMPRESS - 접을 준비가 된 애드endum:**
- Training-Log-Addendum-2026-02-09-to-15.md (4 항목) → Training-Log.md
- Recovery-Protocol-Addendum-2026-02-09-to-15.md (2 항목) → Recovery-Protocol.md

**KEEP - 참조 문서:**
- Training-Plan-5K.md
- Race-Schedule-2026.md
- Training-Log.md
- Recovery-Protocol.md

**KEEP - 현재 계층:**
- Weekly-Plan-2026-02-23.md (현재)
- Weekly-Retro-2026-02-16.md (방금 생성)
- Summary-02-21.md, Summary-02-22.md (가장 최근)

**REFRESH - 오래되었을 수 있음:**
- Training-Plan-5K.md - 마지막 업데이트 6주 전, 4주차 인터벌을 넘어 발전함

**ARCHIVE - 8주차 회고에 접힘:**
- Weekly-Plan-2026-02-16.md
- Summary-02-16.md 부터 Summary-02-20.md 까지
- Training-Log-Addendum-2026-02-09-to-15.md (압축 후)
- Recovery-Protocol-Addendum-2026-02-09-to-15.md (압축 후)

사용자: 훈련 데이터를 애드endum으로 추출했습니다. 지난주 애드endum을 기본 문서로 압축했습니다. 나머지는 아카이브했습니다.

Claude: 좋습니다. 데이터가 참조 문서에 보존되었습니다. 컨텍스트가 큐레이션되었습니다.

통합 노트

트리거 시점:

  • 주간 회고 + 계획 수립 완료 후
  • 월간 회고 + 계획 수립 완료 후
  • 컨텍스트가 부풀어오르거나 대화 품질이 저하될 때

일반적인 주간 큐레이션 흐름:

  1. 주간 회고 (요약의 요약)
  2. 주간 계획 수립
  3. 컨텍스트 큐레이션: a. 일일 요약에서 추출 → 애드endum b. 애드endum 압축 → 주요 참조 문서 c. 일일 요약 아카이브 (이제 회고에 접힘) d. 처리된 애드endum 아카이브 (이제 주요 문서에 접힘)

인지 부하:

  • 가볍게 유지 (빠른 검토, 심층 분석 아님)
  • 사용자가 각 파일에 대한 최종 결정을 내림
  • 에너지가 부족할 때 결정을 강요하지 않음

스킬 의존성:

  • 회고 스킬과 함께 작동 (해당 출력 사용)
  • 계획 수립 스킬과 함께 작동 (계획 수립 완료 후 실행)

"아카이브 전에 접으세요. 각 계층에서 가장 최근 것을 유지하세요."

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

관련 스킬