#DevOps

4개 파트가 하나의 AI 시스템을 공유하기

4개 파트가 하나의 AI 시스템을 공유하기
01

Summary

이모지 하나로 포스트모템 끝? 인프라팀이 6인 1조 AI 에이전트를 '길들이는' 법

2,000줄의 가이드라인과 26개 정책 파일로 완성한 초고속 DevOps AI 협업 시스템 구축기

본 아티클은 인프라팀 내 4개 파트가 하나의 AI 에이전트(Claude Code)를 유기적으로 공유하는 협업 방식을 다룹니다. 개인 편차와 온보딩 병목을 해결하기 위해 '정책 기반 시스템'을 설계하고, 장애 대응부터 인프라 표준 가이드 생성까지 자동화하는 구체적인 실천법과 아키텍처를 제시합니다.

  • 01온보딩 첫날 단 3분 만에 setup.sh 실행으로 팀의 전체 AI 컨텍스트 습득 완료
  • 02장애 쓰레드에 포스트모템 이모지 클릭 시 AWS Bedrock과 Notion API를 통해 5분 내 보고서 자동 생성
  • 03300개 이상의 Slack 메시지가 누적된 복잡한 쓰레드를 단 30초 만에 핵심 요약 및 액션 아이템 추출
  • 04공통 설정(수평)과 파트별 맞춤 설정(수직)을 조합한 유연한 AI 가이드라인 설계
  • 05VPC 연결성 체크리스트 정책화를 통해 복잡한 멀티 어카운트 VPN 구축 기간을 이틀로 단축

RECOMMENDATION

AI 코딩 및 협업 도구를 팀 단위로 도입하고자 하지만 답변의 일관성 부족과 활용 편차로 어려움을 겪는 테크 리더와 DevOps 엔지니어들에게 적극 추천합니다.

The Problem

인프라팀 내에서 AI 도구(Claude Code)를 도입했으나 엔지니어 간 활용 격차, 파편화된 답변 품질, 일관성 없는 장애 대응 및 긴 신규 입사자 온보딩 시간 등의 비효율이 발생했습니다.

The Solution

2,144줄의 공통 가이드(CLAUDE.md)와 26개의 세부 정책 파일로 구체적인 레일을 깔고, 쉘 스크립트(setup.sh) 기반의 수평·수직 결합형 아키텍처를 도입하여 AI 컨텍스트 공유 환경을 구축했습니다.

The Result

신규 팀원의 온보딩 시간이 단 3분으로 단축되었고, 300개 메시지의 Slack 장애 분석에 걸리는 시간이 30초로 줄었으며, 통상 한 달이 소요되던 Multi-Account VPN 구축을 이틀 만에 완수했습니다.

Trade-off

수천 줄의 정책 가이드라인과 26개에 달하는 정책 파일들을 일관되게 형상 관리(Git PR)하고 현행화해야 하는 운영 리소스가 지속적으로 요구되는 한계가 존재합니다.

03

Key Concepts

Concept · 01

CLAUDE.md

Claude Code 에이전트가 실행될 때 참조하는 최상위 설정 파일로, 프로젝트의 빌드, 테스트 명령어, 스타일 가이드 및 자동 실행 정책 등을 정의하는 핵심 컨텍스트 가이드라인입니다.

  • 2,144줄 규모의 파일에 Quick Commands, API 사용 정책, 커밋 컨벤션 등을 명시하여 일관된 AI 작동을 유도했습니다.
  • 읽기 작업은 자동 실행하고 쓰기 작업은 명시적 승인을 거치도록 안전장치를 마련했습니다.
Concept · 02

정책 기반 AI 시스템 (Policy-based AI)

AI 에이전트가 자의적으로 판단하지 않도록 팀의 축적된 노하우와 도메인 지식을 Markdown 형태의 세부 정책 파일로 구체화하여 제공하는 접근법입니다.

  • VPC 연결성 진단 절차나 장애 심각도 분류 기준 등을 26개의 세부 파일로 문서화했습니다.
  • 해결된 장애 패턴을 바탕으로 새로운 정책 파일을 지속적으로 기여 및 생산하는 선순환을 만들었습니다.
Concept · 03

수평·수직 정책 아키텍처

조직 전체가 합의한 공통 규칙(수평)과 각 서브 파트 고유의 전문적인 지식(수직)을 결합하여 가독성과 이식성을 극대화하는 구성 방식입니다.

  • Git 리포지토리에서 공통 정책을 관리하고, setup.sh 실행 시 사용자가 선택한 파트에 맞게 심볼릭 링크로 컨텍스트를 교체합니다.
  • 개인 보안 토큰과 같은 민감 정보는 로컬 전용 파일(.claude.local/)에 분리하여 환경 관리를 표준화했습니다.