AI 코딩 규칙, 팀 자산으로 묶는 오픈소스

개인의 프롬프트 요령 수준에 머물던 AI 코딩 규칙을 팀 자산으로 끌어올리려는 오픈소스가 공개됐다. 티칼(Tikal)이 내놓은 ADLC 팀 스킬(ADLC Team Skills)은 클로드 코드(Claude Code)·코덱스(Codex)·커서(Cursor)·깃허브 코파일럿(GitHub Copilot) 등 서로 다른 코딩 에이전트가 하나의 팀 규범 문서를 읽고 움직이게 만드는 스킬 묶음이다. 깃허브(GitHub) 저장소 기준 별 92개, 커밋 71개이며 MIT 라이선스로 배포된다.

무슨 일인가

이 프로젝트가 겨냥한 문제는 분명하다. 혼자 쓰는 프롬프트 요령은 즉각 성과를 내지만, 같은 방식이 여러 사람에게 번지면 정리되지 않은 기술부채와 컨텍스트 부패, 리뷰가 불가능한 대형 변경 요청, 코드 주인이 사라지는 현상이 뒤따른다는 것이다. 개발진은 이제 속도는 해결된 문제이고 남은 병목은 신뢰와 검증이라고 정리한다.

해법의 방향은 규칙을 사람 머릿속이 아니라 저장소에 두는 것이다. 동반 저장소인 팀 AI 디렉티브(team-ai-directives)에는 팀의 헌법에 해당하는 원칙 문서와 규칙·페르소나·예시, 의사결정 기록 색인, 스킬 목록이 모두 버전 관리 상태로 담긴다. 에이전트가 매 세션 규칙을 새로 배우게 하는 대신, 규칙 파일이 세션이 열리는 순간 자동으로 시스템 프롬프트에 실리는 구조다.

핵심 짚어보기

설치는 npx 명령 한 줄로 끝난다. 전용 도구인 adlc-skills-cli는 스킬을 설치하는 데 그치지 않고 슬래시 명령을 함께 만들어 주며, 이벤트 정의 파일을 통해 9종 코딩 에이전트에 세션 시작 훅을 배선한다.

운영 흐름은 세 단계다. 팀 셋업 명령은 새 디렉티브 저장소를 만드는 방식, 기존 깃허브 저장소를 복제하는 방식, 이미 쓰던 로컬 경로를 연결하는 방식, 기존 설정을 검증만 하는 방식까지 네 가지 모드를 제공한다. 이어지는 헌법 작성 명령이 자리표시자를 실제 팀 원칙으로 바꾸고, 세션 시작마다 자동 실행되는 부팅 명령이 헌법과 결정 기록 색인, 스킬 레지스트리를 하나의 프롬프트로 조립한다. 미션 브리프 기능은 외부 스킬 저장소까지 자동으로 훑어 파이프라인에 끌어오기 때문에 특정 벤더에 묶이지 않는다는 점을 내세운다.

1인기업 실전 적용 포인트

• 1인기업에 팀은 없지만 지난달의 나와 오늘의 나는 사실상 다른 작업자다. 말투·금칙어·배포 절차·검수 기준을 CLAUDE.md 또는 AGENTS.md 한 장에 고정하고 세션 시작 훅으로 자동 주입하면, 같은 지시를 매번 다시 타이핑하는 시간이 통째로 사라진다.
• 규칙 저장소를 딱 하나만 두고 프로젝트마다 서브모듈이나 심볼릭 링크로 끌어다 쓰면, 클로드 코드에서 고친 규칙이 커서·코덱스 작업에도 그대로 적용된다. 도구를 갈아탈 때 규칙을 다시 쓰는 비용이 거의 0이 된다.
• 코드가 아닌 콘텐츠 업무에도 그대로 옮겨진다. 실명 노출 금지, 첫 문장은 사람이 직접 손보기 같은 발행 원칙을 헌법 문서에 열 줄로 못 박아 두면 자동 발행 파이프라인이 매일 같은 기준으로 돈다.
• 설치는 5분이지만 값어치는 문서를 채우는 30분에서 나온다. 원칙 10줄, 금지 5줄, 검수 체크 3줄로 시작하는 편이 완벽한 문서를 다음 달로 미루는 것보다 낫다.

전망 / 주의점

주의할 점도 있다. 규칙 문서를 세션마다 자동으로 싣는 방식은 그만큼 컨텍스트를 소비한다. 문서가 길어질수록 매 세션 토큰 비용이 늘고, 정작 중요한 지시가 장황한 규범 사이에 묻힐 수 있다. 규칙은 길이가 아니라 밀도로 관리해야 한다. 에이전트 스킬 규격과 훅 방식 자체가 아직 빠르게 바뀌는 영역이라는 점도 감안해야 한다.

그럼에도 흐름은 뚜렷해 보인다. 코딩 에이전트 경쟁의 초점이 모델 성능 자체에서 규율과 검증 쪽으로 옮겨가고 있고, 혼자 일하는 사람일수록 자기 규칙을 파일로 남겨 둔 쪽이 오래 버틴다.

출처: 해커뉴스 경유 — 깃허브 tikalk/adlc-team-skills (https://github.com/tikalk/adlc-team-skills)