본문으로 건너뛰기

인박스 자동화에서 시작한 AKM을 모든 작업 요청에 적용하도록 ‘한 바퀴 도는 하네스’로 개조했다

MOSL

2026.08.08

한 줄 요약

인박스 분류에만 적용하던 my-akm 하네스를 모든 AKM 작업 요청에 적용하도록 확장했다. 요청을 분류하고, 목표와 근거를 정한 뒤 실행 지시를 만들고, 작업 결과를 별도 Verifier가 확인하도록 구성했다. 그 결과 작업의 완료·수리·질문·차단 상태가 각각 파일과 실행 기록으로 남게 되었다.

이런 분들께 도움돼요

  • 한 가지 업무용 자동화 방식을 문서 수정, 자료 정리 등 다른 업무에도 확장하고 싶은 분

  • AI가 작업을 시작하기 전에 목표, 참고 자료, 금지 사항과 완료 조건을 먼저 확인하게 만들고 싶은 분

  • 요청이 모호하면 질문하며, 권한을 벗어난 작업은 차단하는 흐름이 필요한 분

  • AI의 “작업 완료” 답변에 의존하지 않고, 별도의 Verifier로 결과와 근거를 확인하고 싶은 분

1. 무슨 업무인가

앞선 두 번의 작업에서 my-akm에 작은 하네스를 붙였다.

첫 번째 작업에서는 인박스 처리 순서를 계약으로 정하고 실제 자료 PDF 1건을 분류한 뒤 실행 영수증을 남겼다. 두 번째 작업에서는 테스트 문서를 일부러 불완전하게 만들어, lint가 경고만 하는 것이 아니라 완료 Gate에서 실제로 작업을 멈추도록 바꿨다.

여기까지는 인박스 자료 한 건을 안전하게 처리하는 흐름이었다. 하지만 지아코모 WEEK3 강의안 31쪽을 다시 보니 더 큰 구조가 보였다.

0. 입구 판단
1. Intent
2. Context
3. Prompt
4. Harness
5. Verifier

판정 뒤
→ 완료
→ 수리: Harness로 복귀
→ 질문: Intent로 복귀
→ 차단·중단

당시 my-akm에는 계약, 실행 패킷, lint와 영수증이 있었지만 이 여섯 단계가 한 흐름으로 이어지지는 않았다. 특히 다음 부분은 에이전트가 대화 중에 알아서 연결하고 있었다.

  • 요청이 단순한 질문인지 정식 실행인지 판단하는 일

  • 이번 작업에 필요한 Context만 고르는 일

  • 선택한 Context를 실행용 Prompt로 바꾸는 일

  • 어떤 Skill이나 procedure가 실행을 맡을지 정하는 일

  • 실행 결과를 독립된 기준으로 확인하는 일

  • 실패했을 때 처음부터 다시 하지 않고 깨진 단계로 돌아가는 일

그래서 이번에는 다음과 같은 처리 흐름을 만드는 것을 목표로 했다.

사용자가 my-akm 작업을 요청하면, 시스템이 요청이 단순한 확인인지 실제 변경 작업인지 판단하고, 필요한 Context와 실행 조건을 정한 뒤 적절한 실행 주체에 넘긴다. 마지막에는 별도의 Verifier가 완료 여부를 확인하고, 문제가 있으면 원인에 따라 수리·질문·차단 경로로 돌려보낸다.

2. 설계 계약

먼저 자동화 범위를 하나씩 결정했다.

첫 번째 결정은 사용자가 요청할 때만 작동한다는 것이었다. 인박스에 파일이 들어왔다고 자동으로 실행하지 않는다. 사람이 일을 시작할 권한은 유지하되, 요청 이후의 흐름을 구조화하기로 했다.

두 번째 결정은 입구 판단을 인박스 분류에만 한정하지 않는 것이었다. 검색, 문서 수정, Skill 실행, lint처럼 사용자가 요청하는 모든 my-akm 작업 요청을 다음 다섯 경로 중 하나로 판단한다.

입구 경로

의미

다음 행동

LIGHT

검색·위치 확인·설명처럼 상태를 바꾸지 않는 요청

바로 답하고 종료

FULL

파일 변경, Skill 실행, lint처럼 상태를 바꾸는 요청

정식 실행 흐름으로 이동

ASK

목표나 범위가 불명확함

질문한 뒤 Intent부터 다시 판단

HOLD

목표는 명확하지만 자료나 근거가 부족함

조건이 채워질 때까지 보류

BLOCK

권한·안전·계약 경계를 위반함

실행하지 않고 중단

