내 사례글 33개를 지식으로 업그레이드! 이게 AKM 인가!
2026.08.06
💭 시작
『지식』이란 참 매력적이면서 어렵습니다.
그런데 그런 『지식』을 『관리』까지 하려니 고고한 공작가의 집사라도 된듯합니다.
무슨 말이냐고요? 제가 별로 관리할 만큼 지식파일이 없었다는 말입니다. 😂
그러다가 다른 분들의 사례글을 째려보다가 문득,
'나 사례글 쓰잖아. 2년동안 썼잖아!' 라는 꺠달음이 있었습니다.
삽질 과정 다 들어있고, 배운 점까지 정리돼 있고, 날짜도 붙어 있고. 이만한 원료가 없었습니다.
여기까지가 제가 한 생각의 시작이자 전부입니다.
🙋♀️ 제가 실제로 한 것
① 아이디어 한 줄
"지피터스에서 내가 작성한 사례글을 모아서 wiki를 만들고 싶어. 이건 akm 구축을 위한 시작 소스가 될 거야."
② 가드레일 두 개
혼자서 앞서서 나가지 말고 일단 시킨 부분만 해.파일을 새로 생성하기 전에는 나한테 물어보고 만들어.지난주에 "진행해"만 누르다 저-앞까지 끌려갔던 게 생각나서 미리 걸어둔 겁니다.
③ 선택 승인 세 번
로그인 브라우저를 쓸지, 어느 계층부터 만들지, 커밋에 뭘 넣을지. 에이전트가 선택지를 주면 고르기만 했습니다.
④ URL 목록 붙여넣기
프로필에서 5건밖에 안 나와서, 제가 28개를 직접 긁어다 줬습니다.
그리고 나머지는 전부 에이전트가 했습니다. 이제부터가 그 얘기입니다.
🔍 에이전트의 판단 ① — "5건일 리가 없다"
제 프로필을 긁어서 나온 결과가 5건이었습니다.
여기서 에이전트가 그냥 넘어가지 않았어요. 무한 스크롤을 끝까지 내리고, 그래도 5건이니까 "비공개 스터디 공간 글은 로그인해야 보일 수 있다"고 판단해서 저에게 물었습니다.
로그인해서 다시 긁었는데도 똑같이 5건.
그래서 결론을 이렇게 냈습니다 — "비공개라서 안 보이는 게 아니라, 프로필 페이지가 애초에 최근 글만 보여주는 구조입니다."
맞았습니다. 그래서 제가 URL을 직접 줬고, 세어보니 33건이었어요.
🐛 에이전트의 판단 ② — 몬스터 두 마리 진단
여기가 제일 신기했던 부분입니다. 저 혼자였으면 원인을 절대 못 찾았을 문제 두 개예요.
몬스터 1 — 한글이 갈라진다
변환된 파일에 이런 게 있었습니다.
에이전트 신용평가사 → 에 이전트 신용평가사아무도 답 못 하는 → 아 무도 답 못 하는
처음엔 에이전트도 "HTML 읽는 도구 문제인가?" 하고 도구를 바꿨습니다. 근데 바꿔도 똑같은 자리에서 깨졌어요.
여기서 판단을 바꿉니다. "두 도구가 같은 자리에서 깨지면 도구 문제가 아니라 원본 문제다."
그래서 원본을 글자가 아니라 바이트 단위로 열어봤습니다.
\xec\x97\x90 \x00 \xec\x9d\xb4 에 ??? 이
글자 사이에 NUL 바이트(아무것도 아닌 빈 값)가 끼어 있었습니다. 33건 중 23개 파일에서 총 102개. 지피터스 서버가 페이지를 내려줄 때 섞여 들어온 것 같아요.
원인을 알고 나니 해결은 한 줄이었습니다. 읽기 전에 NUL만 빼버리면 끝.
몬스터 2 — 표가 통째로 사라짐
제 글에 있던 표가 하나도 안 나왔습니다. 처음엔 "내가 표를 안 썼나?" 했는데 원본 글엔 멀쩡히 있더라고요.
원본 HTML을 뜯어보니 이렇게 생겼습니다.
<div><colgroup>...</colgroup><tbody><tr><th>...</th></tr></tbody></div>표를 감싸는 <table> 태그가 없습니다.
이게 왜 문제냐면 — HTML을 읽는 프로그램은 규칙상 <table> 없는 표 조각(<tr>)을 그냥 버리게 되어 있습니다. 화면에서는 자바스크립트가 돌면서 표로 그려주니까 멀쩡해 보이는데, HTML만 받아서 읽으면 표가 없는 셈이죠.
<colgroup> 앞에 <table>을 끼워넣는 전처리 한 줄로 표 16개가 되살아났습니다.
💡 혹시 지피터스 글을 백업하거나 옮기실 분은 이 두 가지를 꼭 확인해 보세요. 눈으로 보면 멀쩡해서 놓치기 아주 쉽습니다.
🧱 에이전트가 세운 분류 기준 6개
이제 본론입니다. 33건을 AKM의 7계층에 나눠 넣어야 하는데, 이 기준을 제가 정하지 않았습니다. 에이전트가 제안하고 저는 읽고 고개를 끄덕였을 뿐이에요.
친절하게 하나씩 풀어보겠습니다.
기준 A. 원본은 한 글자도 고치지 않는다
33건은 10-sources/에 그대로 두고, 파생 노트를 새로 씁니다. 그리고 새 노트마다 "이 내용의 근거는 이 소스들"이라고 링크를 겁니다.
왜? 나중에 해석이 틀렸다고 판명나도 원본으로 돌아갈 수 있어야 하니까요. 원본을 고치기 시작하면 되돌아갈 곳이 없어집니다.
기준 B. "나를 몰라도 남이 그대로 써서 맞는 말인가?"
이게 제일 유용했습니다. 20-knowledge(지식)와 30-context(내 맥락)를 가르는 질문이에요.
같은 사례글에서 나온 내용도 이 질문으로 갈립니다.
원본 | → 지식 (누구에게나 참) | → 내 맥락 (나에게만 참) |
|---|---|---|
영상 일관성 8건 | "캐릭터 시트를 먼저 만들면 일관성이 올라간다" | "나는 미드저니보다 드리미나를 주로 쓴다" |
에이전트 6건 | "하네스는 AGENTS.md·스킬·룰·훅·메모리 5요소다" | "내 에이전트 '단지'는 아직 성능이 미흡하다" |
브랜딩 6건 | (절차만 뽑아서 | "예술가에 대한 동경" 같은 정체성 |
이 질문 하나로 헷갈리던 게 거의 다 정리됐습니다.
기준 C. 2회 이상 반복된 것만 지식으로 올린다
영상 일관성 → 8건에서 반복 → 승격 ✅
딥리서치 → 4건 → 승격 ✅
노코드 자동화 한계 → 5건 → 승격 ✅
해커톤 신용평가사 → 1건 → 기록으로만 남김 ❌
왜? 한 번뿐인 경험을 "지식"이라고 올리기 시작하면, 결국 소스를 옮겨 적은 것에 불과해집니다.
기준 D. 실행 기록은 33건 중 2건만
60-actions(실행 기록)에 넣은 건 딱 둘이었습니다 — AKM 설치 기록, 해커톤 기록.
왜? 모든 사례를 실행 기록으로 만들면 60-actions가 두 번째 소스 폴더가 되니까요. 기준은 "재현 가능한 판단이 담겼는가"였습니다. 예를 들어 AKM 설치 기록에는 궤도를 되돌린 프롬프트 두 개가 그대로 들어있어서 남겼습니다.
현재 세션을 처음부터 검토해서 어디서부터 어긋났는지 찾아봐줘.그리고 방법이 틀렸다면 알려줘.
기준 E. 40-memory에는 새 내용을 쓰지 않는다
40-memory는 매 세션 반드시 읽는 곳입니다. 여기에 대해 에이전트가 정한 규칙이 재밌었어요.
여긴 새로 쓰는 곳이 아니라, 다른 계층에 이미 있는 것 중에서 승격시키는 곳이다.
승격 조건 세 개를 다 만족해야 합니다.
모르면 같은 실수를 반복한다
한 줄로 요약된다
전문(全文)이 다른 계층에 있다
그래서 지금 제 40-memory는 16줄입니다. 내용은 없고 포인터만요.
영상 작업 → [[consistent-video-workflow]]리서치 → [[deep-research-workflow]]
막혔을 때 → "어디서부터 어긋났는지 찾아봐줘"
왜 이렇게까지? 지난주에 제 볼트가 멈춰 있던 이유가 운영 규약에 "관련 문서를 먼저 확인한다"라고만 써놔서 "관련 문서"가 어느 건지 특정이 안 됐던 거였거든요. 그래서 이번엔 전부 파일명으로 못 박았습니다.
기준 F. 실패 기록엔 'Learn Back' 칸을 강제한다
AKM에는 실패 기록에 한 칸이 더 붙습니다.
## Learn Back- 고친 계층: 30-context
- 고친 파일: [[profile]]
- 무엇이 달라지는가: 에이전트가 선택지를 낼 때 전제를 먼저 밝히게 된다
실패했으면 어느 폴더를 고칠지 지목해야 합니다. 이게 없으면 그냥 창고니까요. 에이전트는 이걸 규칙 문서에 필수 항목으로 박아뒀습니다.
🪞 그리고 거울을 봤습니다
실패 기록 폴더를 채우려고 33건에서 실패한 것만 뽑았는데, 기준 C(2회 이상)를 적용하니 7개가 남았습니다.
패턴 | |
|---|---|
P1 | 이해 못 한 채 "진행해"를 누른다 |
P2 | 순서를 건너뛰고 도구부터 만든다 |
P3 | 쓴 노트가 다시 안 읽힌다 |
P4 | 기획이 부실한 채 가드레일만 세운다 |
P5 | 일관성을 후보정으로 해결하려 한다 |
P6 | 오류가 꼬였는데 그 위에 계속 쌓는다 |
P7 | 도구 전제 조건을 확인 안 하고 시작 |
그리고 마지막에 이렇게 정리해두더군요.
P1·P2·P4는 같은 뿌리입니다 — "내가 이해하기 전에 만들기 시작했다."
이게 좀 아팠습니다. 지난주에 "진행해만 눌렀더니"라고 쓸 때 저는 그게 그 주에 있었던 사고인 줄 알았거든요. 근데 3년치를 모아놓고 보니 사고가 아니라 패턴이었습니다.
흩어져 있으면 "그날의 삽질"인데, 한 폴더에 모으니까 패턴이 보입니다. 이게 지식관리를 하는 이유였구나 싶었어요.
✅ 에이전트가 스스로 검사한 것
이것도 적어둘 만합니다.
초안을 쓴 뒤에 자기가 쓴 숫자를 원본이랑 다시 대조하더니 네 군데를 고쳤습니다.
항목 | 처음 쓴 값 | 실제 |
|---|---|---|
공간별 건수 | 합계가 32 | 33 (에이전트/노코드가 10건) |
NUL 바이트 | 11개 | 102개 (23개 파일) |
복구된 표 | 15개 | 16개 |
| 15줄 | 16줄 |
앞의 두 개는 첫 5건만 처리했을 때의 값을 33건 전체인 것처럼 쓴 거였어요. 저는 전혀 몰랐습니다.
제 이름으로 나갈 글이니까요. 이런 검사는 시켜야 합니다.
📊 결과
10-sources/ 33건 ← 사례글 원본 (수정 금지)20-knowledge/ 4건 ← 하네스 구성요소, 영상 일관성, 딥리서치 프롬프트, 노코드 한계
30-context/ 3건 ← 나는 누구인가 / 내 에이전트들 / 도구 스택
40-memory/ 1건 ← 매 세션 읽는 16줄
50-procedures/ 3건 ← 딥리서치 · 영상제작 · 브랜딩 워크플로우
60-actions/ 2건 ← AKM 설치 기록, 해커톤 기록
70-evaluation/ 2건 ← 반복 실패 7개, 사고 등급 D1~D4
99-system/ 3건 ← 스키마, 분류 규칙, 빌드 기록
그리고 99-system/BUILD-LOG.md에 "무엇을 어디에 왜 만들었나"를 통째로 남겼습니다. 나중에 분류가 헷갈릴 때 돌아올 곳이 필요하니까요.
🤔 그래서 제가 한 게 뭘까요
아직 이 녀석이 넣은 파일이나 판단규칙이 이해가 되지도 않고, 파일을 살펴보지도 않았습니다.
일단 사례글은 좋은 소스인 것 같습니다.
삽질 과정이 다 들어있고, 배운 점까지 정리돼 있고, 날짜도 붙어 있고...
내가 뭘했나 싶었는데, 처음에 주었던 가드레일이 일을 꽤 했답니다. (클코 왈)
그리고 아직 남은 이해의 영역이 있습니다.
아이디어를 내는 것, 울타리를 치는 것, 그리고 결과를 이해하는 것. 일단 이 세 개는 제 몫인 것 같습니다.
어느덧 스터디는 절반이 넘어갔는데, 저의 AKM 여정은 이제 시작하는 것 같습니다. 하하...
로그인하고 댓글을 남겨 주세요
33개의 사례글이 이렇게 하나의 시스템으로 연결될 수 있다는 게 신기하네요.
특히 실패 기록에도 Learn Back을 넣어서 다음 개선으로 이어지게 만든 부분이 제일 인상 깊었어요. 실패도 잘 쌓아두면 결국 자산이 되는 거네요.
저도 기록은 많이 하는 편인데, 단순히 쌓아두는 것과 다시 활용할 수 있게 만드는 건 정말 다른 문제라는 생각이 들었습니다.
앞으로 이 시스템이 또 어떻게 진화할지 궁금해지네요. 저도 하나씩 따라가며 같이 성장해 보겠습니다!
제 사례가 실패 투정이라... ㅋㅋㅋㅋㅋ 기록을 많이 하신다니 존경스럽습니다! 가진 기록이 많으면 복리로 풀어가는 지식도 늘겠어요! 유쌤님의 사례도 구경하러 갈게요~
2년간 써온 사례글이 이미 좋은 원료였다는 깨달음에서 출발하신 점이 재미있었습니다. 삽질 과정과 배운 점, 날짜까지 붙어 있으니 확실히 시작 소스로는 최적이었겠네요. 시작 전에 시킨 부분만 하라는 것과 파일을 만들기 전에 물어보라는 가드레일 두 개를 먼저 걸어두신 것도 결과적으로 큰 역할을 한 것 같습니다.
프로필에서 5건만 나온 결과를 그냥 넘기지 않고 로그인까지 시도한 뒤 페이지 구조 문제로 결론 낸 과정, 그리고 두 도구가 같은 자리에서 깨지면 도구가 아니라 원본 문제라고 판단을 바꿔 바이트 단위로 열어본 대목이 흥미로웠습니다. NUL 바이트가 섞여 한글이 갈라진 사례와 table 태그가 없어 표가 통째로 버려진 사례는 나중에 글을 옮길 때 저도 부딪힐 것 같아 기억해두려 합니다.
분류 기준 중에서는 나를 몰라도 남이 그대로 써서 맞는 말인가라는 질문이 지식과 맥락을 가르는 데 특히 유용해 보였습니다. 2회 이상 반복된 것만 승격하고, 실행 기록은 재현 가능한 판단이 담긴 것만 남기고, 매 세션 읽는 곳에는 새 내용을 쓰지 않고 포인터만 두신 절제가 결국 볼트가 멈추지 않게 하는 장치겠네요. 관련 문서라고만 적어두면 특정이 안 된다는 지난 경험을 파일명으로 못 박아 해결하신 점도 인상 깊었습니다. 실패 기록에 어느 계층을 고칠지 지목하는 칸을 필수로 만든 것도 좋았습니다.
흩어져 있으면 그날의 삽질인데 한 폴더에 모으니 패턴이 보인다는 대목이 가장 남았습니다. 반복 실패 일곱 개 중 셋의 뿌리가 이해하기 전에 만들기 시작한 것이었다는 정리는 쓰기 쉽지 않은 기록일 텐데 솔직하게 적어주셔서 읽는 쪽에 더 도움이 됐습니다. 에이전트가 초안의 숫자를 원본과 다시 대조해 네 군데를 고쳤다는 부분도, 결국 검사는 시켜야 한다는 교훈으로 읽었습니다.
아이디어를 내는 것, 울타리를 치는 것, 결과를 이해하는 것 세 가지가 내 몫이라는 마무리에 공감합니다. 남은 이해의 영역을 채워가시는 다음 이야기도 기대하며 응원하겠습니다!
에이전트의 판단과 기준을 보면서 저도 배우고 있습니다(아직도 ㅎㅎㅎ)
꾸기작님의 정리된 댓글을 보면서 다시 되새기도 있어요 😄


흩어져 있을 때는 ‘그날의 삽질’이었는데, 33개를 모으니 반복되는 패턴이 보였다는 부분이 정말 와닿았습니다. 원본은 그대로 보존하고 지식과 맥락을 분리한 기준도 좋네요. 이제 생성된 지식과 절차를 직접 검토하면서 어떤 것이 정말 재사용되는지 확인하는 다음 편도 기대됩니다!
사실 아직 다음을 진행시키지 않았는데.. 댓글을 보면서 다음을 가야겠다는 채찍질을 스스로에게 하고 있습니다. ㅎㅎㅎㅎ