Agentlas OS

만들거나 빌리세요. 내가 만든 에이전트는 내 것으로 남습니다.
평범한 요청을 실행 가능한 에이전트나 팀으로 만들고, 공개 Agentlas Hub의 전문가를 빌리고, 내가 만든 에이전트는 비공개 소유자 전용 Agent Cloud에 보관합니다.
이미 쓰고 있는 LLM의 지원 호스트에서 실행할 수 있습니다. Hephaestus는 그 아래의 오픈소스 엔진입니다.

_{내가 만든 에이전트는 특정 모델 워크스페이스나 한 대의 PC에 묶이지 않습니다. 다른 곳에서 Cloud 패키지를 불러오려면 지원되는 호스트에 Agentlas OS를 설치하고 로그인해야 합니다.}

English · Korean · 中文 · 日本語 · हिन्दी

붙여넣어 설치하기

지금 쓰는 LLM, 예를 들어 Claude Code, Codex, Gemini CLI, Antigravity, Cursor에 아래 내용을 붙여넣으세요:

이 GitHub 저장소에서 Agentlas OS / Hephaestus를 설치해줘:
https://github.com/agentlas-ai/Agentlas-OS

마켓플레이스 플러그인만 설치하고 끝내지 말고, 다음 세션에도 유지되는
호스트 명령 어댑터까지 설치하도록 저장소의 정식 원터치 설치기를 실행해줘:
curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh | HEPHAESTUS_INSTALL_GLOBAL_ROUTER=1 bash

Claude Code에서는 `hephaestus@agentlas-core-engine`이 user scope로 활성화됐고
`~/.claude/commands/agentlas build.md`가 존재하는지 확인해줘. 다음 세션에서 bare
`/agentlas build` 명령을 쓸 수 없는 상태라면 설치 완료라고 하지 마. 마지막에는
활성화된 플러그인, 명령 표면, 전역 라우팅 상태를 확인하고, 호스트를
재시작하거나 `/reload-plugins`를 실행하라고 알려줘.

이미 쓰고 있는 LLM에서 Agentlas 명령 표면을 바로 활성화하고 싶을 때 사용하세요. 셸에서 직접 설치하려면 아래 전체 설치 방법을 보세요.

_{전문가를 빌리고, 로컬에서 라우팅하고, LLM·브라우저·파일·메모리·도구 위에서 실제 작업을 검증합니다.}

Build · Borrow · Own · 왜 Agentlas OS인가 · 붙여넣어 설치하기 · Claude Agent만 만들면 안 되나 · 전체 설치 방법 · 명령 표면 · v1.1.0의 새로운 기능 · 서브시스템 · 제품 표면 · 소유한 에이전트 운영 · 시스템 패키징 · 문서 레지스트리

만들고, 빌리고, 소유하기

내가 만든 에이전트는 하나의 채팅, 특정 AI 회사의 워크스페이스, 한 대의 컴퓨터에 갇힌 설정이 아니라 이동 가능한 자산이어야 합니다. Agentlas는 일반 에이전트 빌더가 한데 섞어 놓은 세 가지 일을 분리합니다:

패키지는 이동하고, 실행은 현재 호스트에서

할 일을 설명한다
  -> 이동 가능한 에이전트 또는 팀을 만든다
  -> Cloud에 올리기 또는 로컬에만 저장을 선택한다
  -> Cloud 선택 시 내 소유자 전용 Agent Cloud에 보관한다
  -> 다른 지원 호스트에 Agentlas OS를 설치하고 로그인한다
  -> /agentlas cloud로 다시 불러온다
  -> 내가 선택한 모델과 현재 호스트가 작업을 실행한다

Agent Cloud는 소유자의 패키지를 보관하고 다시 전달합니다. 서버에서 대신 LLM 작업을 수행하는 호스팅 모델이 아닙니다. 패키지를 호출하면 내가 선택한 모델과 현재 호스트 런타임이 그 호스트의 권한·안전 모델 아래에서 실행합니다. 자격 증명, 로컬 파일, 컴퓨터별 권한은 패키지와 함께 이동하지 않으며 각 컴퓨터에서 별도로 설정해야 합니다.

Hub와 Agent Cloud는 서로 다른 범위입니다

