문서
Archyl 사용법을 알아보세요.
Getting started
C4 model
Features
- AI 기반 탐색 — Archyl이 AI를 사용하여 코드베이스에서 아키텍처를 자동으로 발견하고 문서화하는 방법과, 푸시할 때마다 이루어지는 증분 업데이트를 알아보세요
- 아키텍처 변경 요청 — 구조화된 변경 요청 워크플로우를 통해 C4 아키텍처 모델의 변경을 제안, 검토, 병합하세요
- 문서 및 ADR — Archyl에서 아키텍처 문서와 아키텍처 결정 기록을 생성하고 관리하세요
- 문서 첨부 파일 — 드래그 앤 드롭, 붙여넣기 또는 첨부 버튼으로 문서 페이지에 이미지와 파일을 업로드하세요 — S3 호환 오브젝트 스토리지에 안전하게 저장됩니다
- 사용자 흐름 — 아키텍처 전반에 걸친 사용자 및 데이터 흐름을 문서화하여 상호작용 시퀀스를 시각화하세요
- 코드형 아키텍처 — archyl.yaml로 C4 아키텍처를 정의하고 동기화 — 버전 관리, CI/CD 지원, 완전한 선언형
- 아키텍처 타임랩스 — 프로젝트의 버전 이력을 한 편의 영화처럼 재생합니다 — 요소가 스스로 그려지고, 폐기된 서비스에는 취소선이 그어지며, 크레딧이 올라갑니다. 그리고 전부 브라우저 안에서 렌더링해 1080p MP4로 내보낼 수 있습니다
- 아키텍처 인사이트 — 아키텍처 문제를 자동으로 감지하고 시스템 설계 개선을 위한 권장사항을 제공합니다
- 공유 및 내보내기 — 이해관계자와 아키텍처 다이어그램을 공유하고 다양한 형식으로 내보내세요
- API 계약 — C4 아키텍처 요소에 직접 연결된 API 명세를 문서화하고 관리하세요
- 릴리스 관리 — GitHub Actions, Webhook, REST API를 통한 자동 수집으로 아키텍처 전반의 배포를 추적하세요
- 마켓플레이스 통합 — 외부 서비스를 연결하고 아키텍처와 함께 실시간 메트릭, 알림, 대시보드를 표시하세요
- 프로덕션 리얼리티 (살아있는 다이어그램) — Kubernetes, Datadog, New Relic 같은 프로덕션 소스를 연결해 실제로 동작 중인 서비스와 의존성을 발견하고, 이를 C4 모델과 대조해 조정합니다 — 읽기 전용이며 비파괴적입니다
- 기술 레이더 — 기술 환경을 시각화하고, 도입 수준을 추적하며, 모든 프로젝트의 기술 스택을 관리하세요
- Webhook 알림 — 프로젝트에서 아키텍처 변경이 발생할 때 실시간 HTTP 알림을 수신하세요
- Slack & Teams 봇 — Slack 또는 Microsoft Teams에서 Archyl에 아키텍처를 질문하고, 실시간 MCP 도구로 답변하고 작업하게 하세요
- 소유권 맵 — 인터랙티브 버블, 종속성 라인, 커버리지 추적으로 아키텍처 전반의 팀 및 사용자 소유권을 시각화
- 적합성 규칙 (가드레일) — C4 모델, 기술 결정, 코딩 표준을 기준으로 코드 변경을 검증하는 결정론적 아키텍처 규칙을 정의합니다 — AI는 관여하지 않습니다
- GitHub Actions 통합 — Archyl의 공식 GitHub Actions로 CI/CD 파이프라인에서 아키텍처 적합성 검사, 드리프트 점수 계산, 컨텍스트 생성 등을 실행하세요
- 적합성 규칙 팩 — 일반적인 아키텍처 패턴을 위한 사전 구축 적합성 규칙 세트 — 마이크로서비스, 클린 아키텍처, 이벤트 기반, API 우선, 보안 기준선
- 관리형 에이전트 실행 — 스케줄에 따라 실행되고, MCP 커넥터를 통해 외부 서비스에 연결되며, 전체 아키텍처 컨텍스트를 활용하여 코드베이스에서 작업하는 자율 AI 에이전트를 배포하세요
- 자체 AI 제공자 사용 — 자체 자격 증명을 사용하여 자체 제공자(OpenAI, Anthropic, Google Gemini, AWS Bedrock 또는 모든 OpenAI 호환 엔드포인트)를 통해 모든 Archyl AI 기능을 라우팅하고 Archyl 쿼터 한도를 건너뛰세요.
Guides
- 첫 번째 프로젝트 만들기 — Archyl에서 첫 번째 아키텍처 프로젝트를 만들고 문서화하는 단계별 가이드
- 다이어그램 임베드 — Confluence, Notion, Miro 및 기타 플랫폼에 인터랙티브 Archyl 다이어그램을 임베드하세요
- 보안 — Archyl이 데이터와 아키텍처 정보를 어떻게 보호하는지 알아보세요
- 설정 및 구성 — AI 프로바이더 구성, 구독 관리, Archyl 경험 커스터마이즈
- 코딩 에이전트 스킬 — Archyl의 코딩 에이전트 스킬 11종을 설치하고 사용하여 Claude Code, Codex 또는 호환 가능한 에이전트에서 직접 아키텍처를 검증, 문서화, 리뷰, 최적화하세요
- Archyl Harness — 어떤 코딩 에이전트든 5분 만에 아키텍처를 인식하게 만드세요: 집중된 컨텍스트, 통제된 작업 세션, Guardrails 강제 적용, 그리고 에이전트 간에 축적되는 메모리
Git integration
- Git 통합 개요 — Git 저장소를 연결하여 AI 기반 아키텍처 디스커버리를 활성화하세요
Collaboration
- 팀 관리 — Archyl에서 더 나은 협업을 위해 팀을 만들고 관리하는 방법을 알아보세요
- 실시간 화이트보드 — 팀과 함께 아키텍처 다이어그램을 실시간으로 협업하세요
- 팀 아키텍처 다이제스트 — 드리프트, ADR, 준수, 토론 등 아키텍처 활동을 요약한 이메일을 각 팀에 정기적으로 보냅니다.