GPTERS 23 · AGENT KNOWLEDGE MANAGEMENT

세 노트로
AKM을 시작합니다.

기존 지식관리 시스템을 버리지 않고, 답변에 참고할 지식과 에이전트가 실행할 때 읽는 운영 지식을 분리합니다. 마지막에는 직접 읽어 검증하고, 실패를 다음 구조 수정으로 되돌립니다.

오늘의 성공 단위는 전체 Vault 이전이 아닙니다. 별도 실습 폴더, privacy-safe 노트 세 개, 답변 참고용 정본 노트 한 개, 에이전트 운영 카드 한 개, Verify 한 번, Learn Back 한 줄이면 충분합니다.

실습 시작20+60분 흐름 보기공개 AKM 저장소 ↗
01 / WHY AKM

왜 AKM인가

노트가 많다는 사실만으로 AI가 원본, 현재 결정, 적용 범위, 실행 절차를 구분하지는 못합니다. AKM은 기존 지식의 집을 허무는 앱이 아니라, 에이전트가 그 집의 방과 규칙을 읽는 운영 지도입니다.

BEFORE / 자주 생기는 장면

자료는 있는데 매번 다시 설명합니다.

  • 원본 링크, 개인 해석, 프로젝트 결정, 체크리스트, 실패 기록이 한곳에 섞입니다.
  • 좋은 답변은 대화에 묻히고, 오래된 초안이 현재 기준처럼 다시 사용됩니다.
  • 검색 결과가 나와도 그것이 권위 있는 최신 기준인지 다시 확인해야 합니다.
AFTER / 책임을 분리한 상태

같은 내용을 서로 다른 책임으로 나눕니다.

  • 원본은 Source로 보존하고, 재사용 판단은 Knowledge로 합성합니다.
  • 프로젝트 조건은 Context, 반복 단계와 stop rule은 Procedure로 둡니다.
  • 실패를 Evaluation에서 판정하고 수정할 레이어로 Learn Back합니다.

Obsidian, Notion, Logseq, 폴더를 그대로 유지합니다. 기존 위치를 가리키는 포인터와 작은 manifest부터 시작합니다. 첫 주에 전체 Vault를 옮기지 않습니다.

TWO KNOWLEDGE ZONES
답변 참고 지식

Source → Knowledge
사실 · 근거 · 정본 · 충돌

에이전트 운영 지식

Context + Operational Memory + Procedure
→ Action → Evaluation → Learn Back

답변 참고 지식은 “무엇을 말할 것인가”를 담당합니다. 에이전트 운영 지식은 “누구의 어떤 상황에서 어떤 순서와 제한으로 실행하고 검증할 것인가”를 담당합니다. Context는 답변과 무관한 격리 구역이 아닙니다. 사용자와 프로젝트 상황에 따라 답변의 적용 범위와 강조점을 바꿀 수 있습니다. Operational Memory는 매번 먼저 알아야 하는 짧고 안정적인 포인터이며, 긴 문서와 일시적 상태를 모두 넣는 곳이 아닙니다.

FAILURE → LEARN BACK

오래된 초안이 현재 기준처럼 쓰였다면

VERIFY, FIX, RE-RUN
01 / NOTICE

오래된 초안이 현재 결정처럼 사용된 지점을 찾습니다.

02 / DIRECT READ

어느 source가 더 권위 있는지 원문에서 직접 확인합니다.

03 / FIX SYSTEM

Procedure 또는 Evaluation의 source·authority·scope 확인 단계를 고칩니다.

04 / RE-RUN

같은 입력으로 다시 실행해 오래된 초안이 기준이 되지 않는지 Verify합니다.

SECONDARY CASE / CEREBRAS

Cerebras는 Slack, 코드, 문서, 내부 시스템을 한곳으로 강제 이관하기보다 기존 출처에서 정보를 모아 사람·자동화·AI 에이전트가 함께 쓰는 검색 계층을 구축했다고 공개했습니다. 하루 15,000건 이상의 질의는 Cerebras의 자체 보고이며 독립 검증되지 않았습니다. 이 숫자는 보편 권장값이 아니라 “자료 위치”보다 “근거와 권한의 연결”이 중요하다는 보조 사례로만 읽습니다.