왜 Agentlas OS인가

대부분의 AI 제품은 또 하나의 에이전트를 만드는 데 집중합니다. Agentlas OS는 그 다음 문제를 다룹니다. 에이전트들이 내가 소유한 팀처럼 계속 일하게 만드는 운영 구조입니다.

설치 후 사용자가 상상해야 하는 장면은 이것입니다:

• Claude, Codex, Gemini, Cursor, Antigravity, 로컬 모델이 흩어진 채팅이 아니라 하나의 팀처럼 움직입니다.
• 실제 로그인된 브라우저가 프롬프트 속 스크린샷이 아니라 실행 표면이 됩니다.
• 에이전트는 채팅이 끝나도 패키지 계약, 라우팅 카드, 메모리 규칙, 권한, 검증 영수증을 남깁니다.
• 내가 소유한 패키지는 로컬에 두거나 소유자 전용 Agent Cloud에 비공개로 보관한 뒤, Agentlas OS가 설치되고 로그인된 다른 지원 호스트에서 다시 불러올 수 있습니다.
• Hub 전문가를 내 로컬 런타임으로 빌려오되, 창작자의 비공개 작업을 복사하거나 내 비공개 파일을 넘기지 않습니다.

Hephaestus는 Agentlas OS 아래의 오픈소스 엔진입니다. 프롬프트 마켓플레이스도, 에이전트 템플릿 생성기도, 또 다른 모델 구독도 아닙니다. LLM 명령 표면 전반에서 에이전트를 만들고, 라우팅하고, 빌리고, 실행하고, 검증하고, 패키징하는 로컬 우선 런타임입니다.

핵심은 "프롬프트로 에이전트 만들기"가 아닙니다.

내 LLM, 브라우저, 메모리, 로컬 도구 위에서 에이전트를 만들고, 패키징하고, 라우팅하고, 실행하고, 검증하는 것입니다.

Claude Agent만 만들면 안 되나

Claude subagent와 custom agent는 유용합니다. 태스크마다 별도 프롬프트, 도구, 컨텍스트 창을 줄 수 있습니다. Agentlas는 그 다음부터 시작합니다.

LLM은 에이전트를 초안으로 만들 수 있습니다. Agentlas는 그 에이전트를 운영 단위로 만듭니다:

제품 경계는 여기입니다. Agentlas는 "더 좋은 프롬프트"로 경쟁하지 않습니다. 에이전트가 하나의 채팅 밖에서도 계속 일할 수 있는 구조를 제공합니다.

Agent OS Stack

Agentlas는 하나의 모델 제공자에 묶이지 않으면서 에이전트 작업을 운영체제적 책임으로 나눕니다:

_{그림 1. 요청 셰이핑, 세 개의 빌더, 생성된 패키지 계약, 메모리 큐레이션, 스킬 수명주기, 런타임 어댑터, 동기화 경계.}

v1.1.0의 새로운 기능 — Briefing Interview Engine

모호한 한 문장짜리 프롬프트로 생성된 에이전트는 실제 엣지 케이스 앞에서 무너집니다. Hephaestus v1.1.0은 Briefing Interview Engine을 통해 태스크 명세를 일급 OS 서비스로 격상합니다:

