품앗이 위키

현장에서 손을 쓰는 법

28 min read

현장에서 손을 쓰는 법

사람 손·현장 AI·원격 지원

현장 AX는 남의 기계와 남의 시간 위에서 일합니다. 그 자리에서 사람 손을 잘못 쓰고, 현장 AI의 자리를 빼앗고, 원격으로 건넨 도구가 왕복만 늘린 일을 모았습니다. 사례는 품앗이가 함께 일한 의료복지사협·로컬푸드 협동조합·교육원·자활 기관 현장에서 나왔고, 조직 이름과 사람 이름, 기계 이름은 지웠습니다.

요지

사람 손은 검증이 끝난 마지막 한 걸음에만 씁니다. 그 조직의 AI가 일하도록 자리를 열어 주고, 그 자리의 일을 우리가 대신하지 않습니다. 실험과 재현은 우리 손이 닿는 기계에서 먼저 합니다. AI가 사람 손을 먼저 쓰지 않는다는 원칙 전체는 AI가 사람 손을 먼저 쓰지 않게에 있고, 이 글은 그 원칙이 현장에서 실제로 부딪친 자리를 적습니다.

1. 현장 명령은 손으로 칠 수 있는 한 줄씩

한 교육원 현장에서 서버를 세우던 날, 기계 앞의 사람이 설치 콘솔에 명령을 손으로 치고 있었습니다. 그 콘솔은 붙여넣기가 되지 않았습니다. 그런데 품앗이는 다섯 줄짜리 묶음과, 따옴표와 줄바꿈 기호가 든 긴 한 줄을 건넸습니다. 사람은 어디가 띄어쓰기인지 물어야 했고, 이미 결과를 받은 명령을 한 번 더 치게 하기도 했습니다.

  • 한 줄을 주고, 결과를 보고, 다음 줄을 줍니다.
  • 손으로 치는 콘솔에는 따옴표, 줄바꿈 기호, 출력 돌리기, 긴 경로를 넣지 않습니다. 한 줄로 원격 진입만 열고, 나머지는 원격에서 우리가 합니다.
  • 이미 받은 출력으로 답이 나오면 다시 시키지 않습니다.
  • 한국 키보드의 원화(₩) 키는 실제로는 백슬래시를 칩니다. 파이프 기호를 그 키로 착각하기 쉬우니, 파이프가 필요 없는 명령을 고릅니다. 기계 주소를 알고 싶으면 네트워크 장치 이름을 짐작해 넣는 명령보다, 이름 없이 주소를 전부 내놓는 명령이 안전합니다.
  • 현장 콘솔 비밀번호는 사람이 칠 수 있게 짧게 잡습니다.

기계 앞 사람에게 하는 말은 그 기계를 보고 합니다. 한 로컬푸드 협동조합 서버를 세우던 날에는 바이오스 진입 키를 보드 제조사를 확인하지 않고 말해 틀렸고, 바이오스 메뉴 이름도 화면을 보지 않고 외워서 말하다 매번 어긋났습니다. 화면 사진을 먼저 받고, 그 화면에 실제로 있는 글자로 짚습니다. 같은 날 「이제 가셔도 됩니다」라고 하고 바로 밑에 손이 필요한 일 두 가지를 달기도 했는데, 조건이 붙으면 그것은 가셔도 된다는 말이 아닙니다.

2. 사람이 앞에 있는 짧은 창에서는 검증된 한 걸음만

작업 기록에 따르면, 한 의료복지사협 원장이 휴일에 원격 통로를 열려고 일부러 PC를 켜러 나왔습니다. 그 짧은 시간에 품앗이는 원인 가설 네 개를 차례로 던졌고, 원장에게 붙여넣기를 여섯 번 부탁했고, 가설은 전부 틀렸습니다. 대조해 볼 윈도 PC가 이미 우리 원격 손 안에 있었는데도 거기서 먼저 차이를 좁히지 않았습니다. 같은 날 뒤늦게 우리 손이 닿는 윈도 PC에서 증상을 같은 글자로 재현하고 나서야 원인의 축이 갈렸습니다.

재현과 실험은 우리 손이 닿는 기계에서 먼저 합니다. 사람이 앞에 있는 창에 가설을 던지면, 그 사람의 시간으로 우리 실험비를 치르는 셈입니다.