20 + 60 MINUTES

사례에서 실습까지 한 번에 닫는 흐름

TOTAL 80 MIN
전체
블록
하는 일
남는 것
0–20분
왜 AKM인가
문제 장면 → 두 지식 구역 → Before/After → 실패와 Learn Back → 오늘 산출물 미리보기
작은 성공 단위 이해
20–28분
안전한 설치
별도 실습 위치에서 clone하고 4분 blocker stop rule을 적용합니다.
short HEAD 또는 정직한 판정
28–34분
저장소 해부
INDEX · SCHEMA · ROUTER · LOOP 네 파일의 역할만 확인합니다.
네 파일 역할표
34–40분
현재 시스템 매핑
기존 위치를 옮기지 않고 AKM 역할 후보를 표시합니다.
레이어 매핑표
40–54분
세 노트 선택
원본·해석·적용 노트를 골라 Migration Manifest 세 행을 채웁니다.
3행 Manifest
54–68분
두 artifact 제작
답변 참고용 정본 노트와 별도의 에이전트 운영 카드를 만듭니다.
Markdown 2개
68–76분
Verify · Learn Back
source direct read로 주장과 범위를 확인하고 수정할 레이어를 정합니다.
판정과 수정 대상
76–80분
Exit Ticket
다음 7일 source, 검증 질문, 완료 evidence를 약속합니다.
다음 행동
02 / SAFE INSTALL

안전한 별도 경로에서 시작합니다.

기존 개인 Vault, Notion export 폴더, 운영 Git 저장소, 이미 쓰는 akm 폴더 안에서 실행하지 않습니다. 설치가 막혀도 구조와 노트 실습은 계속하되 설치 성공을 주장하지 않습니다.

BEFORE CLASS / 수업 전 준비
  • Git 설치 여부를 확인합니다.
  • 새로운 빈 실습 폴더를 만들 수 있는 컴퓨터를 준비합니다.
  • 원본·기록 노트, 해석·요약 노트, 적용·프로젝트 노트를 한 개씩 고릅니다.
  • 기존 PKM을 쓴다면 현재 구조를 짧게 설명할 준비를 합니다.
  • 기존 Vault나 지식관리 시스템은 이동하거나 삭제하지 않습니다.
  • 설치가 막히면 privacy-safe 공개 샘플과 읽기 전용 fallback으로 노트 실습을 계속합니다.

먼저 자료를 확인합니다.

하나라도 확실하지 않으면 개인 노트를 사용하지 않습니다. token, proxy secret, 개인 credential로 회사 정책을 우회하지 않습니다.

TERMINAL / macOS · Linux
mkdir -p "$HOME/akm-lab-gpters23"
cd "$HOME/akm-lab-gpters23"
pwd
git --version
git clone https://github.com/DECK6/akm.git akm-week1
cd akm-week1
git rev-parse --short HEAD
4-MINUTE BLOCKER STOP RULE

네트워크·권한 문제를 오래 끌지 않습니다.

  1. Git 미설치, 네트워크 차단, 권한 문제가 4분 안에 풀리지 않으면 troubleshooting을 멈춥니다.
  2. 검증된 읽기 전용 fallback 또는 pair-observer 방식으로 구조·노트 실습을 계속합니다.
  3. 직접 설치하지 않았다면 NOT TESTED, 정책·권한 때문에 멈췄다면 HOLD입니다.
  4. fallback은 설치 성공 evidence가 아닙니다. Node.js와 lint도 첫 실습의 필수 조건이 아닙니다.
INSTALL EVIDENCE / WORKSHEET
CLONE URL

https://github.com/DECK6/akm.git

03 / ANATOMY

저장소에서는 네 파일만 먼저 엽니다.

폴더 전체를 외우지 않습니다. “어디부터 읽고, 어떤 형식으로 쓰고, 새 자료를 어디로 보내고, 어떻게 Learn Back하는가”만 확인합니다.

99-system/INDEX.md

어디부터 읽는가

