오늘 영상은 이렇게 갑니다

새 시스템에 옮기려는데, 옛 프로그램이 뭘 하는지 아무도 모른다

• 차세대 사업이 시작됐는데 옛 프로그램의 설명서가 없거나 십 년 전 것이다
• 소스를 열어 보면 코볼과 자바가 섞여 있고, 주석에 적힌 숫자와 실제 값이 다르다
• 요구사항 목록에는 없는데 소스만 몰래 하고 있는 일이 있을까 봐 불안하다
• → 소스를 한 줄씩 읽는 데 몇 주가 가고, 읽은 내용은 머릿속에만 남는다

«하는 일 · 업무 규칙 · 호출 흐름» 설명서와 전환 시 주의 목록

출처: ITWorld 「생성형 AI로 앱 마이그레이션 간소화」 — 포춘 5,000대 기업의 70%가 20년 이상 된 소프트웨어를 쓰며, 생성형 AI가 코볼 같은 옛 언어를 설명하고 아키텍처 질문에 답하는 데 도움이 된다고 소개한다

주석에는 15일, 실제 소스는 14일

소스가 몰래 하는 일이 새 시스템에서 사라진다

왜 그렇게 정했는지는 소스에 없다

Code 화면에서 폴더를 연다

압축을 풀면 폴더 10곳, 파일 16개가 나옵니다

zip을 내려받아 압축을 푼 뒤, 그 폴더를 Code 화면에서 엽니다. 모든 파일은 교육용 가상 자료입니다.

프로그램 4개, 말은 코볼과 자바가 섞여 있다

EVALUATE TRUE
  WHEN L-DAYS < 3   MOVE 0 TO L-STAGE
  WHEN L-DAYS < 14  MOVE 1 TO L-STAGE
  WHEN L-DAYS < 30  MOVE 2 TO L-STAGE
  WHEN L-DAYS < 45  MOVE 3 TO L-STAGE
  WHEN OTHER        MOVE 9 TO L-STAGE
END-EVALUATE

앞서 정리한 요구사항 목록이 대조의 기준이다

사람이 정한 설명서 기준을 먼저 알려 준다

내용을 읽고 고른다

연 폴더에서 이렇게 치기 Claude Code

이 폴더는 JJ디지털 요금 미납 안내 문자 프로그램 자료야. 어떤 파일이 어디 있는지 폴더별로 정리해줘.
이름이 비슷하거나 오래돼 보이는 파일, 내용이 비어 있는 파일, 이 일이랑 상관없어 보이는 파일은 따로 알려줘.
원본은 절대 고치지 마.

같은 창에 이어서 Claude Code

01_소스에 있는 프로그램마다 '하는 일'을 한 줄로 써줘. 처음 보는 사람도 알아듣게 쉬운 말로.
02_설정의 실행 순서 메모도 보고, 어떤 프로그램이 어떤 프로그램을 부르는지 화살표로 한 줄에 그려줘.
소스에서 확인되지 않는 건 (확인 필요)라고 써줘.

실제 연결: UNPAY010이 UNPAY020을 고객마다 부르고 → 문자 대상 파일이 나오고 → NoticeSender가 읽어 SmsGateway를 부른다 (그림의 화살표는 «다음 단계»)

큰 그림이 나오면 이어서 Claude Code

프로그램마다 업무 규칙을 뽑아줘. 숫자와 조건은 소스에 있는 그대로 쓰고, 소스의 몇 번째 줄인지도 같이 적어줘.
주석이랑 소스가 다르면 소스를 따르고, 다르다는 것도 알려줘.
내가 안 준 내용은 지어내지 말고 확실하지 않은 건 (확인 필요)라고 표시해줘.

규칙은 모두 12개 (UNPAY010 4 · UNPAY020 1 · NoticeSender 4 · SmsGateway 3) · 화면에는 6개만 보여 줌 · 줄 번호는 실제 파일에서 확인한 값

규칙이 나오면 이어서 Claude Code

주석에 적힌 내용이랑 실제 소스가 다른 곳이 있으면 찾아줘.
설정 파일에 적힌 값이랑 소스에 박힌 값이 다른 곳도 찾아줘. 소스가 그 설정 파일을 읽는지도 알려줘.
어디서도 부르지 않는 부분이 있으면 그것도 알려줘. 전부 어느 줄인지 같이.

셋 다 설명서에 «다르다»고 남겨야 하는 것 · 안 쓰는 부분은 지우자고 하지 말고 «담당자에게 확인»으로 둔다 · 발송 시작이 실제로 8시인지 9시인지는 운영 중인 값을 봐야 한다 (확인 필요)

결과가 나오면 이어서 Claude Code

프로그램별 업무 규칙이 몇 개인지 막대 그림으로 보여줘. 옆에 요구사항 12개가 소스랑 일치, 다름, 애매, 소스에 없음 중 어디에 해당하는지도 같이 보여줘. 눈에 띄게 많은 곳은 빨갛게 표시해줘.

교육용 가상 폴더 기준 · UNPAY010과 NoticeSender에 규칙이 몰려 있어 설명서 검수도 이 두 곳부터 · 요구와 «다름» 3개가 새 시스템에서 가장 위험하다

그림 다음에 이어서 Claude Code