세 번째 결정은 FULL을 compact와 expanded로 나눈 것이었다.

  • compact: 파일 1~2개를 고치는 짧고 위험이 낮은 작업

  • expanded: 여러 파일, Skill, 외부 행동, 승인 또는 Proof가 중요한 작업

간단한 수정까지 매번 큰 실행 패킷과 영수증을 만들면 하네스가 오히려 일을 방해한다. 반대로 논술 채점이나 인박스 일괄 처리처럼 결과와 근거가 중요한 작업은 실행 조건을 파일로 고정할 필요가 있었다.

이 결정들을 AKM 하네스 운영 계약에 반영하고 버전을 1.5까지 올렸다.

3. 어디서 막혔나

어떤 작업이 들어올지 미리 알 수 없었다

인박스 처리와 논술 채점에는 전용 규칙을 만들 수 있었다. 하지만 앞으로 들어올 모든 작업을 미리 등록하는 것은 불가능했다.

그래서 미등록 작업을 막는 대신 generic-full이라는 범용 경로를 만들었다. 공통 완료 조건과 검증 명령으로 먼저 실행하고, 같은 유형이 반복되고 전용 Gate가 필요해질 때만 새 어댑터로 승격하도록 했다.

알려진 작업
→ inbox-processing 또는 essay-grading 어댑터

처음 보는 작업
→ generic-full
→ 반복성과 전용 완료 조건이 확인되면 어댑터 승격

참고 파일을 나열하는 것만으로는 부족했다

기존 실행 패킷의 selected_context에는 작업에 참고할 파일 경로가 들어 있었다. 하지만 파일 목록만으로는 각 자료를 왜 선택했는지, 이번 작업에서 어떤 역할을 하는지 알기 어려웠다. 공식 기준인지 이전 작업에서 만든 자료인지, 지금도 유효한지, 외부 실행 주체에게 전달해도 되는지도 판단하기 어려웠다.

그래서 선택한 파일의 성격과 사용 조건을 설명하는 별도의 Context manifest(참고 자료 정보표)를 추가했다. 실제 참고 파일을 새로 만드는 것이 아니라, 선택한 파일마다 다음 정보를 기록하는 방식이다.

  • role: 계약, 절차, 근거, 원문, Skill 중 어떤 역할을 하는가

  • authority: 공식 자료, 내부 계약, 사용자 제공 자료, 파생 자료 중 무엇인가

  • freshness: 현재도 유효한 자료인지, 추가 확인이 필요한지

  • sensitivity: 공개하거나 외부에 전달해도 되는 자료인지

  • required: 이 자료가 없으면 작업을 진행할 수 없는지

  • reason: 이번 작업에 이 자료를 선택한 이유가 무엇인지

이 정보는 실행 전에 Context가 적절한지 판단하는 기준으로 사용한다. 선택 이유나 자료 정보가 불분명하면 ASK로 보내 확인하고, 반드시 필요한 자료가 없으면 HOLD로 보류한다. 비공개 자료를 외부 실행 주체에게 전달하려는 경우에는 BLOCK으로 작업을 중단한다.

이제는 참고 파일이 목록에 있다는 이유만으로 바로 작업에 사용하지 않는다. 왜 필요한 자료인지, 믿을 수 있는 위치의 자료인지, 현재 사용해도 되는지, 전달해도 안전한지를 확인한 뒤에만 실행용 Prompt를 만든다.

4. 무엇을 바꿨나

my-akm에 아래와 같이 한 바퀴 도는 하네스 흐름을 적용하였다.
입구 판단 → Intent → Context → Prompt → Harness → Verifier

단계

my-akm 구현

입구 판단

LIGHT / FULL / ASK / HOLD / BLOCK 라우팅 절차

Intent

목표·입력·금지 행동·완료 조건을 가진 execution packet

Context

역할·권위·신선도·민감도를 가진 context manifest

Prompt

실행 주체와 출력 계약을 가진 prompt packet

Harness

실행 레지스트리, handoff, 상태 제어기

Verifier

별도 프로세스의 구조화된 Verdict와 strict lint

전체 흐름은 다음과 같이 바뀌었다.

사용자 요청
  → 입구 판단
      ├─ LIGHT: 바로 답변
      ├─ ASK: 질문 후 Intent로 복귀
      ├─ HOLD: 근거·자료 대기
      ├─ BLOCK: 중단
      └─ FULL
           → Intent 실행 패킷
           → Context manifest와 Gate
           → Prompt packet
           → 실행 주체 handoff
           → 실행과 상태 기록
           → 독립 Verifier
                ├─ PASS: 완료
                └─ REPAIR: Harness 단계로 복귀

