ArcKit: 엔터프라이즈 아키텍처 거버넌스 하네스

GitHub Forks

License: MIT

Latest Release

GitHub Issues

구조화된 전략, 설계, 전달 및 보증 워크플로우를 통해 더 나은 엔터프라이즈 아키텍처를 구축하세요.

ArcKit은 엔터프라이즈 아키텍트(enterprise architects)를 위한 툴킷으로, 아키텍처 거버넌스(architecture governance)를 산재된 문서에서 체계적이고 AI 지원 워크플로우로 전환합니다. 이 워크플로우는 다음을 위해 사용됩니다:

• 🏛️ 아키텍처 원칙 수립 및 강제 적용
• 👥 이해관계자 동인(stakeholder drivers), 목표 및 결과 분석
• 🛡️ 리스크 관리 (HM Treasury Orange Book)
• 💼 비즈니스 사례 정당화 (HM Treasury Green Book SOBC)
• 📋 포괄적인 요구사항 문서 작성
• 🗄️ ERD를 사용한 데이터 모델링, GDPR 준수 및 데이터 거버넌스
• 🔬 빌드 대 구매 분석(build vs buy analysis)을 통한 기술 연구 (웹 검색 기반)
• ☁️ 권위 있는 문서를 위해 Microsoft Learn MCP를 사용하는 Azure 특정 연구
• 🗺️ Wardley Mapping을 사용한 전략적 계획 수립
• 📊 시각적인 아키텍처 다이어그램 생성 (Mermaid)
• 🤝 공급업체 RFP 및 선정 프로세스 관리
• ✅ 공식 설계 검토 수행 (HLD/DLD)
• 🔧 ServiceNow 서비스 관리 설계
• 🔗 요구사항 추적성 유지
• 📎 외부 문서를 위한 인용 추적성 (인라인 [DOC-CN] 마커와 출처 인용 포함)

ArcKit은 자격 있는 사람이 검토할 수 있는 초안(DRAFT) 아티팩트를 생성하며, 법률적, 규제적, 임상적 또는 보안 자문을 제공하지 않습니다. ArcKit이 하지 않는 것을 참조하세요.

먼저 시청하기

ArcKit에 익숙하지 않거나 코딩 어시스턴트를 사용하지 않는 사람에게 설명해야 한다면, 필름으로 시작하세요:

• ArcKit explained: ArcKit이 무엇이며, AI가 초안 작성한 아키텍처 문서를 어떻게 검토 가능하게 유지하는지 8분 이내로 설명합니다.
• ArcKit for Beginners: 가상의 위원회 프로젝트를 따라가며, 아키텍처 원칙부터 출시 결정까지 다룹니다. 총 1시간 분량이며, 네 개의 짧은 파트로 구성되어 있습니다.
• ArcKit commands: 각 명령어에 대해 약 1분 30초 길이의 영상을 제공합니다. 해당 명령어가 무엇을 위한 것인지, 언제 실행해야 하는지, 그리고 어떤 결과물을 생성하는지를 보여줍니다.

ArcKit YouTube 채널에는 각 오버레이별 플레이리스트도 있습니다. 내레이션은 AI가 생성했으며, 영상들은 실험적인 성격이 강합니다. Discord에서 다음에 다뤄줬으면 하는 내용을 알려주세요.

빠른 시작 (Quick Start)

설치 (Installation)

Claude Code (프리미어 경험) — ArcKit 플러그인을 설치합니다 (v2.1.287+ 필요):

먼저, Claude Code가 최신 버전인지 확인하세요:

claude install latest

그런 다음 Claude Code에서:

/plugin marketplace add tractorjuice/arckit-claude

'Discover' 탭이나 CLI를 통해 설치할 수 있습니다. 마켓플레이스에는 17개의 플러그인이 제공되므로, 필요한 오버레이만 설치하세요:

# Core (76개 명령어 — 영국 정부 민간 + 일반 엔터프라이즈)
claude plugin install arckit@arckit-claude

...