• 정량적 모호성 게이트: 컴파일 스케줄러가 프롬프트의 명확성을 네 가지 핵심 벡터(목표, 제약, 범위, 컨텍스트)에서 평가합니다. 모호성 점수가 수치 임계값(모호성 점수 $\le 0.2$, 차원별 안전 하한 포함)을 통과할 때까지 빌드 프로세스는 엄격히 게이트됩니다. 명확한 프롬프트는 사소한 작업의 질문 수를 제한하는 예산 시스템 덕분에 인터뷰 루프를 완전히 건너뜁니다.
• 렌즈 기반 시스템 분석: 명확화 질문은 구조화된 렌즈 테이블(범위, 의도, 도전 과제, 시스템 아키텍처)에서 동적으로 뽑아내며, 핵심 라우팅 지표에 집중합니다: 안티스코프 경계(에이전트가 절대 하면 안 되는 것), 검증 가능한 수용 기준, 종료 조건.
• Work Brief: 확정된 세부 사항은 .agentlas/work-brief.json에 동결됩니다 — 검증된 목표, 구체적 제약, 출처 태그가 달린 가정 원장(assumption ledger), 메타데이터 모호성 점수를 기록합니다.
• 컨텍스트 반영 인플라이트 브리프: CLI 도구 cards migrate가 브리프의 세부 내용을 에이전트 라우팅 카드의 트리거와 안티트리거에 자동으로 매핑합니다. route --brief를 실행하면 이 브리프가 모든 Stormbreaker 실행 패킷으로 전파되어, 제약과 종료 조건이 전체 수명주기에 걸쳐 병렬 서브프로세스를 관장하도록 보장합니다.
• 강화된 라우팅 판별력: 같은 주제·다른 의도 충돌(예: 보안 에이전트가 배포 프롬프트를 가로채는 문제)을 양면 게이팅으로 방지합니다: 라우팅 카드에 기록된 인터뷰 검증 안티트리거, 그리고 라우터 내부의 저신뢰도 LLM 리랭킹 에스컬레이션.

전체 설치 방법

수동 LLM 어댑터 설치

현재 LLM이 자체 설정을 실행할 수 없을 때만 사용하세요. 공유 Hephaestus runner와 지원되는 LLM 도구용 명령 어댑터를 설치합니다.

xcode-select --install   # Command line tools (skip if already installed)
git --version            # Confirm git is available
curl -fsSL https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/main/scripts/install-all-runtimes.sh | bash

이 명령은 중립 러너를 ~/.agentlas/runtime/current/bin/hephaestus에 설치하고, Claude Code, Codex, Gemini CLI, Antigravity, Cursor, OpenCode, OpenClaw, Hermes와 호환 로컬/API 호스트용 명령 어댑터를 등록합니다. 설치기는 등록이 끝난 뒤 각 런타임 표면을 검증합니다.

Desktop 시작과 모든 /hep-* 명령은 동일한 무결성 검증·횟수 제한 업데이트를 백그라운드에서 시작합니다. 현재 명령은 네트워크나 설치 작업을 기다리지 않습니다. 업데이트가 성공하면 ~/.agentlas/runtime/current가 원자적으로 교체되고 이미 설치된 호스트 어댑터가 같은 릴리스로 맞춰집니다. 다음 명령 또는 다시 불러온 세션부터 새 릴리스를 사용합니다. v1.1.63부터 v1.1.68까지 잠시 설치됐던 별도 6시간 OS 예약 서비스는 현재 설치 과정과 다음 /hep-* 실행에서 자동 제거됩니다.

선택형 전역 라우터

hep-global install

이 명령은 ~/.codex/AGENTS.md, ~/.claude/CLAUDE.md, ~/.gemini/GEMINI.md에 관리용 marker block을 추가합니다. 이후 Codex, Claude Code, Antigravity/Gemini는 네이티브 Agentlas 세션처럼 일반 프롬프트를 처리합니다. 실질 작업의 라우팅 순서는 Hephaestus Network 먼저, Hephaestus Cloud 두 번째, 로컬 에이전트 세 번째, 로컬 스킬 마지막입니다. Network나 Cloud가 크레딧, 권한, 적합도 문제로 막히면 그 경계를 알리고 다음 fallback으로 내려갑니다. 명령은 여러 번 실행해도 같은 block만 갱신하며, 수정 전 timestamp 백업을 남깁니다.

설치된 router prompt는 상태 줄에 라우터 명령이 아니라 최종 작업자를 표시하도록 지시합니다. 영어/한국어 세션용 status-line 계약을 명시적으로 포함합니다:

전역 라우터 명령 레퍼런스:

독립 Agentlas Terminal이 agentlas 셸 명령을 소유합니다. Core 설치기는 이 명령을 건드리지 않으며, 과거 Core가 만든 정확한 레거시 별칭만 제거합니다. | hephaestus global install | 메인 Hephaestus runner를 통한 동일 명령입니다. | | ~/.agentlas/runtime/current/bin/hephaestus global status | shell shim이 PATH에 없을 때 설치된 runtime을 직접 호출합니다. |

런타임별 플러그인 드라이버