현재 구조와 핵심 파일을 찾는 출발점입니다. 목록이 존재한다고 내용이 사실로 확정되는 것은 아닙니다.

99-system/SCHEMA.md

어떤 역할로 쓰는가

레이어, frontmatter, 상태와 형식의 공통 계약을 확인합니다.

99-system/ROUTER.md

새 자료를 어디로 보내는가

원본, 재사용 지식, 프로젝트 맥락, 절차, 실행 기록을 구분합니다.

99-system/LOOP.md

어떻게 닫는가

Ingest에서 Verify, Learn Back까지 작업이 다음 개선으로 돌아가는 흐름을 봅니다.

examples/minimal-akm/에서 Source와 Knowledge 예시를 나란히 읽습니다. 검색·lint·AI 답변을 원본 대신 사용하지 않습니다. 검색 점수와 lint 통과는 후보 찾기와 형식 점검이지, truth나 사실 검증이 아닙니다.

04 / CHOOSE LANE

깊이는 달라도 마지막 검증은 같습니다.

Advanced는 더 많이 쓰는 레인이 아닙니다. authority, freshness, scope 충돌을 더 엄격히 다루는 레인입니다. 모든 레인은 direct-read Verify와 Exit Ticket에서 다시 만납니다.

CURRENT LANE / BEGINNER

공개 샘플로 Source와 Knowledge를 나누고, 답변 노트 하나와 운영 카드 하나를 만듭니다.

출처 세 개와 결론 한 개를 연결하고, 운영 카드에 사용 시점과 stop rule을 한 줄씩 쓰면 통과합니다.

Advanced 필수 확인 필드: source · authority · scope · effective date · supersedes · reviewer · evidence · stop rule. 최신 파일이라는 이유만으로 정본을 고르지 않습니다.

05 / MAP CURRENT SYSTEM

이동 전에 현재 시스템을 매핑합니다.

현재 위치와 역할을 기록한 뒤 “그대로 둘지, 연결할지, 선택 합성할지”를 결정합니다. 복사부터 시작하지 않습니다.

CURRENT SYSTEM / WORKSHEET
구역현재 위치·노트들어 있는 내용AKM 역할 후보그대로 둘지·연결할지이유
답변 참고 지식SourceSource
답변 참고 지식재사용 판단Knowledge
에이전트 운영 지식프로젝트 조건Context
에이전트 운영 지식반복 단계Procedure
에이전트 운영 지식실패·품질 기준Evaluation
06 / THREE NOTES

privacy-safe 세 노트만 고릅니다.

원본이나 기록에 가까운 노트, 내가 정리한 해석 노트, 실제 프로젝트에 적용한 노트입니다. 원본을 훼손하지 않고 경로 판단만 완료해도 첫 주 마이그레이션은 통과할 수 있습니다.

A

Source A · 원본·기록

B

Source B · 해석·요약

C

Source C · 적용·프로젝트

MIGRATION MANIFEST

정확히 세 행만 결정합니다.

PRESERVE → POINT → SYNTHESIZE
기존 노트구역현재 역할AKM 목적지 후보처리 방식민감도이유
Source A답변 참고 지식
Source B답변 참고 지식
Source C에이전트 운영 지식
07 / THREE FILES

실습에서 완성할 세 개의 Markdown 파일

Manifest는 세 source를 어떻게 다룰지 결정하고, 답변 참고 노트는 무엇을 근거로 말할지 기록하며, 운영 카드는 에이전트가 언제 어떤 제한으로 실행할지 정합니다. 책임이 다르므로 한 파일에 합치지 않습니다.

FICTIONAL ANSWER BOUNDARY

아래 미리보기와 다운로드 파일은 모두 가상 예시 답안입니다. 실제 조직, 정책, 승인 또는 프로젝트를 나타내지 않습니다. 내 입력은 기존 localStorage에만 저장되며 예시를 열거나 내려받아도 덮어쓰지 않습니다.

01-migration-manifest.md

세 source의 보존·연결·합성·HOLD 결정

앞의 3 NOTES와 Manifest 표에 적은 값에 아래 authority·scope·evidence를 더해 한 파일로 내보냅니다.

가상 예시 .md