독립적인 tractorjuice/arckit-claude 마켓플레이스는 모든 Claude Code 플러그인을 호스팅합니다: 핵심 arckit 플러그인, 지역 오버레이(regional overlays), 섹터 오버레이(sector overlays), TOGAF ADM 및 AI 에이전트 아키텍처 오버레이, arckit-fde 툴링 플러그인, 그리고 공개적이지만 독점적인 arckit-uk-gcloud 공급업체 오버레이가 포함됩니다. 14개의 커뮤니티 플러그인(arckit-uae, arckit-fr, arckit-ca, arckit-eu, arckit-at, arckit-au, arckit-au-energy, arckit-us, arckit-uk-finance, arckit-uk-nhs, arckit-uk-gcloud, arckit-togaf-adm, arckit-agent-architecture, arckit-oaa)는 arckit 핵심 플러그인을 요구합니다. arckit-au-energy(섹터)는 추가적으로 arckit-au(관할권)를 필요로 하며, 이를 구성(composes)합니다 — 다음 명령어로 설치합니다: claude plugin install arckit arckit-au arckit-au-energy. arckit-uk-gcloud는 독점적이며 Claude Code 전용의 공급업체 측 G-Cloud 입찰 작성 오버레이입니다 — 설치와 검사에는 공개되어 있지만, MIT 라이선스가 아니며 비(非)Claude 확장 형식으로 배포되지 않습니다. 툴링 플러그인 중 하나인 arckit-fde는 간결하고 Claude Code 전용의 플러그인으로, /arckit-fde:create라는 하나의 명령어를 통해 영국 공공 부문 및 일반 시장 프리셋을 포함하는 브랜드화 가능한(white-label) Forward Deploy Engineering 컨설팅 웹사이트를 docs/(GitHub Pages 준비 완료)에 생성합니다. 의존성은 없으며, 비(非)Claude 형식으로 변환되지 않고, 거버넌스 문서 유형도 없습니다.

이전 버전인 tractorjuice/arc-kit 마켓플레이스는 호환성을 위해 계속 사용할 수 있지만, 새로운 Claude Code 설치는 tractorjuice/arckit-claude를 사용해야 합니다. Claude Code는 ArcKit의 주요 개발 플랫폼이며 가장 완벽한 경험을 제공합니다: 모든 공식 명령어, 자율 연구 에이전트(autonomous research agents), 자동화 후크(automation hooks), 번들된 MCP 서버(AWS Knowledge, Microsoft Learn, Google Developer Knowledge, govreposcrape, uk-tenders) 및 마켓플레이스를 통한 자동 업데이트가 포함됩니다. 아래 Claude Code를 사용하는 이유?를 참조하십시오.

v2.1.287 버전이 필요한 이유? 이 버전은 프롬프트 위에 상태 표시줄을 표시하는 데 ArcKit이 사용하는 Claude mods를 추가합니다. 이 상태 표시줄에는 프로젝트 및 아티팩트 개수, DRAFT 상태인 개수, 그리고 기한이 지난 검토 건수가 표시됩니다. 또한, 새 클라우드 세션에서 실행되지 않던 플러그인 SessionStart 훅을 수정하여, 해당 훅이 ArcKit의 세션 설정 및 버전 확인 과정을 건너뛰는 문제를 해결했습니다.

아래에는 ArcKit이 의존하는 이전 릴리스들도 포함되어 있습니다:

모델 (Models)

• v2.1.284에서는 Anthropic API의 기본 Sonnet 모델인 Claude Sonnet 5.5 (claude-sonnet-5-5)를 1M 컨텍스트와 함께 추가했습니다. 이전 클라이언트는 이 모델을 선택할 수 없습니다. Opus 5.5와 마찬가지로 항상 생각하는(always thinks) 특성을 가지며 기본값이 effort: medium으로 설정되므로, ArcKit의 effort: max 명령은 해당 모델에서 max로 실행됩니다.
• v2.1.280에서는 기본 Opus 모델인 Claude Opus 5.5 (claude-opus-5-5)를 추가했습니다. 이 모델 역시 항상 생각하는 특성을 가지므로, 생각이 꺼진(thinking off) 세션에서 ArcKit의 effort: max 명령이 더 이상 조용히 high로 전송될 수 없게 되었으며, 각 아티팩트 빌드 출처(Build Provenance)의 Effective Effort 행이 정확해졌습니다.
• v2.1.219에서는 1M 컨텍스트와 빠른 모드를 가진 Claude Opus 5 (claude-opus-5)를 추가했습니다. 이전 클라이언트는 이를 선택할 수 없습니다 (Opus 5.5가 기본값으로 대체함).
• v2.1.197에서는 네이티브 1M 컨텍스트와 함께 Claude Sonnet 5를 기본 모델로 설정했습니다.