claude plugin marketplace add https://github.com/agentlas-ai/Agentlas-OS --sparse .claude-plugin claude/plugins
claude plugin install hephaestus@agentlas-core-engine

codex plugin marketplace add agentlas-ai/Agentlas-OS --ref v1.1.91
codex plugin add hephaestus@agentlas-core-engine

그냥 말하세요: 설치 후 네이티브 Agentlas 인터페이스에서는 평문으로 말하면 태스크가 자동 라우팅됩니다. 외부 LLM 도구에서는 아래에 나열된 명시적 명령을 사용하세요. Codex 0.117+에서는 $hephaestus-network, $hephaestus-build, $hephaestus-cloud, $hephaestus-storm 스킬을 사용하고 다른 MCP 표면은 평문으로 요청합니다.

이 저장소의 위치

이 저장소는 Hephaestus 엔진과 LLM 명령 어댑터를 설치합니다. Agentlas OS 아래의 오픈소스 명령 표면입니다.

위 설치 프롬프트는 의도적으로 이 저장소와 현재 LLM 표면에만 집중합니다. Desktop, Hub, Cloud는 같은 Agentlas OS 아키텍처 주변의 제품 표면이며, 플러그인 설치의 선행 조건이 아닙니다. 새 컴퓨터에서 Cloud 패키지를 불러오려면 지원되는 Agentlas OS 호스트를 설치하고 패키지 소유자로 로그인해야 합니다.

명령 표면

네이티브 Agentlas 환경 안에서 Hephaestus는 명령어 없이 동작합니다. 외부 LLM 도구는 의도적으로 작게 유지한 가시 명령 집합을 사용합니다. Stormbreaker, 리서치 로드아웃, 설정 테이블 같은 시스템 수준 유틸리티는 컨텍스트에서 자동으로 붙습니다:

각 명령은 원래 이름인 /hep-*로도 그대로 동작합니다. /agentlas network와 /hep-network는 같은 명령입니다. 이름을 없앤 것이 아니므로 기존 스크립트와 메모, 손에 익은 습관이 그대로 유지됩니다.

OS 서브시스템

Meta-Agent Factory — 프로세스 생성

세 개의 빌더를 사용하는 통합 컴파일 팩토리입니다. 생성된 모든 패키지는 전역 명령(.agentlas/global-commands.json)을 등록하고 검증 스크립트를 함께 배포합니다 — 사용자가 컴파일된 패키지를 어떻게 실행할지 추측할 필요가 없습니다:

Briefing Interview Gate: 빌더는 briefing interview gate(docs/builder-interview-research-gate.md)로 프로세스를 시작합니다: 렌즈 기반 질문을 수행하고, 모호성 임계값을 평가하고, 1차 출처를 검색하고, work brief를 출력합니다.

Network 2.0 — 스케줄러

_{그림 2. A2A 스케줄링: LLM 런타임, 로컬 우선 오케스트레이터, 라우팅 카드, 로컬 메모리, Agentlas Hub A2A/MCP 폴백.}

• 타입이 있는 직무 분석: 활성 호스트 LLM이 요청을 역할, 스킬, 도구, 산출물, 권한, 정원, 핸드오프가 명시된 비식별 WorkOrder로 만듭니다. Core는 substring 목록으로 인력 수요를 추측하지 않습니다.
• 정확한 소스 연합: local, cloud, hub는 각각 정확한 단일 범위이고 network는 세 범위의 봉인된 합집합입니다. 각 소스는 제한된 content-only 메뉴를 반환하며, Core는 실패한 소스를 다른 범위로 몰래 대체하지 않습니다.
• 호스트가 구성하는 태스크 포스: 호스트 LLM이 적합성 근거를 읽고 정확한 Selection을 작성합니다. Core는 결정론적 승자를 고르거나 숨은 Router Agent 리랭킹을 하지 않고 거버넌스, 프라이버시, 신원, 정원, 그래프 무결성만 검증합니다.
• 핀으로 고정된 실행: 검증 후 Core는 원래 소스 세션에서 선택된 불변 릴리스만 가져와 릴리스·패키지·콘텐츠 다이제스트를 확인한 뒤 플래너, 워커, 종합, 검증자를 서로 다른 호출로 실행합니다.
• 증거 기반 평가: 검색 커버리지, 호스트 선택, 불변 준비, 실제 자식 호출, 최종 검증을 각각 별도 주장으로 평가합니다. 벤치마크 결과나 사용 이력은 호스트의 인력 배치 결정을 대신하지 않습니다.

