왜 AI 코딩 에이전트는 아키텍처 컴파일러가 필요한가 (그리고 내가 직접 만들었다)

Source: Dev.to

아무도 이야기하지 않는 문제

AI 코딩 에이전트는 코드를 너무 빠르게 작성합니다. 몇 번의 세션만에 다음과 같은 상황이 됩니다:

• 유틸리티 함수가 기능 모듈을 호출하고 있음
• 기능 로직이 CLI 진입점에 얽혀 있음
• 세 층 깊이의 순환 의존성 발생
• 순수 함수 내부에서 데이터베이스 클라이언트가 인스턴스화됨

이런 문제를 잡아주는 린터도 없고, 포맷터가 고쳐주지도 않습니다. 코드베이스는 동작하지만 점점 유지보수가 어려워지고, 여러분을 돕는 에이전트는 구조적인 피드백을 제공하지 못합니다.

Atomadic Forge: 아키텍처 컴파일러

Atomadic Forge는 아키텍처 컴파일러입니다. Python 또는 JavaScript 레포지토리를 지정하면 다음을 수행합니다:

1. Scouts – 모든 심볼, 티어, 의존성, 언어를 매핑합니다.
2. Wires – 구성 법칙을 위반하는 모든 import를 찾아냅니다.
3. Certifies – 0‑100 점수와 SHA‑256 영수증을 부여합니다.
4. Enforces – 위반 사항을 제자리에서 자동 수정합니다(드라이런 안전).

MCP 서버로 실행되므로 Cursor, Claude Code 등에서 certify, wire, recon, enforce 및 25개 이상의 도구를 직접 호출할 수 있습니다.

티어 구조

a0_qk_constants/     # Zero logic. Pure data: constants, enums, TypedDicts.
a1_at_functions/       # Pure stateless functions. Only imports: a0.
a2_mo_composites/      # Stateful classes, clients, registries. Imports: a0 + a1.
a3_og_features/        # Features assembled from composites. Imports: a0‑a2.
a4_sy_orchestration/   # CLI, entry points, top‑level wiring. Imports: a0‑a3.

각 파일은 정확히 하나의 티어에만 속합니다. 티어는 위쪽으로만 구성됩니다.

사용 예시

forge certify --project ./my-ai-built-app
{
  "score": 47,
  "issues": [
    "a1 imports from a3: utils.py -> feature_pipeline.py (7 occurrences)",
    "circular dependency: auth_client  user_service",
    "a4 contains 340 lines of business logic (belongs in a2/a3)"
  ]
}

forge enforce --apply --source ./src
{
  "score": 91,
  "pre_violations": 34,
  "post_violations": 3,
  "auto_fixed": 31
}

설치

pip install atomadic-forge
forge certify --project .
forge wire --source ./src --suggest-repairs

MCP 설정

{
  "mcpServers": {
    "atomadic-forge": {
      "command": "forge",
      "args": ["mcp", "serve", "--project", "/your/project"],
      "env": { "FORGE_API_KEY": "your-key" },
      "type": "stdio"
    }
  }
}

한눈에 보는 기능

• 944개의 테스트(단위, 통합, MCP 프로토콜, stdio 루프)
• 표준 MCP 도구 29개 / Forge Deluxe에 포함된 도구 35개
• Python 및 TypeScript/JavaScript 지원
• 라이브 데모: 공개 레포를 무료로 스캔
• 오픈 소스

댓글에 질문을 남겨 주세요—모두 읽습니다.