# [[L3 Meta-Factory]]

## 📌 Brief Summary
L3 Meta-Factory는 단순한 에이전트 하네스 실행 환경을 넘어 "다른 하네스들을 생성하는 층"으로 기능하는 Claude Code 생태계의 최상위 아키텍처 계층이다 [1, 2]. 이 계층은 사용자의 자연어 도메인 설명을 바탕으로 전문 에이전트 팀 구조, 런타임 설정, 그리고 에이전트가 사용할 스킬 파일들을 자동으로 찍어내는(factory) 역할을 수행한다 [1, 2]. 목적과 생성 결과물에 따라 팀 아키텍처 팩토리(Team-Architecture Factory)나 런타임 설정 팩토리(Runtime-Configuration Factory) 등 여러 서브 층으로 세분화된다 [1, 3].

## 📖 Core Content
* **L3 Meta-Factory의 핵심 역할**: 에이전트를 조율하는 단일 하네스를 운영하는 것을 넘어, 주어진 과제에 맞는 에이전트 하네스 구조 자체를 동적으로 생성하는 메타 인프라 역할을 한다 [1]. 사용자가 "하네스 구성해줘"와 같은 명령을 내리면 도메인을 분석해 에이전트 정의(`.claude/agents/`)와 스킬(`.claude/skills/`)을 자동 생성해 준다 [2].
* **주요 서브 층(Sub-layers)의 구분**:
  * **Team-Architecture Factory**: 팀 구조, 메시지 프로토콜, 리뷰 게이트 등 에이전트 팀 아키텍처와 스킬을 뽑아내는 데 특화된 층이다 [3, 4]. `revfactory/harness`가 대표적이며 파이프라인, 팬아웃/팬인, 전문가 풀, 생성-검증, 감독자, 계층적 위임 등 6가지 사전 정의된 아키텍처 패턴을 지원한다 [1, 2].
  * **Runtime-Configuration Factory**: 결정적(deterministic)이고 반복 가능한 런타임 설정을 생성하는 데 특화된 층으로, `coleam00/Archon`이 대표적인 프레임워크다 [1, 3, 4].
  * **Codex Runtime Port**: 메타 팩토리 컨셉을 Codex 런타임 환경에 맞게 구현한 층이며, `SaehwanPark/meta-harness`가 여기에 속한다 [1, 3, 5].
* **모듈형 운영 및 조합 방식**: 동일한 L3 계층 내에 존재하더라도 각 서브 층의 용도는 명확히 분리된다 [3]. 팀 아키텍처의 설계가 필요할 때는 Team-Architecture Factory를 활용하고, 런타임 결정성이 필요할 때는 Runtime-Configuration Factory를 사용하며, 필요시 두 팩토리를 조합(아키텍처 설계 후 런타임에 배포)하여 상호 보완적으로 운용할 수 있다 [3, 4].

## ⚖️ Trade-offs & Caveats
소스에 L3 Meta-Factory 아키텍처 도입에 따른 직접적인 부작용이나 최적화의 기술적 한계에 대한 구체적인 관련 정보가 부족합니다. 다만, 단일 팩토리가 모든 하네스 구성 요소를 완벽하게 제공하지 않으므로 목적에 따른 팩토리의 분리 및 조합이 필수적이라는 제약 사항이 존재한다 [3, 4]. 예를 들어 팀 아키텍처 설계 기능과 런타임 결정성 보장 기능은 서로 다른 서브 층에서 개별적으로 처리되므로, 두 가지 요구사항을 모두 충족하려면 서로 다른 팩토리(예: `revfactory/harness`와 `coleam00/Archon`)를 명시적으로 구분하여 조합해야 하는 파이프라인 설계상의 복잡성이 수반된다 [3, 4].

---
*Last updated: 2026-05-05*