작업 실행 주체는 실행 레지스트리에 등록했다.

  • inbox-processing: 자료 수집 procedure

  • essay-grading: jin-essay-evaluator Skill

  • generic-full: 처음 보는 범용 작업

하네스 제어기는 작업이 준비, 실행, 수정, 검증, 완료 중 어느 단계에 있는지 기록한다. 자료가 부족하거나 안전 기준에 맞지 않으면 질문·보류·차단 상태도 남긴다. Prompt compiler는 참고 자료가 Context Gate를 통과했을 때만 실제 작업에 사용할 지시문을 만든다.

5. 실행 영수증

실제 테스트 작업을 처음부터 끝까지 실행해 전체 과정이 제대로 이어지는지 확인하고, 각 단계의 실행 결과를 실행 영수증에 기록했다.

Trace

실제 상태 변화는 다음과 같았다.

ready
→ prepared
→ dispatched
→ running
→ repair
→ running
→ verified
→ complete

첫 검증에서 실패했고, 가장 작은 부분을 고친 뒤 같은 실행으로 복귀했다. 실패를 지우고 새 실행을 성공시킨 것이 아니라 한 run 안에 실패와 수리 이력이 함께 남았다.

Proof

실행 영수증에서 다음 파일을 한 번에 추적할 수 있다.

  • execution packet

  • context manifest와 Context Verdict

  • prompt packet

  • execution handoff와 수락 상태

  • independent Verdict

  • 검증 명령 출력

  • strict lint 출력

  • 인벤토리 갱신 결과

Verdict

Context부터 Prompt, handoff, 산출물, 독립 검증과 최종 인벤토리까지 통과해 최종 PASS가 됐다. Context Gate의 PASS / ASK / HOLD / BLOCK 경로도 별도 테스트로 확인했다.

Repair

첫 Verifier가 지적한 것은 Prompt packet의 lint 필수 섹션 누락이었다. template과 compiler만 최소 수정한 뒤 같은 Verifier로 재검사했다. 수리 후 결과는 오류 0건, 경고 0건이었다.

6. 무엇이 달라졌나

이전 하네스는 인박스 정리만 정해진 절차로 처리했다. 문서 수정, 논술 채점, lint 같은 다른 요청은 Codex가 그때마다 필요한 파일과 절차를 찾아 실행했다. 따라서 작업마다 목표를 어디에 기록하는지, 어떤 자료를 근거로 사용했는지, 무엇을 확인해야 완료인지가 달라질 수 있었다.

이제는 사용자가 my-akm 관련 작업을 요청하면 작업 유형이 등록돼 있으면 해당 Skill이나 procedure를 사용하고, 처음 처리하는 작업은 공통 절차로 실행한다. 작업이 끝나면 Verifier가 결과물과 Proof를 확인해 완료 또는 수리를 판정한다.

이전
인박스 요청
→ 계약된 절차
→ lint
→ 실행 영수증

이후
모든 my-akm 요청
→ 입구 판단
→ Intent·Context·Prompt 고정
→ 범용 또는 전용 실행 주체
→ 독립 Verifier
→ 완료·수리·질문·차단

가장 큰 변화는 작업마다 달라지던 처리 방식에 공통 시작점과 완료 기준이 생긴 것이다. 이제 어떤 요청이 들어와도 왜 이 작업을 하는지, 무엇을 근거로 사용했는지, 어떤 절차가 실행됐는지, 무엇을 확인하고 완료했는지를 실행 기록에서 확인할 수 있다.

도움받은 글

4

함께 이야기해요 4

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

Giacomo 프로필 이미지
Giacomo2026.08.11

인박스에 파일이 들어왔다고 곧바로 돌리지 않고, 사람이 요청한 뒤에만 `my-akm`의 공통 흐름이 시작되게 한 선택이 먼저 눈에 들어왔어요. 요청은 `LIGHT`·`FULL`·`ASK`·`HOLD`·`BLOCK`으로 가르고, `FULL`도 짧고 위험이 낮은 작업과 여러 파일·승인·근거가 중요한 작업으로 나눴습니다. 자동화 범위를 넓히면서도 간단한 확인까지 무거운 절차에 가두지 않았습니다.

참고 자료를 경로 목록으로만 넘기지 않고 `role`·`authority`·`freshness`·`sensitivity`·`required`·`reason`을 붙인 변화도 좋습니다. 자료의 역할과 권위, 최신성, 민감도, 필수성, 선택 이유를 실행 전에 읽게 하니 자료가 없을 때는 `HOLD`, 뜻이 모호할 때는 `ASK`, 외부 전달 경계를 넘을 때는 `BLOCK`으로 갈 근거가 생겼어요. 처음 보는 작업은 `generic-full`로 받고, 반복성과 전용 완료 조건이 확인된 뒤에만 별도 실행 주체로 올리는 방식도 과한 설계를 피합니다.

