Document Task

document-task

• This skill describes how to automatically document (organize) the conversation just before it ends.
  • If classified as Research, append to CLAUDE.local.research.md; if Task, append to CLAUDE.local.task.md using the specified format.
• The output language is always Korean, and files must be saved with UTF-8 encoding.

Instructions

동작 순서 (구체적 절차)

1) 기록 여부 판단 (Document / Skip)

아래의 판단 규칙을 적용해 기록 필요성이 높은 경우에만 문서에 추가합니다. 판단은 마지막 유저 메시지(의도)를 우선으로 하며, 추가 컨텍스트(대화 길이, 포함된 코드/파일/명령 등)를 반영합니다.

기록할 것 (예시 신호 — 하나라도 해당하면 기록 권장)

• 새로운 요구사항/기능 요청/스펙 결정: "이 기능을 이렇게 구현하자", "API 계약은 X로 한다"
• 배포/마이그레이션/구성(인프라) 변경 지시나 결정: "이제 DB 마이그레이션을 포함해야 함"
• 코드·설계 수정 지시 또는 패치 요청(구체적 파일/라인/명령 포함)
• 테스트 케이스, 재현 방법, 버그 리포트(재현 단계/로그/증상)
• 명확한 CLI/스크립트/설치/운영 명령이 포함된 경우(예: sudo apt ..., yarn build)
• breaking change, 호환성 주의, 보안 관련 알림
• 사용자가 '이 내용을 문서화 해달라'고 직접 요청한 경우

기록하지 않을 것 (무시 사례 — 예시)

• 단순 인사/잡담/간단 확인 질문: "안녕", "오늘 어때?"
• 단순 확인·재진술(clarifying) 질문: "그러니까 이건 ~라는 뜻이죠?" (사용자가 이해 확인 목적일 때)
• 아주 짧고 의미없는 반응(예: "좋아요", "응")
• 단순 오타 지적 후의 확인(사용자가 지적한 것이 실제로 문서 수정이 필요한 수준이 아닐 때)

추가 규칙(수정/정정 처리)

• 사용자가 이전 세션에서 기록된 항목의 오류를 지적했을 때:
  • 사용자의 지적이 사실인 경우: 해당 마크다운 파일의 관련 부분을 수정(덮어쓰기/보정)합니다.
  • 지적이 사실이 아닌 경우: 파일을 변경하지 않습니다. (대화 내 근거를 간단히 메모할 수 있음)

2) 분류: Research vs Task

• Research: 질문/정보 요청, 조사·레퍼런스 수집, 설계 검토 등
• Task: 구현·수정·버그 해결·코드 작성·명령 실행 요청 등
• 분류는 휴리스틱(키워드 + 의도)으로 결정하며 모호하면 Research로 보수적 기록.

3) 대상 파일 결정

• Research → CLAUDE.local.research.md
• Task → CLAUDE.local.task.md
• 파일이 없으면 생성.

4) 항목 식별자 (타임스탬프 + ID 사용)

• 각 항목은 아래 메타로 식별:
  • 작성일 (Asia/Seoul 기준, 예: 2025-11-10 15:23:05 (KST))
  • entry_id (에포크초 또는 에포크초 + 짧은 해시, 예: 1699659785)
• 이 방식은 LLM 토큰 소모를 줄이고 충돌 가능성도 낮습니다.

5) 코드 블록의 파일·라인 위치 탐색

• 코드 블록(...)이 포함된 경우, 대표적인 3~5줄을 추출
• Grep 도구로 저장소에서 부분/정확 매칭 시도:
  • 예: Grep(pattern="extracted_lines", output_mode="content", -n=true)
  • 찾으면 코드 위치를 <파일 경로>:<시작행>-<끝행> 형식으로 "특이사항" 섹션에 기록
  • 찾지 못하면 원문 코드 블록은 "질문 원본"에 포함하되, 위치 표기는 생략
• 디렉토리 범위는 프로젝트 루트(.)로 제한
• 여러 파일에서 발견될 경우, 가장 관련성 높은 파일 1~2개만 기록

6) 기록 포맷 (번호 없음 — 타임스탬프/ID 사용)

• 항목은 아래 템플릿으로 append 합니다.
• 각 프롬프트 문서화 섹션 사이는 {entry_id} 종료\n---으로 구분합니다.
  • 혼선 방지를 위해, 위 용도 외에는 ---는 절대 사용하지 않습니다.

# 제목: {문서 제목 — 프롬프트의 핵심을 간결히}

- 작성일: {YYYY-MM-DD HH:MM:SS (KST)}
- entry_id: {epoch_seconds_or_short_id}

## 질문 원본

<user-prompt>
“{개발자가 입력한 프롬프트 원문(정확 복사)}”
</user-prompt>

## 답변

(assistant의 답변 — 최대한 자세하게. 별도로 요약하지 말것)

## 특이사항 (있는 경우)

- 코드 위치: <파일 경로>:<시작행>-<끝행> (가능한 경우만)
- 기타: (마이그레이션 필요, BREAKING CHANGE 등)

## {entry_id} 종료

...

7) 출력/반환

• 성공 예: ✅ CLAUDE.local.research.md에 entry_id #1699659785 추가
• 기록 불필요: ℹ️ 기록 불필요 판단: 대화는 문서화 대상이 아님
• 오류: ⚠️ 파일 쓰기 실패: 권한 문제 또는 알 수 없는 이슈

Resources

Examples

완전한 Research 및 Task 항목 예시는 references/example.md를 참고하세요. 올바른 포맷팅과 구조를 확인할 수 있습니다.

Template

새 항목을 작성할 때는 assets/template.md를 포맷팅 템플릿으로 사용하세요.