DanhDue/architecture-audit

architecture-audit은(는) 무엇을 하나요?

에이전트 기술 'architecture-audit' (DanhDue/ai-agent-tools 제공)

이 기술은 프로젝트의 소프트웨어 아키텍처를 자동으로 감사하고 분석합니다. 설계 패턴, 종속성, 모듈 구조 등을 검토하여 잠재적인 문제점을 찾아냅니다.

주요 기능

• 아키텍처 검토: 코드베이스의 전체적인 구조와 설계 원칙 준수 여부를 확인합니다.
• 종속성 분석: 모듈 간 종속성 그래프를 생성하고 순환 참조를 감지합니다.
• 패턴 준수 검사: 권장 설계 패턴(예: 레이어드 아키텍처, 클린 아키텍처)이 제대로 적용되었는지 확인합니다.
• 기술 부채 식별: 아키텍처 수준의 기술 부채와 개선 영역을 파악합니다.

사용 방법

에이전트에게 다음과 같이 요청할 수 있습니다:

# 전체 프로젝트 아키텍처 감사 실행
architecture-audit --path ./

# 특정 모듈만 감사
architecture-audit --path ./src --module core

지원 환경

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트 (파일 시스템 접근 권한 필요)

출력 형식

감사 결과는 마크다운 보고서로 제공되며, 다음 섹션을 포함합니다:

1. 요약 – 전체 아키텍처 건강 상태
2. 종속성 분석 – 모듈별 종속성 리스트
3. 위반 사항 – 발견된 아키텍처 규칙 위반
4. 권장 사항 – 개선을 위한 구체적인 제안

예시

{
  "summary": {
    "status": "경고",
    "issues": 3,
    "recommendations": [
      "순환 종속성 해결 필요",
      "레이어 간 직접 참조 제거"
    ]
  }
}

참고: 이 기술은 프로젝트 소스 코드를 읽기 전용으로 분석합니다. 중요한 리팩토링을 수행하기 전에 검토 도구로 사용하세요.

라이선스

MIT