Agent skills that bring team coding standards to Claude Code and Codex

개요

ADLC Team Skills는 AI 에이전트가 팀의 코딩 표준, 제품 전략, 아키텍처 표준 및 평가 기준을 공유하는 개인적인 추측기에서 규정을 준수하고 책임감 있는 팀 구성원으로 전환되도록 돕는 오픈소스 도구입니다. 이를 통해 "바이브 코딩"으로 인한 기술 부채, 컨텍스트 손상, 검토 불가한 PR, 코드 소유권 상실 문제를 해결하고 AI 엔지니어링의 속도 병목 현상을 신뢰 및 검증 문제로 전환합니다.

주요 내용

* "바이브 코딩" 문제점 해결: 개인 개발자의 즉각적인 이점과 달리 팀 전체에서 "바이브 코딩"은 기술 부채, 컨텍스트 손상, 검토 불가 PR, 코드 소유권 상실과 같은 문제를 야기합니다. ADLC Team Skills는 이를 해결하기 위해 팀의 규정, 제품 전략, 아키텍처 표준 및 평가 기준을 공유하는 AI 에이전트를 만듭니다.
* ADLC Team Skills 및 Agentic SDLC: ADLC Team Skills는 Twelve-Factor Agentic SDLC의 오픈소스 팀 레이어이며, Team AI Directives(tikalk/agentic-sdlc-team-ai-directives) 리포지토리는 팀의 버전 관리 컨텍스트 모듈(헌법, 규칙, 페르소나, 예시), CDR 인덱스, 스킬 매니페스트를 포함합니다.
* 사용 편의성 및 호환성: npx adlc-skills-cli add tikalk/adlc-team-skills 명령을 통해 설치할 수 있으며, Claude Code, Codex, OpenCode, Cursor, GitHub Copilot 등 Agent Skills 표준을 지원하는 모든 에이전트와 즉시 작동합니다.
* 보편적 오케스트레이션: mission-brief는 모든 소스에서 스킬을 자동으로 검색하고 동적으로 미션 파이프라인에 연결하여 공급업체 종속성을 없앱니다.
* 팀 AI 디렉티브 설정: team-boot는 세션 시작 시 자동으로 실행되어 팀 헌법, CDR 인덱스, PDR/ADR 인덱스, 스킬 레지스트리를 시스템 프롬프트에 통합하며, team-setup 명령을 통해 새로운 팀 AI 디렉티브를 스캐폴드하거나 기존 리포지토리를 연결할 수 있습니다.
* ADLC 아키텍처의 네 가지 기둥:
* Pillar 1: Strategy & Team Directives: 팀 중심의 AI 전략을 위해 팀 헌법, CDR 인덱스 등을 버전 관리되는 Git 리포지토리에 저장하고, team-boot를 통해 세션 시작 시 자동으로 로드합니다.
* Pillar 2: Product Strategy & Architectural Governance: 제품 결정 기록(PDR)과 아키텍처 결정 기록(ADR)을 통해 제품 의도 및 아키텍처 규칙을 문서화하고 추적합니다.
* Pillar 3: Spec-Driven Workflow: "디버그 스펙, 코드 아님" 원칙에 따라, mission-brief를 통해 기능 프롬프트에서 계약을 도출하고, 명확한 목표, 제약 조건, 성공 기준을 정의하여 AI 에이전트의 불확실한 추측을 방지합니다.
* Pillar 4: Team Governance, Verification-First Evals: "만든 사람과 확인하는 사람을 분리"하여, AI 에이전트가 작성한 코드의 품질을 자체적으로 평가하지 않도록 합니다. evals 스킬과 LLM 판사를 활용하여 비즈니스 위험에 대해 코드를 테스트합니다.
* "Build to Delete": 오래된 규칙과 프롬프트 스캐폴딩을 제거하여 모델 개선에 맞춰 시스템을 지속적으로 최적화합니다.
* 다중 리포지토리 워크스페이스: workspace 스킬은 여러 리포지토리를 통합하여 PDR, ADR, CDR을 공유하고 일관된 컨텍스트를 제공합니다.
* OKF 규정 준수: 생성된 컨텍스트 모듈은 Open Knowledge Format (OKF) v0.1 규격을 준수하며, 사용자 정의 필드와 함께 사용됩니다.
* 워크플로우 자동화: 팀 디렉티브 설정, 제품/아키텍처/레벨업 라이프사이클 관리, 미션 실행, 다중 리포지토리 워크스페이스 설정, 애플리케이션 평가 등 다양한 워크플로우를 자동화합니다.

시사점

ADLC Team Skills는 AI 에이전트가 팀의 개발 표준을 내재화하고 협업에 더욱 효과적으로 기여할 수 있도록 함으로써, AI 기반 소프트웨어 개발의 신뢰성, 효율성 및 확장성을 크게 향상시킬 수 있는 프레임워크를 제공합니다. 이는 "바이브 코딩"의 단점을 극복하고 AI 에이전트 개발의 새로운 시대를 열 가능성을 시사합니다.