FractalOps Core Requirements

FractalOps Core 요구사항

FractalOps는 일반적인 “스택 매니저”가 아니라 **조직 메타-컨트롤 플레인(organization meta-control plane)**이다. 핵심 책임은 제품과 실행 기반을 가로질러 다음 경로를 일관되게 유지하는 것이다.

flowchart LR
  onboarding["onboarding"] --> work["work"] --> proposal["proposal"] --> proof["proof"] --> reflect["reflective improvement"]
  reflect -. agentsquad .-> onboarding

Identity (정체성)

FractalOps의 정체성은 onboarding -> work -> proposal -> proof -> reflective improvement 경로를 제품과 실행 substrate 전반에서 끊김 없이 유지하는 데 있다. 이것이 “강하게 소유하는 영역”과 “단순 통합 endpoint”를 가르는 기준이다.

강하게 소유하는 Core (Strongly-Owned Core)

FractalOps가 깊은 제어 로직을 정당하게 가질 수 있는 곳이다.

portal
api
worker
execution-runtime
Temporal
CNPG-backed Supabase Core / Storage / Realtime
Daytona
PlaywrightGrid
proposal, lineage, proof, recovery 계약

Endpoint-First 규칙

대부분의 인접 시스템은 핵심 제어면이 아니라 통합 endpoint다.

예: Nexus, Penpot, Dokploy, Headlamp, 다수의 connector target.

이런 시스템의 기본 계약은 다음 4가지뿐이다.

public URL
머신 접근이 필요할 때의 executor URL
auth / secret 계약
readiness / health 계약

flowchart TD
  Q{이 시스템을 FractalOps가<br/>강하게 소유해야 하나?}
  Q -- "예: 제품 경로의 핵심 substrate" --> Strong["Strongly-Owned<br/>portal/api/worker/execution-runtime/<br/>Temporal/DB/Daytona/PlaywrightGrid"]
  Q -- "아니오: 통합 대상" --> Endpoint["Endpoint-First<br/>public URL + executor URL +<br/>auth/secret + readiness"]
  Endpoint -. 강한 lifecycle 추가 금지 .-> Drift["Prohibited Drift"]

FractalOps는 이들에 대해 기본적으로 강한 lifecycle governance를 두지 않는다.

Core Runtime / Execution 규칙

API는 검증/기록/큐잉(validates, records, queues)을 한다.
Temporal이 무거운 실행을 수행한다.
proposal-bound 작업은 큐를 우회할 수 없다.
proof는 mutation 이후에도 query 가능해야 한다.
secret/token은 SSOT 기반 secret 계약(OpenBao)으로 해석한다.
runtime 선택은 raw stack-local 명사가 아니라 typed runtime asset 또는 endpoint 계약을 쓴다 (토폴로지 runtime_assets: fractalops-control, daytona-runtime, playwrightgrid, cliproxy-runtime 등).

Live Truth 규칙

outbox: portal_live_events
canonical live read: harness-projection
live UI는 경쟁하는 여러 summary를 합치지 않는다.

AgentSquad 규칙

public continuity는 fresh | resume로 유지한다.
launch 진단은 진단으로 남기고, 추가 public mode로 만들지 않는다.
browser-first는 runtime이 강제한다.
auth wall은 자동 버그 분류가 아니라 continuity/recovery 입력으로 다룬다.

금지된 드리프트 (Prohibited Drift)

endpoint 계약으로 충분한 곳에 per-stack 제어 로직 추가.
SSOT 경계 없이 raw local/cluster URL 임베딩.
retired continuity mode를 노출하는 public 문서/API.
request 경로에서의 동기 직접 실행.
canonical 제품 어휘를 대체하는 stack-local 은어.

검증

make test-unit
make test-contract
make test-integration
make codegen-check
URL/principal/live-truth 경계가 바뀌는 곳에는 focused SSOT/runtime 회귀 테스트.