Graphify 코드 지도, 연결선을 믿기 전에 — 3개 파일로 근거를 확인하는 프롬프트

10월 19, 2026

코드 파일 사이 연결의 근거를 돋보기로 확인하는 그림 — AA-20261019-GRAPH-T · AI 생성 썸네일

AA-20261019-GRAPH · 독립 실습 단원 · 약 20~30분

무엇을 해 볼 것인가

AI가 그린 코드 관계도에서 연결마다 파일·줄 번호를 찾아갑니다. 산출물은 모듈 의존도 그림과 연결 근거표입니다. 큰 점이 중요한 기능이라는 해석과 실제 코드에 적힌 import를 구분하는 것이 핵심입니다.

준비물·버전·비용

Python 3.10 이상과 텍스트 편집기, 아래 3개 파일. 기본 검산은 Python 표준 라이브러리로 수행할 수 있습니다. Graphify를 추가하려면 공식 저장소가 안내하는 graphifyy 패키지와 지원 AI 코딩 도구를 확인합니다. 이 글은 설치를 실행하지 않았습니다. 로컬 코드 분석과 문서·미디어에 대한 모델 호출, Cloud 요금은 구분해야 하며 구체적 가격은 미확인입니다.

예제 입력

아래 자료는 AI오토마타가 만든 가상 예제입니다. 필요한 부분을 복사해 로컬 파일로 저장할 수 있습니다. 실제 업무 자료로 바꾸기 전에는 공개·전송 가능 범위를 확인하세요.

# app.py
from service import total
print(total([10, 20]))

# service.py
from rules import tax
def total(values):
    return sum(values) + tax(sum(values))

# rules.py
def tax(amount):
    return amount * 0.1

3개 원본 파일 → 직접 import 추출 → 관계도 생성 → 파일·줄 대조 → 변경 후 재검산

AA-20261019-GRAPH-F1 · 자체 제작 과정 도식

단계별 제작 방법

빈 실습 폴더에 app.py, service.py, rules.py를 각각 만듭니다. 주석의 파일명 아래 코드를 해당 파일로 분리합니다.
app.py를 실행합니다. 결과 33.0을 확인합니다. 이는 관계도를 그린 결과가 아니라 예제 코드가 정상 동작한다는 검산입니다.
최초 프롬프트로 직접 import를 추출하게 합니다. app→service, service→rules가 나와야 합니다. app→rules는 직접 import가 아닙니다.
공식 설치 문서를 읽고 Graphify를 사용할 경우 별도 실습 폴더에서 설정합니다. 공식 패키지명은 graphifyy이며 명령은 graphify입니다. 설치 범위와 모델 사용 여부를 먼저 확인합니다.
지도 결과가 있으면 EXTRACTED와 INFERRED 표시를 구분하고 파일·줄 번호로 되돌아가 연결 이유를 대조합니다. 표시만으로 정확하다고 판단하지 않습니다.
수정 프롬프트로 직접·간접 경로를 분리하고, 확장 실습 후 app.py 결과와 관계도를 다시 검사합니다. 변경 전 자료를 보존합니다.

복사 가능한 프롬프트 4개

각 프롬프트 뒤에 위 예제 전체를 붙여 넣으세요. 최초 → 점검 → 수정 → 확장 순서로 사용합니다. 외부 원문 프롬프트가 아니라 자체 한국어 응용안입니다.

최초

아래 3개 Python 파일의 모듈 의존도를 설명하라. 직접 import와 간접 경로를 분리한다. 각 연결은 시작 파일/대상 모듈/근거 줄/관계 유형으로 적는다. 코드에 없는 함수·파일을 만들지 마라. 그림은 app→service→rules 형태이며 app→rules를 직접 import로 표시하지 마라. 실제 도구를 실행하지 않았다면 Graphify 실행 결과라고 쓰지 마라.

점검

관계표를 원문과 대조하라. app.py 첫 줄은 service의 total을 가져오고 service.py 첫 줄은 rules의 tax를 가져온다. app에서 rules까지의 간접 경로는 두 간선이다. import 관계와 런타임 함수 호출을 같은 뜻으로 취급한 항목을 표시하라. 근거 줄이 없는 연결은 미확인으로 남긴다.

수정

