이 참조 문서 사용 방법
언어 레퍼런스는 Aggrega의 작성 표면, 즉 YAML 스키마, 공통 키워드 어휘, Go 템플릿 시스템, provider 계약, CLI 명령, 컴파일러의 오류 카탈로그, 그리고 처음부터 끝까지 따라가는 예제를 정의합니다. 처음 접하는 경우 아래 장들을 순서대로 읽고, 특정 엔터티, 키워드, provider, CLI 명령 또는 오류를 찾을 때는 해당 하위 디렉터리로 바로 이동합니다.
먼저 aggrega 바이너리를 설치하려면 바이너리 설치를 따르십시오. AI 어시스턴트가 설치와 설정을 대신하게 하려면 AI 어시스턴트로 Aggrega 설정의 프롬프트를 붙여 넣으십시오. Aggrega를 기반으로 스크립트나 카탈로그를 구축하기 전에, 업그레이드로 무엇이 바뀔 수 있고 무엇이 바뀌지 않는지 호환성을 읽으십시오.
레퍼런스를 읽기 전에 아키텍처 장들이 정립하는 멘탈 모델을 먼저 익혀 두십시오. 네 가지 도메인과 팀 토폴로지 장은 Aggrega가 Developer Intent, Platform Catalog, Platform Ops, Platform Operator의 관심사를 서로 다른 작성 표면으로 어떻게 분리하는지 설명하며, 엔터티 분류 체계 장은 엔터티(Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary)와 이들 도메인에 걸친 각 엔터티의 역할을 설명합니다. 이 장 이후의 모든 레퍼런스 장은 독자가 이러한 구조를 이해하고 있다고 가정합니다.
이 레퍼런스는 두 가지 방식으로 사용합니다. 온보딩할 때는 순서대로 읽습니다. 인스턴스 이름 패턴과 대소문자 규칙을 다루는 명명 관례부터 시작하여, 엔터티 장과 어휘 장을 차례로 읽으며 전체 작성 계약을 익힙니다. 조회할 때는 질문에 맞는 하위 디렉터리로 바로 이동합니다. 엔터티별 필드 의미는 entities/, 엔터티 간 공통 키워드는 vocabulary/, Recipe 작성자가 사용할 수 있는 Go 템플릿 표면은 templates/, provider별 디스패치 계약은 providers/, 플러그인 소켓과 플러그인 작성은 plugins/, 각 kind의 JSON Schema는 schema/, 명령줄 사용법은 cli/, 진단은 errors/, 예제 패턴은 examples/를 참조합니다.