자세한 내용: docs/hephaestus-network-2.0.md · 런타임 지원 매트릭스: docs/runtime-fallback-adapters.md

Stormbreaker — 규율 있는 실행

Stormbreaker는 이 에이전트 OS의 실행 게이팅 서브시스템입니다. 모든 결과가 결정적 검사로 검증되기 전에는 에이전트가 성공을 보고하거나 종료하지 못하도록 보장합니다:

Kernel Gating Envelope:
[Scope Lock] -> [Decomposition] -> [Parallel Work Packets] -> [Verify Contracts] -> [Bounded Repair] -> [Final Gate]

로컬 실행 저널 덕분에 긴 실행도 중단 후 재개할 수 있습니다. 실행 패킷은 Work Brief를 함께 실어 나르므로, 안티스코프 규칙과 종료 기준이 모든 병렬 서브프로세스를 관장합니다. Stormbreaker는 명시적 완료 상태(verified / unverified / blocked)를 보고하여 자율 에이전트의 "완료 연기(completion theater)"를 방지합니다.

실행 프로토콜: docs/robustness-protocol.md · 벤치마크 & 평가: docs/robustness-eval.md

Ontology Runtime — 지식 파일시스템

지식 집약적 작업에서는 bin/ontology가 시맨틱 파일시스템 역할을 하며, 비정형 로컬 파일을 에이전트가 읽을 수 있는 데이터베이스 스택으로 변환합니다:

Ingested Files -> [Parser Adapter] -> [CJK trigram/bigram tokenization] 
  -> [FTS5 + SQLite Storage] -> [Reciprocal Rank Fusion Ranking] -> [GraphRAG Search]

GPL 의존성 없이 한국어 문서 파싱(HWPX 및 레거시 HWP5)을 퍼스트파티로 제공합니다. 완전 로컬 SQLite 기반이며, 기밀·비공개 청크는 격리되어 외부 클라우드 훅에 도달하지 못합니다.

bin/ontology ingest ./corpus --scope internal
bin/ontology query "Project Helios Memory Curator" --agent verifier
bin/ontology memory candidates

자세한 내용: docs/ontology-runtime.md

관리형 메모리 — 큐레이션 승격

• 로컬 프로젝트 메모리: ~/.agentlas/networking/ 아래에 저장되며 로컬 머신에 격리됩니다. 명시적 승인 없이는 내보낼 수 없습니다.
• 워크스페이스 개인화: 빌려 온 Cloud/Hub 에이전트의 개인화 로그(요약, 플레이북, 플러그인 잠금, 영수증)를 원시 프롬프트, 자격 증명 값, 비공개 파일을 저장하지 않은 채 관리합니다.
• 큐레이터 게이팅: 스킬과 메모리 수정은 후보 상태로 유지됩니다. 로컬 큐레이터가 홀드아웃/리플레이 증명, 롤백 커버리지, 보안 정책 승인을 확인한 뒤에야 영구 상태로 승격됩니다.

A2A Boundary — 에이전트 간 격리

표준화된 CLI 명령으로 에이전트 간 협업을 안전하게 수행할 수 있습니다:

agentlas-cloud ao a2a import ./agent-card.json .
agentlas-cloud ao a2a export . --agent local/10-builder
agentlas-cloud route "run the release check" --caller local/orchestrator .

가져오기(import)는 제안으로 처리되어 자동 호출이 제한되고, 내보내기(export)는 비공개 경로와 로직을 가리며, 호출은 라우팅이 해석되기 전에 호출자 게이트를 거칩니다.

소유한 에이전트 운영을 위한 설계

사용자와 팀에 필요한 것은 고립된 에이전트를 작성하는 또 하나의 방법이 아닙니다. 내가 소유한 에이전트 워크포스를 운영하는 것입니다. Hephaestus는 이 운영 모델을 위해 설계되었습니다:

