agentlas-operations

# Agentlas 시스템 운용 (One 운용 스킬)

도구의 **존재와 이름은 이 문서가 아니라 [INDEX.md](INDEX.md)가 정본**이다(릴리스 빌드가
라이브 레지스트리에서 자동 생성 — 손 목록은 반드시 썩는다). 이 문서는 **절차만** 다룬다.

## 1. 편성 (hep-network) — 로스터 재사용이 항상 먼저

1. `workforce.goal_context`로 활성 로스터부터 확인한다. **재사용으로 충분하면 모집하지 않는다.**
2. 진짜 공백일 때만: 축약(redacted) 워크오더 1장 → `workforce.search_candidates`
   (`sourceScope=network` = local+cloud+hub 연합).
   - ⚠️ `requiredSkills`에 시드 온톨로지 ID를 걸면 실후보 전원이 가짜 결격을 단다(실측).
3. 선발은 **호스트 LLM이** 한다(연합은 점수 매기지 않는다) → `workforce.validate_selection`
   (연합 결과 원본 그대로 — 축약본은 거절됨) → `workforce.prepare_execution`(projectDir 필수).
4. 준비 성공은 자동으로 로스터에 바인딩된다. 바인딩은 명시적 `workforce.complete_goal`까지 유지
   — 24시간 Hub 리스는 과금 단위지 바인딩 종료가 아니다.
5. 소스 스코프는 정확하게: network=전체, local/cloud/hub는 제한 스코프이지 폴백 계층이 아니다.

## 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`는 서버 상태이지 패키지 결함이 아니다.