methodize

name	methodize
description	긴 AI 페어링 세션에서 잘 풀린 작업의 접근법(순서와 판단 기준)을 재사용 방법론 문서로 추출. 대화 원문(raw)과 학습용 발췌를 함께 남긴다. 컨텍스트 압축 전 체크포인트 호출이 1차 사용이다. 같은 세션에서 여러 번 불러도 같은 문서로 수렴(증분). 호출은 `/methodize [방법론명]`이며 인자 있으면 그 방법론에 증분. large-context 모델 기준, effort는 high.
when_to_use	접근법을 방법론으로 승격, 잘 풀린 세션의 절차 추출, 재사용 가능한 방법론 문서화.
disable-model-invocation	true
allowed-tools	Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion
effort	high

methodize, 세션에서 방법론 추출

세션의 작업 방식(순서와 판단 기준)을 재사용 방법론과 학습용 발췌로 추출한다. **개념과 게이트와 산출 스펙의 기준 문서는 같은 폴더의 session-to-methodology.md**이다. 실행 전 반드시 read. 이 파일은 실행 절차만 담는다.

용어 (처음 읽는 사람용):

• 컨텍스트 압축(compaction): 긴 대화에서 오래된 내용이 요약으로 대체되는 것. 요약 후엔 원문 표현이 사라진다
• 세션 기록(transcript): Claude Code가 세션마다 디스크에 남기는 .jsonl 파일이다. 압축과 무관하게 원문이 실시간 기록됨(약 28일 보관)
• ledger(처리 대장): 어느 세션에서 무엇을 추출했는지 기록하는 파일이다. 재호출 시 같은 문서로 수렴시키는 장치

대상

• 현재 세션에 "방법론감" 완료 작업(품질 좋은 결과물이나 오래 주고받으며 만든 산물)이 있을 때. 압축 전 체크포인트 호출이 1차 사용
• 재호출(압축 후 이어진 대화 종료나 세션 말)은 같은 문서로 증분 수렴한다 (문서 2개 금지)
• /methodize 단독은 자동 판별, /methodize {방법론명}은 증분 대상 지정

절차 (7단계, 깔때기: 원문에서 여정, 구조, 알맹이로)

아래 순서대로 진행한다. 단계 이름은 기준 문서 session-to-methodology.md의 파이프라인과 대응한다.

가치 게이트와 매칭

1. ledger 1순위 조회: .claude/methodology/.extracted-sessions에서 현 세션 ID($CLAUDE_CODE_SESSION_ID 환경변수) 항목 확인. 있으면 그 문서가 기본 증분 대상(체크포인트 N+1). 파일이 없으면 "추출 이력 없음"으로 간주하고 진행(첫 실행이 정상. ledger는 미리 만들지 않고 첫 기록 시점인 가치 게이트 기각 또는 산출 단계에서 스킬이 생성)
2. 없으면 기존 방법론 매칭: category: methodology frontmatter를 가진 문서를 지식베이스 전역에서 grep. 후보가 여럿이면 전부 열거
3. 가치 3질문(반복될 작업인가? 남에게 전파할 가치가 있나? 기존 방법론의 사례 1건으로 충분한가?)에 답을 표기하고 AskUserQuestion 1회로 확정한다. **기본 선택지는 "추출 안 함"**이다(모델 단독 판정은 관대해지므로 근거 표기와 사용자 확정이 견제 장치)
4. 기각도 ledger에 기록(기각:{사유})

원문 확보 [원석]

1. 세션 기록에서 사용자와 AI 대화 텍스트를 추출한다. 도구 호출과 시스템 노이즈는 제외한다:

PROJ="$HOME/.claude/projects/{프로젝트 경로 치환 디렉터리}"
SID="$CLAUDE_CODE_SESSION_ID"
jq -r 'select(.type=="user" or .type=="assistant")
  | (if .type=="user" then "\n----- [USER] -----\n" else "\n----- [ASSISTANT] -----\n" end) as $hdr
  | (.message.content | if type=="string" then [.] elif type=="array" then [.[]|select(.type=="text")|.text] else [] end)
  | select(length>0) | $hdr + (join("\n"))' "$PROJ/$SID.jsonl"

2. 비표준 경로 사용자 발화 표적 회수. 실측 기준, 사용자 발화는 네 경로로 저장되며 기본 필터는 세 번째와 네 번째를 놓친다:

   1. 일반 메시지
   2. 인터럽트와 메시지. 위 두 가지는 text 블록이라 기본 필터가 잡는다
   3. 도구 거부 사유와 AskUserQuestion 답변. tool_result에 내장된다. the user said:와 Your questions have been answered 패턴으로 회수
   4. 작업 중 도착 메시지. queue-operation 타입의 .content로 회수

   세 번째와 네 번째를 보강 섹션으로 append

3. .claude/methodology/cases/raw/{세션ID}.md에 즉시 Write한다. ## Checkpoint N ({시각}) 섹션이다. 재호출은 마지막 체크포인트 이후 델타만 append (기존 섹션 수정 금지)

4. 추출 후 검증: 발췌 후보 핵심 발화를 raw에서 grep으로 실재 확인한다. 없으면 보강 회수, 그래도 없으면 [재구성] 태그

5. 이후 모든 따옴표 인용은 이 파일에서만 한다. 세션 기록 접근 실패 시 폴백은 라이브 대화, 산출물 diff, 사용자 재진술 순이며 [재구성] 태그를 단다(따옴표 금지)

