Aggrega
Aggrega란 무엇인가
Aggrega는 AI 시대 아키텍처를 위한 오픈 소스 컴파일러입니다. 애플리케이션의 컴포넌트와 그 연결 방식을 기술하면, Aggrega가 이를 결정적으로 애플리케이션을 실행하는 배포 파일로 변환합니다.
- 이미 아는 언어를 사용합니다. 이미 사용하는 언어를 위한 컴파일러입니다. YAML을 입력하면 Helm 차트, Kubernetes 매니페스트, 그리고 Compose, Terraform 또는 CloudFormation 파일이 출력됩니다.
- 개발자는 기술하고, Ops는 구현합니다. 개발자는 컴포넌트, 그 기능, 누가 누구를 사용하는지를 선언하고, 플랫폼 팀은 각 컴포넌트를 어떻게, 어디서 실행할지 결정합니다.
- 하나의 애플리케이션, 여러 플랫폼. 같은 애플리케이션이 노트북의 Docker Compose에서도, 프로덕션의 Kubernetes에서도 실행됩니다. 대상을 바꾸면 코드가 아니라 매핑이 바뀝니다.
- 재현 가능하고 거버넌스가 적용됩니다. 같은 입력에는 같은 출력이 나오며, 모든 의존성은 lockfile에 고정됩니다. 정책은 컴파일러에 플러그인으로 연결되어, 정책을 위반하는 빌드를 중단하고 무엇을 고쳐야 하는지 알려 줍니다.
Aggrega는 이탈리아어로 “한데 모은다”라는 뜻입니다. 이 이름은 애플리케이션의 각 부분을 하나의 설명으로 모은다는, 이 도구가 하는 일을 나타냅니다.
-
명령을 실행할 수 있는 어시스턴트에 프롬프트 하나를 붙여 넣으십시오. 어시스턴트가 Aggrega를 설치하고, Aggrega 스킬을 추가하고, Aggrega MCP 서버에 연결하며, 무엇이든 설치하기 전에 먼저 확인을 받습니다.
-
Aggrega를 설치하고, 실행 가능한 예제를 폴더에 작성해 내 컴퓨터에서 실행한 다음, 한 단계씩 확장해 나갑니다. 로컬 모델에서 동작하는 AI 에이전트나 PostgreSQL을 사용하는 웹 앱 중 하나로 시작합니다.
-
Aggrega의 용도부터 언어 참조까지, 읽는 순서대로 문서를 따라가는 경로입니다.
설치
Linux와 macOS에서:
curl -fsSL https://aggrega.ai/install.sh | shWindows에서는 PowerShell에서 다음을 실행합니다:
irm https://aggrega.ai/install.ps1 | iex어느 명령이든 현재 사용자용으로 aggrega 바이너리를 설치합니다. 설치에서는 명령이 하는 일, Homebrew, Scoop, winget, 수동 다운로드를 다루고, MCP 서버 연결에서는 AI 어시스턴트를 연결합니다. Visual Studio Code용 Aggrega 확장은 aggrega 바이너리를 기반으로 Aggrega YAML에 검증, 탐색, 호버, 자동 완성을 제공합니다.
문서
Aggrega 언어와 컴파일러의 사용자용 문서입니다. 영어로 작성되며, 사이트가 제공하는 다른 모든 언어로 번역됩니다. 문서는 세 부분으로 구성됩니다.
- 아키텍처 — Aggrega의 “왜”. 비전, 포지셔닝, 멘탈 모델, 개념 수준의 컴파일러 파이프라인, 엔터프라이즈 거버넌스, 카탈로그, 확장성, 설계 선택. 처음 읽을 때는 번호가 붙은 01장부터 16장까지 순서대로 읽으십시오.
- 작성 가이드 — Aggrega의 “자리에 앉아 작성하는 방법”. 작성 루프, 협업하는 네 가지 역할, kind와 역할의 대응표, 그리고 Model Context Protocol 서버를 통해 AI 어시스턴트를 연결하는 방법. Aggrega 파일 작성하기부터 시작하십시오. AI 어시스턴트가 Aggrega를 직접 설치하고 설정하게 하려면 AI 어시스턴트로 Aggrega 설정하기의 프롬프트를 붙여 넣으십시오.
- 언어 참조 — Aggrega의 “무엇”과 “사용 방법”. 현재 준비 상태는 언어의 상태부터 확인하고, 처음 읽을 때는 번호가 붙은 01장부터 09장까지 순서대로 읽으십시오. 번호가 없는 하위 디렉터리(entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/)는 참조 카탈로그입니다 — 필요에 따라 특정 항목으로 바로 이동하십시오.
Aggrega 소개
Aggrega 컴파일러는 Apache-2.0 라이선스의 오픈 소스이며, 앞으로도 그렇게 유지됩니다. 컴파일러의 비공개 에디션은 없을 것이며, 오픈 코어 방식도 없을 것입니다. 컴파일러의 모든 기능은 오픈 소스 버전에서 제공될 것입니다.
이 에코시스템은 네 가지 기둥 위에 세워져 있습니다.
- 분리 모델(OAM에서 영감을 받음): 개발자 의도(추상적인 “무엇”과 “얼마나”)를 Platform Ops의 물리적 현실(물리적인 “어떻게”와 “어디에”)과 분리하는 설계 지침입니다. 컴파일러는 이 분리를 강제하지 않으며, 스키마 검증을 통과하는 모든 작성 패턴을 받아들입니다.
- 시맨틱 DSL & 운영 온톨로지: 개발자는 닫힌 범용 클라우드 프리미티브 집합(예:
server,worker,stateful-server)을 사용해 Aggrega의 예약된component.aggrega.ai/type레이블 위에 아키텍처를 매핑합니다. 모든 고급 컨텍스트—AI 에이전트의 자율성, 생성 기능, 데이터 규정 준수 등—는 정적 Duck-Typing 레이블을 통해 그 위에 계층화되며, 자체 축으로 컴포넌트를 분류하는 카탈로그는 자체 레이블 키를 추가합니다. - 프로그래밍 가능한 정책 & 검증: 핵심 Go 컴파일러는 주관이 없는 컴파일러입니다. 기업 거버넌스는 전적으로 업계 표준과 플러그 가능한 WebAssembly로 구동됩니다. 카탈로그 검증에는 JSON Schema 2020-12(간결한 YAML 형태의 약식 표기 또는 완전한 JSON Schema YAML로 작성)를, 동적 토폴로지 태깅에는 거버넌스 소켓의
label-transform역할을, 아키텍처 보안 경계 평가에는 그 판정 역할을 사용합니다. - AOT 컴파일러 & 실행 인계: 엄격한 컴파일 파이프라인이 DSL을 기능에 구애받지 않는 중간 표현(IR) 그래프로 변환합니다. IR은 컴포넌트의 토폴로지와 그 사이의
uses에지(누가 누구를 사용하는지)를 담습니다. 컴파일러는 이 그래프를 WebAssembly(Wasm) 거버넌스 소켓에 전달해 전이적 신뢰 취약점을 탐지한 다음, Wasm 렌더링 플러그인을 실행해 정확한 프록시 및 가드레일 구성을 생성합니다. Aggrega는 이 아티팩트를 디스크에 기록하고 CI/CD 파이프라인이나 런타임 오케스트레이터 같은 다른 도구에 넘기며, 이 도구들이 배포를 수행합니다.
라이선스
Aggrega 문서는 Apache License, Version 2.0에 따라 배포됩니다. 전문은 해당 저장소의 LICENSE 파일에 있습니다.