AI Pods로 돌아가기

Legacy Modernization Pod · Forge Modernization

Legacy Migration & Modernization

기억이 아니라 근거로 다시 만듭니다.

시스템이 어떻게 동작하는지 아는 사람은 남아 있지 않고, 문서는 처음부터 없었습니다. Legacy Modernization Pod 팀이 그것이 실제로 무엇을 하는지 복원한 뒤, 그 기준에 맞춰 대체 시스템을 설계하고 구축하고 검증합니다. 네 단계마다 이름이 명시된 사람이 승인합니다. Forge Modernize는 이미 쓰고 계신 AI 코딩 에이전트 위에서 동작합니다.

단계, 분석에서 검증된 재구축까지
4단계, 분석에서 검증된 재구축까지
게이트, 각각을 지정된 사람이 닫습니다
4게이트, 각각을 지정된 사람이 닫습니다
개 명령, 그중 11개가 핵심 경로
20개 명령, 그중 11개가 핵심 경로
개 레거시 자산 지원
3개 레거시 자산 지원

상황

익숙한 이야기인가요?

보통 두 가지가 동시에 참입니다.

왜 지금인가

  • 프레임워크가 수명을 다했고, 보안 패치도 함께 끊겼습니다.
  • 해당 스택으로 채용이 되지 않고, 컴플라이언스가 묻기 시작했습니다.

왜 아직 못 했는가

  • 시스템을 이해하던 마지막 사람이 떠났습니다.
  • 문서는 몇 년 전에 배포된 버전을 설명하고 있습니다.
  • 업무 규칙을 열거할 수 있는 사람이 없으니, 모든 산정이 추측입니다.

일정은 실재하고 지식은 사라졌습니다. 이제 그 시스템 자체가 자신에 대한 유일하게 남은 명세입니다.

누구를 위한 킷인가

Forge Modernization이 우리 팀에 맞을까요?

시스템 자체가 유일한 명세가 되어 버린 경우를 위한 킷입니다. 처음부터 새로 짓는 프로젝트를 위한 도구가 아닙니다.

적합한 경우

  • 남은 사람 중 아무도 설명할 수 없는 운영 중인 시스템 — 문서는 처음부터 없었거나 옛 버전을 설명합니다.
  • 수명이 끝난 프레임워크 — 보안 패치는 끊겼고 컴플라이언스가 묻기 시작했습니다.
  • 아무도 비즈니스 규칙을 나열할 수 없어서, 지금까지의 모든 견적이 추측이었던 시스템.
  • 한 번의 빅뱅 전환 대신 단계마다 서명된 게이트를 원하는 책임자.

적합하지 않은 경우

  • 복원할 것이 없는 신규 구축 — Forge Spec으로 시작하세요.
  • 코드는 그대로 두고 호스팅만 옮기는 리프트 앤 시프트.
  • 소스 코드 접근을 줄 수 없는 시스템. 복원은 기억이 아니라 코드를 읽습니다.
  • 분석 없이 재구축만 원하는 경우. 명세가 먼저 오는 것은 설계된 순서입니다.

1단계 산출물

먼저, 아무도 쓴 적 없는 명세서.

서브시스템 하나를 Markdown으로. 메일함이 아니라 사내 위키에 그대로 들어갑니다.

deliverables/
INDEX.md— start here — every output, by concern
01-understanding/
OVERVIEW.md— modules, data flows, external systems
BUSINESS_RULES.md— one row per rule, with its source line
AI_UNCERTAINTY.md— what we could not determine
REQUIREMENTS.md
MIGRATION_STRATEGY.md— and what not to carry forward
BATCH_WORKFLOWS.md
02-data-model/
DATA_CATALOG.md— entities, field dictionary, CRUD
03-security/
SECURITY_ISSUES.md— adjudicated, not raw scanner noise
04-operations/
DEPLOYMENT.md
LOGGING.md
05-testing/
CHARACTERIZATION.md— the plan for proving parity
TRACEABILITY.md
COVERAGE_GATE.md
06-governance/
REVIEW_CRITERIA.md— what each role must sign
single-page/one per screen
AS-IS_order-entry.md
AS-IS_error-screens.md
wireframes/
navigation-map.html— clickable, pan and zoom
er-diagram.md— declared keys solid, inferred dashed

AS-IS_<screen>.md