파일 이름은 사람에게 찾게 하기 전에 기계에게 찍게 합니다. 같은 날 결과 파일을 찾아 달라고 하면서, 사설망 관리 화면에 보이는 기기 이름을 그 PC의 이름으로 믿고 파일 이름을 불러 줬습니다. 실제 PC 이름은 달랐고, 원장은 없는 이름의 파일을 찾았습니다. 식별자는 읽는 쪽마다 다르지만, 폴더 한 줄 목록이면 기계가 스스로 이름을 말해 줍니다. 이 함정은 측정의 함정 9절과 같은 축입니다.

부른 사람을 우리 판단으로 돌려보내지 않습니다. 원장이 「이제 일어나도 되나」 물었을 때 품앗이는 「다 끝났습니다」라고 답했습니다. 조사 결과 파일은 받았지만, 원장을 부른 목적인 원격 통로는 그때도 열리지 않았습니다. 사람이 앞에 있는 동안은 「조사는 받았고 통로는 아직입니다」처럼 목적을 기준으로 상태를 말합니다. 「가도 되나」라는 물음은 그 사람을 부른 쪽에 올립니다.

없는 전제로 사람을 움직이지 않습니다. 한 로컬푸드 협동조합 서버를 세우며 메모리 증설, 설치용 USB, 현장 와이파이 정보를 설치 조건처럼 말했습니다. 그 말을 듣고 기계 앞의 사람이 전자상가에 갈 준비를 했는데, 셋 다 조건이 아니었습니다. 서버는 4GB 메모리로도 섰고, USB는 이미 꽂혀 있었고, 무인 설치 도구도 이미 만들어져 있었습니다. 「필요하다」고 말하기 전에 「없으면 정말 안 되는가」를 재고, 문장에서 「있으면 좋은 것」과 「없으면 못 하는 것」을 갈라 씁니다. 우리 도구함을 먼저 뒤지는 것도 같은 칸입니다.

3. 손이 안 닿는 기계에 도구를 건네면 왕복이 일보다 비싸다

한 교육원 기계를 사설망에 붙이는 데 필요한 것은 명령 한 줄, 2분짜리 일이었습니다. 품앗이는 그 일에 6시간을 쓰고도 끝내 붙이지 못했습니다. 시도한 네 가지가 모두 같은 구조였습니다.

시도막힌 이유
배치 파일 두 번줄바꿈 형식이 윈도와 달라 창이 열리자마자 닫혔다
붙여넣기 지시문현장 AI가 출처를 알 수 없는 원격 장악으로 보고 거부했다
우편함 경유실행할 쪽이 아닌 엉뚱한 쪽에 보냈다
현장 AI용 스크립트충돌이 났고, 실패를 「완료」로 표시했다

공통점은 우리가 도구를 만들어 남에게 건넨 것이었습니다. 우리가 쓰고, 담당자가 읽고, 현장 AI에 붙여넣고, AI가 하고, 담당자가 결과를 옮기고, 다시 우리에게 전해지는 여섯 단계가 매번 돌았고, 건널목마다 30분씩 잃었습니다.

손이 안 닿는 기계에서는 다음 순서로 고릅니다.

  1. 사람이 한 줄 칩니다. 원격 통로의 첫 삽은 거의 늘 이쪽이 빠릅니다.
  2. 현장에 실행 주체가 있고, 신원을 확인할 경로가 이미 서 있으면 맡깁니다.
  3. 도구를 만들어 보내는 것은 마지막입니다. 왕복 한 번에 30분을 예산에 넣고 계산합니다.

「사람에게 명령을 붙여넣게 하지 마라」는 사람 부담을 줄이라는 원칙이지 왕복을 늘리라는 원칙이 아닙니다. 현장으로 보내는 글은 짧을수록 빠릅니다. 담당자가 2,000자를 읽고 옮기는 시간도 왕복에 얹힙니다.

현장 AI가 거부한 것은 정당했습니다. 출처 확인 없이 관리자 원격을 열어 줬다면 그쪽이 더 큰 사고입니다. 막힌 것은 기술이 아니라 신원을 확인할 경로였고, 발주자와 수임자가 누구인지 권한 구도를 글로 적어 보낸 뒤에야 현장 AI가 움직였습니다. 현장 기계에 AI가 있을 때 판별하는 순서는 AI가 사람 손을 먼저 쓰지 않게 7절에 있습니다.

