설정
플러그인 사용해보기
Engineering 플러그인은 시작점으로 /documentation을 제공하며, 연결된 소스 전체로 확장되고, 찾은 내용을 인용하고, 확신이 없을 때는 담당자를 지정하도록 이미 구성되어 있습니다. 관리자가 플러그인을 관리하고 있고 아직 사용할 수 없다면 이 단계는 건너뛰세요. 아래 내용 중 이것이 필요한 것은 없습니다.
/documentationWrite and maintain technical documentation./architectureCreate or evaluate an architecture decision record (ADR).도구 연결하기
Claude Cowork는 여러분의 시스템과 직접 연동될 때 더욱 강력해집니다. 권한과 접근 권한은 여러분이 직접 관리합니다. 도구 접근 권한에 대해 알아보기(새 탭에서 열림).
설정하려면 Cowork에서 사용자 설정 → 커넥터로 이동하세요.
'%20d='M.87%2018.26c-.25.4-.52.87-.75%201.23a.75.75%200%200%200%20.25%201.02l4.96%203.05a.75.75%200%200%200%201.04-.25c.2-.33.45-.76.73-1.21%201.95-3.22%203.91-2.83%207.45-1.14l4.92%202.34a.75.75%200%200%200%201-.36l2.36-5.34a.75.75%200%200%200-.38-.98c-1.04-.49-3.1-1.46-4.96-2.36-6.68-3.24-12.36-3.03-16.62%204Z'/%3e%3cpath%20fill='url(%23cfB)'%20d='M23.13%205.74c.25-.4.52-.87.75-1.23a.75.75%200%200%200-.25-1.02L18.67.44a.75.75%200%200%200-1.04.25c-.2.33-.45.76-.73%201.21-1.95%203.22-3.91%202.83-7.45%201.14L4.53.7a.75.75%200%200%200-1%20.36L1.17%206.4a.75.75%200%200%200%20.38.98c1.04.49%203.1%201.46%204.96%202.36%206.68%203.24%2012.36%203.03%2016.62-4Z'/%3e%3c/svg%3e)
작업 폴더 설정하기
에이전트의 기준이 되는 파일들(서비스 카탈로그 내보내기, 팀 디렉터리, 용어집, "어디서 무엇을 찾을지" 온보딩 문서)을 하나의 폴더로 드래그하고 Cowork가 그 폴더를 가리키도록 설정하세요. 이 파일들은 에이전트가 다른 곳을 검색하기 전에 참고하는 라우팅 테이블이 됩니다. 해당 폴더로부터 Cowork 프로젝트를 생성(새 탭에서 열림)하면 에이전트가 발전해도 카탈로그와 기본 규칙이 계속 연결된 상태로 유지됩니다.
프롬프트
이것을 Claude Cowork에 복사하세요
엔지니어를 위한 내부 "무엇이든 물어보세요" 에이전트를 구축하세요. 누군가 "스테이징 API 키는 어떻게 받나요," "orders 테이블은 누가 소유하나요," 또는 "지난달 배포가 왜 느려졌나요"라고 물으면 우리 시스템 전체에서 답을 찾고, 출처를 인용하고, 확신이 없으면 누구에게 물어봐야 하는지 알려주세요. 먼저 좋은 답변 하나를 얻은 다음, 이를 공유 스킬로 만드세요.
이것이 효과적인 이유
각 질문 유형마다 예시를 제공하세요. 방법 질문, 소유권 조회, 지표 원인 질문: 엔지니어가 실제로 묻는 질문 유형을 다룹니다.
항상 출처를 인용하세요. 엔지니어는 글이 아니라 링크를 신뢰합니다. 인용은 답변을 검증 가능하게 만듭니다.
확신이 없을 때는 담당자를 지정하세요. "소유 팀 또는 채널"을 요청하면 Claude가 확신이 없을 때 의지할 수 있는 대안이 생깁니다. 검증해야 할 추측 대신 후속 조치를 취할 수 있는 단서를 얻게 됩니다.
참고 문서를 작업 폴더에 넣으세요. 서비스 카탈로그와 팀 디렉터리는 Cowork에게 어디를 찾아야 하고 누구를 가리켜야 하는지 알려줍니다.
더 나은 초안 얻기
맞춰볼 예시를 추가하세요. 마음에 드는 예시를 폴더에 넣으면 Cowork가 여러분의 구조와 어조에 맞춥니다.
불확실한 부분을 표시하도록 요청하세요. "확신이 없는 부분은 표시해 주세요"를 추가하면 초안을 검토할 때 어디를 먼저 봐야 할지 알 수 있습니다.
Cowork를 여러분에게 맞게 만들기
플러그인의 /documentation은 일반적인 시작점입니다. 2단계에서 세 가지 질문에 잘 답변하게 되면, Cowork에게 여러분만의 스킬 버전을 작성하도록 요청하세요. 먼저 검색할 스페이스와 리포지토리, "확신이 없음" 기준, 어조, 그리고 접근이 금지된 시스템을 추가하세요. 몇 분간의 대화만으로 그 이후부터 스킬이 여러분의 스택에 맞게 말하게 됩니다.
지금까지 이 작업에서 한 것을 스킬로 만들거나, 제 피드백을 반영해 /documentation 스킬을 수정해 주세요.
반복 가능하게 만들기
아티팩트로 공유하기
에이전트가 테스트 질문에 잘 답변하게 되면, 아티팩트로 게시하여 조직 내 누구나 하나의 링크로 질문할 수 있게 하세요. 아티팩트는 뒤에서 공유 스킬을 실행하며, 플랫폼 팀이 그 스킬을 소유하고 계속 조정합니다.
답변하지 못한 모든 질문 기록하기
에이전트가 어디서 부족한지 알면 더 나아집니다. /schedule을 입력하거나 Cowork 사이드바에서 예약된 작업을 열면, 매주 실행되어 답변하지 못한 질문을 폴더에 기록하므로 플랫폼 팀이 그 공백을 채울 수 있습니다.
/schedule 매주 금요일 오후 4시에, 이번 주 /documentation이 확신 있게 답변하지 못한 질문들을 나열하고, 주제별로 그룹화하여 각 질문에 제안된 담당자와 함께 Platform/ask-company/gaps-<week>.md에 기록하세요.
매주, 에이전트가 답변하지 못한 질문을 나열하고, 주제별로 그룹화하여 제안된 담당자와 함께 공백 보고서를 작성합니다.
팀원들과 공유하기
이제 맞춤화된 /documentation에는 여러분의 소스, 라우팅 테이블, 확신 규칙이 담겨 있습니다. 워크스페이스 전체에 공유하여 모든 엔지니어가 같은 방식으로 회사에 질문하게 하고, "어떻게 하나요…"에 대한 답이 채널에 누가 있는지에 더 이상 좌우되지 않게 하세요.