본문으로 건너뛰기

AKM 알아보기

민혁

2026.08.01

# AKM 쉬운 말 번역본

> AKM(github.com/DECK6/akm): **1인 도서관이 딸린 공방.**
> 직원(LLM)이 사서·저자·독자·심사위원을 혼자 다 하고, 작업대에서 실패할 때마다 서가의 책이 개정된다.
> 어렵게 보이는 건 용어 때문이고, 잘 정리된 사무실의 서류 체계다.

## 폴더 = 서류함

| 폴더 | 쉬운 말 | 뭐가 들어가나 |
|---|---|---|
| 00-inbox | **접수함** | 새로 온 건 뭐든 일단 여기. 7일 안에 분류 |
| 10-sources | **원본 보관함** | 받은 문서 그대로. 손대기 금지 |
| 20-knowledge | **백과사전** | 누구에게나 참인 지식 (세상이 보증) |
| 30-context | **우리 사정 메모** | 우리한테만 참인 것. 암묵지, 행간 (우리가 보증) |
| 40-memory | **늘 갖고 다니는 쪽지** | 매번 일 시작 전 봐야 할 몇 줄 |
| 50-procedures | **지시서** | 일하는 법: 단계 + 조심할 곳 + 확인법 |
| 60-actions | **일지** | 한 일의 기록 — 단, 선별해서만 |
| 70-evaluation | **채점표 + 오답노트** | 판정 기준과 틀렸던 기록 |
| 80-outputs | **납품함** | 밖으로 나가는 완성품 |
| 90-archive | **창고** | 은퇴한 문서 |
| 99-system | **사규집** | 분류 안내판(ROUTER), 서류 규격(SCHEMA), 업무 순서(LOOP) 등 |

**서가와 판형:** 서류함(서가)이 정해지면 글의 양식(판형)도 정해진다. 지시서는 지시서 양식(언제 쓰나→단계→실수 포인트→확인법), 오답노트는 오답노트 양식. 자유롭게 쓰고 분류하는 게 아니라 **분류 먼저, 그 양식대로 쓰기.**

## 설치하기 = 쪽지 여섯 줄

설치란 CLAUDE.md(에이전트가 매번 자동으로 읽는 파일)에 **여섯 줄**을 붙여넣는 것: ①지식 필요하면 목차(INDEX)와 쪽지(40)부터 읽어라 ②목차 보고 필요한 것만 열어라 ③저장 전엔 분류 안내판을 따라라 ④끝냈다 하기 전에 채점해라 ⑤틀리면 오답노트 쓰고 원인 문서를 고쳐라 ⑥원본 손대지 말고 목차·일지 갱신해라.

**읽기는 깔때기 3단:** 여섯 줄(항상) → 쪽지+목차(매 세션, 짧은 것 전부) → 본문(필요할 때, 골라서). 내려갈수록 드물게, 대신 많이 읽는다. 그래서 쪽지와 목차엔 "짧게!" 규칙이 붙는다 — 매번 통째로 읽히는 곳이 비대해지면 모든 세션이 그 값을 낸다.

## 일하는 순서 = 한 문장

> **접수하고 → 분류하고 → 사전에 정리하고 → 우리 사정에 연결하고 → 지시서대로 일하고 → 채점하고 → 틀렸으면 원인 문서를 고친다.**

마지막이 핵심. 오답노트만 쓰면 반성문 모음이다. **오답을 낳은 교과서를 고쳐야** 다음에 안 틀린다. 이게 없으면 위키(쌓기만)거나 자동화(반복만)일 뿐 — 이라는 게 이 시스템의 자기소개다.

## 헷갈리는 경계, 판별법 한 줄씩

- **백과사전(20) vs 우리 사정(30)**: "경쟁사 직원에게 줘도 유용하고 참인가?" 참이면 백과사전.
- **백과사전(20) vs 지시서(50)**: "아는 것인가, 하는 것인가?"
- **지시서(50) 자격시험 (5개 전부)**: 반복되나 + 단계 있나 + 실수 포인트 있나 + 확인법 있나 + 다음번이 나아지나. 하나라도 탈락이면 못 들어온다.
- **일지(60인가 70인가) 기록 기준 (기본은 안 씀)**: 나중에 재현·검증·복구·인수인계에 필요한가? "무사히 완료"는 버리고, "이렇게 결정, 이유는 X"는 남긴다.
- **쪽지(40) 입장 조건 (전부)**: 짧고 + 안 변하고 + 반복 필요하고 + 매번 먼저 알아야 하고 + 몇 줄이면 충분.
- **채점표(rublic)의 네 칸**: 채점 기준(시험 전에 만든다) / 오답노트 / 응급처치법 / 정기점검 기록.

## 틀렸을 때 — 뭘 고치나

원리: **실패는, 자기를 낳은 문서를 고친다.**

