Ars Umbris란 무엇인가요?
Ars Umbris는 유형화된 지식을 위한 유연하고 에이전트 네이티브한 IDE입니다. 지식, 타입, 스킬, 도구, UI 컴포넌트를 서로 의존할 수 있는 조합 가능한 저장소에 결합합니다.
이 프로젝트는 이러한 저장소를 하나의 유형화된 그래프로 읽습니다. 필드와 참조를 검사한 다음 에이전트가 처리할 수 있는 진단 정보를 제공합니다. 사람과 에이전트는 동일한 기본 요소와 SDK를 사용해 도구를 만들고, 뷰를 추가하고, 애플리케이션을 수정할 수 있습니다.
Ars Umbris는 현재 초기 알파 버전이므로 버그와 호환성을 깨는 변경이 발생할 수 있습니다. 현재는 macOS만 지원합니다.
아키텍처의 구성 방식
Ars Umbris는 세 가지 주요 계층으로 구성됩니다. 각 계층을 이해하면 시스템을 구성하거나 확장할 때 어디를 살펴봐야 할지 판단하는 데 도움이 됩니다.
1. au-engine
au-engine은 유형화된 파일 기반 위에 구축된 저장소 간 그래프 엔진입니다. 여러 저장소의 파일을 색인하고 이를 유형화되고 쿼리 가능한 실시간 그래프로 변환합니다.
또한 Markdown 및 YAML 파일을 위한 사용자 지정 타입 지정 언어를 구현합니다. 자세한 내용은 au-engine.md를 참조하세요.
2. au-host
au-host는 Electron 호스트 애플리케이션입니다. 그래프 위에 유형화된 프로젝션 또는 뷰를 마운트하고, 유형화된 데이터를 기반으로 구성 파일을 통해 조합할 수 있도록 지원합니다.
이러한 조합은 편집할 수 있으며 사람과 에이전트 모두가 구동할 수 있습니다. 호스트 문서는 au-host.md를 참조하세요.
3. au-mcp
au-mcp는 확장 가능한 에이전트 계층을 제공합니다. MCP를 통해 유형화된 도구와 스킬을 노출하고, 어댑터를 통해 원하는 에이전트 하니스와 연동합니다.
MCP 계층에 대한 자세한 내용은 au-mcp.md를 참조하세요.
설치 준비
설치 과정에서는 두 개의 디렉터리를 사용합니다.
~/arsumbris/에는 여러 Ars Umbris 저장소가 저장됩니다.~/.arsumbris/에는 Ars Umbris 구성 파일이 저장됩니다.
프로젝트가 macOS 전용이고 아직 활발히 개발 중이므로 시스템을 변경하기 전에 사전 요구 사항을 검토하세요. 필요한 소프트웨어와 설정 순서는 저장소의 현재 설치 지침을 기준으로 따라야 합니다.
진입점 저장소 설치
README에서는 다음 지침을 사용해 에이전트에게 설치를 수행하도록 요청할 것을 권장합니다.
Ars Umbris 설치를 도와주세요.
1) 아직 존재하지 않는 경우 다음 두 폴더를 만드세요.
- ~/arsumbris/에는 여러 저장소를 보관합니다.
- ~/.arsumbris/에는 구성 파일을 보관합니다.
2) 진입점 저장소를 클론하세요.
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
해당 대상이 이미 존재하면 진행하기 전에 검사하세요. 덮어쓰지 마세요.
3) ~/arsumbris/arsumbris/INSTALL.md를 읽고 현재 설정 절차를 따르세요.
사전 요구 사항을 확인하고, 제 컴퓨터에 필요한 변경 사항이 있다면 적용하기 전에 설명하세요.중요한 안전 단계는 클론하기 전에 기존 ~/arsumbris/arsumbris 디렉터리를 검사하는 것입니다. 기존 체크아웃을 덮어쓰지 마세요. 저장소를 사용할 수 있게 되면 INSTALL.md를 열고 문서에 명시된 현재 지침을 순서대로 따르세요.
저장소의 현재 설정 절차 따르기
- macOS를 사용 중인지 확인합니다.
- 아직 존재하지 않는 경우
~/arsumbris/와~/.arsumbris/를 만듭니다. ~/arsumbris/arsumbris가 이미 존재하는지 확인합니다.- 존재하지 않는 경우
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris로 저장소를 클론합니다. - 이미 존재하는 경우 교체하지 말고 검사합니다.
~/arsumbris/arsumbris/INSTALL.md를 읽습니다.- 해당 파일에 지정된 사전 요구 사항을 확인하고 설치합니다. 적용하기 전에 제안된 시스템 변경 사항을 검토합니다.
INSTALL.md에 문서화된 순서대로 나머지 설정 단계를 완료합니다.
Ars Umbris는 활발히 개발 중이므로 타사 출처의 오래된 설정 지침에 의존하지 마세요. 설치하려는 버전에 맞춰 체크아웃한 저장소의 설치 안내를 사용하세요.
기본 사용 개념
Ars Umbris는 유형화된 지식과 기능을 포함하는 저장소를 중심으로 설계되었습니다. 저장소에는 지식, 타입 정의, 스킬, 도구, UI 컴포넌트가 포함될 수 있습니다. 또한 저장소는 다른 저장소에 의존할 수 있으므로 여러 프로젝트에서 기능과 지식을 재사용할 수 있습니다.
높은 수준에서 일반적인 작업 흐름은 다음과 같습니다.
- 관련 저장소를
~/arsumbris/아래에 배치하거나 클론합니다. au-engine이 해당 저장소 전체의 파일 기반을 색인하도록 합니다.- 생성된 유형화된 그래프를 사용해 연결된 데이터, 필드, 참조를 다룹니다.
au-host를 사용해 그래프 위에 프로젝션과 뷰를 마운트합니다.au-mcp와 MCP 어댑터를 통해 에이전트 하니스를 연결합니다.- 에이전트 또는 사용자가 진단 정보를 검사하고, 도구를 만들고, 뷰를 추가하고, 애플리케이션을 수정하도록 합니다.
README에서는 특정 샘플 프로젝트나 명령줄 작업 흐름 하나를 정해 두지 않습니다. 정확한 명령과 사용 가능한 프로젝션은 INSTALL.md에 설명된 설정 및 연결하는 저장소에 따라 달라집니다.
MCP를 통한 에이전트 작업
Ars Umbris는 Model Context Protocol을 통해 에이전트 하니스에 연결되도록 구축되었습니다. au-mcp 계층은 유형화된 도구와 스킬을 제공하고, 어댑터는 이러한 기능을 사용자가 선택한 하니스에 연결합니다.
이를 통해 에이전트는 애플리케이션을 구축하는 데 사용되는 것과 동일한 기반 요소와 SDK로 작업할 수 있습니다. 실제로 에이전트는 설치 환경에서 제공되는 기능과 구성에 따라 도구 제작, 뷰 추가, 앱 수정에 참여할 수 있습니다.
고급 팁 및 안전 고려 사항
저장소를 조합 가능하게 유지하기
재사용하고 서로 연결할 수 있도록 지식과 기능을 저장소에 구성하세요. 저장소 간 종속성은 프로젝트 모델의 핵심 요소이므로, 저장소를 서로 고립된 폴더가 아니라 하나의 타입이 지정된 그래프를 구성하는 부분으로 생각하세요.
진단을 피드백으로 활용하기
엔진은 타입이 지정된 그래프 전반의 필드와 참조를 검사합니다. 타입이 지정된 Markdown, YAML 또는 관련 저장소 콘텐츠를 편집할 때, 특히 에이전트가 변경 작업을 수행할 때 엔진의 진단 결과를 피드백으로 활용하세요.
레이어 문서 읽기
동작을 이해해야 할 때는 관련 레이어의 문서를 참조하세요: 엔진, 호스트 또는 MCP 에이전트 레이어.
변경 사항을 적용하기 전에 검토하기
설치 프롬프트에서는 필요한 시스템 변경 사항을 적용하기 전에 먼저 설명할 것을 명시적으로 권장합니다. 에이전트가 저장소나 구성을 수정하도록 허용할 때도 동일하게 신중한 접근 방식을 따르세요.
현재 보안 모델 고려하기
Ars Umbris는 사용자의 시스템에서 코드를 실행하며 현재 샌드박싱이 적용되지 않습니다. 프로젝트를 사용하기 전에 SAFETY.md를 검토하세요. 특히 에이전트를 연결하거나 완전히 통제하지 못하는 저장소를 사용할 때는 더욱 주의해야 합니다.
맺음말
Ars Umbris는 타입이 지정된 저장소 간 그래프, Electron 기반 호스트, MCP 에이전트 레이어를 결합한 실험적 타입 지식 IDE입니다. 시작하려면 두 구성 디렉터리를 준비하고, 기존 파일을 덮어쓰지 않도록 진입점 저장소를 클론한 다음 현재 INSTALL.md의 지침을 따르세요. 설치가 완료되면 프로젝트가 알파 단계이며 샌드박싱되지 않은 실행 모델을 사용한다는 점을 염두에 두고 저장소, 프로젝션, 도구, 스킬, 에이전트가 어떻게 함께 작동하는지 살펴보세요.