• 패키지 이동성: 내가 소유한 패키지는 로컬에 두거나 비공개 소유자 전용 Agent Cloud에 보관할 수 있습니다. 다른 지원 컴퓨터에서는 Agentlas OS를 설치하고 로그인해 패키지를 다시 불러옵니다. 호스트 자격 증명, 로컬 파일, 권한은 컴퓨터별로 유지됩니다.
• 모델 중립성: 에이전트 패키지는 한 모델 벤더의 워크스페이스에 속하는 대신 지원되는 호스트용 어댑터를 사용합니다. 운영 아키텍처를 다시 만들지 않고 지원되는 Claude, Codex, Gemini, Antigravity, Cursor, 로컬 모델 표면에서 같은 패키지를 실행할 수 있습니다.
• 구조적으로 보장되는 감사 가능성: 모든 라우팅 결정, 실행 단계, 메모리 후보, 큐레이터 결정이 텍스트 파일로 기록됩니다. diff하고, 감사하고, 커밋할 수 있습니다. 작업은 검증되었거나, 미검증으로 표시됩니다.
• 결정적 파이프라인 게이트: 보안 필터, 안티스코프, 라우팅 카드 트리거, 프롬프트 새니타이즈는 OS 파이프라인에 하드코딩되어 있습니다 — LLM 시스템 지침이나 가이드라인에 의존하지 않습니다.
• 생성 전 명세: Briefing Interview Engine이 요청의 모호성을 측정해 그 점수를 Work Brief에 찍어 두므로, 태스크 실행을 언제나 합의된 내용까지 거슬러 올라가 감사할 수 있습니다.
• 로컬 우선 데이터 경계: 원시 텍스트, 문서, 데이터베이스 파일은 로컬에 남습니다. 외부 트랜잭션은 마스킹되며 옵트인입니다.

프레임워크의 자리

CrewAI, LangChain, 각 벤더의 에이전트 SDK는 라이브러리로 기능합니다 — 단일 프로세스 안에서 커스텀 에이전트 로직을 작성하기에 훌륭합니다. Hephaestus는 **런타임 기반(substrate)**으로 동작합니다: 워크스페이스 런타임 전반에서 에이전트를 명세하고, 패키징하고, 라우팅하고, 실행하고, 감사하고, 마이그레이션합니다. 프레임워크 코드는 Hephaestus 패키지 안에서 실행되며, 커널은 에이전트가 디렉터리 계약과 Routing Card를 준수할 것만을 요구합니다.

무엇을 만들어내는가 (프로세스 패키징)

Hephaestus는 어떤 워크스페이스 런타임이든 파싱·설치·검증·실행할 수 있는 표준 디렉터리 레이아웃으로 에이전트를 패키징합니다. 중요한 것은 agent.md 하나가 아니라 그 주변의 운영 계약입니다:

