잘 만든 강의자료가 사라지는 이유-138개 산출물을 하나의 도서관으로 모은 lecture-recap-library 스킬 제작기
2026.08.06
📝 한눈에 보는 사례
강의자료를 잘 만드는 것과, 만들어진 강의자료를 다시 찾기 쉽게 보관하는 것은 서로 다른 문제다. 강의 전사, 강의 정리, 법률강의 recap, IT 강의 노트가 각자의 전문 워크플로에서 훌륭하게 완성되더라도 결과물이 여러 작업 폴더와 지식베이스에 흩어지면 사용자는 매번 “어디에 저장됐지?”부터 다시 시작해야 한다.
이 문제를 해결하기 위해 lecture-recap-library라는 별도의 스킬을 만들었다. 이 스킬은 강의 내용을 직접 작성하지 않는다. 대신 각 제작 스킬이 검증을 끝낸 최종 산출물을 하나의 사람 중심 보관소로 발행하고, 연결 이미지와 출처, SHA-256, 색인을 함께 관리한다.
첫 구축에서는 다음 결과를 하나의 도서관으로 통합했다.
활성 최종 산출물: 138개
법률강의: 123개
IT 강의: 11개
일반 강의자료: 4개
함께 복사한 연결 이미지: 296개
원본과 통합본의 SHA-256 불일치: 0건
누락된 산출물·연결 자산: 0건
통합 보관소는 다음 위치에 마련했다.
/Users/tearess-mac/Lecture_Recap_Library
😫 문제는 제작 품질이 아니라 ‘마지막 1미터’에 있었다
기존에도 강의를 다루는 전문 스킬은 충분히 강력했다.
legal-lecture-recap은 전사본, 교재, 영상 화면을 정렬해 법률강의 recap을 만든다.legal-lecture-adapter-workflow는 전사 교정본, 강의정리본, 위키 분해 후보를 구조화한다.lecture-transcription-notes는 영상과 음성을 전사하고 고품질 강의노트를 만든다.document-knowledge-automation은 문서와 미디어를 지식 코퍼스로 전환한다.
그런데 각 스킬은 자신의 작업을 잘 끝내는 데 집중했다. 그 결과 최종 산출물은 다음과 같은 서로 다른 위치에 놓였다.
법률강의 제작 작업대
LLM-Wiki의 법률강의 canonical 도메인
IT 강의 도메인
LLM-Wiki 입고용 dropzone
Obsidian의 강의전사 폴더
전문 에이전트가 사용하는 별도 작업 폴더
이 구조는 시스템 관점에서는 이유가 있었다. 원본, 작업본, 검증본, 지식베이스용 canonical 파일은 역할이 다르기 때문이다. 하지만 사람의 관점에서는 불편했다. 완성된 결과물을 보려면 저장 구조를 기억해야 했고, 강의 종류에 따라 다른 폴더를 찾아다녀야 했다.
여기서 중요한 판단이 하나 나왔다.
흩어진 폴더를 없애는 것이 아니라, 각 폴더의 전문적 역할은 유지하면서 최종 결과물을 한곳에서 볼 수 있는 ‘발행 계층’을 추가해야 한다.
즉, 기존 구조를 통째로 재편하는 마이그레이션보다 마지막 전달 단계를 표준화하는 것이 더 안전하고 효과적이었다.
🎯 처음 요청은 단순한 ‘새 폴더’였지만 실제 요구는 더 컸다
처음 요청은 다음과 같았다.
지금 강의제작, 강의정리 스킬들을 통해 강의자료 recap본을 만들면 그게 각각 저장되는 폴더가 다른데, 이것을 따로 저장하는 폴더를 만들고, 모든 강의자료 만들어진 결과물을 그 폴더에다가 저장해야겠어. 지금 이게 흩어져있어서 보기도 힘들고 찾기도 어려워.
표면적으로는 새 폴더 하나를 만들면 되는 요청처럼 보였다. 그러나 실제로 필요한 것은 네 가지였다.
통합 보관 위치 — 사람이 최종 결과물을 찾는 단일 진입점
저장 규칙 — 어떤 파일을 넣고 어떤 파일은 제외할지 정하는 기준
발행 도구 — 복사, 중복 방지, 이미지 편입, 색인 갱신을 실제로 수행하는 실행기
기존 스킬 연결 — 앞으로 새 결과물이 다시 흩어지지 않도록 하는 운영 계약
폴더만 만들고 끝냈다면 기존 자료는 그대로 흩어져 있었을 것이고, 다음 작업부터 다시 같은 문제가 반복됐을 것이다. 따라서 이번 작업의 핵심은 디렉터리 생성이 아니라 “모든 강의 워크플로가 공유하는 최종 발행 규약”을 스킬로 만드는 것이었다.
🧭 이 스킬의 정확한 description
스킬에 등록된 description은 다음과 같다.
Use whenever a lecture-production, lecture-summary, lecture-note, or recap workflow creates a user-facing final artifact. Publishes verified final outputs into one human-facing library, preserves workbench and canonical source locations, copies linked assets, records hashes and provenance, and keeps a searchable index.
이를 한국어로 풀면 다음과 같다.
강의 제작, 강의 요약, 강의노트 또는 recap 워크플로가 사용자용 최종 산출물을 만들 때 사용하는 스킬이다. 검증된 최종 결과물을 하나의 사람 중심 보관소에 발행하되, 기존 작업대와 canonical 원본 위치는 보존한다. 연결 자산을 함께 복사하고, 해시와 출처를 기록하며, 검색·열람 가능한 색인을 유지한다.
이 description에서 중요한 단어는 네 가지다.
1. user-facing final artifact
임시 파일이 아니라 사용자가 실제로 읽고 활용하는 최종본만 대상으로 한다. 원본 영상, STT 청크, 캐시, 가상환경, 모델 파일, 임시 프레임은 통합 보관소에 넣지 않는다.
2. publishes
이 스킬은 단순 백업기가 아니다. 검증을 통과한 산출물을 사람에게 전달 가능한 상태로 ‘발행’한다. 따라서 파일만 복사하는 것이 아니라 색인과 출처, 자산, 검증 결과가 함께 따라간다.
3. preserves workbench and canonical source locations
기존 경로를 없애거나 대체하지 않는다. 작업대는 작업대대로, LLM-Wiki canonical 도메인은 정본으로 유지한다. 통합 보관소는 그 위에 추가되는 인간 중심 열람 계층이다.
4. hashes and provenance
“파일이 있다”는 것만으로는 충분하지 않다. 어느 파일에서 왔는지, 복사 과정에서 내용이 변하지 않았는지 확인할 수 있어야 한다. 이를 위해 출처 경로와 SHA-256을 manifest에 남긴다.
🏗️ 이 스킬은 어느 층위에 있는가
lecture-recap-library는 콘텐츠 생성 스킬이 아니라 횡단형 발행·거버넌스 스킬이다.
강의자료 처리 시스템을 다섯 층으로 나누면 위치가 분명해진다.
층위 | 역할 | 대표 작업 |
|---|---|---|
1. 원천·증거 계층 | 원본을 보존한다 | 영상, 음성, PDF, HWP, 원전사본 |
2. 제작 계층 | 내용을 가공한다 | 전사, 교정, recap, 강의노트 작성 |
3. 검증 계층 | 완성도를 확인한다 | 구조, 누락, 이미지, 인용, 해시 검사 |
4. 발행·통합 계층 | 검증된 최종본을 전달 위치에 모은다 | 복사, 중복 제어, 자산 편입, manifest |
5. 탐색·열람 계층 | 사람이 쉽게 찾고 연다 | 과정별 폴더, |
이 스킬의 중심은 4층이며, 결과적으로 5층을 만들어낸다. 1~3층에서 무엇을 어떻게 만들지는 기존 전문 스킬이 결정한다. lecture-recap-library는 그 결과를 받아 최종 전달 상태로 만드는 후단 스킬이다.
다른 표현으로는 다음과 같이 부를 수 있다.
post-processing skill: 콘텐츠 제작이 끝난 뒤 실행된다.
publication skill: 최종 결과를 사람 중심 보관소에 발행한다.
artifact-governance skill: 산출물의 출처·버전·해시·자산을 관리한다.
cross-cutting skill: 법률, IT, 요리, 여행 등 여러 강의 유형을 가로질러 공통 적용된다.
orchestration support layer: 전문 스킬들의 결과를 하나의 규칙으로 연결한다.
반대로 이 스킬은 다음 역할을 하지 않는다.
강의 내용을 요약하거나 재작성하지 않는다.
법률적 정확성을 판단하지 않는다.
STT 엔진을 선택하지 않는다.
PDF와 발언을 정렬하지 않는다.
원본 저장소를 대체하지 않는다.
이 경계를 명확히 한 것이 스킬 설계의 중요한 성공 요인이었다. 모든 일을 한 스킬에 넣지 않고, 전문 제작 스킬과 공통 발행 스킬의 책임을 분리했기 때문이다.
🛠️ 제작 과정 1: 먼저 현재의 저장 경로를 조사했다
새 폴더를 만들기 전에 기존 스킬과 실제 파일시스템을 함께 조사했다. 문서에 적힌 경로만 보는 것으로는 부족했다. 스킬 설명과 실제 산출물 위치가 다를 수 있기 때문이다.
조사 결과 다음과 같은 성격 차이가 확인됐다.
/Users/tearess-mac/gpters/legal_lecture/recap은 작업대다. recap 파일뿐 아니라 가상환경, 라이브러리, 임시 이미지와 작업 로그가 대량으로 섞여 있었다./Users/tearess-mac/LLM-Wiki_LCL/domains/legal-lecture/20_wiki는 검증된 법률강의 canonical 결과가 있는 도메인이다./Users/tearess-mac/LLM-Wiki_LCL/domains/it-lecture/20_wiki는 IT 강의노트가 별도로 관리되는 공간이다./Users/tearess-mac/LLM-Wiki_LCL/00_inbox/00_dropzone은 최종 도서관이 아니라 입고·라우팅 공간이다./Users/tearess-mac/Documents/obsidian/타디스/강의전사에는 C&B가 만든 최신 전사·recap 중 아직 다른 canonical 도메인에 들어가지 않은 결과가 있었다.
특히 작업대 전체를 단순 복사하면 안 된다는 점이 중요했다. 실제 조사에서 법률강의 작업대에는 3만 개가 넘는 파일과 약 1.7GB의 데이터가 있었고, 그중 상당수는 가상환경과 작업 중간물이었다. “모든 결과물”을 “모든 파일”로 오해하면 통합 보관소가 또 다른 쓰레기장이 될 수 있었다.
따라서 다음 원칙을 세웠다.
작업대는 전수 복사하지 않는다. 과정별 active manifest나 canonical index가 지정한 최종본만 선별한다.
🔧 제작 과정 2: 폴더가 아니라 발행 계약을 설계했다
통합 보관소의 구조는 단순하게 유지했다.
Lecture_Recap_Library/
├── 00_INDEX.md
├── README.md
├── <course>/
│ └── <lecture>/
├── case-library/
│ └── <case-file>
├── 90_manifests/
│ └── library.jsonl
└── 99_archive/
각 디렉터리의 역할은 명확하다.
루트의 과정 폴더: 사용자가 실제 강의 결과물을 여는 공간
case-library: 하위 폴더 없이 사례글·사례게시글을 모으는 공간90_manifests: 기계가 출처와 해시를 추적하는 공간99_archive: 테스트본이나 이전 버전을 활성 결과와 분리하는 공간00_INDEX.md: 사용자가 전체 결과물을 한눈에 찾는 진입점
여기에 다음 발행 계약을 추가했다.
원래 워크플로에서 먼저 산출물 검증을 끝낸다.
분야, 과정, 강의 좌표를 정한다.
최종 산출물을 통합 보관소에 복사한다.
Markdown이나 HTML이 참조하는 로컬 이미지를 함께 복사한다.
출처, 목적지, 파일 크기, SHA-256, 산출물 유형을 JSONL manifest에 기록한다.
00_INDEX.md를 다시 생성한다.목적지 파일을 다시 읽어 원본과 SHA-256이 같은지 확인한다.
완료보고에는 기존 경로와 통합 경로를 함께 적는다.
이 계약 덕분에 “파일을 만들었다”와 “사용자가 찾을 수 있게 전달했다”를 구분할 수 있게 됐다.
⚙️ 제작 과정 3: 실행 가능한 등록 도구를 붙였다
스킬 문서만 작성하면 운영 규칙은 생기지만 실제 작업이 자동으로 수행되지는 않는다. 그래서 스킬 안에 publish_lecture_output.py라는 실행 스크립트를 함께 만들었다.
이 도구의 주된 기능은 다음과 같다.
최종 산출물 복사
지정된 domain/course/lecture 좌표에 파일을 배치한다. 분야는 legal, it, cooking, travel, business, general 같은 공통 slug를 사용한다.
SHA-256 기반 중복 제어
동일한 이름의 파일이 이미 있을 때 내용을 먼저 비교한다.
해시가 같으면 중복 복사하지 않는다.
해시가 다르면 기존 파일을 덮어쓰지 않고
__rev-날짜-시각revision을 만든다.
연결 이미지 복사
Markdown 이미지 문법과 HTML <img>의 상대경로를 읽어 필요한 로컬 이미지를 함께 옮긴다. URL 인코딩된 경로도 해석한다. 반면 원격 URL, data: 이미지, 보관소 바깥으로 탈출하는 위험한 경로는 자동 복사 대상에서 제외한다.
provenance manifest 작성
각 등록 건마다 다음 정보를 library.jsonl에 남긴다.
발행 시각
domain, course, lecture
제목과 산출물 유형
원본 경로와 목적지 경로
SHA-256과 파일 크기
복사된 자산 목록
미해결 자산 목록
검증 상태
사람용 색인 생성
기계용 JSONL만으로는 찾기 어렵기 때문에 같은 정보를 바탕으로 00_INDEX.md를 자동 생성한다. 사용자는 분야와 과정별 목록에서 바로 파일을 열 수 있다.
🔗 제작 과정 4: 기존 스킬 네 개에 후단 규칙을 연결했다
새 스킬이 존재하더라도 다른 제작 스킬이 이를 호출하지 않으면 결과는 다시 흩어진다. 그래서 다음 스킬들의 출력 단계에 lecture-recap-library 발행을 필수 후처리로 연결했다.
legal-lecture-recaplegal-lecture-adapter-workflowlecture-transcription-notesdocument-knowledge-automation
중요한 것은 기존 출력 경로를 없애지 않았다는 점이다.
예를 들어 법률강의 recap은 여전히 작업대에서 만들어지고, 검증된 canonical 파일은 LLM-Wiki 법률강의 도메인에 남는다. 다만 사용자에게 전달할 최종본은 통합 보관소에도 추가된다.
전문 작업대
→ 전문 스킬의 품질 검증
→ canonical 저장
→ lecture-recap-library 발행
→ 통합 색인에서 열람
이 구조는 전문성과 편의성을 동시에 유지한다. 원본 보존과 지식베이스 운영을 희생하지 않으면서 사용자는 최종 결과물을 한곳에서 찾을 수 있다.
🧪 제작 과정 5: 작은 표본으로 실제 동작을 먼저 확인했다
전체 자료를 옮기기 전에 세 가지 서로 다른 사례로 표본 검증을 수행했다.
민사소송법 recap 1건
조세실무 recap 1건
IT 강의 현장노트 1건
이 과정에서 확인한 핵심은 다음과 같다.
파일이 정확한 과정·강의 폴더에 배치되는가
원본과 목적지의 SHA-256이 같은가
조세실무 recap의 상대경로 이미지가 함께 복사되는가
JSONL manifest와 Markdown 색인이 갱신되는가
조세실무 표본에서는 교재 이미지 2개가 실제로 함께 복사됐고, 산출물과 이미지의 해시 검증이 모두 통과했다. 이 표본이 통과한 뒤 전체 편입을 진행했다.
🚧 실행 중 만난 현실적인 장애물
대량 편입 명령은 파일을 많이 복사하는 작업이므로 별도 실행 승인이 필요했다. 채팅에서 사용자가 진행을 지시했더라도 시스템 승인 창이 시간 초과되면 명령은 실행되지 않았다.
이때 중요한 것은 실패를 성공처럼 보고하지 않는 것이었다. 실제 동작 상태를 다음처럼 구분했다.
스킬과 폴더 생성: 완료
표본 3건 등록: 완료
130건 대량 편입: 승인 대기
사용자가 별도 승인 창을 확인한 뒤에야 일괄 편입을 재실행했다. 최종 실행에서는 당시 대상 134건 가운데 132건이 새로 복사됐고, 표본에서 이미 등록한 2건은 동일 해시로 판단되어 중복 복사가 생략됐다.
또 하나의 시행착오는 표본 IT 파일이 정식 과정 좌표와 다른 테스트 과정 좌표에 남은 일이었다. 전체 검증에서 활성 산출물 수가 예상보다 1개 많다는 사실을 발견했고, 테스트 사본을 99_archive로 옮겨 활성 색인에서 제외했다.
이 과정은 작은 숫자 차이도 무시하지 않고 원인을 추적해야 한다는 점을 보여준다.
🔍 제작 과정 6: devlog 대조로 숨은 누락을 찾았다
초기 통합 후에는 활성 산출물이 134개였다. 파일 검증만 보면 모두 정상적인 상태였다. 그러나 그날 공동 업무일지를 다시 읽으면서 C&B가 새로 만든 GPTers IT 강의 2개의 전사본과 recap이 Obsidian 강의전사 폴더에만 있다는 사실을 발견했다.
이 파일들은 기존에 조사한 LLM-Wiki 도메인이나 dropzone에 아직 들어가지 않았기 때문에 최초 편입 목록에서 빠져 있었다.
추가로 편입한 파일은 다음 네 개였다.
에이전트 하네스 1주차 전체전사
에이전트 하네스 1주차 IT 강의 recap
K-스킬 자동화 1주차 전체전사
K-스킬 자동화 1주차 IT 강의 recap
그 결과 최종 활성 산출물은 138개가 됐다. 그리고 스킬의 기존 자료 조사 경로에도 Obsidian 강의전사 폴더를 추가했다.
이 장면은 스킬을 만드는 과정에서 얻은 중요한 교훈을 보여준다.
저장 위치를 문서만 보고 추정하지 말고, 실제 작업일지와 최신 파일시스템을 함께 대조해야 한다.
✅ 최종 결과와 검증
최종 독립 검증 결과는 다음과 같다.
검증 항목 | 결과 |
|---|---|
활성 산출물 | 138개 |
법률강의 | 123개 |
IT 강의 | 11개 |
일반 강의자료 | 4개 |
고유 연결 이미지 | 296개 |
사람용 색인 항목 | 138개 |
원본↔통합본 해시 불일치 | 0건 |
누락·손상 자산 | 0건 |
최종 상태 |
|
검증 결과는 다음 파일에 남겼다.
/Users/tearess-mac/Lecture_Recap_Library/90_manifests/final-verification-20260722.json
스킬 본체와 실행기는 다음 위치에 있다.
/Users/tearess-mac/.hermes/skills/productivity/lecture-recap-library/SKILL.md
/Users/tearess-mac/.hermes/skills/productivity/lecture-recap-library/scripts/publish_lecture_output.py
📦 이 스킬의 주된 기능 요약
1. 단일 인간 중심 결과물 보관소 제공
강의 유형과 제작 도구가 달라도 최종 결과물을 하나의 루트에서 찾을 수 있다.
2. 기존 작업대와 canonical 정본 보존
전문 워크플로의 저장 구조를 파괴하지 않는다. 통합 보관소는 대체재가 아니라 최종 전달 계층이다.
3. 과정·강의 단위 분류
domain/course/lecture 구조로 저장해 대량 자료에서도 위치를 예측할 수 있다.
4. 중복과 충돌 제어
SHA-256이 같은 파일은 중복하지 않고, 내용이 다른 동명 파일은 revision으로 보존한다.
5. 연결 자산 동반 편입
Markdown과 HTML에서 실제로 사용하는 상대경로 이미지를 찾아 함께 복사한다.
6. 출처 추적
원본과 목적지, 파일 크기, 해시, 발행 시각을 JSONL manifest에 기록한다.
7. 검색·열람용 색인 생성
기계용 manifest를 사람용 00_INDEX.md로 변환한다.
8. 완료 기준 강화
“작업 파일이 생성됨”을 완료로 보지 않고 “통합 보관소 발행과 해시 read-back까지 통과함”을 완료로 본다.
💡 이 사례에서 배운 스킬 설계 원칙
원칙 1. 반복 문제의 원인이 콘텐츠가 아니라 연결에 있을 수 있다
강의자료가 부족한 것이 아니었다. 각 자료를 잘 만드는 스킬도 이미 있었다. 문제는 결과를 한곳에 연결하는 공통 후단이 없었다는 점이다.
원칙 2. 폴더 생성과 시스템 설계는 다르다
새 폴더는 저장 장소만 만든다. 스킬은 트리거, 포함·제외 기준, 실행 절차, 충돌 정책, 검증 기준을 함께 만든다.
원칙 3. 범용 스킬은 전문 스킬을 대체하지 않아야 한다
lecture-recap-library가 법률 검토나 STT까지 맡았다면 책임이 과도하게 커졌을 것이다. 이 스킬은 발행과 거버넌스에만 집중한다.
원칙 4. “모든 결과물”과 “모든 파일”을 구분해야 한다
최종 산출물을 모으는 것과 작업 디렉터리 전체를 복제하는 것은 전혀 다르다. 가상환경과 임시 자산을 걸러내는 포함·제외 규칙이 필수다.
원칙 5. 검증은 파일 존재 여부보다 강해야 한다
최소한 다음 네 가지를 따로 확인해야 한다.
목적지 파일 존재
원본과 목적지 해시 일치
연결 자산 존재와 해시 일치
manifest와 사람용 색인 항목 수 일치
원칙 6. 작업일지는 숨은 저장 경로를 발견하는 운영 데이터다
최신 산출물이 아직 canonical 도메인에 들어가지 않았을 수 있다. 공동 업무일지와 실제 파일시스템을 대조하면 문서화되지 않은 누락 경로를 찾을 수 있다.
🌍 다른 업무에 적용할 수 있는 구조
이 스킬의 패턴은 강의자료에만 한정되지 않는다. 핵심 구조는 다음과 같다.
여러 전문 제작 경로
→ 각 경로의 품질 검증
→ 하나의 인간 중심 발행 보관소
→ 해시·출처 manifest
→ 사람용 통합 색인
따라서 다음 업무에도 같은 설계를 적용할 수 있다.
여러 법률 검토 흐름에서 만들어지는 의견서 통합 보관소
이미지 생성 도구별 결과물을 모으는 디자인 라이브러리
회의 전사·요약 결과를 모으는 회의 기록 도서관
여러 리서치 에이전트가 만든 보고서를 모으는 조사 결과 허브
문서 변환 도구별 최종 PDF·DOCX·Markdown을 모으는 납품 보관소
공통점은 “제작은 잘 되지만 결과물의 마지막 위치가 제각각”이라는 문제다.
🚀 앞으로 확장할 수 있는 방향
현재 스킬은 명시적으로 호출되는 발행 방식이다. 앞으로는 필요에 따라 다음 기능을 확장할 수 있다.
새 결과물 감시 — 지정된 canonical·Obsidian 경로에서 새 최종본을 발견해 등록 후보를 만든다.
과정별 대시보드 — 강의 수, 최신 갱신일, 산출물 유형, 누락 자료를 시각화한다.
버전 승격 정책 — 여러 recap 버전 가운데 active canonical만 자동 선택한다.
전문 프로필 공통 연결 — C&B, Libro Vitae 등 별도 프로필이 직접 작업하더라도 같은 발행 계약을 사용하게 한다.
검색 인덱스 연동 — 파일명뿐 아니라 제목, 강사, 과정, 날짜, 주제를 기준으로 검색한다.
다만 자동화가 강해질수록 “어떤 파일이 정말 최종본인가”를 판단하는 기준도 더 엄격해야 한다. 따라서 자동 감시보다 canonical manifest와 검증 게이트가 먼저다.
🤝 결론: 좋은 자동화는 만드는 데서 끝나지 않는다
이번 사례의 출발점은 단순했다. 강의자료가 여기저기 흩어져 있어 보기 어렵고 찾기 어렵다는 문제였다. 하지만 해결 과정에서 더 본질적인 사실이 드러났다.
산출물을 만드는 자동화와 산출물을 전달하는 자동화는 별개의 시스템이다.
기존 강의 스킬들은 콘텐츠 제작이라는 앞단을 잘 수행하고 있었다. lecture-recap-library는 그 뒤에 발행·통합·추적·탐색이라는 공통 후단을 추가했다. 그 결과 전문 작업대와 canonical 정본은 그대로 유지하면서도 사용자는 하나의 도서관에서 138개의 최종 산출물을 찾을 수 있게 됐다.
이 스킬의 가치는 새로운 강의 내용을 만들어내는 데 있지 않다. 이미 잘 만들어진 결과물이 다시 길을 잃지 않게 하는 데 있다. 작업의 마지막 1미터를 표준화하면, 여러 전문 에이전트와 여러 제작 도구가 만든 결과가 비로소 하나의 지속 가능한 시스템으로 연결된다.
로그인하고 댓글을 남겨 주세요
유피테르님, 이 글의 핵심은 흩어진 자료를 한 폴더로 옮긴 데보다, 제작 자동화와 전달 자동화를 별개의 책임으로 분리한 판단에 있다고 읽혔어요. 기존 작업대와 LLM-Wiki 정본은 그대로 두고, 검증된 최종본만 사람 중심 보관소로 발행하는 계층을 더했죠. 단순한 ‘새 폴더’ 요청을 통합 위치, 포함·제외 기준, 실행 도구, 기존 스킬과의 연결이라는 운영 계약으로 확장한 덕분에 전문 워크플로의 역할과 사용자의 찾기 편의가 함께 살아났습니다.
‘모든 결과물’과 ‘모든 파일’을 구분한 과정도 구체적이었어요. 법률강의 작업대에 3만 개가 넘는 파일과 약 1.7GB의 데이터가 섞여 있다는 실제 조사에서 출발해, 가상환경과 임시물을 통째로 복사하지 않고 active manifest와 canonical index가 가리키는 최종본만 고르셨습니다. 발행 때는 연결 이미지, 출처, 내용 일치 여부, 색인을 함께 다루고, 동명 파일의 내용이 다르면 덮어쓰기 대신 revision으로 보존해 통합 보관소가 또 다른 작업 폴더가 되지 않도록 막았고요.
구현 뒤 곧바로 대량 편입하지 않고 법률 2건과 IT 1건으로 파일 배치, 연결 이미지, manifest와 색인 갱신을 먼저 확인한 순서도 설계 의도와 잘 맞아요. 승인 시간 초과 때 대량 편입을 실행된 것처럼 보고하지 않고 표본 완료와 일괄 편입 대기를 나눠 기록했으며, 이후 동일 내용의 표본은 중복 복사하지 않았습니다. 자동화의 신뢰를 기능 목록이 아니라 실행 상태와 재읽기 결과로 증명한 대목이에요.
전체 편입 뒤 활성 산출물이 예상보다 하나 많자 테스트 사본을 보관 영역으로 옮겼고, 다시 업무일지와 최신 파일시스템을 대조해 최초 경로 조사에서 빠진 전사·recap 네 개도 찾아냈습니다. 그 결과 글에서 실제 검증까지 마친 범위는 활성 산출물 138개, 연결 이미지 296개, 색인 138개, 원본과 통합본의 불일치와 누락 자산 0건입니다. 반면 새 결과물 감시, 과정별 대시보드, 버전 승격, 프로필 공통 연결, 검색 연동은 앞으로의 확장안으로 남아 있어 현재 성과와 아직 확인하지 않은 범위도 분명하게 구분됩니다.
저장 불편을 단순 정리 문제가 아니라 발행 규약의 부재로 다시 정의하고, 표본·승인 상태·한 건의 수 차이·숨은 경로까지 끝까지 추적한 작업이 단단해요. 잘 만들어진 산출물이 마지막 위치에서 다시 길을 잃지 않게 만든 이 기록은 여러 전문 자동화를 하나의 지속 가능한 사용 경험으로 연결한 좋은 기준이 됐습니다.
138개 산출물에서 SHA-256 불일치 0건, 누락 0건으로 마무리된 게 신뢰가 가요. "흩어진 폴더를 없애는 게 아니라 발행 계층을 추가한다"는 판단이 특히 좋았어요 — 기존 전문 스킬의 역할은 건드리지 않고 마지막 1미터만 표준화한 거라서요. 처음 요청은 "새 폴더 하나"였는데 실제 필요한 게 통합 위치·저장 규칙·발행 도구·기존 스킬 연결 네 가지라는 걸 풀어낸 과정도 꼼꼼합니다. 앞으로 새 산출물이 다시 흩어지지 않게 스킬까지 연결한 것도요. 박스 탐험하듯 구석구석 살펴봤어요 🐾

이거 써보시면 진짜 멋잇게 강의도서관 만드실거같은디 ㅋㅋㅋㅋ
https://github.com/mengto/complete-shelf
오~! 감사합니다!