간략한 요약
이 비디오에서는 클라우드 코드 설정을 감사하고 개선하는 데 도움이 되는 Claudit이라는 에이전트 기술을 소개합니다. Claudit은 오래된 설정, 중복된 콘텐츠, 비효율적인 구성을 식별하여 클라우드 MD 파일의 품질과 효율성을 향상시킵니다.
- Claudit은 4단계 감사 접근 방식을 사용합니다.
- Claudit은 클라우드 MD 파일의 과도한 엔지니어링, 중복 콘텐츠, 오래된 참조를 식별합니다.
- Claudit은 권장 사항을 제공하고 대화형 개선 루프를 통해 문제를 해결합니다.
Claudit 실행 후 발견한 점
Claudit을 실행한 결과, 인지하지 못했던 새로운 기능과 문제가 있는 부분을 발견했습니다. 클라우드 MD 파일을 설정한 후 잊어버리거나 시간이 지남에 따라 중복된 설정, 불필요한 호출, 장황한 콘텐츠가 쌓여 컨텍스트 낭비와 컨텍스트 손상을 초래할 수 있습니다.
설정 후 잊어버리는 CLAUDE.md 파일의 문제점
대부분의 사용자는 클라우드 MD 파일을 한 번 설정한 후 잊어버리거나 시간이 지남에 따라 설정을 추가합니다. 시간이 지나면서 중복된 설정, 불필요한 호출, 장황한 콘텐츠가 쌓여 컨텍스트 낭비와 컨텍스트 손상을 초래할 수 있습니다.
Claudit이란 무엇인가?
Claudit은 Anthony Castano가 개발한 플러그인으로, 클라우드 설정을 종합적으로 감사합니다. Claudit은 과도한 엔지니어링, 장황한 클라우드 MD 파일, 과도한 후크, MCP 확산 등을 찾아냅니다. 또한, 감사 실행 간에 결과를 저장하는 지속적인 메모리를 사용하여 시간이 지남에 따라 속도와 정확성을 향상시킵니다.
4단계 감사 접근 방식 설명
Claudit은 4단계 접근 방식을 사용합니다. 첫째, 세 개의 연구 에이전트를 가동하여 공식 Anthropic 문서를 가져옵니다. 둘째, 세 개의 감사 에이전트를 가동하여 글로벌 구성, 프로젝트 구성, 에코시스템 구성을 분석합니다. 셋째, 결과를 종합하여 점수를 제공합니다. 마지막으로, 권장 사항을 선택하여 적용할 수 있는 대화형 개선 루프를 제공합니다. 변경 사항을 선택하면 완료 후 이전 및 이후 점수를 보여줍니다.
1단계: 연구 에이전트가 최신 Anthropic 문서를 가져옴
Claudit의 첫 번째 단계는 세 개의 연구 에이전트를 사용하여 최신 Anthropic 문서를 가져오는 것입니다. 이를 통해 각 감사 실행 시 최신 자료를 참조하고, 최신 모범 사례를 따르고 있는지 확인하고, 누락되었을 수 있는 새로운 기능을 식별할 수 있습니다.
2단계: 감사 에이전트가 구성을 분석함
두 번째 단계에서는 세 개의 감사 에이전트가 글로벌 구성, 프로젝트 구성, 에코시스템 구성을 분석합니다. 이들은 연구를 통해 얻은 전문 지식을 바탕으로 구성을 분석합니다.
데모: Claudit 설치 및 실행
Claudit 플러그인을 설치하고 개인 클라우드 코드 프로젝트에서 실행하는 방법을 보여줍니다. 먼저 플러그인 마켓플레이스를 추가하고, 플러그인을 설치한 다음, 클라우드 코드를 다시 시작하여 세션에서 사용할 수 있도록 합니다. 그런 다음 /cloud 명령을 실행하여 감사를 시작합니다.
1단계 및 2단계 실행
Claudit은 먼저 위치와 사용자 정의 구성을 찾습니다. 그런 다음 3개의 에이전트를 사용하여 연구를 수행하는 1단계를 시작합니다. 연구 코어, 연구 에코시스템, 연구 최적화 에이전트가 기존 Anthropic 문서를 감사합니다. 1단계가 완료되면 2단계로 이동하여 연구를 통해 얻은 지식을 바탕으로 구성을 분석합니다. 2단계에서는 글로벌 감사, 프로젝트 감사, 에코시스템 감사를 수행하는 3개의 연구 에이전트가 시작됩니다.
감사 보고서 읽기 및 점수 분석
Claudit은 보고서를 제공합니다. 보고서에는 과도한 엔지니어링, 클라우드 MD 품질, 보안 태세, MCP 구성, 플러그인 상태, 컨텍스트 효율성에 대한 점수가 포함됩니다. 클라우드 MD 파일이 크고, 내장 기능이 다시 명시되어 있고, 중복된 지침이 있으며, 지침 충돌이 있습니다. 시각적 보고서를 통해 상태를 쉽게 확인할 수 있습니다.
과도한 엔지니어링 결과 (449줄, 32% 낭비)
클라우드 MD 파일은 449줄로, 3,566개의 토큰을 포함합니다. 이는 커뮤니티 표준인 50~100줄, 2,500개의 토큰을 훨씬 초과합니다. 분석에 따르면 콘텐츠의 약 32%가 불필요합니다. 8개의 다시 명시된 내장 기능, 4개의 중복된 중복, 지침 충돌, 2개의 오래된 참조가 있습니다.
중복 콘텐츠 및 지침 충돌
클라우드 MD 파일에 중복된 콘텐츠가 있습니다. RSpec 테스트 기술 설명이 두 섹션에 설명되어 있고, docs thoughtbot conventions MD가 세 번 참조되고, bin lint 지침이 여러 번 나타납니다. 379행에서는 예상되는 실패에 대해 결과 패턴을 사용하라고 하지만, 247~285행에서는 드물게 사용하고 대신 Rails 규칙을 기본값으로 사용하라고 합니다.
오래된 참조 및 누락된 기술
오래된 참조는 개발자에게 혼란을 야기합니다. get workree manager 기술이 참조되지만 실제로 존재하지 않고, linear implement 기술 명령이 참조되지만 명령 파일이 없습니다. 테스트를 위해 생성된 임시 클라우드 MD 파일이 모든 세션에 삽입되고 있습니다.
권장 사항 및 대화형 개선 루프
Claudit은 클라우드 MD 파일 정리, 다시 명시된 내장 기능 제거, RSpec 테스트 섹션 중복 제거, 오류 처리 섹션을 참조 링크로 대체, get work tree manager 및 linear scale 참조 수정, 결과 패턴 충돌 해결, 임시 클라우드 MD 파일 제거 및 지우기 등의 권장 사항을 제공합니다. 또한, MCP 서버에 대한 시간 초과 추가, linear MCP를 HTTP로 업데이트, 5개의 발견되지 않은 기술 문서화 등의 권장 사항도 제공합니다.
수정 사항 적용 및 이전/이후 점수 (76에서 90으로)
권장 사항을 선택하여 적용하면 Claudit이 변경 사항을 적용합니다. 과도한 엔지니어링 점수가 15에서 70으로, 클라우드 MD 품질이 80에서 100으로 향상되었습니다. 전체 점수는 76에서 90으로 상승했습니다. 변경 사항 요약과 해결해야 할 나머지 문제가 표시됩니다.
마무리 및 다음 단계
시간이 지남에 따라 클라우드 MD 파일에 불필요한 부분이 쌓일 수 있습니다. Claudit을 사용하면 쉽게 정리할 수 있습니다. 보고서를 실행하고 변경 사항을 적용하십시오.
