SYNAPSE의 ****아키텍처 스캔 리포트(ASR)****는 프로젝트의 아키텍처 건강도를 팩트와 데이터 기반으로 촬영하는 "MRI 스캔"입니다. 우리는 객관적인 측정(Scan)과 주관적인 해석(Diagnosis)을 엄격하게 구분하여, 의사결정자에게 AI의 환각(Hallucination)이 섞이지 않은 명확한 아키텍처 증거를 제공합니다.
### 핵심 철학: 진단(Diagnosis)보다 스캔(Scan)
기존 도구들은 깊이 있는 "AI 진단"을 시도하지만, 파서의 한계나 환각으로 인해 실패하는 경우가 많습니다. ASR 3.0은 과도한 추론을 배제하고 ****데이터 신뢰도(Data Reliability)와 감사 가능성(Auditability)****에 집중합니다.
- **매직 넘버 금지**: 영향도(Impact) 점수는 잘려나간 목록이 아닌 전체 의존성(Intent Edge) 스코프를 기반으로 계산됩니다.
- **추적 가능한 증거**: 모든 유령 의존성(Ghost Dependency)과 경계 침범(Boundary Crossing)은 실제 심볼과 함께 추적됩니다.
- **GUI 우선 워크플로우**: 복잡한 터미널 실행은 폐기되었습니다. 리포트는 VSCode 캔버스 내에서 매끄럽게 생성됩니다.
### 6단계 MRI 구조
| 섹션 | 초점 | 목적 |
|------|------|------|
| **0. Analysis Subject** | 스캔 범위 | 분석된 전체 파일, 내부 엣지, 경계 엣지의 수를 표시합니다. |
| **1. Executive Summary** | 핵심 판정 | 엔트로피와 경계 비율(Boundary Ratio)을 기반으로 즉각적인 PASS/UNSTABLE 판정을 내립니다. |
| **2. Impact Files** | 수술 대상 | 절대적인 전체 외부 엣지 결합도를 기준으로 최상위 "God Class"를 식별합니다. |
| **3. Evidence Layer** | 부채 증명 | 유령 의존성과 경계 위반에 대한 감사 가능한 증거 목록입니다. |
| **4. Expected After Surgery** | 예상 상태 | 최상위 수술 대상을 리팩토링할 경우 예상되는 팩트 기반의 엔트로피 및 경계 변화량입니다. |
| **5. Raw Metrics** | 엔진 출력 | 세부적인 AEL(Architecture Ecology Laboratory) 지표 및 출처 분류(Breakdowns)입니다. |
### 실행 방법 (GUI First)
복잡한 터미널 CLI 스크립트는 잊으십시오.
1. VSCode에서 SYNAPSE 캔버스를 엽니다.
2. UI에서 **가상 디버그(Virtual Debug)** 버튼을 클릭합니다.
3. ASR이 워크스페이스 내에 HTML, Markdown, JSON 형태의 전체 스캔 결과를 즉시 생성합니다.
### 생성되는 증거 아티팩트
```text
synapse_report/surgery/
├── ASR_EV-LIVE.md [Main: 6섹션 마크다운 리포트]
├── ASR_EV-LIVE.html [Main: 웹 열람용 HTML 리포트]
└── ASR_EV-LIVE.json [Source of Truth: 전체 그래프 및 메타데이터 덤프]
```
아키텍처 수술에 앞서 팩트 기반의 증거를 제시함으로써, ASR은 모호한 기술 부채를 실행 가능하고 측정 가능한 목표로 변환합니다.