모든 화면마다 하나씩 만들어집니다.

  1. 1레이아웃과 화면 전환 다이어그램
  2. 2필드 정의와 검증 규칙
  3. 3접근하는 테이블과 CRUD 행렬
  4. 4업무 규칙, 코드 값, 접근 권한
  5. 5미해결 항목과 이전 시 유의사항

마지막 절을 먼저 읽으십시오. 우리가 밝혀내지 못한 것을 알려 주는 절입니다.

재구축이 하는 모든 일은 이 문서들에 비추어 측정됩니다. 그래서 2~4단계가 희망이 아니라 감사 가능한 작업이 됩니다.

이전 과정

레거시 소스에서 검증된 재구축까지.

네 단계이며, 서명 없이 넘어가는 사람은 없습니다. 게이트는 알림이 아니라 정지입니다. 앞 단계가 서명되지 않았다면 다음 단계의 작업은 거부됩니다.

Gate G1

탐색

In
소스 코드, 또는 남아 있는 문서
Runs
소스를 개별 분기 수준까지 호출 그래프로 분해합니다. 규칙을 추출한 뒤, 무엇도 기록되기 전에 두 번째 패스가 그것을 공격합니다.
Out
  • BUSINESS_RULES.md
  • DATA_CATALOG.md
  • AS-IS_<screen>.md
  • AI_UNCERTAINTY.md
  • er-diagram.md

Signs: 검증 책임자 · 아키텍트 · 비즈니스 애널리스트

Gate G2

설계

In
서명된 명세
Runs
모듈별 기본 설계와 상세 설계, 그리고 사용자가 실제로 다룰 모든 화면의 클릭 가능한 프로토타입.
Out
  • BasicDesign.md
  • DetailDesign.md
  • prototype.html
  • IMPLEMENT_PLAN.md

Signs: 솔루션 아키텍트 · PM

Gate G3

구현

In
서명된 구현 계획
Runs
작업 단위를 쪼갠 뒤 애플리케이션 저장소에 구현하고, 단위마다 근거를 남깁니다.
Out
  • TASKS.md
  • source in your repo
  • G3_evidence.md

Signs: 엔지니어링 리드

Gate G4

테스트

In
재구축된 애플리케이션
Runs
Forge QA가 테스트를 생성하고 실행합니다. 모든 실패를 분류합니다. 이전 때문인가, 테스트 때문인가?
Out
  • TEST_HANDOFF.md
  • test suite in your repo
  • G4_evidence.md

Signs: QA · 고객사의 최종 승인

사람이 G1을 보기 전에 두 가지 기계 검사가 돕니다. 문서가 전부 있어도 거부될 수 있습니다. 완비되었다는 것과 품질이 확보되었다는 것은 다르기 때문입니다.

Members only

Who signs which gate

7 roles · G1–G4 · the customer is accountable throughout

Sign in to unlock

Members only

What blocks, and what only advises

3 blocking checks · 1 advisory prompt

Sign in to unlock

모든 명령과 그 역할.

스무 개의 명령이 있고, 그중 열한 개가 핵심 경로에 있습니다. 게이트 검토가 단계마다 한 번 돌기 때문에 이전 한 건당 대략 열네 번 호출됩니다. 나머지는 주 흐름이 대신 불러 주는 연동과 유틸리티입니다.

고객사의 코딩 에이전트 위에서 동작하며, 자체 모델 호출을 하지 않습니다. 별도의 추론 비용이 없고, 소스 코드가 이미 신뢰하는 환경 밖으로 나가지 않습니다.

명령 레퍼런스 열기

왜 신뢰할 수 있는가

모든 규칙이, 우리가 얼마나 확신하는지 함께 말합니다.

각 규칙은 그것이 나온 코드 구조에 고정되며, 그 고정은 리팩터링을 견딥니다. "이건 어디서 나온 거죠?"라는 물음에 위치로 답합니다.

입증됨
코드에서 확인했고, 효과 검사도 일치했습니다.
확정된 사실로서 설계에 그대로 반영됩니다.
추론됨
규칙 자체는 실재합니다. 다만 런타임 효과가 독립적으로 확인되지는 않았습니다.
G1이 닫히기 전에, 해당 영역을 책임지는 검토자에게 이름을 지정해 전달됩니다.
모순됨
코드가 규칙이 말하는 대로 동작하지 않습니다.
유지할지 고칠지 결정할 때까지 멈춥니다. 조용히 고치지도, 그대로 옮기지도 않습니다.