| 무슨 실수 | 진단 | 고칠 것 |
|---|---|---|
| 지시서대로 했는데 틀림 | 레시피가 낡았다 | 지시서(50) |
| 같은 실수 반복 | 까먹는다 | 쪽지(40)에 경고 한 줄 |
| 알던 게 틀림 | 백과사전이 낡았다 | 백과사전(20) |
| 상대 의도 오해 | 그 사람을 몰랐다 | 우리 사정 메모(30) |
| 엉뚱한 함에 넣음 | 안내판이 나빴다 | 분류 안내판(ROUTER) |
| 확인 없이 "다 했다" | 채점표가 없었다 | 채점표(70) 신설 |

판별 요령: 지시서를 **지켰는데** 틀림 → 지시서 탓. **안 지켜서** 틀림 → 실행 탓(쪽지로 경고). 레시피대로 했는데 케이크가 망하면 레시피 탓, 설탕을 빼먹었으면 요리사 탓.

이 "고치기"에 자동 장치는 없다. 여섯 줄 쪽지의 ⑤번이 매번 상기시키고, LLM이 스스로 파일을 고치는 것뿐 — 그래서 LLM이 깜빡하면 루프는 안 돈다.

## "틀렸다"는 누가 아나 — 네 겹의 심판

믿을 만한 순서:  
① **일이 터진다** (에러, 반려, 테스트 실패 — 도구를 돌린 결과가 되돌아와서 안다. 단, 잘못 쓴 보고서엔 에러 메시지가 안 뜬다)  
② **검사기가 잡는다** (lint, 스크립트)  
③ **채점표 들고 자기 채점** — 공식적으로 최하위 증거. 못 믿을 직원이 자기 시험지 채점하는 셈이라, "직접 확인·도구 출력·사람 검토가 우선"이 규칙에 박혀 있다  
④ **사람이 말해준다**.

**채점표는 누가 만드나:** 대부분 에이전트 자신이("기준 없으면 기준부터 만들어라"). 권위는 창작이 아니라 **베끼기**에서 온다 — 공식 규정, 실제 반려당한 지점(판례), 사람의 승인에서 항목을 가져온다. 채점표도 문서라 틀리면 고친다(채점 통과했는데 실제 반려 → 채점표 개정). 서열은 항상 **현실 > 채점표.**

## 문서가 만 개가 되면?

목차(INDEX)는 항목당 한 줄이라도 만 개면 20만~30만 토큰 — "매번 목차를 읽어라"가 부서진다.  
  
대책 셋:

- **층별 목차**: 전관 목차엔 굵은 안내만("세무 관련은 20번 서가"), 상세는 서가별 목차로. 통독 대신 트리 타고 내려가기.
- **손전등(grep)**: 키워드로 전체를 한 번에 훑는다. 단 이건 AKM 규칙이 아니라 에이전트의 자체 능력. AKM의 기여는 **라벨** — 전부 텍스트고(HWP엔 손전등이 안 통함), 파일명·경로·요약 한 줄이 규격대로 붙어 있어서, **비추기만 해도 상자를 안 열고 내용을 안다.**
- **라벨의 경제학**: 저장할 때 라벨 쓰는 비용 한 번으로, 찾을 때마다 본문 통독을 영구 면제. 한 번 쓰고 여러 번 읽히니 남는 장사 — 그래서 다시 안 읽힐 건 저장 자체를 금지한다.

남는 구멍: 라벨이 부실하면 **있어도 못 찾는다**(의미적 누락). 목록 누락은 검사기가 잡지만, 나쁜 요약은 기계가 판정 못 한다 — "못 찾았던 노트의 요약을 고쳐라"는 오답노트 행이다. 그리고 만 개를 훌쩍 넘어 뜻으로 찾아야 하면(동의어, 개념) 검색 엔진을 밖에서 붙여야 한다.

## 왜 서류함인가 — 직원의 머릿속은 못 고친다

LLM의 머릿속 기억은 배운 것의 흐릿한 압축본이고(드문 건 비슷한 걸로 뭉갬 = 환각), 고칠 수 없고(재학습은 수개월·거액), 출처를 못 대고, 떠올릴 때마다 조금 다르다. 서류함은 정확하고, 지금 당장 고쳐지고, 출처가 붙고, 읽을 때마다 같다. 그래서:

- **배움은 고칠 수 있는 쪽에 쌓인다** — 머리는 못 고치니 서류를 고친다(= Learn Back의 정체).
- **분업**: 능력(추론·판단)은 직원에게, 지식(사실·최신·우리 사정)은 서류함에.
- **직원은 바꿔도 서류함은 남는다** — 더 좋은 모델로 갈아타도 지시서·오답노트·사전은 전부 이월.

## 무엇에 쓰나 — 3단계로 자란다

같은 서류함이 도구가 붙는 만큼 자란다:  
① **물어보기** — "이 경우 어떻게 처리해요?" → 절차와 암묵지를 찾아 답변(사내 문서검색, 현실적 시작점)  
② **준비시키기** — 전표 초안과 체크리스트까지 만들어주고 "이제 올리시면 됩니다"  
③ **맡기기** — 회사 시스템이 연결되면(MCP·API) 입력·제출까지 직접. AKM은 어느 단계든 옆에 놓이는 지식 기반이고, 일을 실제로 "하는" 능력은 에이전트의 도구가 정한다.

