cuelo 0.10.72 → 0.10.74

package/.next/types/app/api/live/interpret/cloud/route.ts

@@ -0,0 +1,351 @@
+// File: /home/runner/work/CUELO/CUELO/app/api/live/interpret/cloud/route.ts
+import * as entry from '../../../../../../../app/api/live/interpret/cloud/route.js'
+import type { NextRequest } from 'next/server.js'
+
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+
+type TEntry = typeof import('../../../../../../../app/api/live/interpret/cloud/route.js')
+
+type SegmentParams<T extends Object = any> = T extends Record<string, any>
+  ? { [K in keyof T]: T[K] extends string ? string | string[] | undefined : never }
+  : T
+
+// Check that the entry is a valid entry
+checkFields<Diff<{
+  GET?: Function
+  HEAD?: Function
+  OPTIONS?: Function
+  POST?: Function
+  PUT?: Function
+  DELETE?: Function
+  PATCH?: Function
+  config?: {}
+  generateStaticParams?: Function
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
+  revalidate?: RevalidateRange<TEntry> | false
+  dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
+  dynamicParams?: boolean
+  fetchCache?: 'auto' | 'force-no-store' | 'only-no-store' | 'default-no-store' | 'default-cache' | 'only-cache' | 'force-cache'
+  preferredRegion?: 'auto' | 'global' | 'home' | string | string[]
+  runtime?: 'nodejs' | 'experimental-edge' | 'edge'
+  maxDuration?: number
+  
+}, TEntry, ''>>()
+
+type RouteContext = { params: Promise<SegmentParams> }
+// Check the prop type of the entry function
+if ('GET' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'GET'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'GET'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'GET',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'GET',
+        __return_type__: ReturnType<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('HEAD' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'HEAD'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'HEAD'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'HEAD',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'HEAD',
+        __return_type__: ReturnType<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('OPTIONS' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'OPTIONS'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'OPTIONS'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'OPTIONS',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'OPTIONS',
+        __return_type__: ReturnType<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('POST' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'POST'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'POST'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'POST',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'POST',
+        __return_type__: ReturnType<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('PUT' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'PUT'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'PUT'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'PUT',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'PUT',
+        __return_type__: ReturnType<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('DELETE' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'DELETE'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'DELETE'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'DELETE',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'DELETE',
+        __return_type__: ReturnType<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('PATCH' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'PATCH'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'PATCH'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'PATCH',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'PATCH',
+        __return_type__: ReturnType<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+}
+
+// Check the arguments and return type of the generateStaticParams function
+if ('generateStaticParams' in entry) {
+  checkFields<Diff<{ params: SegmentParams }, FirstArg<MaybeField<TEntry, 'generateStaticParams'>>, 'generateStaticParams'>>()
+  checkFields<Diff<{ __tag__: 'generateStaticParams', __return_type__: any[] | Promise<any[]> }, { __tag__: 'generateStaticParams', __return_type__: ReturnType<MaybeField<TEntry, 'generateStaticParams'>> }>>()
+}
+
+export interface PageProps {
+  params?: Promise<SegmentParams>
+  searchParams?: Promise<any>
+}
+export interface LayoutProps {
+  children?: React.ReactNode
+
+  params?: Promise<SegmentParams>
+}
+
+// =============
+// Utility types
+type RevalidateRange<T> = T extends { revalidate: any } ? NonNegative<T['revalidate']> : never
+
+// If T is unknown or any, it will be an empty {} type. Otherwise, it will be the same as Omit<T, keyof Base>.
+type OmitWithTag<T, K extends keyof any, _M> = Omit<T, K>
+type Diff<Base, T extends Base, Message extends string = ''> = 0 extends (1 & T) ? {} : OmitWithTag<T, keyof Base, Message>
+
+type FirstArg<T extends Function> = T extends (...args: [infer T, any]) => any ? unknown extends T ? any : T : never
+type SecondArg<T extends Function> = T extends (...args: [any, infer T]) => any ? unknown extends T ? any : T : never
+type MaybeField<T, K extends string> = T extends { [k in K]: infer G } ? G extends Function ? G : never : never
+
+type ParamCheck<T> = {
+  __tag__: string
+  __param_position__: string
+  __param_type__: T
+}
+
+function checkFields<_ extends { [k in keyof any]: never }>() {}
+
+// https://github.com/sindresorhus/type-fest
+type Numeric = number | bigint
+type Zero = 0 | 0n
+type Negative<T extends Numeric> = T extends Zero ? never : `${T}` extends `-${string}` ? T : never
+type NonNegative<T extends Numeric> = T extends Zero ? T : Negative<T> extends never ? T : '__invalid_negative_number__'

package/.next/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/recover"
-type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/account" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/attachment-settings" | "/api/attachments" | "/api/attachments/[id]/transcription" | "/api/attachments/draft" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/display-settings" | "/api/document-text" | "/api/experiments" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/github/projects" | "/api/gpt6/handles" | "/api/gpt6/reply" | "/api/gpt6/token" | "/api/gpt6/web6-session" | "/api/home" | "/api/live/call/[callId]" | "/api/live/events" | "/api/live/interpret" | "/api/live/offer" | "/api/live/voices" | "/api/mcp" | "/api/model-roles" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/plugins" | "/api/project-docs" | "/api/project-trust" | "/api/projects" | "/api/runs" | "/api/runs/[runId]" | "/api/runs/[runId]/prelude" | "/api/runs/[runId]/turns" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/state" | "/api/sessions/search" | "/api/settings" | "/api/sidecars/[service]/[...path]" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/subagents/eta" | "/api/theme" | "/api/tool-image" | "/api/update-maintenance" | "/api/updates" | "/api/web-access" | "/api/web-access/recovery" | "/api/web6/consults" | "/api/worktrees"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/account" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/attachment-settings" | "/api/attachments" | "/api/attachments/[id]/transcription" | "/api/attachments/draft" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/display-settings" | "/api/document-text" | "/api/experiments" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/github/projects" | "/api/gpt6/handles" | "/api/gpt6/reply" | "/api/gpt6/token" | "/api/gpt6/web6-session" | "/api/home" | "/api/live/call/[callId]" | "/api/live/events" | "/api/live/interpret" | "/api/live/interpret/cloud" | "/api/live/interpret/cloud/events" | "/api/live/interpret/cloud/input" | "/api/live/offer" | "/api/live/voices" | "/api/mcp" | "/api/model-roles" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/plugins" | "/api/project-docs" | "/api/project-trust" | "/api/projects" | "/api/runs" | "/api/runs/[runId]" | "/api/runs/[runId]/prelude" | "/api/runs/[runId]/turns" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/state" | "/api/sessions/search" | "/api/settings" | "/api/sidecars/[service]/[...path]" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/subagents/eta" | "/api/theme" | "/api/tool-image" | "/api/update-maintenance" | "/api/updates" | "/api/web-access" | "/api/web-access/recovery" | "/api/web6/consults" | "/api/worktrees"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -46,6 +46,9 @@ interface ParamMap {
   "/api/live/call/[callId]": { "callId": string; }
   "/api/live/events": {}
   "/api/live/interpret": {}
+  "/api/live/interpret/cloud": {}
+  "/api/live/interpret/cloud/events": {}
+  "/api/live/interpret/cloud/input": {}
   "/api/live/offer": {}
   "/api/live/voices": {}
   "/api/mcp": {}

package/.next/types/validator.ts

@@ -362,6 +362,33 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/live/interpret/cloud/events/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/interpret/cloud/events">> = Specific
+  const handler = {} as typeof import("../../app/api/live/interpret/cloud/events/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/live/interpret/cloud/input/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/interpret/cloud/input">> = Specific
+  const handler = {} as typeof import("../../app/api/live/interpret/cloud/input/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/live/interpret/cloud/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/interpret/cloud">> = Specific
+  const handler = {} as typeof import("../../app/api/live/interpret/cloud/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/live/interpret/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/interpret">> = Specific

package/README.md

@@ -8,55 +8,41 @@
   <a href="https://bun.sh"><img src="https://img.shields.io/badge/runtime-Bun-f472b6?style=flat&colorA=222222" alt="Bun"></a>
 </p>
 
-# CUELO — AI Coding Agent Workspace & Harness for omp (oh-my-pi)
+# CUELO — Browser workspace and multi-agent harness for omp (oh-my-pi)
 
-**CUELO** is an open-source AI coding agent workspace and harness for **[omp (oh-my-pi)](https://github.com/can1357/oh-my-pi)**.
+CUELO is an open-source browser workspace and harness for [omp (oh-my-pi)](https://github.com/can1357/oh-my-pi) coding agents: shared terminal sessions, multi-agent work you can inspect, account usage, and voice.
 
-Use the same `~/.omp/agent` sessions, credentials and model configuration from the terminal and browser. The web workspace provides session management, model configuration, skills, worktrees, usage views and PWA access. The public harness provides multi-agent orchestration and model-routing rules; some integrations require separately configured services, as detailed below.
+CUELO는 터미널에서 쓰던 omp 세션·계정·모델 설정을 브라우저에서 그대로 이어 쓰고, 여러 에이전트의 작업과 검수를 한 화면에서 보는 오픈소스 작업 공간이자 하네스입니다.
 
-**한국어:** CUELO는 omp(oh-my-pi)를 위한 오픈소스 AI 코딩 에이전트 작업 공간이자 하네스입니다. 웹 앱은 omp SDK를 서버 안에서 실행하고, `omp` CLI와 같은 `~/.omp/agent` 디렉터리를 씁니다. 터미널에서 하던 세션을 브라우저에서 이어 가고, 다시 터미널로 돌아가도 기록·계정·모델 설정을 공유합니다.
+## Why CUELO
 
-내장 OMP 코어는 **18.12.6**입니다. 별도로 설치한 `omp` CLI의 버전은 웹 업데이트와 독립적이며, 앱에 포함된 CLI를 `omp` 명령으로 사용하는 설치에서는 웹과 같은 코어를 사용합니다.
-
-문서 하네스는 기존 Word·Excel·PowerPoint 문서를 열고 편집하거나 변환할 때 LibreOffice를 우선 사용합니다. 원본은 보존하고 출력 결과를 확인하며, 매크로·전용 기능·서식 호환성이 필요하거나 사용자가 지정하면 MS Office를 사용합니다.
-
-장기 백그라운드 작업은 관측 기한이 되면 대기를 깨워 상태를 확인하게 합니다. 이미 끝난 결과는 먼저 회수하며, 작업을 자동으로 취소하거나 재실행하지 않습니다. [하네스 안내](./docs/harness.md#발주와-검수-계약)에 적용 범위와 확인 방법이 있습니다.
-
-취소되거나 시간초과된 하위 작업의 늦은 완료 내용은 기존 수용 결과를 덮어쓰지 않습니다. 중단 상태는 성공으로 바뀌지 않으며, 진단용 내용과 기록된 사용량은 별도로 남습니다. 이미 실행된 외부 작업이나 과금을 되돌리는 기능은 아닙니다.
-
-소스가 없는 .NET 어셈블리와 JavaScript/Electron 배포물은 [REA 선택 연결 안내](./docs/harness.md#바이너리-분석용-rea-연결선택)에 따라 정적으로 조사할 수 있습니다. Linux에서 기존 MCP 연결·도구 상속·제한 세션 동작을 검증했으며, 프로젝트별 등록은 승인 뒤에만 수행합니다. Windows REA 호환성은 아직 확인하지 않았습니다.
-
-CUELO의 목적은 작업 중 확인한 실패와 막힘을 기억·작업 규칙·실행 절차에 반영해, 사람이 같은 문제를 다시 지적하지 않아도 다음 작업에서 실수를 줄이는 것입니다. 원인을 확인하고 필요한 부분만 바꾸며, 다음 작업에서 적용과 효과를 확인하는 것까지를 지향합니다. 기록을 저장했다는 이유만으로 자동 개선이 끝났다고 보지는 않습니다.
-
-작업 규칙은 추가 개선을 제안할 때 해결할 실제 실패, 가장 작은 수정이라고 판단한 이유, 관측 가능한 완료 기준을 먼저 설명하도록 정합니다. 근거가 빠진 개선은 구현을 보류하며, 테스트 통과와 사용자 환경의 실제 동작 확인은 구분합니다.
-
-검증 결과는 [연결 검사·실환경 확인·모델 평가](./docs/harness.md#검증-결과-읽기)로 구분해 읽습니다. 도구에 요청을 전달했다는 표시만으로 사용자가 원한 작업까지 끝났다고 판단하지 않습니다.
-
-교차 검토를 닫을 때 검토 이후의 파일 변경·삭제를 알려 줍니다. 앞선 라운드에서 이미 검토한 삭제는 다른 파일의 후속 검토를 이어 가도 다시 경고하지 않습니다. 이 안내는 검토 통과 판정을 바꾸지 않습니다.
-
-세션은 관련 작업을 시작할 때 미결 항목과 미해결 실패를 현재 근거로 분류하고, 이미 승인된 범위 안의 실행 가능한 일만 원인 확인·처리·재검증한 뒤 문서를 맞춥니다. 막힌 실패는 증거와 재검증 기준을 `HANDOFF.md`에 남겨 다음 관련 세션이 이어받습니다. 백그라운드에서 스스로 고치는 기능은 아닙니다. 자세한 내용은 [하네스 안내](./docs/harness.md#미결-작업-처리)를 참고하세요.
-
-WSL에서 작업하는 프로젝트에 기존 Windows 사본이 연결되어 있으면, 작업 완료 후 검증·게시한 소스와 문서를 Windows 사본에도 같은 커밋으로 반영합니다. Windows에 별도로 남은 변경이나 갈라진 이력은 덮어쓰지 않고 알립니다. 실시간 양방향 동기화는 아니며, 설치된 프로필·인증정보·실행 산출물·독립 CLI는 복사하지 않습니다. Windows 전용 장비 프로젝트는 기존 위치와 도구를 유지합니다.
-
-Anthropic 구독 계정이 모두 주간 한도에 닿으면, 미리 둔 예비 API 키로 요청을 이어 갈 수 있습니다. 5시간 한도만 찬 경우에는 지금처럼 리셋을 기다리고, 주간 한도가 리셋되면 다시 구독 계정을 씁니다. 키는 폴백할 때만 읽고 에이전트가 실행하는 셸에는 넘기지 않습니다. 키를 두는 위치와 조건은 [하네스 안내](./docs/harness.md)에 있습니다.
-
-문서가 없는 프로젝트에서 처음 소스를 커밋하면, 커밋 결과에 그 프로젝트의 인계 문서와 작업 기록을 만들라는 알림이 붙습니다. 알림만 표시하고 커밋을 막지는 않습니다.
+- **One agent home, two surfaces**: the terminal `omp` CLI and the browser share the same `~/.omp/agent` sessions, credentials and model settings. Start in one, continue in the other.
+- **Multi-agent work you can inspect**: Main delegates to Makers; each task gets a card with live status, Main's review verdict, a flow graph and the files it changed.
+- **Accounts and models at a glance**: per-account usage cards with limit windows and reset guidance, plus model roles you switch from the composer.
+- **Voice call and face-to-face interpreter**: a live voice call with the agent, and an interpreter for Korean with English, Chinese, Vietnamese, Japanese or Thai, using your ChatGPT account or Google Cloud.
+- **Phone-ready**: install as a PWA, lock it with a password, and reach it over your own HTTPS proxy or VPN.
+- **A harness that learns from failures**: observed failures become rules and memory so the same mistake is not repeated. It is not an automatic background self-fix.
 
-주제별로 저장한 교훈을 정정하면 최초 기록과 최신 정정의 출처를 구분해 조회할 수 있습니다. 회상 목록에도 확인 가능한 전역·프로젝트 범위와 정정 정보를 표시합니다. 기억은 현재 요청과 저장소의 적용 조건을 대조하는 참고 자료이며 실행 승인을 대신하지 않습니다. 이전 교훈 본문을 별도 이력으로 쌓지는 않습니다. 자세한 보존 범위는 [하네스 안내](./docs/harness.md)를 참고하세요.
-
-교훈의 근거 파일명이나 제목에 비밀 토큰 형태의 문자열이 있으면 저장 전에 거절합니다. 거절된 정정은 기존 기억을 바꾸지 않습니다.
-
-이전 세션이나 압축 전 대화에서 빠진 사용자 지시·정정은 원문 회수 도구로 다시 확인할 수 있습니다. 현재 프로젝트와 각 세션의 선택된 분기를 기준으로 찾으며, 보관 세션·다른 프로젝트는 명시한 경우에만 포함합니다. 검색 한도에 걸리면 결과가 일부임을 표시하고, 원문을 읽기만 하며 현재 승인으로 되살리지 않습니다.
+### 한국어 요약
 
-하네스의 일반 비-UI 작업은 구성된 구현 후보 가운데 과제의 남은 판단과 검증 방법에 맞는 후보를 추천합니다. 한도 소진 때만 다른 후보를 쓰는 방식은 아니며, 근거가 부족하면 기존 기본값을 유지합니다. 추천은 Main의 선택을 돕는 정보이고 진행 중인 담당자의 모델을 바꾸지 않습니다.
+- **한 곳의 에이전트, 두 개의 화면**: 터미널 `omp` CLI와 브라우저가 같은 `~/.omp/agent`의 세션·계정·모델 설정을 씁니다. 터미널에서 하던 세션을 브라우저에서 이어 가고 다시 돌아갈 수 있습니다.
+- **들여다볼 수 있는 여러 에이전트 작업**: Main이 Maker에게 일을 맡기면 작업마다 카드가 붙어 실행 상태, Main의 검수 판정, 흐름 그래프, 바뀐 파일을 보여 줍니다.
+- **계정과 모델 한눈에**: 계정별 사용량 카드에서 한도 창과 리셋 권장을 보고, 입력창에서 모델 역할을 바꿉니다.
+- **실시간 통화와 대면 통역**: 에이전트와 음성으로 통화하고, 한국어와 영어·중국어·베트남어·일본어·태국어 사이를 ChatGPT 계정이나 Google Cloud로 통역합니다.
+- **휴대폰에서도**: PWA로 설치하고 비밀번호로 잠근 뒤, 직접 둔 HTTPS 프록시나 VPN으로 접속합니다.
+- **실패에서 배우는 하네스**: 작업 중 확인한 실패를 규칙과 기억에 반영해 같은 실수를 줄입니다. 백그라운드에서 저절로 고치는 기능은 아닙니다.
 
-컨텍스트 창과 압축 시작점은 따로 관리합니다. 실제 요청·압축 뒤 재탐색·보고 비용을 근거로 설정을 조정하고, 누락된 값은 미상으로 남기는 운영을 따릅니다. 외부 사례의 절감률을 보장하지 않으며 압축 뒤 기존 결정과 검증 증거를 이어받습니다. 설정과 해석은 [하네스 안내](./docs/harness.md#컨텍스트와-압축-운용)를 참고하세요.
+## Quick start
 
-큰 도구 출력에서 필요한 부분만 찾는 `artifact_search`를 제공합니다. 저장된 원문을 로컬 키워드로 검색하고, 찾은 구간을 원래 `read`로 다시 확인합니다. 기존 명령 실행과 파일 읽기를 대체하거나 다른 세션의 출력을 섞지 않습니다. 사용 범위와 한계는 [큰 출력 검색](./docs/harness.md#큰-출력-검색)을 참고하세요.
+```bash
+npm install -g cuelo
+cuelo setup
+cuelo start
+```
 
-작업을 시작할 때 회상된 교훈과 현재 요청의 적용 조건·예외·충돌을 점검해 에이전트에게 참고 안내를 제공합니다. 같은 입력은 반복 점검하지 않으며, 판단이 불명확하거나 점검에 실패해도 작업을 막지 않습니다. 현재 지시와 승인 범위가 우선입니다.
+Requires Node.js 22.19+ and Bun 1.4.2+. Open http://127.0.0.1:30141 and sign in with your own provider account. For a source install, see [실행하기](#실행하기) and [docs/installation.md](./docs/installation.md).
 
-**Keywords:** AI coding agent · agent harness · multi-agent orchestration · omp · oh-my-pi · model routing · developer tools
+**한국어:** 웹 앱은 omp SDK를 서버 안에서 실행하고, `omp` CLI와 같은 `~/.omp/agent` 디렉터리를 씁니다. 하네스의 세부 동작은 [하네스 세부 동작](#하네스-세부-동작)과 [하네스 안내](./docs/harness.md)에 있습니다.
 
 ## 이 저장소로 되는 것과 따로 필요한 것
 
@@ -131,13 +117,13 @@ Anthropic 구독 계정이 모두 주간 한도에 닿으면, 미리 둔 예비
 
 **통역**
 
-- 사이드바의 「통역」을 고르면 작업 화면 위에 통역 화면이 열립니다. 한국어·영어·베트남어·일본어·태국어 가운데 내 언어와 상대 언어를 고르고 「통역 시작」을 누르면, 휴대폰을 두 사람 사이에 두고 각자 말하기만 하면 됩니다. 누가 말하든 상대 언어로 바로 소리 내어 옮깁니다. 버튼을 번갈아 누를 필요가 없습니다.
-- 통역은 연결된 ChatGPT 계정의 Codex 라이브 음성 통화로 합니다. 통화에는 고른 두 언어로 만든 통역 지시와, 고른 분위기·내 성별·나이대, 통화를 다시 열 때의 최근 통역 대화만 들어갑니다. 작업 세션·하네스 규칙·작업 대화 기록은 들어가지 않으며 작업을 위임하지도 않습니다. 목소리와 말 빠르기(보통·천천히)는 **설정 → 통화 음성**에서 고른 값을 씁니다.
+- 사이드바의 「통역」을 고르면 작업 화면 위에 통역 화면이 열립니다. 한국어·영어·중국어·베트남어·일본어·태국어 가운데 내 언어와 상대 언어를 고르고 「통역 시작」을 누르면, 휴대폰을 두 사람 사이에 두고 각자 말하기만 하면 됩니다. 누가 말하든 상대 언어로 바로 소리 내어 옮깁니다. 버튼을 번갈아 누를 필요가 없습니다.
+- 통역은 기존 ChatGPT 계정과 **Google Cloud 인증** 가운데 골라 연결할 수 있습니다. 기본값은 기존 ChatGPT 연결이고, Cloud 방식은 서버에 설정한 로그인 인증과 프로젝트를 사용합니다. 통역에는 고른 두 언어, 분위기·내 성별·나이대와 다시 연결할 때의 최근 전사만 들어갑니다. 작업 세션·하네스 규칙·작업 대화 기록은 들어가지 않으며 작업을 위임하지도 않습니다. 기존 연결의 목소리는 **설정 → 통화 음성**의 값을 씁니다. 연결별 준비와 과금 조건은 [라이브 통화 안내](./docs/live-voice.md#통역-엔진-선택)를 확인하세요.
 - 통역은 낱말을 그대로 옮기지 않고 앞 대화를 보고 뜻을 옮깁니다. 한국어에서 빠진 주어도 앞 대화로 채우고, 앞에서 나온 것을 「그거」, 「첫 번째 걸로」처럼 가리키면 그 이름으로 옮깁니다(쌀국수 두 가지를 들은 뒤 「첫 번째 걸로」는 「phở bò로」). 무엇을 가리키는지 애매하면 들은 그대로 옮깁니다. 이름·숫자·가격은 그대로 지킵니다. 베트남어의 anh·chị·em·chú·cô 같은 호칭, 태국어의 ครับ·ค่ะ, 일본어 존댓말을 상대와 분위기에 맞게 고릅니다.
-- 「분위기」(편하게, 정중하게, 격식 있게, 흥정, 긴급)와 「내 성별」·「내 나이대」를 고르면 그 말투와 호칭으로 통역합니다. 흥정은 가격·수량을 정확히 지키며 흥정하는 말투로, 긴급은 빠뜨리는 말 없이 분명하게 옮깁니다. 세 칸 모두 고르지 않아도 되고, 고른 값은 브라우저에 기억하며, 통역 중에 바꾸면 새 설정으로 다시 연결합니다.
-- 화면에는 오간 말이 말풍선 자막으로 쌓입니다. 큰 글씨가 통역, 작은 글씨가 들은 원문입니다. 글자(한글·가나·태국 문자·베트남어 성조 부호 등)로 누가 말했는지 가려 내 말은 오른쪽, 상대 말은 왼쪽에 둡니다. 영어와 베트남어처럼 같은 글자를 쓰는 짝에서 이름·숫자만 말해 가를 수 없으면 왼쪽에 둡니다.
-- 통역 화면을 열거나 언어를 바꾸거나 통역을 끝내면, 고른 언어 짝으로 통화를 미리 연결해 25초쯤 기다립니다. 그 안에 「통역 시작」을 누르면 연결을 기다리지 않고 바로 듣기 시작하고, 그보다 늦으면 전처럼 누른 뒤에 연결합니다. 미리 연결할 때는 마이크를 열지 않습니다. 마이크는 「통역 시작」을 누른 뒤에야 켜집니다. 화면을 닫으면 미리 연결한 통화도 끊습니다.
-- 통역 중에 언어를 바꾸면 새 언어 짝으로 다시 연결합니다. 한동안 아무도 말하지 않아 통화가 끊기거나, 와이파이와 모바일 데이터가 바뀌어 연결이 끊기면 마이크를 켠 채 바로 다시 연결하고 앞 대화를 이어서 통역합니다. 다시 연결하는 동안에는 「다시 연결 중…」이 보입니다. 5분쯤 아무 말이 없으면 통역을 멈추고 알려 줍니다. 「대화로」를 누르면 통화와 마이크를 끝냅니다. 마이크는 HTTPS 주소에서만 켜지며, 통역 기록은 화면이 열려 있는 동안만 보관하고 서버에 저장하지 않습니다. 직접 입력해 번역하는 칸과 말풍선 다시 듣기는 없습니다.
+- 「분위기」(편하게, 정중하게, 격식 있게, 흥정, 긴급)와 「내 성별」·「내 나이대」는 모든 통역 연결에서 공통으로 설정할 수 있습니다. 고른 값은 브라우저에 기억하고, 엔진을 바꿔도 유지하며 새 통역에 반영합니다. 세 칸 모두 고르지 않아도 됩니다.
+- 자막은 **통역**과 **들은 원문**을 별도 흐름으로 보여 줍니다. 긴 말의 원문과 통역이 서로 다른 시점에 도착해도 한 문장씩 억지로 짝짓지 않습니다. 휴대폰에서는 통역이 위에, 원문이 아래에 놓이며 넓은 화면에서는 나란히 읽습니다.
+- 통역 화면을 열면 고른 연결의 준비 상태를 확인합니다. 일부 연결 방식은 화면을 열거나 언어를 바꾸거나 통역을 끝낸 뒤 통화를 잠시 미리 연결하며, 「통역 시작」을 누르면 준비된 연결을 사용합니다. 준비 시간이 지나면 누른 뒤 새로 연결합니다. 준비 중에는 마이크를 열지 않습니다. 마이크는 「통역 시작」을 누른 뒤에야 켜지고, 화면을 닫으면 준비된 통화도 끊습니다.
+- 통역 중에 언어나 분위기·화자 설정을 바꾸면 새 설정으로 다시 연결합니다. 와이파이와 모바일 데이터 전환 등으로 연결이 끊기면 마이크를 유지하며 다시 연결하고 앞 대화를 이어갑니다. 그동안 「다시 연결 중…」이 보이며, 말없이 재연결이 반복되면 통역을 멈추고 알려 줍니다. 「대화로」를 누르면 통화와 마이크를 끝냅니다. 마이크는 HTTPS 주소에서만 켜지며, 통역 기록은 화면이 열려 있는 동안 유지하고 CUELO 서버에 영구 저장하지 않습니다. 직접 입력해 번역하는 칸과 자막 다시 듣기는 없습니다.
 - 「마주보기」를 켜면 화면 전체가 위아래로 나뉩니다. 위쪽은 뒤집혀 맞은편 사람이 자기 언어로, 아래쪽은 내가 내 언어로 최근 말을 큰 글씨로 읽고, 가운데 띠에서 통역을 시작·끝내거나 마주보기를 끕니다. 통역하는 동안에는 휴대폰 화면이 꺼지지 않습니다.
 - 통역을 시작하면 언어·분위기 칸이 접히고 맨 윗줄에 언어 짝만 남습니다. 언어 짝을 누르면 다시 펼쳐집니다. 방금 오간 말은 크게, 지난 말은 작고 흐리게 보이고, 「가」 단추로 글자 크기를 세 단계로 바꿀 수 있습니다. 화면 아래에는 지금 상태(연결 중, 듣는 중, 옮기는 중, 다시 연결 중)가 색 점과 글로 보입니다.
 - 홈 화면에 설치한 앱에서는 `/?view=translator` 주소로 열면 처음부터 통역 화면이 열립니다. Android에서는 앱 아이콘을 길게 눌러 「통역」 바로가기를 고를 수 있습니다.
@@ -169,6 +155,48 @@ Anthropic 구독 계정이 모두 주간 한도에 닿으면, 미리 둔 예비
 - 프로젝트 신뢰: 설정에서 프로젝트별 승인을 관리·해제하고, 실행 중에는 작업을 끊지 않고 신뢰 승인을 예약합니다. 신뢰하지 않은 저장소의 확장·훅·도구·MCP는 실행하지 않습니다([docs/project-trust.md](./docs/project-trust.md)).
 - 비밀번호 잠금(HTTP Basic Auth, scrypt 해시 저장)과 `/recover` 복구([docs/authentication.md](./docs/authentication.md)).
 
+## 하네스 세부 동작
+
+내장 OMP 코어는 **18.12.6**입니다. 별도로 설치한 `omp` CLI의 버전은 웹 업데이트와 독립적이며, 앱에 포함된 CLI를 `omp` 명령으로 사용하는 설치에서는 웹과 같은 코어를 사용합니다.
+
+문서 하네스는 기존 Word·Excel·PowerPoint 문서를 열고 편집하거나 변환할 때 LibreOffice를 우선 사용합니다. 원본은 보존하고 출력 결과를 확인하며, 매크로·전용 기능·서식 호환성이 필요하거나 사용자가 지정하면 MS Office를 사용합니다.
+
+장기 백그라운드 작업은 관측 기한이 되면 대기를 깨워 상태를 확인하게 합니다. 이미 끝난 결과는 먼저 회수하며, 작업을 자동으로 취소하거나 재실행하지 않습니다. [하네스 안내](./docs/harness.md#발주와-검수-계약)에 적용 범위와 확인 방법이 있습니다.
+
+취소되거나 시간초과된 하위 작업의 늦은 완료 내용은 기존 수용 결과를 덮어쓰지 않습니다. 중단 상태는 성공으로 바뀌지 않으며, 진단용 내용과 기록된 사용량은 별도로 남습니다. 이미 실행된 외부 작업이나 과금을 되돌리는 기능은 아닙니다.
+
+소스가 없는 .NET 어셈블리와 JavaScript/Electron 배포물은 [REA 선택 연결 안내](./docs/harness.md#바이너리-분석용-rea-연결선택)에 따라 정적으로 조사할 수 있습니다. Linux에서 기존 MCP 연결·도구 상속·제한 세션 동작을 검증했으며, 프로젝트별 등록은 승인 뒤에만 수행합니다. Windows REA 호환성은 아직 확인하지 않았습니다.
+
+CUELO의 목적은 작업 중 확인한 실패와 막힘을 기억·작업 규칙·실행 절차에 반영해, 사람이 같은 문제를 다시 지적하지 않아도 다음 작업에서 실수를 줄이는 것입니다. 원인을 확인하고 필요한 부분만 바꾸며, 다음 작업에서 적용과 효과를 확인하는 것까지를 지향합니다. 기록을 저장했다는 이유만으로 자동 개선이 끝났다고 보지는 않습니다.
+
+작업 규칙은 추가 개선을 제안할 때 해결할 실제 실패, 가장 작은 수정이라고 판단한 이유, 관측 가능한 완료 기준을 먼저 설명하도록 정합니다. 근거가 빠진 개선은 구현을 보류하며, 테스트 통과와 사용자 환경의 실제 동작 확인은 구분합니다.
+
+검증 결과는 [연결 검사·실환경 확인·모델 평가](./docs/harness.md#검증-결과-읽기)로 구분해 읽습니다. 도구에 요청을 전달했다는 표시만으로 사용자가 원한 작업까지 끝났다고 판단하지 않습니다.
+
+교차 검토를 닫을 때 검토 이후의 파일 변경·삭제를 알려 줍니다. 앞선 라운드에서 이미 검토한 삭제는 다른 파일의 후속 검토를 이어 가도 다시 경고하지 않습니다. 이 안내는 검토 통과 판정을 바꾸지 않습니다.
+
+세션은 관련 작업을 시작할 때 미결 항목과 미해결 실패를 현재 근거로 분류하고, 이미 승인된 범위 안의 실행 가능한 일만 원인 확인·처리·재검증한 뒤 문서를 맞춥니다. 막힌 실패는 증거와 재검증 기준을 `HANDOFF.md`에 남겨 다음 관련 세션이 이어받습니다. 백그라운드에서 스스로 고치는 기능은 아닙니다. 자세한 내용은 [하네스 안내](./docs/harness.md#미결-작업-처리)를 참고하세요.
+
+WSL에서 작업하는 프로젝트에 기존 Windows 사본이 연결되어 있으면, 작업 완료 후 검증·게시한 소스와 문서를 Windows 사본에도 같은 커밋으로 반영합니다. Windows에 별도로 남은 변경이나 갈라진 이력은 덮어쓰지 않고 알립니다. 실시간 양방향 동기화는 아니며, 설치된 프로필·인증정보·실행 산출물·독립 CLI는 복사하지 않습니다. Windows 전용 장비 프로젝트는 기존 위치와 도구를 유지합니다.
+
+Anthropic 구독 계정이 모두 주간 한도에 닿으면, 미리 둔 예비 API 키로 요청을 이어 갈 수 있습니다. 5시간 한도만 찬 경우에는 지금처럼 리셋을 기다리고, 주간 한도가 리셋되면 다시 구독 계정을 씁니다. 키는 폴백할 때만 읽고 에이전트가 실행하는 셸에는 넘기지 않습니다. 키를 두는 위치와 조건은 [하네스 안내](./docs/harness.md)에 있습니다.
+
+문서가 없는 프로젝트에서 처음 소스를 커밋하면, 커밋 결과에 그 프로젝트의 인계 문서와 작업 기록을 만들라는 알림이 붙습니다. 알림만 표시하고 커밋을 막지는 않습니다.
+
+주제별로 저장한 교훈을 정정하면 최초 기록과 최신 정정의 출처를 구분해 조회할 수 있습니다. 회상 목록에도 확인 가능한 전역·프로젝트 범위와 정정 정보를 표시합니다. 기억은 현재 요청과 저장소의 적용 조건을 대조하는 참고 자료이며 실행 승인을 대신하지 않습니다. 이전 교훈 본문을 별도 이력으로 쌓지는 않습니다. 자세한 보존 범위는 [하네스 안내](./docs/harness.md)를 참고하세요.
+
+교훈의 근거 파일명이나 제목에 비밀 토큰 형태의 문자열이 있으면 저장 전에 거절합니다. 거절된 정정은 기존 기억을 바꾸지 않습니다.
+
+이전 세션이나 압축 전 대화에서 빠진 사용자 지시·정정은 원문 회수 도구로 다시 확인할 수 있습니다. 현재 프로젝트와 각 세션의 선택된 분기를 기준으로 찾으며, 보관 세션·다른 프로젝트는 명시한 경우에만 포함합니다. 검색 한도에 걸리면 결과가 일부임을 표시하고, 원문을 읽기만 하며 현재 승인으로 되살리지 않습니다.
+
+하네스의 일반 비-UI 작업은 구성된 구현 후보 가운데 과제의 남은 판단과 검증 방법에 맞는 후보를 추천합니다. 한도 소진 때만 다른 후보를 쓰는 방식은 아니며, 근거가 부족하면 기존 기본값을 유지합니다. 추천은 Main의 선택을 돕는 정보이고 진행 중인 담당자의 모델을 바꾸지 않습니다.
+
+컨텍스트 창과 압축 시작점은 따로 관리합니다. 실제 요청·압축 뒤 재탐색·보고 비용을 근거로 설정을 조정하고, 누락된 값은 미상으로 남기는 운영을 따릅니다. 외부 사례의 절감률을 보장하지 않으며 압축 뒤 기존 결정과 검증 증거를 이어받습니다. 설정과 해석은 [하네스 안내](./docs/harness.md#컨텍스트와-압축-운용)를 참고하세요.
+
+큰 도구 출력에서 필요한 부분만 찾는 `artifact_search`를 제공합니다. 저장된 원문을 로컬 키워드로 검색하고, 찾은 구간을 원래 `read`로 다시 확인합니다. 기존 명령 실행과 파일 읽기를 대체하거나 다른 세션의 출력을 섞지 않습니다. 사용 범위와 한계는 [큰 출력 검색](./docs/harness.md#큰-출력-검색)을 참고하세요.
+
+작업을 시작할 때 회상된 교훈과 현재 요청의 적용 조건·예외·충돌을 점검해 에이전트에게 참고 안내를 제공합니다. 같은 입력은 반복 점검하지 않으며, 판단이 불명확하거나 점검에 실패해도 작업을 막지 않습니다. 현재 지시와 승인 범위가 우선입니다.
+
 ## 실행하기
 
 CUELO는 GitHub 소스와 npm 패키지 [`cuelo`](https://www.npmjs.com/package/cuelo)로 설치합니다. npm의 `omp-web`은 upstream 프로젝트이며 CUELO와 별개입니다. **기존 `omp` CLI만 설치한 PC에도 `omp-web` 없이 CUELO를 추가할 수 있습니다.** 기존 `config.yml`·계정·세션을 보존하는 순서는 [대표 설치 경로](./docs/installation.md#대표-경로-omp만-있는-windows-pc-omp-web-없음)에 있습니다.

package/Tools/CUELO_Setup/files/native-runtime-patch.js

@@ -9,7 +9,7 @@ const MEMORY_RE = /(const phase1Model = await resolveMemoryModel\(\{[^}]*?fallba
 const MEMORY_DONE = /const phase1Model = await resolveMemoryModel\(\{[^}]*?fallbackRole: "smol"/;
 const EXPECTED = {
     name: 'cuelo',
-    version: '0.10.72',
+    version: '0.10.74',
     distribution: 'cuelo',
     coreVersion: '18.12.6',
 };

package/Tools/OMP_Global_Config/agent/RULES.md

@@ -82,11 +82,16 @@
 - 여러 파일을 훑거나 문서·README·저장소 구조를 조사할 때는 먼저 `skim`에 질문한다. 허용 텍스트 파일
   내용은 `skim` 역할 모델(Hive의 DeepSeek v4.1 Flash 1017)로 전송된다. 이 모델이 고정 대체 모델과 같아
   실패해도 다시 부르지 않고 오류로 끝난다. 비밀 자료를 대상으로 삼지 말고, 수정할 정확한 줄은 `read`로 확인한다.
-- 문서 초안(md·csv·Excel·Word·PDF 보고서·표)이 필요하면 Main·Maker 모두 먼저 `draft`로 쓴다. Gemini가
-  작성해 cwd 안에 저장하고, 실패하면 Hive의 DeepSeek 1017로 한 번 대체한다(참고 텍스트는 Google 또는 Hive로 전송).
-  만들어진 파일은 직접 열어 검토한 뒤 쓴다. 코드·설정·규칙·`HANDOFF.md`·작업 기록·정확한 줄 수정은 초안이
-  아니므로 `edit`/`write`를 쓴다. Gemini는 번역·문서 다듬기(`draft`)와 OCR 후보(`retry.fallbackChains.ocr`)에만
-  쓰며 같은 Antigravity 계정 할당량을 공유한다.
+- **글씨가 들어가는 콘텐츠는 Gemini가 먼저 쓰고 AI 슬롭 점검을 거친다(2026-10-25 사용자 결정).** 새로 쓰거나 한 문단
+  이상 다시 쓰는 글은 Main·Maker 모두 먼저 `draft`로 쓴다. README·CHANGELOG·`docs/`·보고서·안내서·소개 글·게시물,
+  `HANDOFF.md`·`doc/history` 작업 기록의 서술, md·csv·Excel·Word·PDF 보고서·표, PPT 슬라이드 문구, HTML·웹 화면과
+  UI의 문구가 모두 대상이다. 사실·수치·경로·명령·커밋은 `instruction`이나 `paths`로 넘겨 모델이 지어내지 않게 한다.
+  Gemini가 작성해 cwd 안에 저장하고, 실패하면 Hive의 DeepSeek 1017로 한 번 대체한다(참고 텍스트는 Google 또는 Hive로
+  전송). 결과는 직접 열어 사실·형식을 검토하고, 반영하기 전에 AI 슬롭 점검을 같은 작업에서 돌린다: 한국어 글은
+  `humanizer`, 영어 글은 `stop-slop`, 화면·UI 문구는 `kill-ai-slop` 스킬 절차를 따른다. 틀린 사실과 슬롭만 고쳐
+  `edit`로 반영한다. 코드·설정·규칙 파일(`RULES.md`·`AGENTS.md`·`rules/`·SOP), 몇 줄 이하의 정확한 수정, 사용자에게
+  하는 대화 답변은 대상이 아니다. Gemini는 이 글쓰기·번역과 OCR 후보(`retry.fallbackChains.ocr`)에 쓰며 같은
+  Antigravity 계정 할당량을 공유한다.
 - **문서 기본 편집 도구는 LibreOffice다(2026-10-15 사용자 결정).** 기존 Word·Excel·PowerPoint 문서의
   열기·편집·변환은 Writer·Calc·Impress를 우선 사용한다. 새 문서 초안은 위 `draft` 규칙을 따른다.
   MS Office는 사용자가 지정했거나, 매크로·외부 연결·전용 기능·서식 호환성 때문에 필요한 경우에 쓴다.