Bound OnPrem Harness™: 망분리 코드 인텔리전스 & 에이전트 TDD 하네스

핵심 공학 원칙: 실행 하네스 (Harness)
핵심 슬로건: “데이터가 나가면 안 되는 업무와 변경이 운영에 닿는 업무를 일반 클라우드 프롬프트로 다루지 않습니다.”

1. 개요 (Overview)

금융, 제조, 방산 등 핵심 지적재산권(IP)과 소스코드를 다루는 엔터프라이즈 환경에서는 상용 클라우드 LLM(ChatGPT, Claude 등)의 도입이 엄격히 금지됩니다. 소스코드 한 줄, API 키 하나가 외부 서버로 전송되는 즉시 컴플라이언스 위반 및 심각한 보안 사고로 이어지기 때문입니다.

**Bound OnPrem Harness™**는 물리적으로 차단된 사내 폐쇄망 인프라에서 로컬 모델을 구동하고, 독자 개발한 AST(추상 구문 트리) 정적 분석 파이프라인을 통해 소스 전문 없이도 전체 아키텍처 맵을 자동 추출·문서화하는 엔터프라이즈 전용 온프레미스 AI 하네스입니다.

2. AST 기반 지식화 및 보안 파이프라인

소스코드 전문을 거대 모델에 통째로 밀어 넣으면 토큰 낭비와 환각이 발생합니다. Bound OnPrem Harness™는 코드를 기계적으로 파싱하여 의미론적 뼈대만 추출합니다.

flowchart LR
    A["사내 핵심 소스코드<br/>(망분리 온프레미스)"] --> B["커스텀 AST 정적 파서<br/>(클래스/메서드/타입/import 추출)"]
    B --> C["구조화 메타 JSON<br/>(구현 세부 은닉)"]
    C --> D["로컬 LLM (Ollama Mistral-7B)<br/>(외부 트래픽 0건)"]
    D --> E["Mermaid 구조도 &<br/>온보딩 아키텍처 가이드"]

1. 구현 세부 정보 은닉: 비즈니스 로직 알고리즘이나 민감한 하드코딩 값은 제거되고, 클래스 선언, 입출력 타입 시그니처, 모듈 간 참조 관계만 정제됩니다.
2. 폐쇄망 로컬 추론: 완전한 온프레미스 환경에서 구동되므로 외부 인터넷 망과의 통신 패킷이 단 1바이트도 발생하지 않습니다.
3. 온보딩 시간 3배 단축: 수십만 라인의 복잡한 레거시 프로젝트에 신규 투입된 엔지니어가 모듈 간 상속 관계와 데이터 흐름을 시각적으로 즉각 파악할 수 있습니다.

3. Spec-First TDD: AI 에이전트 변경의 절대 원칙

AI에게 코드 작성을 맡길 때 가장 위험한 것은 **기존 기능이 소리 없이 깨지는 회귀 결함(Regression)**입니다. BOUND AX는 다음 4단계 하네스를 통과하지 못한 에이전트 변경을 결코 운영에 반영하지 않습니다.

1. 스펙 선작성 (Spec-First): 인터페이스 규약, 엣지 케이스, 허용 입력을 마크다운 명세서에 먼저 확정합니다.
2. 실패하는 선행 테스트 (Red Test): 구현체 작성 전, Vitest / Pytest로 검증할 테스트 케이스를 먼저 작성하여 실패를 확인합니다.
3. 가장 단순한 구현 (Minimal Implementation): 불필요한 과잉 추상화(YAGNI) 없이 테스트를 통과하는 최소 코드를 작성합니다.
4. 회귀 스위트 100% 통과 (Green & Refactor): 전체 테스트 스위트가 통과할 때까지 루프를 돌려 **운영 회귀 결함 0%**를 증명합니다.