완료 확인을 별도 `Verifier`에 맡긴 구성에는 독립성을 한 번 더 구체화할 여지가 있습니다. 판정 주체가 달라도 실행기의 자기평가나 수리 제안, 실행 중 바뀐 기준을 그대로 함께 받으면 같은 사각지대를 공유할 수 있어요. 검증기에는 후보 결과물·원자료·사전에 정한 완료 기준만 읽기 전용으로 주고, 수리 전후에 기준이 같았는지를 남기면 ‘별도’가 실제 입력과 권한의 차이로 설명됩니다.

이번 실행은 이미 첫 확인을 해냈습니다. `Prompt packet`의 lint 필수 섹션 누락으로 첫 검증이 실패하자 `template`과 `compiler`만 최소 수정했고, 같은 `Verifier`로 돌아가 오류와 경고 0건을 확인했어요. 다음 확인은 결함 하나를 의도적으로 심은 `generic-full` 작업에서 검증기가 깨진 기준과 근거 위치를 짚고, 같은 기준으로 수리 전후를 판정하는 정도면 충분합니다. 분야별 성공 조건을 확인할 자료가 없다면 구조 검사가 통과해도 `ASK`나 `HOLD`로 남는지도 함께 볼 수 있고요.

첫 실패를 지우지 않고 `ready → prepared → dispatched → running → repair → running → verified → complete`를 한 실행 안에 남긴 선택이 큰 구조를 현실적인 운영 기록으로 붙잡아 줍니다. 사람은 시작할 권한을 지키고, 시스템은 요청 뒤의 근거와 수리 이력을 책임지게 한 균형이 또렷합니다.

자연어회계처리 프로필 이미지

유기적으로 순환할 수 있는 튼튼한 하네스가 완성된 것 같습니다. 제 자동화 파이프라인에도 꼭 참고해서 녹여내 보고 싶을 만큼 알찬 공유였습니다. 👍 akm보드 평가 한번 받아보시는것도 ㅎㅎ 피드백을 워낙잘해주셔서

꾸
꾸기작2026.08.08

저는 자동화를 붙일 때 사람 손을 최대한 빼는 쪽으로만 생각했거든요. 그래서 잠깐 멈췄습니다. 인박스에 파일이 들어와도 알아서 실행하지 않는다고요.

요청 이후의 흐름은 전부 구조로 묶으면서, 일을 시작할 권한만은 사람에게 남겨두셨더군요. 자동화의 경계를 시작 지점에 그으신 셈이네요. 선이 또렷하네요. 다섯 갈래로 나눠 보내는 것보다 이 한 줄이 먼저 눈에 들어왔어요.

첫 검증이 실패한 다음이 더 볼만했습니다. 실패를 지우고 새 실행을 성공시키는 대신, 한 run 안에 실패와 수리 이력을 같이 남기셨더군요. 저는 성공만 남깁니다. 나중에 아무 도움이 안 되더라고요.

다음엔 어떤 작업 유형이 어댑터로 승격될지 궁금해집니다. 3차까지 이어지는 기록이라 따라 읽는 맛이 있네요. 다음 편 기다리겠습니다.

뽀짝이 프로필 이미지
뽀짝이2026.08.08

LIGHT / FULL / ASK / HOLD / BLOCK 다섯 경로로 요청을 먼저 분류하고, FULL도 compact와 expanded로 나눈 설계가 실용적이에요. "간단한 수정까지 매번 큰 실행 패킷을 만들면 하네스가 오히려 일을 방해한다"는 판단이 딱 맞았다고 생각해요.

Context manifest에 role·authority·freshness·sensitivity·required·reason 여섯 가지 메타데이터를 붙인 부분도 눈에 띄었습니다. 파일 목록만 넘기던 방식에서, 왜 이 자료를 골랐는지·지금도 유효한지·외부에 넘겨도 되는지를 명시하게 된 것이라 실행 전 Gate가 진짜로 판단할 근거가 생긴 셈이고요.

실행 영수증에 "첫 검증 실패 → 최소 수리 → 재검사" 이력이 한 run 안에 남는 것도 좋았습니다. 실패를 지우고 성공만 남기지 않은 원칙 덕분에 나중에 뭘 고쳤는지 그대로 추적할 수 있을 테니까요. 꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

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

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

이런 사례도 있어요

사례 전체 보기