대부분의 규칙은 "추론됨"에 놓이며, 그것이 핵심입니다. "입증됨"은 두 번 얻어야 합니다. 한 번은 코드를 읽어서, 한 번은 코드가 규칙의 주장대로 동작하는지 확인해서.

It finds the bugs you were about to rebuild.

두 번째 패스가 첫 번째와 다툽니다. 한쪽은 모든 인용을 다시 확인합니다. 다른 한쪽은 주장을 무시하고, 어떤 규칙으로도 설명되지 않는 동작이 코드에 있는지 묻습니다.

이 과정에서 레거시의 실제 버그가 드러납니다. 범위가 지정되지 않은 삭제, 실행을 멈추지 않는 리다이렉트, 이미 없는 함수에 대한 호출 같은 것들입니다. 그것들이 새 시스템의 기능으로 굳기 전에 알게 됩니다.

결함이 0건이라고 주장하는 보고서는 발행하지 않습니다. 운영 중인 시스템에 대한 정적 분석이 그런 주장을 할 자격을 얻은 적은 없기 때문입니다.

무엇을 이전하는가

세 가지 자산, 그리고 거기에 없을 때의 경로.

자산이 섞여 있는 것이 보통입니다. 설계 문서가 있는 서브시스템 하나와 코드만 있는 네 개는, 아주 평범한 출발점입니다.

  • PHP

    프레임워크가 있든 없든. 파일 단위 절차형 페이지도 포함합니다.

  • COBOL

    메인프레임 자산, 화면과 배치.

  • .NET

    레거시 ASP.NET과 VB.NET.

파싱할 소스가 없다면?

문서만으로 진행하는 경로는 언어를 가리지 않습니다. 명세서, PDF, 스프레드시트, 스크린숏 — 남아 있는 무엇이든 같은 파이프라인에 들어가 같은 산출물 묶음을 만듭니다.

무엇 위에 다시 만드는가

스코핑에서 합의한 대로, 고객사가 정합니다. 이 방법론은 대상 스택을 가리지 않습니다.

보안 현황도 함께 얻습니다

10년 된 자산에는 10년치 노출이 쌓여 있습니다. 규칙을 복원하는 그 과정이, 소음을 걸러낸 우선순위 있는 레거시 보안 진단을 함께 만들어 냅니다.

Questions we get asked

The ones that decide it.

문서가 아예 없습니다. 그러면 진행이 불가능한가요?
그것이 일반적인 상황이고, 이 킷이 존재하는 이유입니다. 일반적인 자산에서 다섯 중 넷은 코드만 있습니다. 여기서 역공학은 차선책이 아니라 주된 경로입니다.
AI가 규칙을 지어내지 않았다는 것을 어떻게 알 수 있나요?
모든 규칙에는 등급과 출처 고정이 있고, 첫 번째 결과를 공격하기 위한 두 번째 패스가 있습니다. 근거를 댈 수 없는 규칙이 근거 있는 규칙처럼 보이는 일은 없습니다.
내부를 볼 수 없는 블랙박스인가요?
아닙니다. 저희 엔지니어가 에이전트의 산출물을 검토하고, 지정된 검토자가 문서 전체가 아니라 개별 발견에 배정되며, 모든 게이트의 승인 권한은 고객사에 있습니다.
인수인계 후에 저희 팀이 직접 운영할 수 있나요?
가능합니다. 스테이징에서 워크플로를 검증한 뒤, 표준 도구로 재현 가능한 방법론을 인계합니다. 저희 실행 속도를 높이는 자동화 자체는 저희가 계속 보유합니다.

Members only

How to audit a bundle, in order

7 steps · what a verification team checks first

Sign in to unlock

Members only

Limitations, stated plainly

6 limits · read as carefully as the capability copy

Sign in to unlock

시작하기

가장 꾸며내기 어려운 부분부터 시작하십시오.

서브시스템 하나를 주십시오. 그 시스템의 실제 업무 규칙과 실제 데이터 모델, 그리고 우리가 확정하지 못한 것의 정직한 목록을 돌려드립니다. 전체 이전이 딛고 서는 1단계 산출물과 같은 것입니다.