상세 필드

  • 학습 레인·현재 시스템
  • privacy-safe 확인
  • Source A·B·C 이름과 현재 위치
  • 현재 역할·지식 구역
  • AKM 목적지·처리 방식
  • 민감도·Authority·Scope
  • 문서 상태·이유
  • 직접 읽은 근거
가상 예시 답안 / PREVIEW

주간 브리핑 source pack

  • Source A — 승인된 가상 팀 공통 기준, 원본 유지·포인터
  • Source B — 작성자의 미승인 제안, 승인 내용과 분리해 선택 합성
  • Source C — 가상 라온 프로젝트 한정 기록, 연결하되 공통 반영은 HOLD

Manifest 추가 필드

이름·현재 역할·목적지·처리 방식·민감도·이유는 바로 앞 3 NOTES와 Manifest 표의 입력을 그대로 사용합니다.

SOURCE A / 원본·기준
SOURCE B / 해석·제안
SOURCE C / 적용·프로젝트
02-answer-reference-note.md

근거와 판단을 분리한 답변 참고 노트

세 source의 상태·authority·scope·freshness를 적고 Source-to-Claim 표와 Verify 판정을 연결합니다.

가상 예시 .md

상세 필드

  • type·aliases·description·author
  • akmLayer·akmType·trustLevel
  • date created·date modified·tags
  • status·sourceNotes
  • 답할 질문·source 3개
  • 상태·Authority·Scope·Freshness
  • 확인된 사실·합성한 판단
  • Source-to-Claim·직접 읽은 구간
  • 충돌·불확실성·적용 범위
  • Verify 판정·다음 source
가상 예시 답안 / PREVIEW

어떤 문서를 공통 기준으로 쓸 것인가?

판단: Source A만 가상 팀 공통 기준으로 사용합니다. Source B는 미승인 제안, Source C는 라온 프로젝트 예외로 분리하고 공통 반영 여부는 HOLD로 남깁니다.

답변 참고 노트 필드

이 파일의 frontmatter와 본문을 채웁니다. 세 source의 이름·상태·authority·scope와 뒤의 Source-to-Claim·Verify 입력은 같은 브라우저 상태에서 자동으로 연결됩니다.

03-agent-operating-card.md

지식을 복제하지 않는 에이전트 운영 카드

먼저 읽을 답변 참고 노트를 가리키고 Trigger·Procedure·권한 경계·Stop·Evidence·Learn Back만 기록합니다.

가상 예시 .md

상세 필드

  • type·aliases·description·author
  • akmLayer·akmType·trustLevel
  • date created·date modified·tags
  • status·sourceNotes
  • 언제 읽는가·먼저 읽을 노트
  • 사용자·프로젝트 Context·Trigger
  • 순서가 있는 실행 Procedure
  • 권한 경계·Stop·HOLD 조건
  • 완료 Evidence·평가 판정
  • Learn Back 대상·다음 행동
가상 예시 답안 / PREVIEW

브리핑 source 판정 전 읽는 카드

먼저 답변 참고 노트를 읽고 approval·authority·scope·supersedes를 확인합니다. 확인할 수 없거나 프로젝트 범위가 불명확하면 실행을 멈추고 HOLD로 남깁니다.

에이전트 운영 카드 필드

운영 지식만 복제하지 말고 먼저 읽을 답변 참고 노트를 지정합니다. 비워 두면 위에서 작성한 답변 참고 노트 제목을 사용합니다.

THREE LOCAL FILES

현재 입력을 세 개의 Markdown 파일로 분리합니다.

브라우저가 다운로드를 세 번 허용하는지 확인해 주세요. 서버나 계정으로 전송하지 않습니다.

08 / TWO ARTIFACTS

근거와 실행 규칙을 별도 파일로 만듭니다.

답변 참고용 정본 노트는 질문, source, 사실, 합성 판단, 충돌과 적용 범위를 담습니다. 에이전트 운영 카드는 언제 읽고, 어떤 Context와 Procedure로 실행하며, 언제 멈추고 무엇을 evidence로 남길지 정합니다.

ARTIFACT 01 / ANSWER REFERENCE

답변 참고용 정본 노트