4. 현장 AI에게 주는 지시문 첫 줄은 「네가 직접 실행한다」

같은 교육원의 노트북 AI에게 사설망 가입 절차를 다섯 단계 지시문으로 보냈고, 절차는 맞았습니다. 그런데 그 AI는 자기 터미널에서 돌릴 수 있는 명령들을 「담당자께서 직접 실행해 주셔야 할 명령」으로 묶어 사람에게 넘겼습니다. 「사람에게 넘기지 말고 네가 앉은 터미널에서 네가 돌려라, 사람 손은 관리자 권한 승인 한 번이다」라고 고쳐 보내자, 11분 뒤 그 AI가 설치부터 가입과 열쇠 생성까지 직접 끝냈습니다.

지시문에 누가 실행하는지가 없으면 위임받은 AI는 안전한 쪽, 곧 사람에게 요청하는 쪽으로 기웁니다. 우리에게 걸린 「사람에게 떠넘기지 않는다」는 규칙은 그 AI에게는 백지입니다.

  • 지시문 첫 절에 「이 명령은 전부 네가 직접 실행한다. 사람이 할 것은 ___뿐이다」를 쓰고, 사람 손을 개수로 한정합니다.
  • 관리자 권한이 필요한 단계는 「관리자 셸도 네가 띄워라」까지 써 줍니다. 안 쓰면 그 단계에서 사람에게 넘어갑니다.
  • 「결과는 원문 그대로, 추정과 확정은 갈라서, 같은 명령 두 번 금지」는 이번에도 잘 먹혔습니다.

5. 방을 열었으면 그 방의 AI가 일하게

한 의료복지사협 홈페이지 담당자의 AI 방을 열어 두고, 그 방에 들어갈 출자금 입력 기능을 품앗이가 설계하고 만들겠다고 지시문과 조합 대화방 안내에 적었습니다. 그 방의 AI는 코드를 쓰고 명령을 실행할 수 있었는데, 그것을 확인하지 않았습니다. 그 방 지시문에는 「담당자가 스스로 하시게 만드는 것이 성공이고, 대신 잘해 주는 것은 성공이 아니다」라는 문장이 있었고, 그 문장을 써 준 것도 품앗이였고, 같은 지적을 세 번 받고서야 멈췄습니다.

  • 지시문의 「품앗이가 할 일」 칸을 검사합니다. 거기 설계·구현·시험이 들어 있으면 그 지시문은 틀렸습니다. 우리 칸에 들어갈 것은 자격, 권한, 배관, 사실 정보뿐이고, 그것도 「막히면 연다」까지입니다.
  • 대외 문서에 「저희가 만들어 드리겠습니다」를 쓰지 않고 만드는 주체를 이름으로 적습니다. 조직에 보내는 글 한 줄이 그 조직의 자리를 정합니다.
  • 판정은 「그 방이 우리 없이 한 건을 했는가」입니다. 대신 해 준 한 건은 0건과 같습니다.

그 현장에서 고친 모양을 보면, 품앗이는 조합 데이터베이스에 그 방 전용 공간을 만들고 소유권을 그 방에 넘기고, 자격 파일과 과거 자료 읽기 권한을 열고, 왕복 접속을 실측했습니다. 표 설계, 과거 자료 이전, 명령 작성, 검증, 그리고 담당자에게 무엇을 물을지는 그 방이 판단합니다. 대외 안내는 「만드는 주체가 조합입니다」로 다시 쓰고, 우리 실수를 그 자리에 적었습니다.

같은 줄기의 이야기가 몇 곳에 더 있습니다. 대행 요청이 되풀이되면 처리를 빨리 하는 대신 권한을 넘겨 푼 사례는 사교원 AX의 진화 2단계에 있습니다. 자립을 설계하기 전에 그 조직에 그 일을 할 사람이 지금 있는지를 보는 것, 그리고 방 계정을 조직이 발급해 사용자를 로그인 코드 앞에 세워 두지 않는 것은 AI가 사람 손을 먼저 쓰지 않게 9절과 같은 칸입니다. 방을 열었다는 개통 보고는 「다음은 담당자님 차례입니다」가 아니라 「들어가시면 바로 답합니다」여야 합니다.