## 한 문단 요약

일하는 직원이 사람이 아니라 **의미는 이해하지만 믿을 수 없는** LLM이기 때문에 이 모든 게 필요하다. 지시를 문서로 박아두고(지시서), 매번 쪽지로 상기시키고(쪽지), 완료 보고를 채점표로 검사하고(채점표), 틀리면 지시 문서 자체를 고쳐서(오답노트→교과서 수정) 같은 실수가 재발하지 않게 한다. 기계가 검사할 수 있는 것은 전부 검사기에 맡기고, 판단이 필요한 것만 LLM에게 남긴다 — **기계의 것은 기계에게, LLM의 것은 LLM에게.**
5

함께 이야기해요 5

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.08.01
AKM을 이렇게 서류함 비유로 풀어내니 훨씬 손에 잡히네요. "분류가 글쓰기보다 먼저"라는 원칙이나 지시서 자격시험 5가지 체크리스트처럼, 실제로 쓸 때 헷갈리기 쉬운 경계를 판별법 한 줄씩으로 정리해두신 게 특히 실용적이에요. "오답을 낳은 교과서를 고쳐야 다음에 안 틀린다"는 문장이 오래 머물더라고요. 오답노트만 쌓으면 반성문 모음이 된다는 지적 — Learn Back이 없으면 위키이거나 자동화일 뿐이라는 구분, 날카롭게 맞아요. 정리하면서 스스로 더 명확해지는 것들이 생겼을 것 같아요. 🐾
DECK 프로필 이미지
DECK2026.08.06

‘1인 도서관이 딸린 공방’이라는 비유는 복잡한 폴더 설명보다 먼저 머릿속에 지도를 만들어 줬습니다.

Learn Back을 실패 목록이 아니라 그 실패를 낳은 원인 문서의 수정으로 푼 부분도 반가웠고요.

결국 뒤이은 실행이 다른 규칙을 읽게 해야 루프가 닫힌다는 이야기니까요.

inbox의 자료 하나가 라우팅과 검증을 거쳐 승격되고 다시 수정되는 예시 하나면 입문 설명이 완성되겠네요.

꾸
꾸기작2026.08.06

AKM을 이렇게 명확하게 설명해주신 글이 정말 인상 깊었습니다. "1인 도서관이 딸린 공방"이라는 표현이 정말 좋습니다. LLM이 직원이 되면서 문서 기반 관리의 중요성을 이렇게까지 정리한 점이 정말 탁월합니다. 폴더를 서류함으로, 파일의 양식을 규칙화하는 부분이 특히 좋습니다. 단순해 보이지만 시스템의 본질을 정확히 포착한 설명입니다.

"분류 먼저, 그 양식대로 쓰기"라는 원칙이 정말 명확합니다. 접수함, 원본 보관함, 백과사전, 우리 사정 메모, 쪽지, 지시서, 일지, 채점표, 납품함, 창고의 10개 폴더가 각각 무슨 역할을 하는지 표로 정리한 부분도 정말 좋습니다. "경쟁사 직원에게 줘도 유용하고 참인가?"라는 한 줄 판별법도 정말 통찰력 있습니다.

틀렸을 때 "실패는 자기를 낳은 문서를 고친다"는 원칙이 정말 핵심입니다. 지시서대로 했는데 틀리면 지시서를 고치고, 같은 실수를 반복하면 쪽지에 경고를 넣는다는 방식이 정말 실천적입니다. "네 겹의 심판"—일이 터지기, 검사기, 자기 채점, 사람의 검토라는 순서도 정말 명확합니다. 채점표도 틀리면 고친다는 부분이 특히 좋습니다.

만 개의 문서가 될 때의 대책—층별 목차, 손전등 검색, 라벨의 경제학도 정말 현실적입니다. "저장할 때 라벨 쓰는 비용 한 번으로 찾을 때마다 본문 통독을 영구 면제"라는 표현이 정말 좋습니다. "능력은 LLM에게, 지식은 서류함에"라는 분업의 원칙도 정말 명확합니다. 이 글을 읽으면서 LLM과 함께 일한다는 것의 본질을 배웠습니다. 계속 발전해 나가는 AKM을 응원하겠습니다!

스쿨셰프 프로필 이미지
스쿨셰프2026.08.10

민혁 님, AKM을 “1인 도서관이 딸린 공방”과 00~99 서류함으로 풀어 주신 번역이 용어 장벽을 확 낮췄습니다. 특히 오답노트만 쓰면 반성문 모음이고 “오답을 낳은 교과서를 고쳐야” Learn Back이 된다는 한 문장, 그리고 지시서를 지켰는데 틀린지·안 지켜서 틀린지에 따라 고칠 서류를 가른 표가 기억에 남습니다. CLAUDE.md 여섯 줄과 읽기 깔때기 3단도 바로 옮겨 쓰기 좋았습니다.

김도경 프로필 이미지
김도경2026.09.27

덕분에 잘 읽었습니다~

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기