개발 & 프로그래밍/AI

Microsoft Amplifier - Specialized AI agents

Jiung. 2025. 10. 16. 16:58
반응형

Amplifier: 설치부터 활용까지, AI 개발 환경 강화 가이드

AI 코딩 어시스턴트는 이제 많은 개발자에게 필수 도구가 되었습니다. 하지만 세션이 길어지면 맥락을 잃거나, 여러 프로젝트에 걸쳐 일관된 지침을 적용하기 어려운 등 한계에 부딪히기도 합니다. Amplifier는 바로 이런 문제들을 해결하기 위해 설계된 강화된 개발 환경입니다.

이 가이드에서는 Amplifier가 무엇인지, 어떻게 설치하고 기존 프로젝트에 안전하게 적용하여 개발 생산성을 높일 수 있는지 단계별로 알아보겠습니다.

Amplifier란 무엇인가?

Amplifier는 일반 AI 코딩 어시스턴트를 전문가 팀, 축적 가능한 지식, 강력한 자동화 시스템으로 슈퍼차지하는 통합 개발 환경입니다. 매번 새로운 세션에서 처음부터 시작하는 대신, Amplifier는 검증된 패턴과 전문 에이전트, 워크플로우를 즉시 제공하여 복잡한 솔루션을 최소한의 지시로 구현할 수 있도록 돕습니다.

  • 20개 이상의 전문 에이전트: bug-hunter(디버깅), zen-architect(설계) 등 특정 작업에 특화된 에이전트 제공
  • 지식 베이스 시스템: 프로젝트 문서, 메모 등을 학습시켜 AI가 쿼리할 수 있는 영구적인 지식으로 축적
  • 병렬 워크트리 시스템: 여러 아이디어나 해결책을 동시에 빌드하고 테스트
  • 자동화 도구: 코드 품질 검사, 대화 기록 자동 저장 및 복원 등

1단계: 설치 및 환경 설정 (QuickStart)

Amplifier를 사용하기 위해 필요한 도구들을 확인하고 설치합니다.

설치 여부 확인

  • python3 --version # 3.11 이상 필요
  • uv --version # 버전 무관
  • node --version # 버전 무관
  • pnpm --version # 버전 무관
  • git --version # 버전 무관

필요한 도구 설치

Mac

brew install python3 node git pnpm uv

 

Ubuntu/Debian/WSL

# 시스템 패키지
sudo apt update && sudo apt install -y python3 python3-pip nodejs npm git

# pnpm
npm install -g pnpm
pnpm setup && source ~/.bashrc

# uv (Python 패키지 매니저)
curl -LsSf https://astral.sh/uv/install.sh | sh

 

Windows

  1. WSL2를 설치합니다.
  2. WSL 환경에서 위의 Ubuntu 명령어를 실행합니다.

Amplifier 설정

# 1. 저장소 복제 및 디렉토리 이동
git clone https://github.com/microsoft/amplifier.git
cd amplifier

# 2. Python 의존성 설치
make install

# 3. 가상 환경 활성화
source .venv/bin/activate # Linux/Mac/WSL
# .venv\Scripts\Activate.ps1 # Windows PowerShell

2단계: 프로젝트에 적용하기 (심볼릭 링크 사용)

Amplifier의 가장 큰 장점은 원본 프로젝트 파일을 그대로 유지하면서 모든 기능을 사용할 수 있다는 점입니다. 이는 '심볼릭 링크'(바로 가기)를 통해 가능합니다.

    1. Amplifier 디렉토리로 이동합니다. (이미 amplifier 디렉토리에 있다면 이 단계는 생략) 
      cd ~/amplifier
    2. 작업할 프로젝트의 심볼릭 링크를 ai_working/ 디렉토리 내에 생성합니다. 
      # 예시: /path/to/my/project 경로에 있는 내 프로젝트를 연결
ln -s /path/to/my/project ai_working/my-project-link
    3. Amplifier 디렉토리에서 Claude Code를 실행합니다. 
      claude
    4. Claude Code 세션에서 작업할 프로젝트를 명시합니다.
I'm working in ai_working/my-project-link, and using the capabilities from amplifier.

 

중요: 심볼릭 링크를 통해 파일을 수정, 생성, 삭제하면 원본 프로젝트에 직접 반영됩니다. 따라서 항상 Git으로 변경 사항을 추적하는 것이 안전합니다.

3단계: 주요 기능 활용하기

전문 에이전트 호출

단순 요청 대신, 특정 역할의 에이전트를 지정하여 더 전문적인 결과물을 얻을 수 있습니다.

"Use the zen-architect agent to design my application's caching layer."
"Deploy bug-hunter to find why my login system is failing."

 

지식 베이스 구축 및 활용

프로젝트 관련 문서를 추가하고 make knowledge-update 명령어를 실행하면, Amplifier는 해당 내용을 분석하여 개념과 관계

를 추출합니다. 이 과정이 반복될수록 AI가 참고할 수 있는 지식이 복리(compounds)처럼 쌓여 프로젝트에 대한 더 깊은 이해를 갖게 됩니다. 이것이 "시간이 지날수록 똑똑해지는" 이유입니다.

  1. 지식 베이스 업데이트: (프로젝트의 docs/, specs/ 등 문서를 추가한 후 실행) 
    make knowledge-update
  2. 축적된 지식 쿼리: 
    make knowledge-query Q="authentication patterns"

FAQ

Q1: 심볼릭 링크와 파일 복사의 차이점은 무엇인가요?

  • 심볼릭 링크: 원본 파일을 가리키는 '바로 가기'입니다. 디스크 공간을 거의 차지하지 않으며, 링크를 통해 수정하면 원본이 즉시 변경됩니다.
  • 복사: 파일을 완전히 복제합니다. 디스크 공간을 2배로 사용하며, 원본과 복사본은 서로 영향을 주지 않습니다.

Q2: 여러 프로젝트를 동시에 연결할 수 있나요?
네, 가능합니다. ai_working/ 디렉토리에 여러 개의 심볼릭 링크를 생성하면 됩니다.

ln -s ~/project-a ai_working/project-a
ln -s ~/project-b ai_working/project-b

 

Q3: 여러 프로젝트가 연결된 상태에서 특정 프로젝트만 작업하려면 어떻게 해야 하나요?
항상 ~/amplifier 디렉토리에서 claude를 실행한 후, 세션 시작 시 작업할 프로젝트를 명확히 지정해야 합니다.

"I'm working only in ai_working/project-a/. Please don't modify other projects."

 

주의: 심볼릭 링크가 있는 디렉토리(~/amplifier/ai_working/project-a)로 직접 이동해서 claude를 실행하면 Amplifier의 기능(.claude/ 설정)을 사용할 수 없습니다.

 

Q4: 심볼릭 링크를 안전하게 제거하려면 어떻게 하나요?
rm 명령어로 링크 파일만 제거하면 됩니다. 원본 프로젝트는 안전하게 유지됩니다.

# 링크만 삭제 (안전)
rm ai_working/my-project-link

# ⚠️ 절대 이렇게 사용하지 마세요 (원본 디렉토리 내용까지 삭제될 수 있음)
# rm -rf ai_working/my-project-link/

추가 참고 자료

반응형
저작자표시 비영리 변경금지 (새창열림)