SOURCE + KNOWLEDGE
MARKDOWN TEMPLATE
---
type: note
aliases:
  - ""
description: "English relevance hint describing what this note helps a future human or agent retrieve."
author:
  - ""
date created: 2026-07-23
date modified: 2026-07-23
tags:
  - AKM
  - GPTERS
status: inProgress
sourceNotes:
  - "Source A"
  - "Source B"
  - "Source C"
---

# 내가 다시 사용할 지식

## 이번 노트가 답할 질문

이 세 자료를 다시 찾는 이유는 무엇인가?

## 사용한 원본

- Source A:
- Source B:
- Source C:

## 확인된 사실

- 원본에서 직접 확인한 사실
- 여러 source에서 공통으로 확인된 내용

## 합성한 판단

다음 작업에도 재사용할 수 있는 판단을 작성합니다.

## 충돌·불확실성

- 서로 다르게 말하는 부분
- 아직 확인하지 못한 부분
- HOLD로 남길 내용

## 적용 범위

이 판단은 누구와 어떤 프로젝트에서 유효합니까?
ARTIFACT 02 / AGENT OPERATIONS

에이전트 운영 카드

CONTEXT + PROCEDURE + EVALUATION
MARKDOWN TEMPLATE
---
type: procedure
aliases:
  - ""
description: "English relevance hint describing when an agent should load and use this operating card."
author:
  - ""
date created: 2026-07-23
date modified: 2026-07-23
tags:
  - AKM
  - agent-operations
status: inProgress
sourceNotes:
  - "답변 참고용 정본 노트"
---

# 에이전트 운영 카드

## 언제 읽는가


## 먼저 읽을 답변 참고 지식


## 사용자·프로젝트 Context


## 실행 Procedure

1.
2.
3.

## Stop·HOLD 조건


## 완료 Evidence


## 실패 시 Learn Back 대상

Context / Procedure / Evaluation 중 어디를 수정할지 작성합니다.
09 / SOURCE-TO-CLAIM

주장마다 원문 구간을 연결합니다.

최신성만 보지 말고 authority와 scope를 함께 확인합니다. 원본의 사실과 작성자의 해석, proposal과 승인 결정을 분리합니다.

정본 노트의 주장Source직접 확인한 문장·구간AuthorityScope판정
10 / VERIFY

원문을 다시 열고 판정합니다.

결과가 그럴듯한지보다 source를 직접 읽었는지 확인합니다. 확인할 수 없는 내용은 지우거나 단정하지 않고 HOLD로 보존합니다.

DIRECT-READ CHECKLIST
VERIFY RESULT
11 / LEARN BACK

실패를 다음 구조 수정으로 돌려보냅니다.

프롬프트만 다시 쓰고 끝내지 않습니다. 어떤 레이어의 어떤 필드나 단계를 고칠지 정한 뒤 같은 세 source로 재검증합니다.

`[실패 또는 불확실성]`을 발견해 `[Procedure/Evaluation/Context]`의 `[필드 또는 단계]`를 수정하고, 같은 세 source로 다시 확인했습니다. 결과는 `[판정]`입니다.
12 / EXIT TICKET

다음 7일 행동까지 적습니다.

설치 성공을 과장하지 않고, 무엇을 유지하고 무엇을 새로 연결했는지 말합니다. 마지막 세 문항은 다음 source, 검증 질문, 완료 evidence를 한 묶음으로 고정합니다.

13 / TAKE IT WITH YOU

워크시트를 내 브라우저에서 꺼냅니다.

입력 내용은 자동으로 외부에 올라가지 않습니다. Markdown을 복사하거나 파일로 내려받아 본인이 선택한 안전한 위치에 저장합니다.

LOCAL MARKDOWN PROJECTION

선택 레인 · 진행률 · 모든 입력을 한 파일로 만듭니다.

빈 항목도 질문 구조로 남기므로 이후에 이어 쓸 수 있습니다. 서버로 전송하지 않습니다.

CLEAR LOCAL DATA

이 페이지가 저장한 레인·진행·워크시트 값만 지웁니다. 다른 사이트 데이터는 건드리지 않습니다.