fade-away은(는) 무엇을 하나요?
사용자가 작업을 전환하고 맥락을 다시 설명하지 않고도 개인 LLM 지식 베이스를 구축할 수 있도록 가벼운 로그 -> 토픽 위키 -> 지수 -> 주간 MOC -> 지식 위키 메모리 계층을 유지합니다.
운영 계약
이 스킬은 첫 번째 턴뿐만 아니라 전체 대화에 걸쳐 실행됩니다. 각 어시스턴트 응답 전에, 턴이 세션 시작, 턴별 저장, 토픽 전환, 수동 기록, 토픽 승격, 주간/대시보드/린트, 또는 지식 승격을 트리거하는지 확인하세요. 가장 흔히 놓치는 규칙은 턴별 저장입니다: 모든 실질적인 어시스턴트 턴은 활성 저널 항목에 한 줄의 (HH:MM) <진행>을 추가합니다.
핫 경로를 작게 유지하세요. 빈도가 낮은 메커니즘은 references/에 두고 트리거가 발동될 때만 로드하세요.
경로
<VAULT_ROOT>는 fade-away가 유지 관리하는 Obsidian 볼트입니다. 세션당 한 번, 다음 순서로 해석합니다:
- 프로젝트의
AGENTS.md/CLAUDE.md에 선언된Vault root필드 (부트스트랩 설치 프로그램scripts/bootstrap_vault.py가 작성). - 해당 필드가 없으면 현재 프로젝트/작업 디렉토리를 볼트 루트로 처리합니다.
읽거나 쓰기 전에 항상 <VAULT_ROOT>를 해당 절대 경로로 확장하세요:
- 저널:
<VAULT_ROOT>/03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-MM-DD.md여기서<YYYY-MM>은 날짜의 해당 월,<YYYY-Wnn>은 해당 날짜의 ISO 주입니다. - 주간 지수:
<VAULT_ROOT>/03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-Wnn 周索引.md여기서<YYYY-MM>은 해당 주의 일요일이 포함된 월입니다. - 작업 지수:
<VAULT_ROOT>/00 Tasks/_Index.md - 토픽 페이지:
<VAULT_ROOT>/00 Tasks/<topic-filename>.md - 지식 페이지:
<VAULT_ROOT>/02 Knowledge/<domain>/<page>.md - 참조: 이 스킬의
references/디렉토리
00 Tasks/ 또는 _Index.md가 없으면 세션 동안 작업 지수 및 토픽 로직을 건너뜁니다. 세션 중간에 00 Tasks/를 자동 생성하지 마세요. 저널 로깅은 계속 실행됩니다.
备忘.md와 같은 최상위 파일은 03 Journal/ 아래에 직접 위치할 수 있습니다. 이동하지 마세요.
시간대 규칙
이 스킬이 기록하는 모든 날짜와 시간은 볼트 시간이라는 하나의 일관된 시간대를 사용해야 합니다. 프로젝트의 AGENTS.md / CLAUDE.md에 있는 Time zone 필드에서 볼트 시간을 확인하고, 설정되지 않은 경우 시스템의 로컬 시간대로 대체합니다. 부트스트랩 설치 프로그램은 기본값을 Asia/Hong_Kong으로 설정하므로, 설정되지 않은 볼트는 Asia/Hong_Kong / GMT+8 / UTC+8로 동작합니다.
저널 파일 이름, 상위 경로, 제목, 진행 줄, 토픽 프론트매터, _Index.md 타임스탬프 및 주간 지수 추론에 볼트 시간을 사용하세요.
권장 셸 확인 (구성된 시간대로 대체):
TZ=Asia/Hong_Kong date
하네스 날짜 힌트보다 볼트 시간을 신뢰하세요. 하네스 날짜가 볼트 시간과 충돌하는 경우, 새로운 볼트 시간 읽기에서 저널 파일 이름, ISO 주, HH:MM을 도출하세요. 추가/동시성 세부 사항은 references/journal-write-protocol.md를 읽으세요.
세션 상태
내부적으로 추적:
current_entry_start: 활성 저널 항목HH:MM.current_entry_date: 활성 저널 항목YYYY-MM-DD.current_entry_title: 현재 짧은 중국어 작업 제목.bound_topic:.md없는 토픽 파일 이름, 또는None.bind_skipped: 사용자가 바인딩을 선택하지 않은 경우에만True.task_auto_bind_checked/task_auto_bind_skipped: 새 저널 항목마다 재설정.knowledge_candidate_prompted/knowledge_candidate_skipped: 새 저널 항목마다 재설정.knowledge_context_checked: 현재 사용자 요청이 지식 검색 게이트를 통과했거나 게이트가 의도적으로 건너뛰어진 경우True.tracking_disabled: 사용자가 이 세션에 대해 옵트아웃한 경우에만True.
대화 시작
-
<VAULT_ROOT>/00 Tasks/_Index.md가 있으면 읽습니다. 테이블 본문 행을[[topic]] | timestamp | next-step으로 구문 분석하고, 누락된 파일은 빈 지수로 처리합니다. -
동일한 토픽의 동시 세션이 있는지 간단히 확인합니다. 오늘 날짜의 볼트 시간 저널이 있으면 끝 부분을 읽습니다. 마지막 진행 줄이 15 볼트 시간 분 이내이고 해당 항목이 사용자의 첫 번째 메시지와 합리적으로 겹치는 경우, 다음을 표시합니다:
⚠️ 다른 세션 <HH:MM>에서 방금 [[<topic>]]을(를) 작성했습니다. 동일한 작업을 병렬로 수행 중일 수 있습니다. 최신 진행 상황을 먼저 확인하고 응답하겠습니다.그런 다음 최근 항목을 읽어 이 응답이 병렬 작업과 모순되지 않도록 합니다. 최근 겹치는 항목이 없으면 자동으로 건너뜁니다.
-
_Index.md, 오늘의 저널 또는 일치하는 토픽 페이지만 신뢰하기 전에 실질적인 요청에 대해 지식 검색 게이트를 실행합니다. 요청이<VAULT_ROOT>/02 Knowledge/에 지속적인 컨텍스트가 있을 수 있는 프로젝트/도메인/사람/방법에 관한 것이거나, 사용자가 컨텍스트, 분석, 결정, 전략, 계속, 검토, 작성 스타일, 재사용 가능한 워크플로우 또는 이전 작업을 요청하는 경우references/knowledge-retrieval-trigger.md를 읽습니다. 인벤토리 우선 라우팅을 사용하세요: 라이브 Knowledge 트리를 나열하고, 여기서 현재 폴더/프로젝트를 도출한 다음, 광범위한 본문 검색 전에 파일 이름, H1/제목, 별칭, 태그,status: canonical, 탐색 페이지 및 진실 공급원 페이지와 일치시킵니다. 확인을 기다리는 인사, 대시보드/린트 전용 보고서, 순수 저널 부기, 원자적 유틸리티 쿼리 및 메타데이터 우선 패스 후 관련 Knowledge 적중이 없는 경우에만 건너뜁니다. -
사용자의 첫 번째 메시지에 따라 다음 순서로 전달합니다:
- 부트스트랩/설정 의도 (
install fade-away,setup,bootstrap,초기화,처음 사용,오픈소스 배포, 또는 누락된_Index.md와 사용자의 초기화 요청):references/bootstrap-vault.md를 읽습니다. 부트스트랩은 일회성 설정 경로입니다. 볼트 루트가 명확하지 않으면 물어보고 사용자가 확인하지 않는 한 파일을 절대 생성하지 마세요. - 컨텍스트/명령어 확인 의도 (
AGENTS,CLAUDE,컨텍스트,경험 상속,규칙 표류, 프로젝트 구조, 스킬/볼트/워크플로우 유지 관리 또는 새로운 cwd/프로젝트 경계):references/context-check.md를 읽습니다. 표류가 발견되거나 사용자가 명시적으로 요청하는 경우에만 보고하고, 사용자가 특정 패치를 확인하지 않는 한 명령어 파일을 작성하지 마세요. - 메모리 린트 의도 (
lint,건강 검진,지식 베이스 확인,작업 인덱스 확인,위키로 만들 적합한 항목 보기또는 유사):references/lint-vault-memory.md를 읽고 먼저 보고서를 렌더링하고 사용자가 확인하지 않는 한 수정 사항이나 지식 페이지를 작성하지 마세요. - 지식 승격 의도 (
지식으로 침전,knowledge에 쓰기,위키로 만들기,지식 페이지로 보관또는 유사):references/promote-to-knowledge.md를 읽습니다. - 주간 지수 의도 (
주간 인덱스,주간 보고서,weekly index,weekly summary,이번 주 요약또는 유사):references/render-weekly-index.md를 읽습니다. 모듈이 주간 지수를 작성하거나 업데이트하는 경우에만 저널 항목을 엽니다. - 대시보드 의도 (
작업 보기,칸반 보드,dashboard,개요또는 유사):references/render-dashboard.md를 읽고 렌더링만 하며, 아직 저널 항목을 열지 마세요. - 명확한 기존 토픽 일치: 해당 토픽 페이지를 자동으로 읽고
bound_topic을 설정한 다음 저널 항목을 엽니다. - 모호한 인사 (
hi,안녕,있어?,일 시작할게등):_Index.md에 행이 있으면⏮️ 마지막: <task>, 다음 단계는 <next-step>입니다. 계속할까요, 아니면 새 작업인가요?를 출력하고 답변을 기다립니다. 사용자가 확인하는 경우에만 첫 번째 행에 바인딩합니다. - 새 실질적 작업: 이전 작업을 언급하지 말고
bound_topic = None으로 둡니다.
- 부트스트랩/설정 의도 (
저널 항목 열기
실제 작업이 시작될 때만 저널 항목을 엽니다. 볼트 시간 일일 경로를 03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-MM-DD.md로 계산합니다. 여기서 <YYYY-MM>은 날짜의 해당 월, <YYYY-Wnn>은 ISO 주입니다. 누락된 월/주 폴더를 mkdir -p로 생성합니다.
일일 파일이 없으면 references/journal-write-protocol.md의 템플릿에서 생성합니다. ## 🕐 작업 타임라인을 확인한 다음 해당 섹션 하단에 하나의 헤더를 추가합니다:
- 바인딩되지 않음:
### HH:MM ▶️ <짧은 중국어 제목> - 바인딩됨:
### HH:MM ▶️ <짧은 중국어 제목> → [[00 Tasks/<bound_topic>]]
current_entry_start, current_entry_date 및 current_entry_title을 저장합니다. 새 항목에 대한 작업, 지식 후보 및 지식 검색 플래그를 재설정합니다.
턴별 저장
실질적인 출력이 있는 모든 어시스턴트 턴 후에, 현재 저널 항목 내에 정확히 하나의 진행 줄을 추가합니다:
(HH:MM) <한 줄 진행 상황>
활성 항목 본문 끝, 다음 ### 타임라인 헤더 또는 EOF 바로 앞에 추가합니다. 이전 진행 줄을 다시 작성하지 마세요. 턴이 단순한 명확화 질문이거나 tracking_disabled = True인 경우 저장을 건너뜁니다.
쓰기 전에, 정확한 추가 위치, 동시 쓰기 리베이스, 볼트 시간 경계 처리, 함정 줄 구문 또는 저널 템플릿이 필요한 경우 references/journal-write-protocol.md를 읽으세요.
저장 후 확인
턴별 저장 후 다음 확인을 실행합니다:
- 명시적 승격: 표시된 출력에 명시적
➡️ 다음 단계마커 또는## ➡️ 다음 단계섹션이 포함된 경우, 토픽/인덱스 계층을 업데이트합니다.bound_topic이 설정된 경우references/topic-update-protocol.md를 읽고, 그렇지 않고bind_skipped = False인 경우references/promote-to-wiki.md를 읽습니다. - 토픽 자동 새로고침:
bound_topic이 설정되고 명시적 다음 단계가 나타나지 않은 경우, 활성 항목이 기존 부실 임계값을 충족할 수 있으면references/topic-update-protocol.md를 읽습니다. 현재 자동 새로고침 동작을 유지하고, 사용자가 요청하지 않는 한 확인 프롬프트로 변환하지 마세요. - 작업 자동 바인딩: 활성 항목이 바인딩되지 않고 명시적
➡️ 다음 단계가 없는 경우,references/task-candidate-trigger.md를 읽습니다. 작업 유사 세션에 대해 토픽을 자동으로 생성/바인딩하고, 단순 Q&A, 인사, 대시보드/린트 전용 보고서, 순수 명확화 또는 작업 특성이 없는 세션은 건너뜁니다. - 지식 후보: 재사용 가능한 지식이 나타났을 수 있고 사용자가 이미 승격을 요청하지 않은 경우,
references/knowledge-candidate-trigger.md를 읽습니다.02 Knowledge/를 자동으로 생성하거나 업데이트하지 마세요.
세션 중 토픽 전환
사용자가 X 계속하기, X로 돌아가기 또는 다른 방식으로 항목이 이미 열려 있는 동안 전환을 요청하는 경우:
X를_Index.md와 보수적으로 일치시킵니다.- 명확한 일치가 없으면 짧은 명확화 질문을 하나 합니다.
- 일치가 명확하고
bound_topic과 다른 경우, 다음을 묻습니다:[[X]]로 전환할까요? 현재 항목에 전환 기록을 한 줄 추가하고 새 X 항목을 열겠습니다. - 확인 시
(HH:MM) 현재 작업에서 전환, [[00 Tasks/X]]로 이동.을 추가하고, 토픽 페이지를 읽고,bound_topic = X를 설정하고, 바인딩된 새 저널 항목을 엽니다. - 사용자가 거부하면 기존 바인딩을 유지합니다.
세션 중에 자동으로 토픽을 전환하지 마세요.
수동 기록 요청
사용자가 기록해 줘, 방금 진행 상황 기록해 줘 또는 유사한 말을 하면, 이전 저장 이후의 진행 상황을 요약하는 추가 진행 줄을 현재 항목에 하나 추가합니다. 사용자가 명시적으로 작업 전환을 요청하지 않는 한 새 항목을 열거나 현재 항목을 닫지 마세요.
모듈
저빈도 워크플로우는 필요할 때만 로드하세요:
references/journal-write-protocol.md: 저널 생성, 추가 위치, 볼트 시간 경계 처리, 동시 쓰기 리베이스, 함정 줄 구문 및 저널 템플릿.references/bootstrap-vault.md: 새 사용자의 Obsidian 볼트를 위한 일회성 설정 워크플로우; 확인 후에만 최소 fade-away 디렉토리/템플릿/인덱스 및 명령어 진입점을 생성합니다.references/context-check.md:AGENTS.md,CLAUDE.md, 프로젝트 구조 노트 및 Knowledge 상속과 같은 부실 명령어/컨텍스트 표면에 대한 콜드 스타트 또는 경계 변경 확인; 확인될 때까지 쓰지 않고 표류를 보고합니다.references/task-candidate-trigger.md: 실질적인 바인딩되지 않은 작업 항목을00 Tasks에 자동 바인딩; 사소하거나 작업이 아닌 세션은 건너뜁니다.references/topic-update-protocol.md: 바인딩된 토픽 페이지 업데이트,_Index.md새로고침 및 현재 토픽 자동 새로고침 동작 실행.references/promote-to-wiki.md: 명시적➡️ 다음 단계또는 작업 자동 바인딩 트리거 후 바인딩되지 않은 저널 항목을 토픽 페이지에 바인딩하고_Index.md를 업데이트합니다.references/render-dashboard.md:_Index.md에서 읽기 전용 작업 대시보드를 렌더링합니다.references/render-weekly-index.md:03 Journal/<YYYY-MM>/<YYYY-Wnn>/YYYY-Wnn 周索引.md에 온디맨드 주간 MOC를 생성하거나 업데이트합니다.references/lint-vault-memory.md: 작업, 저널, 주간 지수 및 지식 계층에 대한 읽기 전용 상태 보고서를 렌더링합니다.references/knowledge-retrieval-trigger.md: 실질적 작업 전에 라이브02 Knowledge/트리를 인벤토리하고, 메타데이터에서 후보를 순위 지정하며, 소수의 관련 페이지를 읽어 오래된 지속적 컨텍스트, 방법 및 프로젝트 사실이 답변에 영향을 미칠 수 있도록 합니다.references/knowledge-candidate-trigger.md: 확인될 때까지 쓰지 않고02 Knowledge/에 재사용 가능한 저널 자료를 제안합니다.references/promote-to-knowledge.md: 확인 후02 Knowledge/아래에 큐레이팅된 페이지를 생성하거나 업데이트합니다.
형식 규칙
- 시간 형식: 구성된 볼트 시간대를 사용하는 24시간제
HH:MM. - 저널 제목: 짧고 설명적인 중국어;
작업1과 같은 일반 제목은 피하세요. - 토픽 파일 이름: 케밥-케이스, 공백 없음, 디스크에만
.md확장자. - 저널의 토픽 위키링크:
[[00 Tasks/<topic>]]. - 인덱스 행 형식:
| [[<topic>]] | YYYY-MM-DD HH:MM | <이스케이프된 다음 단계> |. - 레거시
task-tracker디렉토리는 제거되었습니다. 사용자가 이전 트래커를 요청하면fade-away로 대체되었음을 설명하세요.
엣지 케이스
- 사용자 옵트아웃 (
이번에는 기록하지 마):tracking_disabled = True로 설정하고 세션 동안 모든 쓰기를 건너뛰지만, 컨텍스트를 위한_Index.md읽기는 허용됩니다. - 자정 넘기기: 볼트 시간 자정을 사용합니다. 볼트 시간 자정 이후에는 새 볼트 시간 일자의 저널에 연속 항목을 열고 거기서 턴별 저장을 계속합니다.
- 대시보드 전용 턴: 대시보드를 렌더링하고 기다립니다. 사용자가 실제 작업을 시작할 때까지 저널 항목을 열지 마세요.
- 인덱스 일치에 대한 토픽 페이지 누락: 토픽 행은 존재하지만 페이지가 누락되었다고 말한 다음, 다시 생성할지 아니면 바인딩되지 않은 상태로 계속할지 묻습니다.