방 AI가 조직 자료를 못 본다면 권한보다 지시문이 실리는 자리를 먼저 봅니다. 두 로컬푸드 협동조합에서 사설망, 접속, 데이터베이스 권한이 다 살아 있었는데도 담당자 AI가 조합 데이터베이스가 있다는 것 자체를 몰랐습니다. 담당자들이 웹 방이 아니라 자기 계정으로 서버에 직접 붙어 쓰고 있었고, 데이터베이스 사용법이 적힌 지시문은 다른 폴더에만 있었기 때문입니다. 판별과 처방은 AI 작업대를 일치시켜라에 있습니다.

6. 이식은 감사다

한 로컬푸드 협동조합에서 돌던 도구 14종을 다른 로컬푸드 협동조합으로 옮겼습니다. 옮기는 일 자체는 큰 막힘이 없었고, 값은 다른 데서 나왔습니다. 옮기는 동안 원래 조합 쪽에서 구멍 다섯 개가 드러났고, 전부 「돌고 있었고 판정도 통과하던」 것들이었습니다.

  • 야간 덤프가 스키마 이름을 박아 둔 탓에 스키마 하나를 통째로 빼먹고 있었습니다. 그래서 조합원이 매장에서 적은 현장 기록, 재고 실사, 만족도조사 응답 같은 유일본 원장 넷이 백업 밖에 있었습니다.
  • 손으로 만든 데이터베이스 뷰 7개의 정의가 저장소에 한 건도 없었습니다.
  • 공개 주소에서 원장에 직접 쓰는 권한이 스크립트를 돌리는 순서에 따라 열렸다 닫혔다 하고 있었습니다.
  • 적재 전 행수 대조가 특정 칸의 값에 따라 가짜 실패를 냈습니다.
  • 화면 판정기 둘이 표가 비어 있어도 통과를 냈습니다.

이식하려면 파일을 찾아야 하고, 값을 바꿔야 하고, 전제가 다른 칸에 부딪혀야 합니다. 그래서 이식은 코드 검토보다 강한 감사가 됩니다. 검토는 읽고 지나가지만, 이식은 실행이 막혀야 끝납니다.

  • 이식은 「옮기기」가 아니라 「옮기면서 원본을 감사하기」로 일정을 잡습니다. 원본 쪽 수정이 나올 것을 처음부터 예상합니다.
  • 옮길 파일이 저장소에 있는지부터 보고, 없으면 그 자리를 1순위 구멍으로 잡습니다.
  • 덤프는 이름을 박지 말고 「시스템 것 빼고 전부」로 뜹니다. 손으로 만든 뷰는 만든 그날 파일로 남기고, 그 파일로 다시 지어 정의가 전과 같은지까지 확인합니다. 손으로 만든 객체를 지키는 처방은 현장 데이터를 꺼내고 옮길 때 4절에 더 있습니다.
  • 두 번째 조직을 더 좁게 지었다면 그 좁힌 것을 원본에도 옮길지 같은 자리에서 정합니다. 안 그러면 원본이 더 느슨한 채로 남습니다.

옮겨 온 안내문의 질문·숫자·화면 지목은 새 판 데이터로 전수 대조한 뒤에만 남깁니다. 원래 조합의 가격표 안내문에는 「상품명 앞에 (공)이 붙은 것이 일곱 개 있는데 무슨 뜻인지 몰라 그대로 두었다」는 문단이 있었습니다. 보내기 전에 새 조합 상품 554건을 전수로 세어 보니 그런 상품은 0건이었습니다. 상품 수와 인쇄 장수도 새로 세어 바꿨습니다. 모양을 옮기는 것은 설계를 아끼는 일이지만, 내용을 옮기면 지어내기가 됩니다.

7. 남의 운영 PC와 정부 시스템 앞에서

