@agent-native/core 0.93.0 → 0.94.0

package/docs/content/locales/ko-KR/cross-app-sso.mdx

@@ -9,7 +9,11 @@ description: "Dispatch를 ID 기관으로 사용하여 ID 페더레이션을 통
 
 이것은 이미 사용하고 있는 동일한 신뢰 기본 요소 [A2A](/docs/a2a-protocol) 및 [External Agents](/docs/external-agents)(요청 경계에서 확인된 `A2A_SECRET` 서명 JWT)로 에이전트 간 호출 대신 인간 로그인 경로에 적용됩니다.
 
-> **통합 배포와 도메인별 배포.** 하나의 원본(`your-agents.com/mail`, `your-agents.com/calendar`)에서 모든 앱을 호스팅하는 경우 이미 단일 쿠키 도메인을 통해 공유 로그인을 받고 있으므로 페더레이션이 필요하지 않습니다. Cross-App SSO는 앱이 별도의 도메인에서 실행되는 경우에만 필요합니다. [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)를 참조하세요.
+<Callout tone="info">
+
+**통합 배포와 도메인별 배포.** 하나의 원본(`your-agents.com/mail`, `your-agents.com/calendar`)에서 모든 앱을 호스팅하는 경우 이미 단일 쿠키 도메인을 통해 공유 로그인을 받고 있으므로 페더레이션이 필요하지 않습니다. Cross-App SSO는 앱이 별도의 도메인에서 실행되는 경우에만 필요합니다. [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment)를 참조하세요.
+
+</Callout>
 
 ## 무엇과 이유 {#what-why}
 
@@ -86,15 +90,17 @@ description: "Dispatch를 ID 기관으로 사용하여 ID 페더레이션을 통
 
 </Diagram>
 
