Archyl 코딩 에이전트 플러그인을 설치하고 사용하여 Claude Code, Codex 또는 호환 가능한 코딩 에이전트에서 직접 아키텍처를 관리하세요

코딩 에이전트 플러그인

Archyl Developer Plugin을 사용하면 코딩 에이전트(Claude Code, Codex 또는 호환 가능한 도구)에서 직접 전체 C4 아키텍처 모델을 관리할 수 있습니다. 에디터와 Archyl 대시보드를 번갈아 사용할 필요 없이, 터미널을 떠나지 않고도 시스템, 컨테이너, 컴포넌트, ADR, 적합성 규칙 등을 생성할 수 있습니다.

이 플러그인은 오픈 소스이며 github.com/archyl-com/agent-skills에서 확인할 수 있습니다.

주요 기능

이 플러그인은 다음 영역에 걸친 Archyl의 200개 이상의 MCP 도구에 대한 심층적인 지식을 에이전트에 제공합니다:

영역	기능
C4 모델링	시스템, 컨테이너, 컴포넌트, 코드 요소 및 관계를 생성하고 관리
문서화	Architecture Decision Records, 프로젝트 문서, 사용자/시스템 플로우, AI 인사이트
거버넌스	적합성 규칙, 드리프트 감지, DORA 메트릭, 소유권 매핑
운영	릴리스, 환경, API 계약, 이벤트 채널, 기술 레이더
협업	댓글, 변경 요청, 화이트보드, 팀 관리
히스토리	스냅샷, 타임 트래블, 아키텍처 비교, 감사 로그
통합	웹훅, 마켓플레이스 위젯, 글로벌 아키텍처 뷰

사전 요구 사항

API 접근 권한이 있는 Archyl 계정
API 키 (Archyl 대시보드의 설정 → API 키에서 발급)
Claude Code, Codex 또는 호환 가능한 코딩 에이전트

설치

1단계: 마켓플레이스 추가

Claude Code에서 다음 명령어를 실행하세요:

/plugin marketplace add archyl-com/agent-skills

그런 다음 플러그인 관리자를 열어 자동 업데이트를 설정하세요:

/plugin 실행
Marketplaces 선택
목록에서 archyl-marketplace 선택
Enable auto-update 또는 Disable auto-update 선택

2단계: 플러그인 설치

/plugin install archyl-developer@archyl-com-agent-skills

설치 후 Claude Code를 재시작하세요.

3단계: MCP 서버 구성

프로젝트의 .mcp.json에 Archyl MCP 서버를 추가하세요:

{
    "mcpServers": {
        "archyl": {
            "type": "http",
            "url": "https://api.archyl.com/mcp",
            "headers": {
                "X-API-Key": "arch_your_api_key_here"
            }
        }
    }
}

arch_your_api_key_here를 Archyl 대시보드에서 발급받은 실제 API 키로 교체하세요.

기타 코딩 에이전트

플러그인 콘텐츠는 플러그인 형식을 지원하는 모든 에이전트와 호환됩니다. 리포지토리의 archyl-developer 플러그인 디렉토리에서 스킬 파일을 직접 사용할 수도 있습니다.

일반적인 워크플로우

설치가 완료되면 자연어로 코딩 에이전트에 아키텍처 작업을 요청할 수 있습니다. 다음은 일반적인 워크플로우입니다:

새 프로젝트 문서화

에이전트에 아키텍처 모델 스캐폴딩을 요청하세요:

Create a new Archyl project for our e-commerce platform.
Add the main systems: WebApp, PaymentService, and PostgreSQL Database.
Then create containers for the API server and React frontend inside WebApp.

에이전트가 적절한 MCP 도구(create_project, create_system, create_container)를 호출하고 모든 것을 연결합니다.

기존 아키텍처 분석

Get the full C4 model for my project and summarize the architecture.
Check the drift score — is the documentation still accurate?
Show me any open architecture insights.

아키텍처 규칙 적용

Create a conformance rule that prevents any container from having
more than 10 direct dependencies. Then run a conformance check.

아키텍처 결정 기록

Create an ADR titled "Migrate from REST to gRPC for internal services".
Set it as proposed, explain the context around latency requirements,
and link it to the ApiGateway and PaymentService containers.

배포 성능 확인

Show me the DORA metrics for the last month.
What's our deployment frequency and lead time trend?

기술 레이더 관리

Show me the current technology radar.
Add "Temporal" as an adopted workflow orchestration technology
and tag it on the OrderProcessing container.

작동 방식

이 플러그인은 모든 Archyl MCP 도구에 대한 구조화된 지식(매개변수, 예상 값, 모범 사례 포함)을 코딩 에이전트에 제공합니다. 에이전트에 아키텍처 작업을 요청하면 다음과 같이 동작합니다:

호출할 MCP 도구를 식별합니다
올바른 매개변수를 구성합니다 (프로젝트 ID, 요소 유형, 관계 유형)
복잡한 워크플로우를 위해 여러 호출을 연결합니다
생성되거나 수정된 내용의 요약을 반환합니다

에이전트는 항상 list_projects를 먼저 호출하여 사용 가능한 프로젝트를 탐색하고 후속 작업에 필요한 projectId를 가져옵니다.

C4 모델 참조

이 플러그인은 C4 모델의 4가지 레벨을 모두 이해합니다:

레벨	요소	예시
1	System	"Payment Platform", "Email Service"
2	Container	"API Server", "PostgreSQL Database", "React Frontend"
3	Component	"AuthService", "PaymentProcessor", "UserRepository"
4	Code	"PaymentGateway interface", "processPayment()"

명명 규칙

에이전트는 요소를 생성할 때 다음 명명 규칙을 따릅니다:

Systems: PascalCase, 설명적 (PaymentPlatform, NotificationService)
Containers: PascalCase, 유형 힌트 포함 (ApiServer, PostgresDatabase, RedisCache)
Components: PascalCase, 모듈 지향 (AuthService, PaymentProcessor)
Code Elements: 소스 코드의 정확한 심볼 이름

관계 유형

요소를 연결할 때 에이전트는 적절한 관계 유형을 사용합니다:

유형	사용 사례
`uses`	시스템 간 일반적인 의존성
`calls`	동기식 HTTP/gRPC 호출
`sends_to` / `consumes_from`	비동기 메시징 (큐, 이벤트)
`reads_from` / `writes_to`	데이터베이스 접근
`implements` / `extends`	코드 수준의 상속

기여하기

이 플러그인은 오픈 소스입니다. 다음과 같은 방법으로 기여할 수 있습니다:

도구 이름, 매개변수 또는 설명 수정
새로운 Archyl 기능에 대한 커버리지 추가
워크플로우 예제 개선
누락된 도메인에 대한 참조 파일 추가

자세한 내용은 기여 가이드를 참조하세요.

코딩 에이전트 플러그인 - Archyl Docs