마크다운 기반 소프트웨어 아키텍처 의사결정 및 리뷰 프레임워크
중간맛 분석
JavaScript 생태계용 마크다운 기반 ADR(Architectural Decision Record) 프레임워크입니다. Claude Code 플러그인, MCP 서버, 전통적 설정 등 세 가지 설치 방식을 지원하며, 난이도는 중상(3/5)입니다. 즉시 사용 가능하며, 공식 설정 가이드와 Loom 비디오 데모가 있습니다. 핵심 스택: Node.js ≥18, 마크다운, YAML 설정 파일.
이런 레포예요
이럴 때 쓰면 좋아요
- 팀의 아키텍처 결정을 마크다운으로 영구 기록하고 나중에 참조
- AI 어시스턴트와 협업하여 새 기능 또는 버전의 아키텍처를 다중 관점에서 리뷰
- pragmatic 모드로 신속한 프로토타입 개발 중에도 아키텍처 원칙 검증
핵심 기능
대안 대비 차별점
LLM 주도의 다중 관점 아키텍처 리뷰(보안·성능·확장성·유지보수성 등)와 pragmatic 모드를 통해 원칙과 실무의 균형을 자동으로 관리하며, 재정규화 프로세스로 리뷰 결과를 구현 계획으로 변환합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Node.js ≥18 (플러그인/MCP 설치 시)
- Claude Code, Cursor, 또는 GitHub Copilot/Codex 등 AI 어시스턴트
바로 시작하기
- Claude Code를 사용 중이면 플러그인 설치(권장):
/plugin marketplace add codenamev/ai-software-architect
/plugin install ai-software-architect@ai-software-architect
- 또는 MCP 서버 설치(Cursor 호환):
npm install -g ai-software-architect
-
또는 전통 설정(모든 AI 어시스턴트 지원): GitHub에서 복제:
https://github.com/codenamev/ai-software-architect -
아키텍처 설정 실행:
Setup ai-software-architect
- 첫 ADR 작성:
Create ADR for [의사결정 주제]
예: "Create ADR for PostgreSQL database choice"
- 아키텍처 리뷰 시작:
Start architecture review for [버전/기능]
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try codenamev/ai-software-architect
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「기획·설계」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/codenamev/ai-software-architect)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기