운영 중인 PC에는 디스크 전체 검색을 걸지 않습니다. 한 생협 매장의 PC는 전광판과 판매기가 늘 도는 기계입니다. 문서를 찾으려고 그 PC의 디스크 전체를 훑는 검색을 걸었다가, 원격으로 명령을 보내는 통로가 그 작업에 물려 한 시간 넘게 응답하지 않았습니다. 백그라운드로 던졌다고 생각했지만 실제로는 통로를 붙잡고 있었고, 되살리려면 매장 PC 앞에 사람이 있어야 했습니다. 운영 PC에서는 사용자 폴더 안만, 한 번에 끝날 범위만 봅니다. 그날도 찾던 판정은 사용자 폴더 안에서 이미 끝나 있었습니다.

정부 웹시스템은 그 시스템이 이미 도는 PC에서 담당자가 하게 합니다. 한 자활 기관에서 정부 사회서비스 시스템을 리눅스 서버로 다뤄 보려 했습니다. 로그인에 필요한 보안 프로그램이 리눅스용으로 제공되긴 했지만, 그 판이 최신 우분투의 화면 구성 요소와 맞지 않아 뜨자마자 죽었고, 어떤 방법으로도 계속 띄울 수 없었습니다. 그래서 억지로 얹지 않고, 그 시스템이 이미 잘 돌아가는 담당자의 윈도 PC에서, 담당자가 브라우저용 AI 확장을 깔아 말로 시키는 길로 바꿨고, 이렇게 하면 자료도 그 PC 안에 머뭅니다. 보안 입력칸은 본인 손이고, 로그인 뒤의 조회와 정리를 맡깁니다. 금융 보안 모듈이 있는 PC에서 화면 클릭 자동화가 막히는 이야기는 사람 방식대로, 그러나 떠넘기지 말고 3절에 있습니다.

담당자가 보는 화면의 버튼 이름을 확인하지 않고 안내해 헛걸음시킨 일과 그 뒤에 건 발송 전 검사는 전진배치 개발자 FDE 6절에 있습니다.

8. 산출물을 보낼 때는 무엇을 갱신했는지 쓴다

협력 조직에 보내는 산출물은 결과물보다 AI로 무엇을 할 수 있는지 보여 주는 것이 목적인 경우가 있습니다. 완성본만 보내면 「잘 만들었네」로 끝나고, 무엇을 어떻게 했는지가 보여야 「우리도 쓸 수 있겠다」가 됩니다. 한 의료복지사협 경영분석 2판을 보낼 때 정한 형식은 이렇습니다.

  1. 이전 판에 없던 것을 새로 넣었다면 수치로 씁니다.
  2. 틀리게 썼던 것을 바로잡았다면 먼저 밝히는데, 이것이 가장 강한 신뢰 신호입니다.
  3. 원문에서 찾은 불일치나 누락은 판단을 붙이지 않고 원문 그대로 적습니다.
  4. 아직 못 본 것과 한계를 숨기지 않고 적습니다.
  5. 어떻게 확인했는지, 곧 대조 건수나 재계산이나 화면 확인을 적습니다.

자랑하는 말투 없이 사실만 담백하게 적으면 읽는 사람이 알아봅니다. 착수 보고도 같은 결이라서, 「완성했다」가 아니라 「AI를 다루는 힘과 자료가 흐르는 길을 뚫었다, 이제 쓰면서 키운다」로 씁니다. 이사회 보고에 안 된 것과 미확인을 따로 적는 원칙은 전진배치 개발자 FDE 6절에 있습니다.

일곱 줄로 줄이면

  1. 현장 콘솔에는 손으로 칠 수 있는 한 줄씩, 원격 진입만 열고 나머지는 원격에서 한다.
  2. 사람이 앞에 있는 창에는 검증된 한 걸음만 쓰고, 실험은 우리 손이 닿는 기계에서 한다.
  3. 「필요하다」고 말하기 전에 없으면 정말 안 되는지 잰다.
  4. 손이 안 닿는 기계에는 도구를 건네기보다 사람이 한 줄 치는 길을 먼저 본다.
  5. 현장 AI 지시문의 첫 줄은 「네가 직접 실행한다, 사람 손은 이것뿐」이다.
  6. 방을 열었으면 판정은 그 방이 우리 없이 한 건을 했는가다.
  7. 이식할 때는 원본을 감사하고, 옮겨 온 질문과 숫자는 새 데이터로 다시 센다.

관련 노드

작성: 품앗이 · 2026-10-22 · 의료복지사협·로컬푸드 협동조합·교육원·자활 기관 현장 기록 기준

그래프 뷰

백링크