├── AGENTS.md                              # 정본 운영 루프와 source-of-truth map
├── agent.md / agents/                     # 단일 워커, HQ/orchestrator, 또는 팀 역할
│   ├── 10-single-agent-builder/
│   ├── 20-multi-agent-team-builder/
│   └── 30-agentlas-packager/
├── .agentlas/                             # Agentlas OS 시스템 디렉터리
│   ├── sitemap.json                       # 제품 그래프: 모드, 런타임 어댑터, 메모리, 릴리즈 체크
│   ├── mode-map.json                      # single-agent / team / packager 분류 계약
│   ├── routing-card.json                  # trigger, anti-trigger, capability, risk, routing readiness
│   ├── agent-card.json                    # A2A-facing identity와 capability card
│   ├── company-blueprint.json             # 멀티 에이전트 패키지의 팀/회사 topology
│   ├── global-commands.json               # 런타임 명령 alias와 설치 표면
│   ├── memory-map.json                    # 메모리 root, write owner, trust label, exclude 규칙
│   ├── memory-tickets.jsonl               # durable promotion 전 후보 메모리 이벤트
│   ├── project-soul-memory.md             # 프로젝트 레벨 운영 메모리
│   ├── curator-decisions.jsonl            # Memory Curator의 승격/거절 결정
│   ├── vault-references.json              # raw value 없는 secret/credential reference
│   ├── validation-ledger.jsonl            # 검증과 릴리즈 evidence
│   ├── field-test-report.json             # package readiness field test 결과
│   ├── skill-registry.json                # reusable skill inventory와 lifecycle metadata
│   ├── skill-trials.jsonl                 # promotion 전 skill trial evidence
│   ├── agent-ontology/                    # capability, artifact, scope, edge를 담은 local code/agent map
│   └── super-ontology-*.json/jsonl        # evidence, privacy, side effect, resilience governance contract
├── skills/                                # 정본 reusable skills
├── modes/                                 # build/package 동작 모드 계약
├── schemas/                               # card, memory map, sitemap, eval, manifest JSON schema
├── templates/                             # package, memory, interview, eval, ontology, contract template
├── ontology/ + bin/ontology               # 로컬 우선 parser/search/GraphRAG runtime
├── agentlas_cloud/                        # Hub/Cloud bundle, routing, update, runtime API
├── .claude/ codex/ .gemini/ .agents/      # 같은 core 위의 얇은 runtime adapter
├── claude/ codex/ gemini/ antigravity/    # plugin/extension/workflow distribution
├── cursor/ hermes/ openclaw/              # 추가 runtime shim과 skill mirror
├── docs/                                  # architecture, chain map, memory, ontology, routing, eval docs
│   ├── source-of-truth.md
│   ├── chain-map.md
│   ├── memory-architecture.md
│   ├── ontology-runtime.md
│   ├── hephaestus-network-2.0.md
│   └── builder-interview-research-gate.md
└── scripts/                               # verification, installer, sync, release, public-safety gate
    ├── verify-package.sh
    ├── verify-ontology-runtime.sh
    ├── verify-routing-cards.sh
    ├── sync-adapters.sh
    └── public_safety_check.sh

이 구조 때문에 Agentlas 에이전트는 LLM이 쓴 역할 프롬프트 하나가 아닙니다. 라우팅, 메모리, 사이트맵, code/agent ontology, 권한, 런타임 어댑터, 검증 원장, 릴리즈 게이트가 함께 들어 있는 운영 단위입니다.

의존관계 기반 프로젝트 맥락

Hephaestus는 프로젝트 지도를 로컬에만 보관하고 소스 fingerprint로 자동 갱신합니다. 작업이 구체화되면 전체 문서를 밀어 넣는 대신 그 작업이 구조적으로 의존하는 목표, 제약, 정의, 역참조, 인터페이스와 관련 파일만 Context Slice로 전달합니다.

hephaestus context refresh --project .
hephaestus context refs resolveHubEntityKind --project .
hephaestus context slice --project . --task "entity kind 라우팅 수정" \
  --target src/package-kind.ts --render
hephaestus context impact --project . --changed src/package-kind.ts
hephaestus context verify --project . --changed src/package-kind.ts \
  --reviewed src/register/route.ts

Claude와 Codex는 로컬 훅으로 작업 조각을 받고 편집 직전에 역참조 경고를 받습니다. Desktop, Terminal, Stormbreaker, Workforce도 같은 Core 구현을 사용합니다. Network/Cloud 검색과 번들 가져오기는 계속 redacted 상태이며, 로컬 소스 경로나 Context Map 내용은 외부로 보내지 않습니다.

목표별 문서

공개 안전 경계

이 저장소에는 Agentlas 결제/계정 로직, 프로덕션 클라우드 자격 증명, 고객 데이터베이스, 원시 비공개 대화 기록, 네이티브 키체인 관리자, 비공개 배포 스크립트가 포함되어 있지 않습니다.

Hephaestus가 컴파일하는 공개 산출 패키지에는 로컬 절대 경로, API 키, 서비스 계정 키, .env 시크릿, 원시 대화 기록, 고객 로그, 비공개 개발자 노트가 들어가서는 안 됩니다.

기여와 검증

풀 리퀘스트를 열거나 업데이트를 발행하기 전에 검증 테스트 스위트를 실행하세요:

scripts/verify-package.sh
scripts/verify-ontology-runtime.sh
scripts/verify-experience-assets-contract.sh
scripts/public_safety_check.sh

라이선스

Apache-2.0. LICENSE를 참고하세요.