codeaware

codeaware

AI가 코드를 얼마나 안전하게 이해하고 수정할 수 있는지 진단하는 MCP 서버.

기존 코드 품질 도구들이 놓치는 "숨은 맥락" 을 탐지하여 AI 시대에 진짜 중요한 질문에 답합니다.

"AI가 이 코드를 얼마나 안전하게 다룰 수 있는가?"

How It Works

  SCAN                  SCORE                  ACT
┌──────────┐         ┌──────────┐         ┌──────────┐
│  File /  │         │  6-Level │         │ Roadmap  │
│ Project  │  ───▶   │  Rating  │  ───▶   │ & Guide  │
│  Scan    │         │  Report  │         │          │
└──────────┘         └──────────┘         └──────────┘
     │                    │                    │
     ▼                    ▼                    ▼
 6 Analyzers        Hidden Context       Discover Context
 run in parallel    override check       → Ask user questions
                                         → Save answers
                                         → Safe refactoring

3단계 워크플로우: 코드를 스캔하고 → 6단계 척도로 채점하고 → 개선 로드맵과 리팩토링 가이드를 제공합니다. 핵심은 숨은 맥락 탐지: 매직 넘버, 설명 없는 예외 처리, 순서 의존성 등 AI가 "이해했다"고 착각하고 수정했다가 장애가 나는 원인을 사전에 찾아냅니다.

AI Comprehensibility Scale

 Level 1          Level 2          Level 3          Level 4          Level 5          Level 6
┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│  Well-  │    │ Mostly  │    │  Mixed  │    │  Diffi- │    │ Hidden  │    │ Incomp- │
│organized│    │  good   │    │patterns │    │  cult   │    │ context │    │rehensib.│
└─────────┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘
  AI가 바로       부분적          패턴 혼재,       강결합,         코드 외부         의도 파악
  이해 가능       정리 필요       시간 필요        규칙 없음       지식 필요         자체 불가

6 Analysis Dimensions

Hidden Context Override: hiddenContext >= 0.7 → 무조건 Level 6, >= 0.5 → 최소 Level 5. 다른 차원이 아무리 좋아도 숨은 맥락이 있으면 안전하지 않습니다.

MCP Tools

MCP Prompts

Context Discovery Workflow

리팩토링 전에 AI가 모르는 것을 먼저 밝혀내는 워크플로우입니다.

  ┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
  │  scan_file  │     │  discover_  │     │    User     │     │   guide_    │
  │  분석 실행   │ ──▶ │   context   │ ──▶ │   answers   │ ──▶ │ refactoring │
  │             │     │  질문 생성   │     │  맥락 저장   │     │  안전 가이드  │
  └─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘

예시: discover_context가 if (userType === 3) 을 발견하면:

"Line 5의 숫자 3은 무슨 의미인가요? (비즈니스 규칙, 외부 시스템 코드, 특정 임계값 등)"

사용자가 "3 = 레거시 CRM의 프리미엄 유저 티어"라고 답하면, 이 맥락이 저장되어 리팩토링 시 AI가 해당 값을 함부로 변경하지 않습니다.

Slash Commands

Quick Start

# 마켓플레이스 추가 (최초 1회)
/plugin marketplace add giwonn/giwonn-plugins

# 플러그인 설치
/plugin → Discover → codeaware 검색 → 설치

git clone https://github.com/giwonn/codeaware
cd codeaware && bun install
claude mcp add codeaware -- bun run src/index.ts

{
  "mcpServers": {
    "codeaware": {
      "command": "bun",
      "args": ["run", "/path/to/codeaware/src/index.ts"]
    }
  }
}

Project Structure