컨텍스트 생성 (브라운필드 역채움)
이미 존재하는 코드베이스를 6개의 읽기 전용 정찰 에이전트로 스캔해 프로젝트 상태 문서 일체를 자동으로 복원하는 codeArbiter 스킬입니다.
개발·코딩고급★ 145⑂ 7AI 점수 8/10마지막 업데이트: 2026. 9. 13.
무엇을 해주나
기존에 굴러가던 코드베이스(브라운필드)에 프로젝트 상태 문서가 없을 때, 추측 없이 문서를 역으로 채워 넣습니다.
- 사전 점검:
.codearbiter/CONTEXT.md에<!--INITIALIZED-->마커가 없고 의미 있는 소스가 존재하는지 확인합니다. 소스가 없으면decompose스킬로 넘깁니다. - 6개 정찰 병렬 실행: 기술 스택(A), 인프라/CI(B), 아키텍처(C), 보안 태세(D), 테스트(E), 데이터 모델(F)을 각각 읽기 전용 서브에이전트가 조사하고, 원본 코드가 아닌 "파일 경로 + 줄 번호 + 값 이름"만 담긴 보고서를 반환합니다.
- 합성 및 신뢰도 분류: HIGH(사실로 기록) / MEDIUM(추론 표기) / LOW(
[CONFIRM-NN]플레이스홀더)로 나눠 문서 초안을 작성합니다. - 갭 인터뷰: 정찰이 확신하지 못한 항목만 사용자에게 한 번에 하나씩 질문하고, 모호한 답변은 되물어 확정합니다.
- 기록 및 잠금:
CONTEXT.md,tech-stack.md,coding-standards.md,security-controls.md,open-questions.md,open-tasks.md,overrides.log(조건부release-targets.md)를 쓰고 초기화 마커로 잠급니다.
이런 분께 추천
- codeArbiter 플러그인을 이미 사용 중이고, 문서가 전혀 없는 레거시 저장소를 온보딩하려는 팀
- 오케스트레이터 컨텍스트에 원본 소스를 통째로 올리지 않고 대규모 코드베이스를 요약하고 싶은 분
- 비밀값 노출 없이(경로·줄 번호만) 보안 태세를 정리하고 싶은 분
주의:
.codearbiter/디렉터리 규약과{{PLUGIN_ROOT}}/hooks/taskwrite.py등 플러그인 내부 스크립트에 의존하므로, 이 스킬만 따로 떼어 쓰기는 어렵습니다.
활용 예시
- 문서 없는 5년 된 모노레포 온보딩 —
/create-context실행 → 정찰 6종이package.json,.github/workflows/,prisma/schema.prisma등을 훑어 기술 스택·빌드 명령·엔티티 목록이 담긴 초안 생성. - 세션 시작 시 자동 감지 —
CONTEXT.md는 있는데<!--INITIALIZED-->마커가 없는 상태로 세션을 열면 이 스킬로 자동 라우팅되어 미완성 초기화를 마무리. - 릴리스 타깃 자동 판별 — 루트에 매니페스트 1개와 CHANGELOG 1개만 있을 때
release-targets.md행을 HIGH 신뢰도로 작성하고, 애매하면 아예 쓰지 않고[CONFIRM-NN]으로 남김.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/arbiterForge/codeArbiter/HEAD/core/surface/skills/context-creation/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 arbiterForge/codeArbiter 의 core/surface/skills/context-creation 폴더를 내 ~/.claude/skills/context-creation/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/arbiterForge/codeArbiter.git && mkdir -p ~/.claude/skills/context-creation && cp -r codeArbiter/core/surface/skills/context-creation/* ~/.claude/skills/context-creation/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 작업할 디렉터리로 이동합니다.
- 저장소를 내려받습니다:
git clone https://github.com/arbiterForge/codeArbiter.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills/context-creation - 파일을 복사합니다:
cp -r codeArbiter/core/surface/skills/context-creation/* ~/.claude/skills/context-creation/ - 이 스킬은 codeArbiter 플러그인 전체(훅 스크립트
hooks/taskwrite.py,hooks/_releaselib.py,includes/cut-docs.md)에 의존하므로, 가능하면 저장소 README의 플러그인 설치 절차를 그대로 따라 전체를 설치하는 것을 권장합니다. - Claude Code를 재시작한 뒤, 문서가 없는 기존 저장소에서
/create-context를 실행하거나 "기존 코드베이스로 프로젝트 컨텍스트를 만들어줘"라고 요청합니다. - 정찰 결과를 검토하고,
[CONFIRM-NN]질문에 하나씩 답하면.codearbiter/폴더가 채워지고 초기화가 잠깁니다.
GitHub에서 원본 보기 ↗라이선스: AGPL-3.0