-1. **앱 → 디스패치(승인).** 앱이 사용자를 신원 인증 기관으로 보냅니다:
+1. **앱 → Dispatch(승인).** 앱의 `GET /_agent-native/identity/login` 경로(“Agent-Native로 로그인” 버튼이 연결되는 경로)가 리디렉션을 구성하고 사용자를 ID 기관으로 보냅니다.
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri`는 이 앱의 `GET /_agent-native/identity/callback` 경로이며, 3단계에서 서명된 토큰을 받는 경로입니다.
+
 <Endpoint id="cross-app-sso-identity-authorize-ko-kr" title={"ID 인증 엔드포인트"} method="GET" path="/_agent-native/identity/authorize" summary={"디스패치(ID 기관)는 사람을 인증하고 서명된 ID 토큰으로 다시 리디렉션합니다."} auth={"디스패치 세션(없는 경우 대화형 로그인)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ description: "Dispatch를 ID 기관으로 사용하여 ID 페더레이션을 통
    | `scope`      | 항상 `"identity"` — 이 토큰은 로그인만 승인합니다 |
    | `exp`        | **≤ 2분** 문제 발생 후                            |
 
-4. **앱은 이메일로 확인하고 JIT 연결합니다.** 앱은 자체 `A2A_SECRET`로 토큰 서명을 확인하고 `scope: "identity"` 및 `exp`를 확인한 다음 **확인된 이메일을 통해 엄격하게 적시 연결**을 수행합니다.
+4. **앱은 이메일로 확인하고 JIT 연결합니다.** 앱의 `GET /_agent-native/identity/callback` 경로는 자체 `A2A_SECRET`로 토큰 서명을 확인하고 `scope: "identity"`와 `exp`를 검사한 다음 **확인된 이메일만으로 적시 연결**을 수행합니다.
    - 해당 이메일을 가진 로컬 사용자가 존재하는 경우 → 변경하지 않고 다시 사용하세요.
    - 그렇지 않은 경우 → 해당 이메일에 대한 로컬 사용자를 생성하세요.
 
@@ -292,9 +298,13 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 **5. 롤백 = 해당 앱 배포 시 환경 변수 설정을 해제합니다.**
 앱을 되돌리려면 **해당 앱 환경에서 `AGENT_NATIVE_IDENTITY_HUB_URL`를 제거하고 다시 배포/다시 시작하세요.** 앱은 즉시 이전 인증 동작으로 돌아갑니다. **실행 취소할 데이터 변경은 없습니다**. ID 행은 추가만 되었으며 변수를 설정 해제하면 페더레이션 경로가 다시 휴면 상태가 됩니다. 각 앱의 컷오버 및 롤백은 독립적이며 되돌릴 수 있습니다.
 
-> 롤아웃은 각 앱이 활성화될 때 사용자를 로그아웃하지만(Dispatch를 통해 다시 인증) 항상 **데이터가 그대로 유지된 동일한 이메일 일치 계정**에 다시 로그인합니다. 왜냐하면 ID 행은 절대 삭제되거나 이름이 바뀌지 않고 추가만 되기 때문입니다.
+<Callout tone="info">
+
+롤아웃은 각 앱이 활성화될 때 사용자를 로그아웃하지만(Dispatch를 통해 다시 인증) 항상 **데이터가 그대로 유지된 동일한 이메일 일치 계정**에 다시 로그인합니다. 왜냐하면 ID 행은 절대 삭제되거나 이름이 바뀌지 않고 추가만 되기 때문입니다.
+
+</Callout>
 
-## 관련 {#related}
+## 다음 단계 {#whats-next}
 
 - [Authentication](/docs/authentication) — 로컬 인증 모드, 세션, 조직, `A2A_SECRET` 환경 변수
 - [A2A Protocol](/docs/a2a-protocol) — 서명된 JWT, 경계에서 검증 신뢰 모델을 재사용합니다.

package/docs/content/locales/ko-KR/deployment.mdx

@@ -452,3 +452,11 @@ export default createAgentChatPlugin({
 ## 다중 인스턴스 배포 {#multi-instance}
 
 에이전트 네이티브 앱은 Drizzle를 통해 SQL에 모든 상태를 저장하고 [polling](/docs/key-concepts#polling-sync)를 통해 UI를 데이터베이스와 동기화합니다. 파일 시스템 상태, 고정 세션, 메모리 내 캐시가 없습니다. 이는 다중 인스턴스 및 서버리스 배포가 즉시 작동한다는 것을 의미합니다. 모든 인스턴스가 동일한 `DATABASE_URL`를 가리키면 자동으로 수렴됩니다. [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) 및 [Portability](/docs/key-concepts#hosting-agnostic)를 참조하세요.
+
+## 다음 단계
+
+- [**Database**](/docs/database#production) — 첫 프로덕션 배포 전에 영구 SQL 백엔드를 선택합니다
+- [**Security**](/docs/security) — 이 페이지에서 언급한 프로덕션 체크리스트와 선택적 플래그입니다
+- [**Authentication**](/docs/authentication) — 선택한 인증 모드의 OAuth 자격 증명과 환경 변수입니다
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — `deploy`의 단일 오리진 빌드 기반이 되는 워크스페이스 모델입니다
+- [**Frames**](/docs/frames) — 프로덕션 UI 편집을 위한 내장 에이전트 패널과 Builder.io 클라우드 프레임의 차이입니다

package/docs/content/locales/ko-KR/external-agents.mdx

@@ -136,13 +136,8 @@ OAuth 토큰. ChatGPT는 검토 또는 게시된 커넥터 도구를 유지할
 도구 또는 MCP 앱 메타데이터가 변경되었습니다. 아직 오래된 앱별 커넥터가 있는 경우
 각 오래된 커넥터를 디스패치, 새로 고치거나 다시 연결하는 것과 함께 활성화됩니다. 업데이트 중
 디스패치는 ChatGPT 또는 Claude의 캐시된 캘린더/메일/등을 다시 쓰지 않습니다.
-스냅샷. 범위는 다음과 같습니다:
-
-| 범위        | 그것이 가능하게 하는 것                   |
-| ----------- | ----------------------------------------- |
-| `mcp:read`  | 읽기 전용 도구 및 도구/리소스 검색        |
-| `mcp:write` | 초안 작성, 업데이트 및 기타 actions 변형  |
-| `mcp:apps`  | 인라인 MCP 앱, 차트, 대시보드, 초안 및 UI |
+스냅샷. `mcp:read` / `mcp:write` / `mcp:apps` 범위는 아래의
+[표준 원격 MCP OAuth](#standard-oauth)에서 설명하는 범위와 같습니다.
 
 Cursor, Goose, Postman, MCPJam 및 VS Code GitHub Copilot은 동일한 리모컨을 사용합니다.
 빌드가 원격 OAuth를 지원하는 경우 자체 MCP 서버 UI를 통해 MCP URL

package/docs/content/locales/ko-KR/key-concepts.mdx

@@ -11,11 +11,9 @@ description: "에이전트 네이티브 앱 작동 방식: actions 우선, SQL
 
 모든 에이전트 기반 앱은 세 가지가 함께 작동합니다.
 
-> **에이전트** — 데이터를 읽고, 쓰고, actions를 실행하고, 코드를 수정하는 자율 AI입니다. skills 및 지침으로 사용자 정의할 수 있습니다.
->
-> **적용** — 에이전트 주변의 제품 표면. 처음에는 작업만 수행할 수도 있고, 풍부한 채팅, 작은 제어 영역 또는 대시보드, 흐름, 시각화가 포함된 전체 React UI 화면일 수도 있습니다.
->
-> **컴퓨터** — 데이터베이스, 브라우저, 코드 실행. 에이전트는 SQL 및 내장 도구를 사용하여 직접 작업합니다. MCP 서버는 기본이 아닌 선택적인 추가 기능입니다.
+- **에이전트** — 데이터를 읽고, 쓰고, actions를 실행하고, 코드를 수정하는 자율 AI입니다. skills 및 지침으로 사용자 정의할 수 있습니다.
+- **적용** — 에이전트 주변의 제품 표면. 처음에는 작업만 수행할 수도 있고, 풍부한 채팅, 작은 제어 영역 또는 대시보드, 흐름, 시각화가 포함된 전체 React UI 화면일 수도 있습니다.
+- **컴퓨터** — 데이터베이스, 브라우저, 코드 실행. 에이전트는 SQL 및 내장 도구를 사용하여 직접 작업합니다. MCP 서버는 기본이 아닌 선택적인 추가 기능입니다.
 
 <Diagram id="doc-block-nxqkcw" title={"에이전트, 애플리케이션 및 컴퓨터"} summary={"하나의 공유 SQL 저장소에서 세 개의 레이어가 함께 작동합니다. 에이전트와 애플리케이션은 모두 동일한 데이터를 읽고 씁니다."}>
 
@@ -278,8 +276,7 @@ LLM를 인라인으로 호출하면 어떨까요?
 
 에이전트가 API 호출, 데이터 처리, 데이터베이스 쿼리 등 복잡한 작업을 수행해야 하는 경우 **작업**을 실행합니다. Actions는 기본 `defineAction()`를 내보내는 `actions/`의 TypeScript 파일입니다.
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -381,9 +378,8 @@ useDbSync({ queryClient });
 
 에이전트 네이티브 앱에는 UI 앱과 함께 AI 에이전트를 제공하는 내장형 에이전트 패널이 포함되어 있습니다. 이것이 아키텍처가 작동하는 이유입니다. 에이전트에는 컴퓨터(데이터베이스, 브라우저, 코드 실행)가 필요하고 앱에는 AI 작업을 위한 에이전트가 필요합니다.
 
-> **내장형 에이전트 패널** — 모든 앱에 채팅 및 선택적 CLI 터미널이 내장되어 있습니다. Claude 코드, Codex, Gemini, OpenCode 및 Builder.io를 지원합니다. 로컬로 실행됩니다. 무료 오픈 소스.
->
-> **클라우드** — 실시간 공동 작업, 시각적 편집, 역할 및 권한을 통해 모든 클라우드에 배포합니다. 팀에 가장 적합합니다.
+- **내장형 에이전트 패널** — 모든 앱에 채팅 및 선택적 CLI 터미널이 내장되어 있습니다. Claude 코드, Codex, Gemini, OpenCode 및 Builder.io를 지원합니다. 로컬로 실행됩니다. 무료 오픈 소스.
+- **클라우드** — 실시간 공동 작업, 시각적 편집, 역할 및 권한을 통해 모든 클라우드에 배포합니다. 팀에 가장 적합합니다.
 
 ## 상황 인식 {#context-awareness}
 
@@ -455,14 +451,11 @@ UI는 경로 변경 시 이를 기록합니다. 상담원은 조치를 취하기
 
 이것이 바로 당신이 직접 접착했을 "및 기타 모든 것"입니다.
 
-## 심층 분석 {#deep-dives}
-
-특정 패턴에 대한 자세한 지침:
+## 다음 단계 {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — 비전과 철학
-- [Context Awareness](/docs/context-awareness) — 탐색 상태, 화면 보기, 명령 탐색
-- [Skills Guide](/docs/skills-guide) — 프레임워크 skills, 도메인 skills, 사용자 정의 skills 만들기
-- [Native 채팅 UI](/docs/native-chat-ui) — 작업 선언 테이블, 차트 및 BYO 런타임 상태
-- [Agent Surfaces](/docs/agent-surfaces) — 헤드리스, 풍부한 채팅, 내장형 사이드카 및 전체 앱 경로
-- [A2A Protocol](/docs/a2a-protocol) — 에이전트 간 통신
-- [Multi-App Workspace](/docs/multi-app-workspace) — 공유 인증, skills, 구성 요소 및 자격 증명을 사용하여 하나의 단일 저장소에서 여러 앱을 호스팅합니다.
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — 이러한 규칙의 비전과 철학입니다
+- [**Context Awareness**](/docs/context-awareness) — 탐색 상태, view-screen 및 navigate 명령을 자세히 설명합니다
+- [**Skills Guide**](/docs/skills-guide) — 프레임워크 skills, 도메인 skills 및 사용자 지정 skills 만들기입니다
+- [**Native Chat UI**](/docs/native-chat-ui) — action에서 선언한 표와 차트 및 자체 런타임 지원 방식입니다
+- [**Agent Surfaces**](/docs/agent-surfaces) — 채팅, 네이티브 인라인 UI, 전체 앱 페이지, 내장 sidecar, 자동화 및 외부 에이전트 경로입니다
+- [**A2A Protocol**](/docs/a2a-protocol) — 에이전트 간 통신입니다

package/docs/content/locales/ko-KR/multi-tenancy.mdx

@@ -17,7 +17,7 @@ description: "모든 에이전트 기반 앱은 구성이 필요 없는 조직,
 - **조직 전환** — 세션은 활성 조직(`session.orgId`)을 추적하고 이를 전환하면 사용자와 상담원이 보는 데이터가 변경됩니다.
 - **조직별 데이터 격리** — 모든 쿼리는 자동으로 활성 조직으로 범위가 지정됩니다.
 
-CRM, 프로젝트 추적기, 지원 받은 편지함 또는 모든 팀 도구에 대한 에이전트 기반을 평가하는 경우 다중 테넌트 기반이 이미 존재합니다. 모든 자사 템플릿은 다중 테넌트입니다. 목록은 [Cloneable SaaS templates](/docs/cloneable-saas)를 참조하세요.
+CRM, 프로젝트 추적기, 지원 받은 편지함 또는 모든 팀 도구에 대한 에이전트 기반을 평가하는 경우 다중 테넌트 기반이 이미 존재합니다. 모든 자사 템플릿은 다중 테넌트입니다. 목록은 [템플릿](/docs/cloneable-saas)를 참조하세요.
 
 <Diagram id="doc-block-7qqrxz" title={"조직 멤버십 및 격리"} summary={"사용자는 owner/admin/member로 조직에 가입합니다. 모든 소유 가능 행은 이를 소유한 테넌트의 org_id을 전달하며 경계를 넘어 누출되는 행은 없습니다."}>
 
@@ -117,8 +117,8 @@ CRM, 프로젝트 추적기, 지원 받은 편지함 또는 모든 팀 도구에
 
 이것은 사용자별 범위 지정에 사용되는 것과 동일한 파이프라인입니다. SQL 수준 메커니즘, `ownableColumns()` 계약 및 `accessFilter` / `resolveAccess` / `assertAccess` 가드에 대해서는 범위 지정 파이프라인을 위한 단일 정보 소스인 [Security → Data Scoping](/docs/security#data-scoping)를 참조하세요.
 
-## 관련 문서 {#related}
+## 다음 단계 {#related}
 
-- [Authentication](/docs/authentication#organizations) — 세션, 소셜 제공자 및 조직 관리 표면
-- [Security → Data Scoping](/docs/security#data-scoping) — SQL 수준 격리, `ownableColumns()` 계약 및 액세스 가드
-- [Multi-App Workspace](/docs/multi-app-workspace) — 공유 인증 및 RBAC를 사용하여 하나의 단일 저장소에서 여러 에이전트 기반 앱 호스팅
+- [**Authentication**](/docs/authentication#organizations) — 세션, 소셜 제공자 및 조직 관리 표면
+- [**Security — Data Scoping**](/docs/security#data-scoping) — SQL 수준 격리, `ownableColumns()` 계약 및 액세스 가드
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — 공유 인증 및 RBAC로 하나의 monorepo에서 여러 Agent-Native 앱을 호스팅합니다

package/docs/content/locales/ko-KR/notifications.mdx

@@ -113,6 +113,7 @@ await notify(
 | `inbox`   | `notifications` 테이블에 유지됩니다. 종 UI를 운전 | 항상 켜짐 — 기본 요소의 일부.                                   |
 | `webhook` | POST JSON를 구성된 URL로                          | 시작 시 `NOTIFICATIONS_WEBHOOK_URL` 환경 변수가 설정되었습니다. |
 
+이메일, Slack, webhook은 받은 편지함과 함께 항상 등록됩니다. 전송 시 알림별 메타데이터의 URL/수신자를 우선 사용하고, 그다음 일치하는 환경 변수로 대체합니다. 둘 다 설정되지 않으면 해당 채널은 알림 전송 시 아무 작업도 하지 않습니다.
 웹훅 채널은 소유자의 임시 [secrets](/docs/security)에 대해 URL 및 `NOTIFICATIONS_WEBHOOK_AUTH` 모두에서 `${keys.NAME}` 참조를 확인하므로 원시 값이 에이전트의 컨텍스트에 입력되지 않습니다. 키별 URL 허용 목록이 시행됩니다. 이는 자동화 `web-request` 도구에서 사용하는 것과 동일한 규칙입니다.
 
 <Diagram id="doc-block-1lw1rdr" title={"채널 및 심각도"} summary={"받은 편지함은 항상 켜져 있습니다. 웹훅에는 환경 변수가 필요합니다. 맞춤 채널은 시작 시 등록됩니다. 심각도는 배지 스타일을 결정하고 모든 채널에 전달됩니다."}>
@@ -203,7 +204,7 @@ await notify(
 
 모든 서버 플러그인에서 맞춤 채널을 등록하세요.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 core-routes 플러그인에 의해 `/_agent-native/notifications/*`에 마운트되었습니다. 모든 경로의 범위는 인증된 세션의 이메일로 지정됩니다.
 
-| 방법     | 경로                                                |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| 방법     | 경로                                                           |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-1232thx" title={"알림 나열"} summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"현재 사용자에 대한 최근 알림 나열"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-1232thx" title={"알림 나열"} method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"현재 사용자에 대한 최근 알림 나열"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ core-routes 플러그인에 의해 `/_agent-native/notifications/*`에 마운트
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "ISO 타임스탬프 커서 — 페이지네이션을 위해 이 시간 전에 생성된 알림을 반환합니다."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ core-routes 플러그인에 의해 `/_agent-native/notifications/*`에 마운트
 
 ## UI 구성 요소 {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

package/docs/content/locales/ko-KR/processors.mdx

@@ -49,8 +49,11 @@ description: "모델의 스트리밍된 출력과 도구 호출을 중간에 관
 
 </Diagram>
 
-> [!WARNING]
-> 프로세서는 **구성**이지 도구나 작업이 아니며 저작 DSL도 아닙니다. 프로세서는 자체 스트림 범위 상태와 `abort()`만 관찰하고 변경합니다. 앱 동작을 정의하거나 actions를 대체하거나 모델에 나타나지 않습니다. 앱 작업은 [actions](/docs/actions)에 속합니다.
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+프로세서는 **구성**이지 도구나 작업이 아니며 저작 DSL도 아닙니다. 프로세서는 자체 스트림 범위 상태와 `abort()`만 관찰하고 변경합니다. 앱 동작을 정의하거나 actions를 대체하거나 모델에 나타나지 않습니다. 앱 작업은 [actions](/docs/actions)에 속합니다.
+
+</Callout>
 
 ## 후크 {#hooks}
 
@@ -131,10 +134,13 @@ await runAgentLoop({
 
 **사용하지 않을 때 오버헤드가 없습니다.** 루프는 하나 이상의 프로세서가 제공되는 경우에만 프로세서 체인을 구축합니다. `processors`가 생략되거나 비어 있으면 이음매 코드가 실행되지 않으며 루프는 바이트 단위로 변경되지 않습니다. 후크는 등록 순서에 따라 실행되며 동기화되거나 비동기화될 수 있습니다.
 
-> [!NOTE]
-> 루프 수준 이음매는 현재 제공 가능하며 하위 에이전트, A2A, MCP 및 테스트에서 직접 호출할 수 있습니다. HTTP 채팅 핸들러를 통해 `processors`를 스레딩하는 것(요청별 확인자가 `runAgentLoop`를 직접 호출하지 않고 구성할 수 있도록)은 아직 연결되지 않은 편리한 배관입니다. 지금은 `runAgentLoop` 호출 사이트에서 프로세서를 구성하세요.
+<Callout id="doc-block-proc1note" tone="info">
+
+루프 수준 이음매는 현재 제공 가능하며 하위 에이전트, A2A, MCP 및 테스트에서 직접 호출할 수 있습니다. HTTP 채팅 핸들러를 통해 `processors`를 스레딩하는 것(요청별 확인자가 `runAgentLoop`를 직접 호출하지 않고 구성할 수 있도록)은 아직 연결되지 않은 편리한 배관입니다. 지금은 `runAgentLoop` 호출 사이트에서 프로세서를 구성하세요.
+
+</Callout>
 
-## 관련
+## 다음 단계
 
 - [**Durable Resume**](/docs/durable-resume) — 완료된 부작용을 다시 실행하지 않고 루프가 중단을 견디는 방법
 - [**Custom Agents & Teams**](/docs/agent-teams) — 하위 에이전트는 동일한 루프를 실행하며 자체 프로세서를 보유할 수 있습니다.

package/docs/content/locales/ko-KR/server.mdx

@@ -94,8 +94,7 @@ server/routes/
 
 각 경로는 `defineEventHandler`를 내보냅니다.
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -135,8 +134,7 @@ UI와 에이전트가 모두 작업을 수행해야 하는 경우 사용자 지
 
 읽기 전용 상태 endpoint는 action으로 유지하세요:
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -169,8 +167,7 @@ GET /_agent-native/actions/get-status?service=billing
 도구, 채팅 기록 또는 실행 상태에서는 `completeText()`를 명시적 이스케이프로 사용
 해치.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -235,8 +232,7 @@ UI와 에이전트는 동일한 기능을 공유합니다.
 
 플러그인은 `server/plugins/`에 있으며 시작 시 실행됩니다. 마이그레이션, 공급자 설정, 반복 작업, 통합 어댑터 및 프레임워크 플러그인 구성에 사용하세요.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -414,8 +410,11 @@ export default runMigrations(
 
 </Diagram>
 
-> [!WARNING]
-> 응답을 반환한 후 기다리지 않은 약속에 의존하지 마십시오. 서버리스 호스트는 실행을 정지시킵니다. 정식 통합 대기열은 [Messaging](/docs/messaging)를 참조하세요.
+<Callout tone="warning">
+  응답을 반환한 후 기다리지 않은 약속에 의존하지 마십시오. 서버리스 호스트는
+  실행을 정지시킵니다. 정식 통합 대기열은 [Messaging](/docs/messaging)를
+  참조하세요.
+</Callout>
 
 ## 고급: 탈출 해치 {#advanced-escape-hatches}
 
@@ -457,3 +456,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## 다음 단계
+
+- [**Actions**](/docs/actions) — 기본 작업 표면이며, 여기에 맞지 않을 때만 사용자 지정 경로를 사용합니다
+- [**Database**](/docs/database) — 사용자 지정 경로와 작업이 모두 가져오는 `getDb()`/`schema` 패턴
+- [**Security**](/docs/security#access-guards) — `accessFilter`/`assertAccess`와 전체 데이터 범위 지정 모델
+- [**Messaging**](/docs/messaging) — 인바운드 webhook을 위한 표준 통합 큐 패턴
+- [**MCP Protocol**](/docs/mcp-protocol) — 이 서버가 자동으로 마운트하는 `/_agent-native/mcp` 엔드포인트

package/docs/content/locales/ko-KR/sharing.mdx

@@ -1,13 +1,13 @@
 ---
 title: "공유 및 개인정보 보호"
-description: "프레임워크에 내장된 Google-Docs 스타일 공유. 문서, 대시보드, 디자인, 데크, 클립, 녹음, 양식 등 사용자가 생성한 모든 리소스는 하나의 일관된 공유 UI를 통해 기본적으로 동일한 비공개 모델을 얻습니다."
+description: "프레임워크에 내장된 익숙하고 일관된 공유 기능입니다. 문서, 대시보드, 디자인, 자료, 클립, 녹화, 양식 등 사용자가 만든 모든 리소스에 동일한 기본 비공개 모델과 일관된 공유 UI가 적용됩니다."
 ---
 
 # 공유 및 개인정보 보호
 
 문서, 대시보드, 디자인, 데크, 화면 녹화, 회의 기록, 양식, 예약 링크 등 사용자가 에이전트 기반 앱에서 생성하는 모든 리소스는 **기본적으로 작성자에게 공개됩니다**. 다른 사람들은 작성자가 명시적으로 공유하거나 공개 상태를 `org` 또는 `public`로 변경한 경우에만 볼 수 있습니다.
 
-Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼, 동일한 대화 상자, 동일한 3계층 가시성 모델, 동일한 사용자별/조직별 부여 — 앱별 재창조 없이 모든 템플릿에 적용됩니다.
+어디서나 하나의 익숙한 공유 모델을 사용합니다. 모든 템플릿에서 앱별로 새로 만들 필요 없이 동일한 공유 버튼, 동일한 대화 상자, 동일한 3단계 공개 범위 모델, 동일한 사용자별/조직별 권한 부여를 사용합니다.
 
 ## 왜 하나의 모델 {#why}
 
@@ -92,7 +92,7 @@ Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼,
 - **콘텐츠** — 문서
 - **슬라이드** — 자료
 - **디자인** — 디자인 및 자산
-- **클립** — 화면 녹화(Loom 스타일)
+- **클립** — 화면 녹화
 - **Plan** — visual plans and PR recaps
 - **양식** — 양식 정의
 - **캘린더** — 이벤트 및 예약 링크
@@ -115,7 +115,7 @@ Google 문서도구처럼 보이고 작동합니다. 동일한 공유 버튼,
 
 - 가시성 선택기(`Private` / `Organization` / `Public link`).
 - "사람 또는 팀 추가" 자동 완성 — 조직에서 사용자를 검색하거나 이메일을 붙여넣습니다.
-- 개별 이메일 승인을 위한 Google 문서 스타일 `알림 people` 확인란.
+- 개별 이메일 권한 부여를 위한 `사용자에게 알림` 확인란.
 - 역할 선택기와 제거 컨트롤이 포함된 현재 부여 목록입니다.
 - 현재 표시 여부를 고려하는 링크 복사 버튼입니다.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 `server/db/index.ts`에서 한 번의 등록 호출:
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 프레임워크의 더 광범위한 데이터 범위 지정 모델에 대한 공유 - 소유 가능한 테이블에 대한 목록/읽기/쓰기 액세스는 `accessFilter()` / `resolveAccess()` / `assertAccess()`를 통과하며 `org_id` 태그가 지정된 리소스는 조직 전체에서 보이지 않습니다. 전체 파이프라인, CI 가드 및 위협 표면에 대해서는 [Security → Data Scoping](/docs/security#data-scoping)를 참조하세요.
 
-## 참조 {#see-also}
+## 다음 단계 {#see-also}
 
-- [Security & Data Scoping](/docs/security) — 공유를 기반으로 하는 액세스 필터 및 소유권 모델
-- [Authentication](/docs/authentication) — 세션, 조직 및 ID가 요청 컨텍스트로 흐르는 방식
-- [Extensions](/docs/extensions#sharing) — 샌드박스 미니앱 표면에서 공유.
-- [Creating Templates](/docs/creating-templates) — `ownableColumns`를 새 템플릿의 스키마에 연결합니다.
+- [**보안 — 데이터 범위 지정**](/docs/security#data-scoping) — 공유의 기반이 되는 액세스 필터 및 소유권 모델
+- [**인증**](/docs/authentication) — 세션, 조직, 요청 컨텍스트로 ID가 전달되는 방식
+- [**Extensions**](/docs/extensions#sharing) — 샌드박스 미니 앱 표면에서의 공유
+- [**템플릿 만들기**](/docs/creating-templates) — 새 템플릿 스키마에 `ownableColumns` 연결하기

package/docs/content/locales/ko-KR/skills-guide.mdx

@@ -5,7 +5,7 @@ description: "에이전트 네이티브에서 skills가 작동하는 방식: 프
 
 # Skills 가이드
 
-Skills는 상담원에게 특정 패턴과 워크플로에 대한 깊은 지식을 제공하는 Markdown 파일입니다.
+Skills는 특정 패턴과 워크플로에 관한 깊이 있는 지식을 에이전트에 제공하는 Markdown 파일입니다. 모든 규칙을 하나의 시스템 프롬프트에 몰아넣는 대신, 작업에 실제로 필요할 때만 에이전트가 로드하는 집중된 파일로 지식을 나눕니다. 그러면 기본 컨텍스트는 작게 유지하면서도 필요할 때 깊이 탐색할 수 있습니다.
 
 ## skills란 무엇입니까 {#what-are-skills}
 
@@ -120,9 +120,11 @@ Skills는 `.agents/skills/<name>/SKILL.md`에 거주하며 상담원을 위한
 
 현재 app-backed skills에는 Plan의 `visual-plan`, `visual-recap`, `visualize-repo`, Design의 `visual-edit`, Assets의 `assets`, repo-backed docs/blog/MDX editing을 위한 `content`가 포함됩니다.
 
-앱 지원 skills는 에이전트 기반 앱을 스킬 마켓플레이스 아티팩트로 패키지합니다. 번들에는 에이전트 지침, 내보낸 skills, MCP 커넥터 메타데이터, 호스팅/로컬 실행 지침 및 MCP 앱과 같은 UI 표면이 포함될 수 있습니다.
+<Callout tone="info">
 
-> **아래 전체 세부정보:** 앱 지원 skills의 메커니즘(매니페스트 형식, CLI 명령, 마켓플레이스 어댑터, 자동 업데이트 해싱)은 [App-backed skills — full details](#app-backed-skills-full)에서 다룹니다.
+**아래 전체 세부정보:** 앱 지원 skills의 메커니즘(매니페스트 형식, CLI 명령, 마켓플레이스 어댑터, 자동 업데이트 해싱)은 [App-backed skills — full details](#app-backed-skills-full)에서 다룹니다.
+
+</Callout>
 
 ## 사용자 정의 skills 생성 {#creating-skills}
 
@@ -177,7 +179,11 @@ Skills는 `.agents/skills/<name>/SKILL.md`에 거주하며 상담원을 위한
 
 `.agents/skills/my-skill/SKILL.md`에 파일을 저장합니다. 디렉토리 이름은 머리말의 `name`와 일치해야 합니다.
 
-> **또한 참조:** 기술 설명을 단어로 표현하고, 점진적 공개를 적용하고, `AGENTS.md`를 간결하게 유지하는 방법은 [Writing Agent Instructions](/docs/writing-agent-instructions)를 참조하세요. 두 페이지 모두 `project-imports` 스킬을 실행 예시로 사용합니다.
+<Callout tone="info">
+
+**또한 참조:** 기술 설명을 단어로 표현하고, 점진적 공개를 적용하고, `AGENTS.md`를 간결하게 유지하는 방법은 [Writing Agent Instructions](/docs/writing-agent-instructions)를 참조하세요. 두 페이지 모두 `project-imports` 스킬을 실행 예시로 사용합니다.
+
+</Callout>
 
 ## 기술 범위: 런타임 대 개발 {#skill-scope}
 
@@ -267,33 +273,37 @@ scope: dev
 
 </Diagram>
 
-> **또한 참조:** 기술 설명을 단어로 표현하고, 점진적인 공개를 적용하고, `AGENTS.md`를 간결하게 유지하는 방법은 [Writing Agent Instructions](/docs/writing-agent-instructions)를 참조하세요.
-
 ## Skills 대 AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md** — 개요. 모든 스크립트를 나열하고, 데이터 모델을 설명하고, 앱 아키텍처를 설명합니다. 상담원은 앱을 이해하기 위해 먼저 이 내용을 읽습니다.
->
-> **Skills** — 심층 분석. 각 기술은 세부 규칙, 코드 예제, 해야 할 일/하지 말아야 할 목록이 포함된 하나의 패턴에 중점을 둡니다. 에이전트는 특정 패턴을 따라야 할 때 이를 읽습니다.
+<Callout tone="info">
+
+**AGENTS.md** — 개요. 모든 스크립트를 나열하고, 데이터 모델을 설명하고, 앱 아키텍처를 설명합니다. 상담원은 앱을 이해하기 위해 먼저 이 내용을 읽습니다.
+
+**Skills** — 심층 분석. 각 기술은 세부 규칙, 코드 예제, 해야 할 일/하지 말아야 할 목록이 포함된 하나의 패턴에 중점을 둡니다. 에이전트는 특정 패턴을 따라야 할 때 이를 읽습니다.
+
+</Callout>
 
 `AGENTS.md`는 앱이 *무슨 일을*하는지 상담원에게 알려줍니다. Skills는 에이전트에게 특정 작업을 올바르게 수행하는 방법을 _방법_ 알려줍니다. 둘 다 필요합니다. 방향을 지정하려면 `AGENTS.md`, 실행을 위해서는 skills가 필요합니다.
 
 ## Skills 대 메모리 {#skills-vs-memory}
 
-> **Skills** — 재사용 가능한 제작 방법 가이드입니다. 모든 사용자에게 적용되며 작업이 일치할 때 요청 시 호출됩니다.
->
-> **메모리(`LEARNINGS.md` / `memory/MEMORY.md`)** — 공유 프로젝트 학습 및 개인 구조화된 메모리가 매 턴 로드됩니다.
+<Callout tone="info">
+
+**Skills** — 재사용 가능한 제작 방법 가이드입니다. 모든 사용자에게 적용되며 작업이 일치할 때 요청 시 호출됩니다.
+
+**메모리(`LEARNINGS.md` / `memory/MEMORY.md`)** — 공유 프로젝트 학습 및 개인 구조화된 메모리가 매 턴 로드됩니다.
+
+</Callout>
 
 지식이 앱에서 작업하는 *모든 사람*에게 적용된다면("항상 하위 쿼리보다 CTE를 선호합니다"), 그것은 기술 또는 공유 `LEARNINGS.md`입니다. _이 특정 사용자_("Steve는 간결한 답변을 좋아합니다")에 관한 것이라면 `memory/MEMORY.md`에 속합니다. 전체 치료에 대해서는 [Workspace Memory](/docs/workspace#memory)를 참조하세요.
 
----
+## Skills와 SQL 리소스 {#skills-vs-resources}
 
-# 고급
+이 페이지에서는 skill을 `.agents/skills/<name>/SKILL.md`의 파일로 설명합니다. [Workspace](/docs/workspace#skills)에서는 같은 skill을 `skills/<slug>/SKILL.md` 경로의 workspace/shared/personal 범위 SQL 리소스로 설명합니다. 두 설명은 같은 개념을 서로 다른 관점에서 본 것입니다. Code 모드는 파일을 직접 읽고 쓰고, App 모드는 파일 시스템 없이 작동하도록 리소스 행으로 저장합니다. 어느 방식이든 이 페이지의 형식으로 콘텐츠를 작성하세요.
 
 ## 앱 지원 skills — 전체 세부정보 {#app-backed-skills-full}
 
-앱 지원 skills는 에이전트 기반 앱을 스킬 마켓플레이스 아티팩트로 패키지합니다.
-번들은 에이전트 지침, 내보낸 skills, MCP 커넥터를 포함할 수 있습니다.
-메타데이터, 호스팅/로컬 실행 지침 및 MCP 앱과 같은 UI 표면
+[앱 지원 skills](#app-backed-skills)의 매니페스트 형식, CLI 명령, 마켓플레이스 어댑터, 자동 업데이트 해싱에 관한 전체 세부정보:
 
 각 앱 지원 기술은 앱 루트에서 `agent-native.app-skill.json`로 시작합니다.
 
@@ -410,3 +420,10 @@ npx @agent-native/core@latest skills update scaffold --project
 `AGENTS.md` 및 `.agents/skills`는 표준을 유지합니다. 업데이트 명령도 복구됩니다
 Claude 호환성 링크(`CLAUDE.md` 및 `.claude/skills`)이므로 Claude 코드는
 두 번째 사본을 유지하지 않고 동일한 지침을 따릅니다.
+
+## 다음 단계 {#whats-next}
+
+- [**에이전트 지침 작성**](/docs/writing-agent-instructions) — skill 설명을 작성하고 AGENTS.md, skills, 메모리로 지침을 분리하기
+- [**Workspace**](/docs/workspace#skills) — App 모드에서 skills가 SQL 리소스로 저장되는 위치
+- [**에이전트 멘션**](/docs/agent-mentions) — 채팅에서 skill을 호출하는 `/` 명령 트리거
+- [**Plan 플러그인 및 마켓플레이스**](/docs/plan-plugin) — 실제 앱 지원 skill의 전체 설치 및 자동 업데이트 흐름

package/docs/content/locales/ko-KR/template-assets.mdx

@@ -90,6 +90,18 @@ Assets는 브랜드와 일관된 미디어를 생성하고 관리하기 위한
 - **다른 앱에는 자산 선택기 또는 생성기가 필요합니다** — 슬라이드, 디자인, 콘텐츠, 블로그 편집기 또는 사이트 빌더는 선택기를 삽입하거나 A2A를 통해 자산을 호출할 수 있습니다.
 - **코딩 에이전트에서 브랜드 미디어를 사용할 수 있기를 원합니다** — Codex, Claude Code, Claude 또는 ChatGPT는 채팅을 종료하지 않고도 자산을 생성하고 선택할 수 있습니다.
 
+## 그것으로 무엇을 할 수 있나요
+
+- **자산 라이브러리를 생성합니다.** 참조 이미지, 비디오, 표준 로고, 스타일 노트, 팔레트, 폴더 및 생성된 출력을 브랜드, 캠페인, 제품 또는 카테고리별로 그룹화합니다.
+- **채팅을 통해 생성합니다.** 홈 작성기 및 라이브러리 생성 컨트롤은 `sendToAgentChat()`를 사용하여 에이전트에 프롬프트를 보내므로 사용자는 변형을 검사하고 피드백을 제공하고 반복할 수 있습니다.
+- **이미지 및 비디오 생성.** 활성화된 경우 Builder 관리 이미지 생성을 사용할 수 있으며 Gemini는 비디오 생성과 수동 이미지 대체 기능을 제공합니다.
+- **참조를 업로드하고 설명하세요.** 라이브러리 UI에서 이미지나 비디오를 추가하거나 작곡가 첨부 버튼을 표시한 다음 제목, 설명, 대체 텍스트, 프롬프트, 모델, 미디어 유형, 상태, 역할, 폴더 또는 컬렉션별로 검색하세요.
+- **생성 감사 로그를 유지합니다.** 모든 실행은 나중에 설계 검토를 위해 프롬프트, 모델, 종횡비, 참조, 소스 자산, 계보, 생성된 자산, 상태, 오류 및 타임스탬프를 기록합니다.
+- **로고 정확성을 유지합니다.** 에이전트는 자리 표시자 영역을 생성할 수 있으며 서버는 이미지 모델을 사용하여 다시 그리는 대신 업로드된 표준 로고를 최종 이미지에 합성합니다.
+- **선택기로 삽입.** 다른 앱은 `/picker`를 iframe하고 `@agent-native/embedding`에서 `chooseAsset` 이벤트를 수신하여 자산을 블로그 편집자, 사이트 빌더, 슬라이드 데크 및 사용자 정의 앱을 위한 자산 선택기/생성기로 전환할 수 있습니다. 또한 선택기는 기존 이미지 전용 호스트에 대한 레거시 `chooseImage` 별칭을 내보냅니다.
+- **앱 지원 스킬로 설치합니다.** `agent-native.app-skill.json` 매니페스트는 자산 스킬과 MCP 커넥터 메타데이터를 내보내므로 마켓플레이스가 앱, 지침 및 선택기를 함께 설치할 수 있습니다.
+- **다른 에이전트에게 서비스를 제공합니다.** 슬라이드, 디자인, 콘텐츠, 메일 및 발송은 A2A를 통해 자산을 호출하여 라이브러리 나열, 배치 생성, 비디오 생성, 자산 구체화, 내보내기 가져오기 및 삽입이 허용되는 인라인 미리 보기 렌더링을 수행할 수 있습니다.
+
 ## 시작하기
 
 라이브 데모: [assets.agent-native.com](https://assets.agent-native.com).
@@ -112,18 +124,6 @@ Assets는 브랜드와 일관된 미디어를 생성하고 관리하기 위한
 - "업로드된 이 다이어그램을 더욱 깔끔한 제품 설명 이미지로 바꾸세요."
 - "비디오 스토리보드를 만들고 가장 좋은 프레임 세트를 이 라이브러리에 저장하세요."
 
-## 그것으로 무엇을 할 수 있나요
-
-- **자산 라이브러리를 생성합니다.** 참조 이미지, 비디오, 표준 로고, 스타일 노트, 팔레트, 폴더 및 생성된 출력을 브랜드, 캠페인, 제품 또는 카테고리별로 그룹화합니다.
-- **채팅을 통해 생성합니다.** 홈 작성기 및 라이브러리 생성 컨트롤은 `sendToAgentChat()`를 사용하여 에이전트에 프롬프트를 보내므로 사용자는 변형을 검사하고 피드백을 제공하고 반복할 수 있습니다.
-- **이미지 및 비디오 생성.** 활성화된 경우 Builder 관리 이미지 생성을 사용할 수 있으며 Gemini는 비디오 생성과 수동 이미지 대체 기능을 제공합니다.
-- **참조를 업로드하고 설명하세요.** 라이브러리 UI에서 이미지나 비디오를 추가하거나 작곡가 첨부 버튼을 표시한 다음 제목, 설명, 대체 텍스트, 프롬프트, 모델, 미디어 유형, 상태, 역할, 폴더 또는 컬렉션별로 검색하세요.
-- **생성 감사 로그를 유지합니다.** 모든 실행은 나중에 설계 검토를 위해 프롬프트, 모델, 종횡비, 참조, 소스 자산, 계보, 생성된 자산, 상태, 오류 및 타임스탬프를 기록합니다.
-- **로고 정확성을 유지합니다.** 에이전트는 자리 표시자 영역을 생성할 수 있으며 서버는 이미지 모델을 사용하여 다시 그리는 대신 업로드된 표준 로고를 최종 이미지에 합성합니다.
-- **선택기로 삽입.** 다른 앱은 `/picker`를 iframe하고 `@agent-native/embedding`에서 `chooseAsset` 이벤트를 수신하여 자산을 블로그 편집자, 사이트 빌더, 슬라이드 데크 및 사용자 정의 앱을 위한 자산 선택기/생성기로 전환할 수 있습니다. 또한 선택기는 기존 이미지 전용 호스트에 대한 레거시 `chooseImage` 별칭을 내보냅니다.
-- **앱 지원 스킬로 설치합니다.** `agent-native.app-skill.json` 매니페스트는 자산 스킬과 MCP 커넥터 메타데이터를 내보내므로 마켓플레이스가 앱, 지침 및 선택기를 함께 설치할 수 있습니다.
-- **다른 에이전트에게 서비스를 제공합니다.** 슬라이드, 디자인, 콘텐츠, 메일 및 발송은 A2A를 통해 자산을 호출하여 라이브러리 나열, 배치 생성, 비디오 생성, 자산 구체화, 내보내기 가져오기 및 삽입이 허용되는 인라인 미리 보기 렌더링을 수행할 수 있습니다.
-
 ## 코딩 에이전트에서 사용
 
 Codex, Claude 코드, Claude 또는 ChatGPT를 떠나지 않고 브랜드 미디어를 생성하고 선택하세요.
@@ -170,10 +170,13 @@ Codex, Claude 코드, Claude 또는 ChatGPT를 떠나지 않고 브랜드 미디
 
 이 문서의 나머지 부분은 자산 템플릿을 포크하거나 확장하는 모든 사람을 위한 것입니다.
 
-### 비계
+### 빠른 시작
 
 ```bash
 npx @agent-native/core@latest create my-assets --standalone --template assets
+cd my-assets
+pnpm install
+pnpm dev
 ```
 
 ### 데이터 모델

package/docs/content/locales/ko-KR/template-brain.mdx

@@ -201,7 +201,7 @@ Postgres, Neon, D1, Turso 및 유사한 호스트. 애플리케이션 상태는
 현재 경로, 필터 및 선택된 ID를 통해 상담원은 항상 현재 정보를 알 수 있습니다.
 탐색 및 선택.
 
-Brain의 스키마는 `templates/brain/server/db/schema.ts`에 있습니다. 테이블 8개:
+Brain의 스키마는 `templates/brain/server/db/schema.ts`에 있습니다. 테이블 9개:
 
 | 테이블                   | 무엇을 담고 있는지                                                                                                          |
 | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
@@ -549,3 +549,5 @@ Brain은 에이전트 기본 4개 영역 계약을 따릅니다. 편집을 통
 - [**Dispatch template**](/docs/template-dispatch) — 비계 조정 앱
 - [**Workspace**](/docs/workspace) — 앱 전체에서 공유 리소스
 - [**A2A Protocol**](/docs/a2a-protocol) — 교차 앱 위임
+- [**템플릿**](/docs/cloneable-saas) — 복제 후 소유하는 모델과 시작할 수 있는 모든 도메인 템플릿
+- [**시작하기**](/docs/getting-started) — Actions, 애플리케이션 상태, 실시간 동기화 등 프레임워크의 기본 사항

package/docs/content/locales/ko-KR/template-clips.mdx

@@ -17,7 +17,7 @@ search: "클립 브라우저 로그 개발자 로그 콘솔 로그 네트워크
   />
 </WireframeBlock>
 
-Loom + Granola + Wispr Flow가 하나의 앱으로 통합되었다고 생각해보세요. 그러나 에이전트는 모든 표면에서 일류 편집자이며 녹음, 회의 및 받아쓰기는 SaaS 공급업체의 것이 아니라 귀하의 것입니다. Clips는 공유 녹음물을 상담원이 읽을 수 있도록 해줍니다. 일반 Clips 공유 링크를 상담원에 붙여넣으면 대본을 텍스트로 "듣고" 타임스탬프가 표시된 화면 프레임을 이미지로 "볼" 수 있습니다. 원본 비디오는 필요하지 않습니다. 프레임 보기는 모든 이미지 지원 에이전트(ChatGPT, Claude 코드, 커서, Codex)에서 작동합니다. 텍스트 전용 웹 채팅은 여전히 ​​전체 내용을 얻을 수 있으며 업로드한 프레임을 사용할 수 있습니다.
+비동기 화면 녹화, 캘린더와 동기화된 회의 메모, 푸시 투 토크 음성 받아쓰기를 하나의 앱에 담았습니다. 에이전트는 모든 화면에서 일급 편집자로 작동하며 녹화, 회의, 받아쓰기는 SaaS 공급업체가 아니라 사용자의 것입니다. Clips는 공유 녹화도 에이전트가 읽을 수 있게 합니다. 공개 Clips 공유 링크나 임시 **에이전트용으로 복사** 링크를 에이전트에 붙여넣으면 원본 동영상 없이도 대본을 텍스트로 "듣고" 타임스탬프가 있는 화면 프레임을 이미지로 "볼" 수 있습니다. 프레임 보기는 이미지 지원 에이전트(ChatGPT, Claude Code, Cursor, Codex)에서 작동합니다. 텍스트 전용 웹 채팅도 전체 대본을 받고 사용자가 업로드한 프레임을 활용할 수 있습니다.
 
 <Diagram id="doc-block-wz0gsz" title={"캡처, 복사, 재사용"} summary={"세 가지 캡처 유형이 하나의 라이브러리에 포함됩니다. 상담원이 스크립트를 작성하고 제목을 지정하고 요약하면 모든 스크립트를 검색하고 공유할 수 있습니다."}>
 
@@ -83,8 +83,7 @@ Loom + Granola + Wispr Flow가 하나의 앱으로 통합되었다고 생각해
 - **모든 녹음에 대해 자동 생성된 제목, 요약 및 챕터 마커**를 받으세요. 상담원이 이를 채우고 최신 상태로 유지합니다.
 - **모든 기록을 검색**합니다. 화면 녹화, 회의, 받아쓰기가 모두 하나의 라이브러리에 있습니다. "우리가 출시 계획을 논의한 클립을 찾아보세요."
 - **클립 공유** 클립별 권한(공개, 팀, 비공개)이 있습니다. 링크 추적 및 스레드 댓글도 작동합니다.
-- **Slack에서 공개 클립을 미리 보세요** Loom 스타일의 재생 가능한 클립을 펼친 후
-  Workspace는 Clips Slack 앱을 설치합니다.
+- **Slack에서 공개 클립을 미리 보세요**. 워크스페이스가 Clips Slack 앱을 설치하면 재생 가능한 동영상 미리보기가 펼쳐집니다.
 - **Chrome 확장 프로그램을 사용하여 브라우저 로그를 캡처하세요.** 브라우저 녹화는
   수정된 콘솔 로그를 첨부하고 다음 작업에 도움이 되는 가져오기/XHR 메타데이터
   제품 버그 및 브라우저 전용 재현
@@ -512,7 +511,7 @@ UI의 경로는 `templates/clips/app/routes/` 아래에 있습니다. 인증된
 
 ### 키 actions
 
-모든 에이전트 호출 가능 작업은 `templates/clips/actions/`의 TypeScript 파일이며, `POST /_agent-native/actions/:name`에 자동으로 마운트되고 CLI에서 `pnpm action <name>`로 실행 가능합니다. ~80개의 actions가 있습니다. 유용한 그룹화:
+모든 에이전트 호출 가능 작업은 `templates/clips/actions/`의 TypeScript 파일이며, `POST /_agent-native/actions/:name`에 자동으로 마운트되고 CLI에서 `pnpm action <name>`로 실행 가능합니다. 약 100개의 actions가 있습니다. 유용한 그룹화:
 
 - **녹화 수명 주기** — `create-recording`, `finalize-recording`, `update-recording`, `set-thumbnail`, `archive-recording` / `restore-recording` / `trash-recording` / `delete-recording-permanent`, `move-recording`, `tag-recording`.
 - **기록 및 AI** — `request-transcript`, `cleanup-transcript`, `regenerate-title` / `regenerate-summary` / `regenerate-chapters`, `set-chapters`, `generate-workflow`. (`cleanup-transcript` 및 `finalize-meeting`는 서버 측 미디어 파이프라인 호출입니다. 대부분의 다른 AI 기능은 에이전트 채팅에 위임됩니다.)