보안 및 권한 (Security and permissions)

• v2.1.251은 작업 디렉토리 내에서 권한 확인 후에 심볼릭 링크(symlink)가 교체된 파일 도구(읽기, 쓰기, 편집)의 동작을 막고, Grep 및 Glob이 심볼릭 링크된 검색 경로를 통해 Read() 거부 규칙을 준수하도록 수정했습니다. 이는 v2.1.222–v2.1.224가 Bash에 대해 해결했던 것과 같은 유형의 우회(bypass)이며, ArcKit의 file-protection 및 secret-file-scanner 게이트도 이와 관련된 방어 장치입니다.

• v2.1.234는 Claude Code의 MCP 진단이 **해결된 비밀 정보(resolved secrets)**를 출력하는 것을 막습니다. ArcKit은 ${user_config.*} API 키가 요청 헤더에 포함되는 두 개의 키가 지정된 MCP 서버를 번들로 제공합니다. 키가 구성되지 않은 세션에서는 이러한 연결이 설계상 실패하므로, ArcKit은 이 수정 사항 덕분에 정확히 해당 진단 결과를 산출하게 되었습니다.

• v2.1.222는 백그라운드 에이전트 작업 내에서 PreToolUse 자동 허용 훅(auto-allow hooks)이 도구 제한을 우회하는 것을 방지합니다. 이 문제는 v2.1.232에서 서브에이전트 스폰(subagent spawns)이 기본적으로 백그라운드 처리되면서 중요하게 다루어졌습니다.

• v2.1.223 및 v2.1.224는 Bash 권한 확인 우회, 샌드박스 denyRead/denyWrite 트레일링 슬래시(trailing-slash) 우회, 그리고 프로젝트 경로가 200자를 초과할 경우 다른 프로젝트의 세션 디렉토리로 해석되던 버그를 수정했습니다. v2.1.224는 또한 Bash 결과에서 샌드박스 위반 상세 정보를 표시합니다.

• v2.1.172는 이전 클라이언트에서 서브도메인을 일치시키지 못했던 와일드카드 도메인 WebFetch 규칙(WebFetch(domain:*.gov.uk))을 수정했습니다. 이는 OFFICIAL-SENSITIVE 배포 환경에서 연구 에이전트 트래픽을 제한하는 데 ArcKit이 권장하는 정확한 형태입니다.

노력 및 사고 (Effort and thinking)

• v2.1.251은 사고(thinking)가 꺼져 있을 때 Opus 5의 effort: xhigh/max를 실패 처리하는 대신 high로 전송하도록 수정하여, ArcKit의 effort: max 명령이 사고 비활성화 세션에서도 완료되게 합니다.
• v2.1.221은 사고가 비활성화된 상태에서 WebSearch가 effort: xhigh/max를 반환할 때 400 오류를 발생시키던 문제를 수정했습니다. 이는 ArcKit의 effort: max 명령과 사고 비활성화를 사용해 실행하는 세 가지 최대 노력 연구 에이전트 모두에 영향을 주었습니다.

플러그인 로딩 및 에이전트 (Plugin loading and agents)

