agentlas-ai Agentlas 시스템 운용 (One 운용 스킬)
도구의 존재와 이름은 이 문서가 아니라 INDEX.md가 정본이다(릴리스 빌드가 라이브 레지스트리에서 자동 생성 — 손 목록은 반드시 썩는다). 이 문서는 절차만 다룬다.
1. 편성 (hep-network) — 로스터 재사용이 항상 먼저
workforce.goal_context로 활성 로스터부터 확인한다. 재사용으로 충분하면 모집하지 않는다.- 진짜 공백일 때만: 축약(redacted) 워크오더 1장 →
workforce.search_candidates(sourceScope=network= local+cloud+hub 연합).- ⚠️
requiredSkills에 시드 온톨로지 ID를 걸면 실후보 전원이 가짜 결격을 단다(실측).
- ⚠️
- 선발은 호스트 LLM이 한다(연합은 점수 매기지 않는다) →
workforce.validate_selection(연합 결과 원본 그대로 — 축약본은 거절됨) →workforce.prepare_execution(projectDir 필수). - 준비 성공은 자동으로 로스터에 바인딩된다. 바인딩은 명시적
workforce.complete_goal까지 유지 — 24시간 Hub 리스는 과금 단위지 바인딩 종료가 아니다. - 소스 스코프는 정확하게: network=전체, local/cloud/hub는 제한 스코프이지 폴백 계층이 아니다.
- 워커를 띄우기 직전마다 살아 있는 세션을 알리고
model.resolve_allocation을 부른다 (stage=planner/worker/synthesis/verifier). 영수증의 provider·model·effort를 그대로 쓴다.- 이건 편성뿐 아니라 One이 스스로 워커를 나눌 때도 적용된다. 한 모델로 다 하는 턴은 배정할 것이 없으니 부르지 않는다 — 역할이 갈리는 순간에만 부른다.
- 세션에는
session_id·model·provider를, 호스트가 아는 경우에만tier·supported_efforts·context_window를 싣는다. 없는 값을 지어내지 않는다 — 빠진 컨텍스트 창은 보수적 하한으로 가정되고 영수증이 그 사실을 밝힌다 (inventory_context_window_assumed). - 오케스트레이터/워커 등급은 오퍼레이터가
hep-orch orchestrator=<tier|model> worker=<tier|model>로 정한다. 작업이나 도구 인자가 그 상한을 올릴 수 없다.
2. 자동화 (hep-graph)
- 반복 작업은 대화로 그래프를 만들어 저장한다(
/hep-graph). 실행 중 승인 게이트는 없다 (오너 결정 2026-08-09: 승인은 만들 때 한 번). - "항상 허용"을 그래프 digest에 걸지 않는다 — digest가 바뀌면 바로 그 실행의 재개가 거부된다. 사람의 결정은 실행 밖 기록에 둔다.
3. 자산 (cargo / Agent Cloud / marketplace)
- 내 서랍:
cargo.*(드래프트·라이브러리, 로그인 필요). 오너 자산 검색은/hep-cloud. - 공개 검색:
marketplace.search_agents(로그인 불필요) — kind가cloud-callable이면get_runtime_bundle(BYOM: 내 모델이 번들을 실행, 서버는 LLM을 돌리지 않는다),install-only면get_manifest로 설치. - 도구가 안 보이면 단정 전에
agentlas_resolve_plugins— 미설치 ≠ 부재. 설치는 사용자 결정. - 서버 거절(
insufficient_credits·owner_only등)은 그 문구 그대로 보고한다. 지정 원격 에이전트를 로컬 폴백이 대신 실행한 척하지 않는다.
4. 메모리 계약 (One 워커로서)
- 작업 전
agentlas.memory.preflight— 아는 사실 재유도 금지. - durable은 직접 쓰지 않는다. 답 끝의
## Memory Events봉투가 유일한 기록 경로이고 런타임이 티켓으로 포장한다. 근거 없는 fact/decision/procedure는 hypothesis로 강등된다. - 앞선 durable을 대체하는 학습이면 candidate에
"supersedes":"<h:16hex>"를 넣는다 (회수에서 숨겨질 뿐 삭제되지 않는다). - One 서랍(
~/.agentlas/one/)은 읽기 자유·쓰기 금지(D3) — 편집 시도는 PreToolUse가 거절한다.
5. 표면별 함정 (실측 기반)
- 플러그인 MCP 서버는 세션 시작 때 캐시에서 로드된다 — 릴리스 직후엔 새 세션에서 검증.
- 원격 서버는 관대하고 로컬 Core는 엄격하다(validate에는 연합 결과 원본 전체를 넘길 것).
- Hub 발행 503
WRITE_MODE=blocked는 서버 상태이지 패키지 결함이 아니다.