실패를 삼키는 구조
코드 읽기 공부와 현장의 뺑뺑이
2026년 11월 5일 하루 동안 있었던 세 가지 일을 그날의 작업 기록과 대화 기록에서 꺼내 겹쳐 보았습니다. 짧은 점검 스크립트 하나를 같이 읽은 공부, 한 현장 담당자와 AI가 PC 계정 이름을 주고받으며 여러 번 오간 일, 우리가 AI 작업자에게 맡긴 일이 조용히 멈춘 일입니다. 조직과 사람의 이름, 기계 주소와 계정 이름은 싣지 않았습니다.
요지
일이 같은 자리를 맴돌 때, 원인은 대개 사람이 아니라 시스템이 아는 것을 말하지 않는 데 있습니다. 서로 다른 실패가 한 문장으로 뭉쳐 나오면 사람도 AI도 짐작으로 움직입니다. 이 병은 코드에만 있지 않고, 사람과 AI가 일을 넘겨주는 이음매마다 있습니다. 고치는 방법은 경우의 수를 더 상상하는 것이 아닙니다. 삼키던 실패를 갈래별로 말하게 하는 것입니다.
1. 코드: 열네 줄짜리 완료 판정기
현장에 새 서버나 PC를 세우면 우리는 「사설망에 떠서 우리가 실제로 들어갔다」만 완료로 칩니다. 이 규칙을 코드로 옮긴 판정기는 이렇게 일했습니다.
- 사설망 관리 서비스에 기기 명단을 묻는다.
- 명단에서 그 이름의 리눅스 기계를 찾는다. 없으면 「사설망에 없다」고 말한다.
- 그 기계에 접속해 이름을 묻는다. 안 되면 「접속이 안 된다」고 말한다.
같이 읽으면서 질문 두 개를 던졌습니다.
첫 질문: 명단을 묻는 열쇠의 기한이 지나면 무슨 말이 뜰까? 기한 지난 열쇠를 흉내 내 돌려 본 기록을 보면, 서비스는 명단 대신 「열쇠가 틀렸다」는 쪽지를 돌려줬습니다. 명단을 읽는 쪽은 쪽지에서 명단 칸을 찾지 못하고 조용히 쓰러졌습니다. 화면에는 「그 기계가 사설망에 없다」가 떴습니다. 문제는 열쇠인데 기계 탓을 한 것입니다. 이 말을 믿으면 멀쩡한 기계를 다시 설치하러 갑니다.
원인은 세 군데였습니다. 요청을 「조용히」 보내는 옵션이 거절 메시지를 삼켰고, 받기와 읽기를 한 줄로 이은 연결이 앞 단계의 실패를 삼켰습니다. 고친 방법은 받는 줄과 읽는 줄을 둘로 나누고, 그 사이에 「받기가 실패했나」를 묻는 조건문 하나를 넣은 것입니다.
둘째 질문: 윈도 PC 이름을 넣으면 무슨 말이 뜰까? 「리눅스인 것」만 찾는 조건 때문에, 사설망에 멀쩡히 붙은 윈도 PC도 「사설망에 없다」로 나왔습니다. 이 구멍은 열흘 전에 한 번 걸려서 기록까지 남겼는데, 「나중에 고칠 일」로 남겨진 채 비어 있었습니다.
고친 뒤 판정기는 끝 번호를 셋으로 나눕니다.
| 끝 번호 | 뜻 | 다음 할 일 |
|---|---|---|
| 0 | 완료 | 없음 |
| 1 | 기계가 아직 안 됨 | 현장 기계를 본다 |
| 2 | 판정 자체를 못 함: 열쇠 거절, 다른 종류의 기계 | 우리 쪽 열쇠와 절차를 본다 |
정상 기계, 없는 이름, 윈도 PC, 기한 지난 열쇠 네 경우를 모두 직접 돌려 확인했습니다.
2. 현장: 계정 이름 하나에 다섯 번 오가다
같은 날, 한 조합의 담당자가 사무실 PC 두 대에 연결 꾸러미를 돌렸습니다. 두 PC 모두 사설망에 잘 붙었습니다. 그런데 우리가 접속하려면 각 PC의 윈도 계정 이름이 필요했습니다.
설치 꾸러미는 그 계정 이름을 이미 알고 있었습니다. 다만 화면에만 찍고 「이 결과를 방에 보내 주세요」라고 사람에게 옮기게 했습니다. 그다음은 이렇게 흘렀습니다.
- AI가 「설치 창 맨 아래 LOGIN USER 줄을 주세요」라고 청했습니다.
- 담당자가 이름을 줬는데, 그건 컴퓨터 이름이어서 접속이 「거부」됐습니다.
- 다시 청하자 맞는 이름이 왔고, 한 대가 끝났습니다.
- 다른 PC도 컴퓨터 이름이 먼저 와서 또 「거부」됐습니다.
- AI가 「그건 컴퓨터 이름입니다. 로그인할 때 쓰는 이름이 필요합니다」라고 갈라서 말하자, 담당자가 다음 답에서 스스로 맞는 이름을 찾았습니다.
담당자가 틀린 것은 하나도 없습니다. 「LOGIN USER」, 「HOSTNAME」, 「사람 모양 아이콘」이 한꺼번에 섞인 부탁을 받으면 누구라도 헷갈립니다. 게다가 계정 이름이 틀려도, 열쇠가 안 깔려도, 접속은 똑같이 「거부」라고만 말합니다. 그래서 AI도 「아마 컴퓨터 이름일 것」이라고 짐작으로 답할 수밖에 없었습니다. 판정기의 「사설망에 없다」와 같은 병입니다.
방 대화 기록을 다시 읽어 보면 고칠 자리는 릴레이 자체였습니다. 그래서 꾸러미가 끝날 때 컴퓨터 이름, 계정 이름, 접속 상태를 우리 쪽 「받기만 하는 창구」로 직접 보내게 고치기로 했습니다. 꾸러미에는 밖으로 뻗는 열쇠를 넣지 않고, 회신이 실패해도 설치는 깨지지 않게 합니다. 이 글을 쓰는 시점에는 아직 고치는 중입니다.
3. 우리: 「맡겼다」가 완료처럼 보였다
그 꾸러미 수정을 AI 작업자에게 맡겼습니다. 그런데 두 번 연속 백업 파일 하나만 남기고 멈췄습니다.
실행 중인 프로세스 목록으로 확인해 보니, 우리가 쓰던 화면은 메시지 하나마다 AI를 일회용으로 새로 띄우고, 답이 끝나면 내리는 방식이었습니다. 그 아래에서 뒤로 돌려 둔 작업자는 답이 끝나는 순간 같이 내려갔습니다. 알림은 다음 메시지 때에야 왔습니다.
그동안 보고에는 「작업자에게 맡겼습니다, 진행 중입니다」라고 나갔습니다. 실제로 바뀐 줄은 0줄이었습니다. 코드에서 고친 병을 같은 날 우리 일하는 방식이 앓고 있었던 셈입니다.
4. 세 층에 같은 모양이 있다
| 층 | 실패를 삼킨 자리 | 겉으로 보인 말 |
|---|---|---|
| 코드 | 조용히 옵션과 한 줄 연결, 「리눅스만」 조건 | 「사설망에 없다」 |
| 현장 | 꾸러미가 계정 이름을 화면에만 찍음 | 「거부」 → 사람에게 다시 묻기 |
| 일하는 방식 | 작업자가 조용히 멈춤 | 「맡겼습니다」 |
세 번째가 가장 알아채기 어렵습니다. 맡겼다는 사실 자체가 일이 끝난 것처럼 보이게 하기 때문입니다.
5. AX 교육에 주는 것
코드를 짜는 법보다 읽는 질문 하나가 먼저입니다. 이날 공부한 사람은 코드를 한 줄도 쓰지 않았습니다. 대신 「이 말이 뜨는 길은 몇 갈래인가?」라는 질문 하나로 판정기의 구멍 두 개를 짚었습니다. 그리고 같은 질문을 현장으로 옮겨 「담당자가 맴도는 것도 이 문제」라고 알아봤습니다. 코드를 읽는 근육과 현장의 막힘을 읽는 근육은 같은 근육이었습니다.
교재는 자기 조직의 도구로 합니다. 교과서 예제였다면 이해하는 데서 끝났을 것입니다. 실제로 쓰는 스크립트를 교재로 삼으니, 공부하는 동안 실제 버그 두 개가 고쳐졌습니다. 열흘 묵은 기록 하나가 닫혔고, 현장 문제의 뿌리까지 닿았습니다. 조직의 AX 챔피언에게도 코딩 강좌보다 자기 조직 AI 도구가 내는 실패 문구를 같이 읽고 「이 말이 뜨면 진짜 원인은 몇 가지일까」를 묻는 시간을 권합니다.
사람에게 묻는 문장도 인터페이스입니다. 기계 말(「LOGIN USER」)로 물으면 사람은 비슷한 기계 말(컴퓨터 이름)로 답합니다. 무엇이 틀렸는지 갈라서 말해 주면, 기계만이 아니라 사람도 스스로 풀어 갑니다.
다만 경우의 수를 다 상상하라는 뜻은 아닙니다. 일어나지 않을 경우까지 막으려 하면 코드가 불어나고, 불어난 코드에 또 구멍이 생깁니다. 이날 고친 것들은 상상을 더 해서 고친 것이 아니라 삼키던 것을 멈추게 해서 고친 것입니다. 원칙은 두 줄이면 됩니다.
- 실패를 삼키지 말고, 갈래별로 다른 말을 하게 한다.
- 성공만 시험하지 말고, 실패도 일부러 한 번씩 내 본다.
다음에 할 일
- 꾸러미가 결과를 직접 보내도록 고치기: 진행 중
- 사설망 문제를 위에서부터 한 칸씩 내려가며 짚는 진단 순서를 도구로 만들지 정하기. 순서는 열쇠, 명단, 승인, 기한, 접속, 차단 설정, 기계 종류, 경로, 로그인입니다