여정 정리 [1차 증류]

원문 기반 타임라인(트리거에서 전환점, 산출로). 재호출은 델타 구간만.

구조와 층위 [2차 증류]

구조 판별 질문(앞 산출이 다음 입력이면 파이프라인, 순서 무관 점검이면 체크리스트, 판단 규범이면 원칙. 혼합 허용하되 지배 구조 하나 선택)과 층위 분리(범용 후보 대 이 도메인 특화). "범용" 라벨은 명시 적용 2건 전까지 "범용 후보"로만 둔다. 1건에서 "어디에나 적용" 단정 금지.

기억 보강 (원문에 없는 암묵지)

1. 기준 문서의 시드 체크리스트("이것도 하셨나요?"라는 작업 유형별 표준 요소)와 "이것 말고 또?"와 비효율, 왕복 질문을 AskUserQuestion 1회 다중선택으로 배치. 질문 총 상한 3회
2. 답변 수신 즉시 발췌 초안에 append (실행 중 압축 대비. 중간 영구화)
3. 검증 게이트: 기억으로 복원된 단계는 산출물 흔적(파일, 커밋, 문서)과 대조해 [실측] 또는 [기억-미확인]으로 표기한다(후자는 본문 아닌 후보란에 격리). 사람의 회상("분명 했을")은 틀릴 수 있다. 검증 없이 영구 문서에 넣지 않는다
4. 무응답이면 [미보강] 태그와 ledger 상태 기록 후 진행. 재개는 재호출 시 [미보강] 항목이 이 단계의 재진입점

다듬기와 회고와 자체 비판

정합성 재독과 비효율, 왕복까지 기록(잘한 것만 담으면 미화)과 승격 직전 자체 비판 재독("정직성 원칙을 이 문서 자신에게 적용했는가. 사례 수 표기, 한계, 회고"). 공개 예정 문서는 적대적 검토(예를 들어 red-team 계열 스킬이나 에이전트) 권장.

산출 형식: 결론 먼저(BLUF), 훑어도 구조가 잡히게(표와 라벨 불릿), 독자 우선. 외부 노출본은 추가로 내부 경로 참조 금지, 전문용어 풀어쓰기, 정량 표기, 추측과 확정 구분.

산출 [알맹이]

1. 신규: .claude/methodology/{slug}.md. frontmatter에 provenance: n=1 정직 표기
2. 증분: diff 미리보기 후 사용자 승인 후 Edit. 기존 서술과 모순(CONFLICT)이면 자동 수정 금지하고 좌우 비교표로 사용자 확정
3. 학습용 발췌: cases/{slug}-{YYYY-MM-DD}-{주제}.md. 발췌 단위는 4연쇄(before 상태, 사용자 발화 원문 인용, AI 반응, 산출 변화)에 맥락과 So What 각 1줄. 인용은 원문 확보 파일에서만. 시크릿과 개인정보 마스킹
4. 방법론 부록 사례 표에 발췌 링크 1행 append (적용만 한 세션도 1행. 재사용 추적)
5. ledger 기록과 종료 안내. 아래 두 가지를 반드시 출력:
   • 검토 순서 (사용자 약 5분): 첫째 방법론 본체로 [미보강]과 [기억-미확인] 태그(사용자 답이 필요한 곳), 회고 절, provenance 정직성을 본다. 둘째 학습용 발췌로 인용의 맥락 적합을 본다. 셋째 ledger 마지막 행 상태를 본다. 원문(raw)은 안 봐도 됨(아카이브라 인용 확인이나 재증류 때만)
   • 전파 제안: 사내 게시 채널, 또는 공개 배포(익명화와 정직 표기 전제)

ledger (수렴 장치)

.claude/methodology/.extracted-sessions. 1행 1레코드 (모든 경로 기본값은 .claude/methodology/이며 별도 지식베이스를 쓰면 일괄 교체):

{세션ID} | {slug 또는 추출안함} | checkpoint {N} | {완료|미보강|기각:사유} | {산출 경로} | {ISO 시각}

키는 (세션ID, slug) 쌍이다. 재호출 시 같은 키가 있으면 차단이 아니라 그 문서로 증분하고 checkpoint N+1. 원문 확보와 여정 정리는 마지막 시각 이후 델타만.

경계 (유사 작업과 구분)

작업	이 스킬과 차이
세션의 사실과 결정 기록	재사용 단위가 '사실'이면 지식 노트로, '절차(어떻게)'면 methodize
단건 시행착오 기록	교훈 1건이면 트러블슈팅 노트가 먼저. 반복 구조가 보이면 methodize
그날 회고	회고는 그날의 기록. methodize는 재사용 방법론
다음 세션 인계	인계 독자는 다음 세션 모델. methodize 독자는 동료와 신입

제약

• 따옴표 인용은 원문 확보 파일에서만 한다. 기억 재구성 인용 금지([재구성] 태그 경로 예외)
• 기존 문서 수정은 diff 미리보기와 승인 없이 금지
• [미보강]과 [기억-미확인] 잔존 상태로 공개 배포 금지
• 시크릿과 개인정보 마스킹(발췌 포함). 타인 발화 인용은 내부 공유도 주의
• 이모지와 모델 버전 토큰 금지