• v2.1.246은 ArcKit의 정확한 레이아웃에서 발생했던 네 가지 플러그인 로딩 버그를 수정했습니다: /reload-plugins가 skills/*/SKILL.md 아래에 스킬을 정의하는 플러그인의 경우 0개의 스킬을 계산하던 문제, 후크 오류 메시지가 해석된 경로 대신 리터럴 ${CLAUDE_PLUGIN_ROOT}를 표시하던 문제, 플러그인 캐시가 중복된 SHA 이름의 디렉토리를 생성하던 문제, 그리고 claude plugin update <bare-name>이 실패하던 문제입니다.
• v2.1.200은 git 워크트리(worktrees)에서 프로젝트 범위의 플러그인 로딩과 claude agents --plugin-dir <dir> 가시성 문제를 수정하여, ArcKit의 브랜치 및 테스트 리포지토리 작업 흐름을 신뢰할 수 있게 합니다.
• v2.1.198–v2.1.199는 백그라운드 서브에이전트 안정성, 부모 오류 전파(parent error propagation), 그리고 후크 stderr 가시성을 수정했습니다. 이는 /arckit:build, 리더/라이터 핸드오프(handoffs) 및 후크 진단에 중요합니다.

이전 수정 사항: v2.1.156 Opus 4.8 thinking-block 수정, v2.1.154 플러그인 defaultEnabled: false, v2.1.144 세션 제목 및 헤드리스 Skill 도구 수정, v2.1.143 플러그인 종속성 강제 적용, v2.1.139 훅 args: string[], v2.1.129 모니터 레이아웃 및 프롬프트-캐시 수정, v2.1.121 MCP/출처(provenance) 훅 잠금 해제, v2.1.118–v2.1.119 릴리스/텔레메트리 잠금 해제, 그리고 초기 /context, Auto 모드, 플러그인 업데이트, MCP 누수, 재시도 및 서브에이전트 작업 디렉토리 수정.

Gemini CLI — ArcKit 확장을 설치하세요:

gemini extensions install https://github.com/tractorjuice/arckit-gemini

제로 설정(Zero-config): 76개의 모든 공식 명령어, 템플릿, 스크립트 및 번들된 MCP 서버(AWS Knowledge, Microsoft Learn). gemini extensions update arckit을 통해 업데이트합니다.

GitHub Copilot (VS Code) — ArcKit CLI와 스캐폴드 프롬프트 파일을 설치하세요:

# pip으로 설치
pip install git+https://github.com/tractorjuice/arc-kit.git

...

.github/prompts/arckit-*.prompt.md (165개의 프롬프트 파일 — 76개 공식 명령어와 커뮤니티 오버레이), .github/agents/arckit-*.agent.md (10개의 사용자 지정 에이전트), 그리고 .github/copilot-instructions.md (레포지토리 전체 컨텍스트)를 생성합니다. Copilot Chat에서 /arckit-requirements, /arckit-stakeholders 등으로 명령을 호출하세요.

Codex CLI — ArcKit CLI를 설치하세요:

# pip으로 설치
pip install git+https://github.com/tractorjuice/arc-kit.git

...

Mistral Vibe CLI — ArcKit 확장을 연결하세요:

# 독립형 확장 저장소를 클론
git clone https://github.com/tractorjuice/arckit-vibe.git
cd arckit-vibe
...

제로 설정(Zero-config): 스킬로서의 76개 공식 명령어, 10개의 전문 에이전트, 모든 템플릿 및 번들된 MCP 서버(AWS Knowledge, Microsoft Learn, Google Developer Knowledge, GovRepoScrape).

Kimi Code CLI — kimi를 시작한 후 프롬프트에서 ArcKit 플러그인을 설치하세요:

/plugins install https://github.com/tractorjuice/arckit-kimi.git

모든 ArcKit 명령어는 Agent Skill로 배포되며, /skill:arckit-<명령어> 형식으로 호출됩니다 (예: /skill:arckit-requirements). kimi.plugin.json 매니페스트에는 묶인 여섯 개의 MCP 서버가 모두 포함되어 있으며, 세션 시작 시 architecture-workflow 스킬이 자동으로 로드됩니다.

최신 릴리스: v6.18.2

OKF 상호 운용성 (Interoperability)

ArcKit은 Open Knowledge Format(OKF) 형태의 프런트매터 레이어를 사용하여 Markdown 지식 번들을 교환할 수 있습니다:

• /arckit:export-okf는 ArcKit의 ARC-*.md 아티팩트를 이식 가능한 type, title, resource, tags, timestamp, 및 arckit 메타데이터가 포함된 OKF 번들로 복사합니다.
• /arckit:import-okf는 OKF 번들을 스캔하고, .arckit/tmp/okf-import-report.json 파일을 작성하며, 기본적으로 안전한 가져오기(safe imports)를 RSCH 검토 노트로 구현합니다.
• 네이티브 ArcKit 파일은 사용자가 ARCKIT_OKF_FRONTMATTER=1을 통해 소스 프런트매터 스탬핑을 명시적으로 활성화하거나, .arckit/config.json에 { "okfFrontmatter": true }를 포함하지 않는 한 변경되지 않습니다.

플랫폼 지원