03_신규요구의 요구사항 목록이랑 지금까지 뽑은 규칙을 맞춰봐줘.
요구마다 일치, 다름, 소스에 없음, 애매 중 하나로 표시하고, 왜 그런지 소스의 줄 번호로 알려줘.
요구 목록에는 없는데 소스가 하고 있는 일은 따로 모아줘.

대조가 끝나면 이어서 Claude Code

04_시험자료의 시험사례 고객 10명이 옛 프로그램에서 어떻게 되는지, 지금까지 정리한 규칙대로 한 명씩 따라가서 결과를 써줘.
결과는 발송, 이월, 보류, 제외, 해지심사 중에서 고르고 이유도 짧게 적어줘.
그다음 지난달_실제발송결과랑 비교해서, 다른 고객이 있으면 어느 규칙을 잘못 읽었는지 알려줘.

10명 중 6명만 보여 줌 · C02는 14일째라 2차, 수신거부라 제외 · C03은 수신거부인데 3차라 발송 · 지난달 실제 결과와 비교하면 10/10명이 같다 → 설명서의 규칙이 실제와 맞다

비교가 끝나면 바로 이어서 Claude Code

고객 몇 명이 발송, 이월, 보류, 제외, 해지심사로 나왔는지 세어줘. 다 더하면 전체 고객 수랑 같은지도 알려줘.
요구사항 12개가 일치, 다름, 애매, 소스에 없음으로 몇 개씩인지도 세어줘. 전환 주의 목록은 모두 몇 건인지도.
안 맞으면 어디서 틀렸는지 알려줘.

3 + 1 + 1 + 4 + 1 = 10 · 6 + 3 + 1 + 2 = 12 · 안 맞으면 «구버전 파일이나 복사본을 읽지 않았나»부터 본다

결과가 실제와 다를 때 Claude Code

C03 결과가 지난달 실제랑 달라. 수신거부 고객이라도 이용정지 예고는 보낸다는 규칙이 UNPAY010에 있어. 그 줄을 다시 읽고 설명서랑 사례 결과를 고쳐줘.
같은 실수가 다른 규칙에도 있는지 확인해줘.

결과가 다르면 «어느 줄을 근거로 그렇게 읽었나»부터 묻는다 · 조건의 «이상·미만», «그리고·또는»을 잘못 읽는 일이 가장 흔하다 · 고친 뒤 10명 모두 다시 비교한다

결과가 맞으면 이어서 Claude Code

지금까지 정리한 걸로 프로그램별 설명서를 워드로 만들어줘. 프로그램마다 하는 일, 업무 규칙(줄 번호 포함), 호출 흐름 순서로.
그리고 새 시스템으로 옮길 때 주의할 것을 엑셀 목록으로 따로 저장해줘. 구분, 내용, 어디에 있나, 결정은 사람이 칸을 넣어줘.
새 파일로 저장하고 이름은 프로그램별_설명서, 전환주의목록으로 해줘.

원본은 그대로, 새 파일만 늘었다

마지막으로 한 순서를 남겨 둘 때 Claude Code

오늘 한 순서를 옛 프로그램 설명서 만드는 순서라는 메모로 폴더에 저장해줘.
폴더 살펴보기, 하는 일과 호출 순서 정리, 규칙 뽑기, 주석과 다른 곳 찾기, 요구사항과 맞춰 보기, 고객 사례로 확인하는 것까지.
다음에 다른 프로그램 폴더를 열고 지난번처럼 해줘라고 하면 그대로 하게.

연습은 4개, 현장은 수백 개 — 같은 순서로 나눠 맡긴다

읽는 시간과 빠뜨려서 생기는 재작업을 줄인다

※ «가정»으로 표시한 수치는 설명용이며, 건수는 교육용 가상 폴더 기준입니다 · 출처: ITWorld 「생성형 AI로 앱 마이그레이션 간소화」(맥킨지 보고서 인용)

AI는 읽고 정리하고, 옮길 규칙의 확정은 사람

• «다름» 3개 중 어느 쪽이 맞는지(14일인가 15일인가)는 업무 담당자가 정한다
• 수신거부 고객에게 이용정지 예고를 보내는 것은 법적 고지·약관과 관련될 수 있어 담당 부서가 확인한다 (확인 필요)
• 숨은 규칙을 새 시스템에 옮길지 버릴지, 안 쓰는 부분을 지울지는 담당 개발자와 업무 담당자가 함께 정한다
• 설명서의 줄 번호와 규칙은 사람이 소스에서 몇 곳을 열어 확인한 뒤 회의에 낸다

우리 회사 소스로 하기 전에 3가지

설명서를 회의에 내기 전, 5가지 확인

• 소스·설정 파일 원본은 그대로이고, 설명서와 주의 목록은 새 파일이다
• 복사본이나 2019 구버전을 읽지 않았고, 설명서의 숫자는 주석이 아니라 소스 기준이다
• 고객 사례 10명의 결과가 지난달 실제 결과와 10/10으로 맞는다
• 이유를 짐작으로 채우지 않았고, 모르는 것은 (확인 필요)로 남아 있다
• «다름»·숨은 규칙·안 쓰는 부분은 담당 개발자와 업무 담당자가 확인했다

우리 회사 옛 프로그램으로 해 보세요

오늘 쓴 부탁 문장은 영상 설명란과 JJ AI+ 학습 사이트에서 복사할 수 있습니다