Execution Naming Glossary

실행 네이밍 사전 (Execution Naming Glossary)

FractalOps에는 무언가를 “run”할 수 있는 표면이 너무 많습니다. 그래서 runtime을 이 모두를 가리키는 일반어로 쓰면 안 됩니다. 잘못된 단어 하나가 곧바로 잘못된 소유자/잘못된 시간축을 함의하기 때문입니다.

이 명사들이 어떤 시간축에 사는지를 그림으로 보면 다음과 같습니다.

flowchart LR
  subgraph build["빌드 시간 (CI)"]
    deploy_image["deploy image\nCI 빌드 컨테이너 산출물"]
  end
  subgraph lifecycle["에이전트 생애주기"]
    harness["Agent Execution\nprovider policy · process boundary"]
    temporal["Temporal workflow\n스케줄 · deadline · retry"]
  end
  subgraph attempt["1회 시도 (per-attempt)"]
    surface["execution surface\nprovider 표면"]
    workspace["execution workspace\n리스된 workspace"]
    adapter["agent process adapter\nCLI/browser 실행기"]
  end
  subgraph platform["플랫폼/API 경계"]
    asset["operation asset\n타입드 머신 selector"]
    rac["operation asset control\n머신 command/HTTP 제어 계약"]
  end

  deploy_image --> harness
  harness --> temporal
  harness --> surface --> workspace --> adapter
  rac --> asset

정규 명사 (Canonical Names)

Name	Owns	Does not own
`Agent Execution`	Provider policy, process launch, takeover boundary	Durable cadence, source files, deploy artifacts
`Temporal workflow`	durable schedule, deadline, retry policy, activity execution	Studio projection, file sync
`execution surface`	provider surface where work can run	Lifecycle policy or proof
`execution workspace`	one leased workspace for an agent attempt	Shared product meaning, Git ownership
`agent process adapter`	one CLI/browser attempt executor	Workspace provisioning or lifecycle policy
`workspace bootstrap asset`	file delivery before an agent starts	Source truth or delivery proof
`source ref bundle`	read-only source/reference archive	Agent-owned output
`agent-owned worktree`	writable Git checkout for one agent lane	Cross-agent shared context
`assembly worktree`	shared read/observation checkout	Git ownership for an agent lane
`deploy image`	CI-built container artifact	Agent lifecycle or workspace lease
`operation asset`	typed platform/API machine selector	AgentSquad prose default
`operation asset control`	application contract for machine command/HTTP control	Generic workflow orchestration
`executor URL`	machine-facing control URL	Human navigation
`public URL`	browser-facing human URL	Internal command execution

코드 근거: operation asset / operation asset control / executor URL / public URL은 추상 개념이 아니라 실제 타입입니다.

RuntimeAssetDescriptor의 executor_url(머신 제어)과 entry_url(사람/브라우저 진입)은 별도 필드입니다 — backend/src/fractalops/domain/access/features/runtime/assets.py.
operation asset control 계약은 RuntimeAssetControlService(list_assets / get_asset / check / run_command / http_request)로 구현됩니다 — backend/src/fractalops/application/access/features/runtime_asset_control/service.py.

교체 규칙 (Replacement Rules)

AgentSquad provider/process 경계에만 Agent Execution이라고 말한다.
deadline·retry·내구 activity에는 Temporal workflow라고 말한다.
AgentSquad 산문에서 Daytona, Dokploy, PlaywrightGrid 등 provider 표면에는 execution surface라고 말한다.
1회 시도용 리스된 workspace에는 execution workspace라고 말한다.
Claude/Codex/Antigravity/브라우저 실행 모드에는 agent process adapter라고 말한다.
CI 이미지 산출물에는 deploy image라고 말한다.
플랫폼/API 호환 경계에서만 operation asset이라고 말한다.

그 외 정규 명사 (도메인 경계)

다음 명사들은 헌법 네이밍 법과 CLAUDE.md의 네이밍 규약을 따릅니다.

Name	의미	함정
`Portal`	1차 인간 워크플로 표면	”frontend” / “UI”로 부르지 않는다
`Proposal Plane`	유일한 합법 변경 게이트	”approval system”으로 부르지 않는다
`Semantics` / `DataHub`	그래프/계보 의미 · 카탈로그	”metadata”로 뭉뚱그리지 않는다
`Chronicle evidence`	장기 증명 평면	”audit log”로 부르지 않는다
`group`	권한 경계이자 RBAC 범위	`service cell`과 섞지 않는다
`service cell`	실행/인력 편성 단위	`group`으로 붕괴시키지 않는다
`executor URL` / `public URL`	머신 제어 URL / 사람 진입 URL	둘은 별도 계약이다
`project execution workspace`	프로젝트가 소유하는 단일 공유 Daytona sandbox lease. Profile은 내부의 격리 process/worktree만 소유하고 sandbox를 fork하지 않는다	상태 술어는 인라인 set-literal이 아니라 `execution_workspace_lifecycle` 도메인 모듈의 이름을 쓴다 (ADR-0005)
`serving` vs `dispatchable` workspace	살아서 서빙 중(`ready/active/idle_warm`) vs 디스패치 게이트 통과(`+connected`)	두 집합은 역사적으로 다르다 — 통일하려다 라이브 세션을 다시 파킹시키지 말 것
`ready-lease demotion`	execute 경로가 이미 serving인 리스를 materializing으로 강등하는 것	금지 (`preserves_ready_lease` 가드, #2796 시소)
`convergence starvation`	terminal litter가 stuck-fetch 창을 독식해 수렴 대상을 가리는 것	fetch는 materializing 우선 (#2792); litter reaper는 부채 #12

호환 필드 (Compatibility Fields)

기존 payload에는 아래 이름이 남아 있을 수 있습니다. 새 제품 언어가 아니라 wire 필드로 취급하세요.

agent_process_kind = delivery work kind.
agentProcessKind = agent process adapter kind.
runtime image = platform release artifact field.
BOARD_STATUS = AGENT_HUD_STATUS wire-supported retired field.

네이밍 냄새 (Naming Smells)

새 산문이나 코드 리뷰 코멘트가 다음처럼 쓰면 바로잡으세요.

runtime을 workspace 의미로 쓰는 것
runtime을 provider 표면 의미로 쓰는 것
runtime을 deploy image 의미로 쓰는 것
runtime을 agent process 의미로 쓰는 것
workspace를 Git 소유 의미로 쓰는 것
handoff로 delivery 참조를 대체하는 것

좁은 규칙: 한 명사, 한 소유자, 한 시간축.