오류 지도: app이 rules를 직접 import한다, tax가 total을 호출한다. 원문과 반대이거나 없는 관계를 수정하라. app→service→rules의 import 경로와 total 내부의 tax 호출을 분리해 설명하라. 수정 전/수정 후/근거 파일·줄 번호 표를 작성하라. 전체 프로젝트에 대한 성능·보안 판정은 하지 마라.

확장

rules.py의 비율만 0.2로 바꾼 v2를 가정하라. 입력 [10,20]의 출력은 36.0이어야 한다. 모듈 import 간선은 그대로인지 확인하고, 출력값 변경과 구조 변경을 별도로 기록하라. 작은 정적 예제의 결과를 동적 import나 대규모 프로젝트에 일반화하지 마라.

검사 전

연결선이 보임 → 실제 호출이라고 단정

검사 후

관계 유형 + 원문 위치 → 직접·간접 구분

AA-20261019-GRAPH-F2 · 자체 제작 비교 도식. 실제 제품 화면 아님.

기대 결과·검산 기준

항목	기준	확인점
실제 예제 출력	33.0	30+30×0.1
직접 import	app→service	app.py:1
직접 import	service→rules	service.py:1
간접 경로	app→service→rules	두 간선, 직접 import 아님
v2 출력	36.0	import 구조는 동일

실제로 확인한 범위

세 파일을 실제로 만들고 별도 Python 프로세스로 app.py를 실행해 33.0을 확인했습니다. Python AST로 직접 import 두 개를 추출했습니다. 이 기록은 자체 검산 결과이며 Graphify의 설치·그래프 생성·AI 질의는 미실행입니다.

오류 해결

import는 실제 함수가 반드시 실행된다는 증거가 아닙니다. 코드가 바뀐 뒤 오래된 지도를 사용하면 줄 번호와 관계가 어긋날 수 있습니다. 연결 개수나 색상만으로 수정 우선순위를 정하지 마세요. 동적 import·별칭·실행 조건은 이 작은 예제로 검증하지 않았습니다.

연습 과제·평가

app.py에서 total 호출을 제거하고 import만 남겨 보세요. import 관계는 남지만 실행 결과 33.0은 사라집니다. 평가: 파일 분리2점, 출력 검산2점, 직접·간접 구분2점, 줄 번호2점, 실행 여부 표시2점. import를 실행 호출로 단정하면 수정합니다.

대체 방법·오프라인 실습

제품 계정이 없거나 사용 한도가 끝나면 예제 원문과 기준표를 인쇄해 두 사람이 작성자·검수자 역할을 나눕니다. AI가 없어도 원문 위치, 숫자, 목록을 대조할 수 있습니다. 결과 기록은 입력 버전/사용 도구/실행 시각/출력/검수 항목/수정 내용 순으로 남기세요. 실제 실행하지 않은 칸은 미실행이라고 적습니다.

기존 글과의 차이

기존 intent.md 글이 만들 앱의 요구사항을 고정했다면, 이번에는 이미 있는 코드의 구조를 근거와 함께 읽습니다. 관련 기존 실습 보기

원영상·공식 출처·권리 확인

Claudical 원영상 · 게시 2026-10-17 · 수집 확인 2026-10-19.

원영상 공개 설명의 Graphify 개념과 공식 저장소 링크를 확인했습니다. 영상의 FastAPI 노드·연결 수치는 재현하지 않았습니다. 자막·장면은 미확인이고 본문의 3개 파일과 프롬프트는 자체 예제입니다.

2026-10-18 확인한 저장소는 코드의 로컬 파싱과 문서·미디어의 모델 처리 경로를 구분하고, 연결에 EXTRACTED/INFERRED 표시와 결과 파일을 안내했습니다. 저장소에 Apache-2.0·MIT 라이선스 표시가 있으므로 재배포할 때 해당 파일의 조건을 확인하세요. 자체 예제는 외부 코드를 복제하지 않았습니다.

영상·자료의 재배포 허락은 확인하지 않아 원본을 내려받아 재배포하지 않습니다. 본문의 가상 예제·프롬프트·도식은 자체 제작이며 썸네일은 AI 생성입니다. 교재 편집용 자료 ID는 AA-20261019-GRAPH입니다. 인쇄 안내문은 예제, 프롬프트, 빈 검수표, 기준표 순서로 구성하면 링크 없이도 연습할 수 있습니다. 책 쪽수는 편집 단계에서 배정합니다.

AI 오토마타