@agent-native/core 0.77.3 → 0.77.6

package/docs/content/locales/ko-KR/template-videos.md

@@ -10,7 +10,7 @@ description: "모션 그래픽, 제품 데모 및 키네틱 텍스트를 위한
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Logo reveal</h1><span class='wf-pill accent'>6 seconds</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Render</button></div><div class='wf-card' style='flex:1;display:flex;align-items:center;justify-content:center;min-height:250px'><div style='text-align:center'><strong>Remotion preview</strong><br/><small class='wf-muted'>logo scales in as the title fades</small></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><div style='display:flex;gap:8px;align-items:center'><span class='wf-pill'>0s</span><span class='wf-pill'>2s</span><span class='wf-pill'>4s</span><span class='wf-pill'>6s</span><div style='flex:1'></div><button>New track</button></div><div class='wf-box'>Title fade · 0-48 frames</div><div class='wf-box'>Logo scale · 48-120 frames</div><div class='wf-box'>Camera push · 72-144 frames</div></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;gap:12px;padding:16px;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>로고 공개</h1><span class='wf-pill accent'>6 seconds</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Render</button></div><div class='wf-card' style='flex:1;display:flex;align-items:center;justify-content:center;min-height:250px'><div style='text-align:center'><strong>Remotion 미리보기</strong><br/><small class='wf-muted'>logo scales in as the title fades</small></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><div style='display:flex;gap:8px;align-items:center'><span class='wf-pill'>0s</span><span class='wf-pill'>2s</span><span class='wf-pill'>4s</span><span class='wf-pill'>6s</span><div style='flex:1'></div><button>새 트랙</button></div><div class='wf-box'>제목 페이드 · 0-48프레임</div><div class='wf-box'>로고 스케일 · 48-120프레임</div><div class='wf-box'>카메라 푸시 · 72-144프레임</div></div></div>"
 }
 ```
 
@@ -18,7 +18,7 @@ description: "모션 그래픽, 제품 데모 및 키네틱 텍스트를 위한
 
 ```an-diagram title="데이터로서의 애니메이션" summary="컴포지션은 React 구성 요소입니다. 모든 애니메이션은 트랙에서 읽혀지므로 에이전트와 타임라인이 동일한 데이터를 편집합니다."
 {
-  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Timeline<br><small class=\"diagram-muted\">drag, resize, scrub</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">\"fade in at 2s\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">AnimationTrack</span><small class=\"diagram-muted\">startFrame / easing / animatedProps</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>React composition<br><small class=\"diagram-muted\">Remotion &lt;Player&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">MP4 / WebM</div></div>",
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Timeline<br><small class=\"diagram-muted\">드래그, 크기 조절, 스크럽</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">\"fade in at 2s\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">AnimationTrack</span><small class=\"diagram-muted\">startFrame / easing / animatedProps</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>React 컴포지션<br><small class=\"diagram-muted\">Remotion &lt;Player&gt;</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">MP4 / WebM</div></div>",
   "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -99,7 +99,7 @@ pnpm dev
 
 서버 측 스키마는 `templates/videos/server/db/schema.ts`에 있습니다:
 
-```an-schema title="Video data model" summary="SQL-backed compositions plus design systems and nestable folders, each with a framework shares table."
+```an-schema title="비디오 데이터 모델" summary="SQL 지원 컴포지션과 디자인 시스템, 중첩 가능한 폴더가 있으며 각각 프레임워크 공유 테이블이 있습니다."
 {
   "entities": [
     {
@@ -110,7 +110,7 @@ pnpm dev
         { "name": "id", "type": "text", "pk": true },
         { "name": "title", "type": "text" },
         { "name": "type", "type": "text" },
-        { "name": "data", "type": "text", "note": "Full composition JSON blob" },
+        { "name": "data", "type": "text", "note": "전체 구성 JSON blob" },
         { "name": "created_at", "type": "text" },
         { "name": "updated_at", "type": "text" }
       ]
@@ -138,7 +138,7 @@ pnpm dev
     {
       "id": "folder_memberships",
       "name": "folder_memberships",
-      "note": "Many-to-many join",
+      "note": "다대다 조인",
       "fields": [
         { "name": "folder_id", "type": "text", "fk": "folders.id" },
         { "name": "composition_id", "type": "text", "fk": "compositions.id" }

package/docs/content/locales/ko-KR/tracking.md

@@ -21,7 +21,7 @@ track(
 
 ```an-diagram title="하나의 track() 호출, 모든 공급자" summary="서버 및 클라이언트 호출자는 동일한 레지스트리에 도달하여 모든 이벤트를 모든 활성 공급자에게 병렬로 전달합니다."
 {
-  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">Server code<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">Browser code<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
+  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">서버 코드<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">브라우저 코드<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, 보내고 잊기</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
   "css": ".trk{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.trk .diagram-col{display:flex;flex-direction:column;gap:8px}.trk .diagram-arrow{font-size:22px;line-height:1}.trk .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -102,11 +102,11 @@ export default defineAction({
 
 `track()`는 브라우저/앱 코드에서도 작동합니다. `@agent-native/core/client`에서 클라이언트 쌍을 가져오고 동일한 방식으로 호출합니다. 이벤트를 `POST /_agent-native/track`의 프레임워크 경로에 게시하고 **동일** 등록된 서버 측 공급자(PostHog, Mixpanel, Amplitude, webhook)에 전달합니다. 분석 SDK는 브라우저에 제공되지 않으며 공급자 키는 클라이언트 측에 노출되지 않습니다.
 
-```an-api title="The client tracking route"
+```an-api title="클라이언트 추적 경로"
 {
   "method": "POST",
   "path": "/_agent-native/track",
-  "summary": "Forward a browser event to the registered server-side providers",
+  "summary": "등록된 서버측 공급자에게 브라우저 이벤트 전달",
   "auth": "Session required + same-origin/CSRF marker (set automatically by the client helper). Not an open analytics relay.",
   "params": [
     { "name": "name", "in": "body", "type": "string", "required": true, "description": "Event name. Capped at 200 characters." },

package/docs/content/locales/ko-KR/using-your-agent.md

@@ -1,17 +1,17 @@
 ---
 title: "에이전트 사용"
-description: "에이전트와 함께 작업하는 일상적인 루프: 에이전트는 사용자가 보고 있는 것을 보고, 지시하고, 삽입하고, UI-light로 이동하고, 함께 공동 편집합니다."
+description: "에이전트와 함께 작업하는 일상적인 루프: 에이전트는 사용자가 보고 있는 것을 보고, 지시하고, 삽입하고, 가벼운 UI로 이동하고, 함께 공동 편집합니다."
 ---
 
 # 에이전트 사용
 
 에이전트 네이티브의 기본 아이디어는 에이전트와 UI가 **동등한 파트너**라는 것입니다. 그 이유는 [What Is Agent-Native?](/docs/what-is-agent-native)를 참조하세요. 이 섹션은 그 약속의 나머지 절반, 즉 앱 옆에 도킹된 에이전트와 실제로 작업하는 느낌에 관한 것입니다.
 
-간단한 통과선이 있습니다. 상담원은 귀하가 보고 있는 내용을 **보고** 원하는 방향으로 **지시**하고, 어디에든 **삽입**할 수 있으며, 더 적합할 때는 완전히 **UI-light**할 수 있으며, 동일한 문서를 동시에 **공동 편집**할 수 있습니다. 각각은 이 섹션의 페이지입니다.
+간단한 통과선이 있습니다. 상담원은 귀하가 보고 있는 내용을 **보고** 원하는 방향으로 **지시**하고, 어디에든 **삽입**할 수 있으며, 더 적합할 때는 완전히 **가벼운 UI**할 수 있으며, 동일한 문서를 동시에 **공동 편집**할 수 있습니다. 각각은 이 섹션의 페이지입니다.
 
 ```an-diagram title="일상적인 루프" summary="도킹된 에이전트로 작업하는 5가지 방법 - 각각이 이 섹션의 페이지입니다."
 {
-  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>UI-light</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">Co-edit</span><small class=\"diagram-muted\">live, side by side</small></div></div>",
+  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>가벼운 UI</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">공동 편집</span><small class=\"diagram-muted\">실시간, 나란히</small></div></div>",
   "css": ".diagram-loop{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-loop .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px;flex:1}.diagram-loop .diagram-arrow{align-self:center;font-size:22px;line-height:1}"
 }
 ```
@@ -49,7 +49,7 @@ description: "에이전트와 함께 작업하는 일상적인 루프: 에이전
 → [**Drop-in Agent**](/docs/drop-in-agent) — `<AgentPanel>`, `<AgentSidebar>` 및 `sendToAgentChat()`를 React 앱에 마운트합니다.
 → [**Agent Surfaces**](/docs/agent-surfaces) — 워크플로가 헤드리스, 채팅 우선, 내장형 또는 전체 앱인지 선택하세요.
 
-## UI-light로 갈 수 있습니다 {#ui-light}
+## 가벼운 UI로 갈 수 있습니다 {#ui-light}
 
 모든 앱에 전체 대시보드가 필요한 것은 아닙니다. 상담원이 제품인 경우 대부분의 맞춤 UI를 건너뛸 수 있습니다. 앱을 열고 원하는 것을 요청하면 상담원이 나머지 작업을 수행하게 됩니다. 에이전트에는 여전히 기록, 작업 공간, 설정 등 관리 영역이 있지만 주요 상호 작용은 클릭이 아닌 대화입니다.
 
@@ -67,5 +67,5 @@ description: "에이전트와 함께 작업하는 일상적인 루프: 에이전
 - [**Agent Mentions**](/docs/agent-mentions) — `@` 언급으로 지시
 - [**Voice Input**](/docs/voice-input) — 말로 지시
 - [**Drop-in Agent**](/docs/drop-in-agent) — 모든 React 앱에 삽입
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) — 에이전트가 제품인 경우 UI-light로 이동
+- [**Pure-Agent Apps**](/docs/pure-agent-apps) — 에이전트가 제품인 경우 가벼운 UI로 이동
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — 동일한 문서를 함께 공동 편집

package/docs/content/locales/ko-KR/voice-input.md

@@ -21,7 +21,7 @@ description: "에이전트 채팅 작성기의 음성 받아쓰기 — Builder G
 
 ```an-diagram title="음성 녹음 제공자 대체" summary="작곡가는 오디오를 녹음한 다음 서버 공급자를 순서대로 안내하고 서버 공급자를 사용할 수 없는 경우에만 브라우저 Web Speech API에 드롭합니다."
 {
-  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">Mic button<br><small class=\"diagram-muted\">records webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">default when Builder connected</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
+  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">마이크 버튼<br><small class=\"diagram-muted\">webm/opus 녹음</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">Builder 연결 시 기본값</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
   "css": ".diagram-voice{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-voice .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-voice .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -43,17 +43,17 @@ Builder는 가장 쉬운 경로입니다. 설정에서 Builder.io를 연결하
 ```an-callout
 {
   "tone": "info",
-  "body": "**Credential resolution order:** the route checks the user's own encrypted secret first, then the shared deployment key. A power user with their own key always overrides the shared one. If neither exists, the route returns a 400 the composer recognizes and silently falls back to browser Web Speech."
+  "body": "**자격 증명 확인 순서:**경로는 사용자의 암호화된 비밀을 먼저 확인한 다음 공유 배포 키를 확인합니다. 자신의 키를 가진 고급 사용자는 항상 공유된 키를 재정의합니다. 둘 다 없으면 경로는 작성자가 인식한 400을 반환하고 자동으로 브라우저 웹 음성으로 대체됩니다."
 }
 ```
 
 ## 경로 {#route}
 
-```an-api title="Voice transcription route"
+```an-api title="음성 전사 경로"
 {
   "method": "POST",
   "path": "/_agent-native/transcribe-voice",
-  "summary": "Transcribe a recorded audio clip into prompt text",
+  "summary": "녹음된 오디오 클립을 프롬프트 텍스트로 변환",
   "auth": "Active session (Better Auth cookie). Same-origin only.",
   "description": "The composer POSTs the recorded clip here; the route resolves a provider and returns the transcribed text. You should not call this directly.",
   "params": [

package/docs/content/locales/ko-KR/what-is-agent-native.md

@@ -26,13 +26,13 @@ description: "대부분의 AI 앱이 절반만 구축된 것처럼 느껴지는
 
 대부분의 팀은 사다리처럼 올라가는 진행 과정이 있으며 대부분은 한 단계를 너무 일찍 멈춥니다.
 
-### Rung 1 — 단일 LLM 호출(안티패턴) {#rung-one}
+### 단계 1 — 단일 LLM 호출(안티패턴) {#rung-one}
 
 텍스트 상자가 프롬프트를 보내고 AI가 문자열을 반환하면 이를 표시합니다. 아마도 스피너를 사용했을 수도 있습니다. 사용자가 경로를 수정할 방법도 없고, AI가 조치를 취할 방법도 없으며, 무슨 일이 일어났는지, 왜 발생했는지 확인할 방법도 없습니다.
 
 SaaS 제품에 기본적으로 부착된 "요약" 버튼인 "AI 기능"은 어디에서나 볼 수 있습니다. 데모에서는 인상적으로 보이지만 현실이 지저분해지는 순간 깨집니다. 그것은 제품이 아닙니다. 그거 장난감이에요.
 
-### Rung 2 — 도구와의 채팅 {#rung-two}
+### 단계 2 — 도구와의 채팅 {#rung-two}
 
 이제 AI는 _일을 할 수 있습니다_. 여기에는 "이메일 초안", "연락처 검색", "쿼리 실행" 등의 도구와 도구 호출 및 결과를 실시간으로 보여주는 채팅 인터페이스가 있습니다. Claude, ChatGPT 및 커서의 내부 모습은 다음과 같습니다.
 
@@ -52,7 +52,7 @@ SaaS 제품에 기본적으로 부착된 "요약" 버튼인 "AI 기능"은 어
 
 ```an-diagram title="사다리 원리" summary="대부분의 팀은 렁 1 또는 2에서 멈춥니다. 에이전트 네이티브는 렁 3입니다. 즉, 하나의 공유 작업 표면에 대한 실제 앱이자 실제 에이전트입니다."
 {
-  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Rung 3 · agent-native</span><strong>Agent + UI as equal partners</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Rung 2</span><strong>A chat with tools</strong><small class=\"diagram-muted\">The agent can act — but it is still just a chat window. No dashboards, lists, or shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Rung 1</span><strong>A single LLM call</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
+  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">단계 3 · agent-native</span><strong>에이전트 + UI가 동등한 파트너</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">단계 2</span><strong>도구가 있는 채팅</strong><small class=\"diagram-muted\">에이전트는 동작할 수 있지만 여전히 채팅 창일 뿐입니다. 대시보드, 목록, 단축키는 없습니다.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">단계 1</span><strong>단일 LLM 호출</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
   "css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
 }
 ```
@@ -91,7 +91,7 @@ SaaS 제품에 기본적으로 부착된 "요약" 버튼인 "AI 기능"은 어
 
 ```an-diagram title="하나의 시스템, 두 가지 방식" summary="에이전트와 UI는 동일한 작업과 동일한 데이터베이스에 기록합니다. 한 사람이 무엇을 하든 다른 사람이 본다."
 {
-  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clicks, forms, shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natural language · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL 데이터베이스</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI updates live</div></div>",
+  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">클릭, 폼, 단축키</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">자연어 · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL 데이터베이스</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI가 실시간 업데이트</div></div>",
   "css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -165,9 +165,9 @@ Claude 코드와 같은 도구가 강력하다고 느끼는 이유는 모델이
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread\",\n  schema: z.object({ emailId: z.string(), body: z.string() }),\n  run: async ({ emailId, body }) => {\n    // db and schema come from your app's server/db setup\n    await db.insert(schema.replies).values({ emailId, body });\n  },\n});",
   "annotations": [
-    { "lines": "5", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this as a tool." },
+    { "lines": "5", "label": "도구 표면", "note": "`description`는 이를 도구로 호출할 시기를 결정하기 위해 에이전트가 읽는 것입니다." },
     { "lines": "6", "label": "타입 계약", "note": "하나의 zod `schema`가 에이전트, UI, HTTP, MCP, A2A 등 **모든** 표면의 입력을 검증합니다." },
-    { "lines": "7-10", "label": "One implementation", "note": "The `run` body is the single source of truth. The UI button and the agent tool both execute exactly this." }
+    { "lines": "7-10", "label": "하나의 구현", "note": "`run` 본문은 단일 정보 소스입니다. UI 버튼과 에이전트 도구 모두 이를 정확하게 실행합니다." }
   ]
 }
 ```

package/docs/content/locales/ko-KR/workspace-connections.md

@@ -18,7 +18,7 @@ description: "어디서나 연결 한 번 사용 통합을 위한 공유 공급
 
 ```an-diagram title="한 번 연결하고 앱을 부여하고 자격 증명을 재사용하세요." summary="연결은 저장소를 가리키는 공급자 메타데이터(비밀 아님)와 credentialRef를 보유합니다. 앱별 보조금으로 잠금을 해제할 수 있습니다. 앱은 단일 준비 상태를 읽습니다."
 {
-  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, status, scopes, config &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
+  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, 상태, 범위, 설정 &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
   "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
 }
 ```
@@ -58,32 +58,32 @@ await upsertWorkspaceConnectionGrant({
 });
 ```
 
-```an-schema title="The connection model" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
+```an-schema title="연결 모델" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
 {
   "entities": [
     {
       "id": "conn",
       "name": "workspace_connections",
-      "note": "Named provider account. Never stores secret values.",
+      "note": "지정된 공급자 계정. 절대 비밀 값을 저장하지 마세요.",
       "fields": [
         { "name": "id", "type": "string", "pk": true, "note": "e.g. acme-slack" },
-        { "name": "provider", "type": "string", "note": "stable provider id, e.g. slack" },
+        { "name": "provider", "type": "string", "note": "안정적인 공급자 ID, e.g. 느슨하게" },
         { "name": "label", "type": "string" },
         { "name": "accountId", "type": "string", "nullable": true },
         { "name": "accountLabel", "type": "string", "nullable": true },
         { "name": "status", "type": "string", "note": "e.g. connected" },
         { "name": "scopes", "type": "string[]", "nullable": true },
-        { "name": "config", "type": "json", "nullable": true, "note": "safe, non-secret config" },
+        { "name": "config", "type": "json", "nullable": true, "note": "안전하고 비밀이 아닌 구성" },
         { "name": "credentialRefs", "type": "json", "nullable": true, "note": "pointers to vault keys, e.g. { key, scope }" }
       ]
     },
     {
       "id": "grant",
       "name": "workspace_connection_grants",
-      "note": "Per-app permission to use a connection.",
+      "note": "연결을 사용하기 위한 앱별 권한입니다.",
       "fields": [
         { "name": "connectionId", "type": "string", "fk": "conn.id" },
-        { "name": "appId", "type": "string", "note": "e.g. brain, analytics" }
+        { "name": "appId", "type": "string", "note": "e.g. 두뇌, 분석" }
       ]
     }
   ],
@@ -208,7 +208,7 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ```an-diagram title="연결 저장소와 Vault" summary="볼트는 비밀 값을 소유합니다. 연결은 공급자 메타데이터와 credentialRef(포인터)를 소유합니다. 실행 시 앱은 부여된 연결을 통해 참조를 확인하고 자격 증명 모음에서 값을 읽습니다."
 {
-  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection store</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">status, scopes, config</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">App action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">never returned to the agent or UI</small></div></div></div>",
+  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">연결 저장소</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">상태, 범위, 설정</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">앱 action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">에이전트나 UI에 반환되지 않음</small></div></div></div>",
   "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/ko-KR/workspace-management.md

@@ -11,7 +11,7 @@ description: "브랜칭, CODEOWNERS, PR 검토 및 Dispatch가 Git 수준 거버
 
 ```an-diagram title="두 개의 거버넌스 평면" summary="Git은 코드를 관리합니다. Dispatch은 런타임을 관리합니다. 그것들은 보완적입니다. 하나를 다른 것 안에 복제하지 마십시오."
 {
-  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git / GitHub</span><strong>Code governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR review</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
+  "html": "<div class=\"gov\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Git 및 GitHub</span><strong>코드 거버넌스</strong><div class=\"gov-list\"><span class=\"diagram-pill\">CODEOWNERS</span><span class=\"diagram-pill\">branch protection</span><span class=\"diagram-pill\">PR 검토</span><span class=\"diagram-pill\">git log / blame</span></div></div><div class=\"diagram-pill diagram-muted\">+</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Dispatch</span><strong>Runtime governance</strong><div class=\"gov-list\"><span class=\"diagram-pill\">vault secrets &amp; grants</span><span class=\"diagram-pill\">workspace resources</span><span class=\"diagram-pill\">agent profiles</span><span class=\"diagram-pill\">approvals &amp; audit</span></div></div></div>",
   "css": ".gov{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.gov .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:240px}.gov .gov-list{display:flex;flex-wrap:wrap;gap:6px;margin-top:4px}"
 }
 ```
@@ -64,16 +64,16 @@ GitHub의 CODEOWNERS 파일은 변경된 파일을 기반으로 검토자를 PR
 # Framework core — affects every app; platform team reviews all changes
 packages/core/                     @your-org/platform-team
 
-# Dispatch control plane — secrets, integrations, workspace resources
+# 디스패치 제어 플레인 — 비밀, 통합, 작업 공간 리소스
 templates/dispatch/                @your-org/platform-team
 
-# Per-app ownership — each team reviews their own app
+# 앱별 소유권 - 각 팀이 자신의 앱을 검토합니다.
 templates/mail/                    @your-org/mail-team
 templates/analytics/               @your-org/analytics-team
 templates/calendar/                @your-org/calendar-team
 # ... add an entry per app
 
-# Workspace-level config — broad review since it affects everyone
+# 작업 공간 수준 구성 — 모든 사람에게 영향을 미치므로 광범위한 검토
 .github/                           @your-org/platform-team
 package.json                       @your-org/platform-team
 pnpm-workspace.yaml                @your-org/platform-team

package/docs/content/locales/ko-KR/workspace.md

@@ -13,7 +13,7 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 
 ```an-diagram title="Claude-Code 작업 공간이지만 SQL에 저장됨" summary="동일한 사용자 정의 계층(지침, 기술, 메모리, 에이전트, 작업, MCP)은 모든 파일이 공유 다중 테넌트 데이터베이스의 행이라는 점을 제외합니다."
 {
-  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Agent-native workspace</span><small class=\"diagram-muted\">rows in one SQL 데이터베이스</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">one codebase, many users, scoped <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
+  "html": "<div class=\"ws-map\"><div class=\"diagram-card cc\"><span class=\"diagram-pill warn\">Claude Code / Codex</span><small class=\"diagram-muted\">~/.claude/ on a local disk</small><div class=\"ws-files\"><span class=\"diagram-box\">CLAUDE.md</span><span class=\"diagram-box\">skills/</span><span class=\"diagram-box\">memory</span><span class=\"diagram-box\">mcp.json</span></div><small class=\"diagram-muted\">one codebase per developer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card an\"><span class=\"diagram-pill accent\">Agent-native 워크스페이스</span><small class=\"diagram-muted\">rows in one SQL 데이터베이스</small><div class=\"ws-rows\"><span class=\"diagram-pill\">AGENTS.md</span><span class=\"diagram-pill\">skills/&hellip;</span><span class=\"diagram-pill\">memory/&hellip;</span><span class=\"diagram-pill\">mcp-servers/&hellip;</span></div><small class=\"diagram-muted\">하나의 코드베이스, 여러 사용자, 범위 지정 <code>u:&lt;email&gt;:&hellip;</code></small></div></div>",
   "css": ".ws-map{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.ws-map .diagram-card{display:flex;flex-direction:column;gap:8px;padding:16px 18px;flex:1;min-width:220px}.ws-map .ws-files,.ws-map .ws-rows{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0}.ws-map .diagram-arrow{font-size:24px}"
 }
 ```
@@ -53,7 +53,7 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 
 ```an-diagram title="세 가지 범위, 하나의 유효 파일" summary="런타임은 읽기 시 작업 영역, 앱 및 개인 범위에서 동일한 경로를 확인합니다. 가장 구체적인 범위가 우선합니다."
 {
-  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">company-wide defaults from Dispatch</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">Organization / app</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
+  "html": "<div class=\"ws-stack\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Workspace</span><small class=\"diagram-muted\">Dispatch의 회사 전체 기본값</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">조직 / 앱</span><small class=\"diagram-muted\">team override for one app</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Personal</span><small class=\"diagram-muted\">per-user override &mdash; wins</small><code>context/brand.md</code></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">Effective <code>context/brand.md</code></div></div>",
   "css": ".ws-stack{display:flex;flex-direction:column;align-items:flex-start;gap:8px}.ws-stack .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px;min-width:280px}.ws-stack .diagram-arrow{font-size:20px;align-self:center}.ws-stack code{font-size:.85em}.ws-stack .diagram-box{align-self:center;margin-top:4px}"
 }
 ```
@@ -74,7 +74,7 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 3. 저장하고 **채팅**으로 전환하고 무엇이든 물어보세요. 상담원은 즉시 새 규칙을 따릅니다.
 
 ```an-callout
-{ "tone": "info", "body": "No restart, no redeploy. `AGENTS.md` is read at the start of every turn, so an edit you save now changes the agent's behavior on the very next message." }
+{ "tone": "info", "body": "다시 시작하거나 재배포할 필요가 없습니다. `AGENTS.md`은 매 턴 시작 시 읽혀지므로 지금 저장하는 편집 내용은 바로 다음 메시지에서 에이전트의 행동을 변경합니다." }
 ```
 
 **원할 때 다음 단계:**
@@ -96,10 +96,10 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 새로운 작업 공간을 위한 유용한 스타터 팩:
 
 ```text
-context/company.md              # what the company does, ICP, products, links
-context/brand.md                # voice, visual identity, spelling, forbidden usage
-context/messaging.md            # positioning, value props, proof points, objections
-instructions/guardrails.md      # compliance, escalation, and approval rules
+context/company.md              # 회사가 하는 일, ICP, 제품, 링크
+context/brand.md                # 음성, 시각적 정체성, 철자법, 금지된 사용
+context/messaging.md            # 포지셔닝, 가치 제안, 입증 포인트, 반대 의견
+instructions/guardrails.md      # 규정 준수, 에스컬레이션 및 승인 규칙
 skills/company-voice/SKILL.md   # on-demand guidance for customer-facing writing
 agents/<slug>.md                # reusable custom agent profiles
 ```
@@ -119,7 +119,7 @@ workspace context/brand.md
 ```text
 <!-- context/brand.md -->
 
-# Brand
+# 브랜드
 
 - Voice: direct, warm, concrete
 - Use: "workspace", "agent", "team"
@@ -183,18 +183,18 @@ instructions/legal-review-policy.md
 
 `AGENTS.md`, skills, 메모리, 사용자 지정 에이전트, MCP 서버 등 이러한 표면은 모두 동일한 기본 리소스 형태(`path` + `scope` + `content`)이며 동일한 방식으로 처리되고 해결됩니다.
 
-```an-schema title="The workspace resource model" summary="One resource shape backs every workspace file. The runtime keys it by path and scope and resolves the effective value on read."
+```an-schema title="작업공간 자원 모델" summary="하나의 리소스 형태는 모든 작업 공간 파일을 백업합니다. 런타임은 이를 경로 및 범위별로 키를 지정하고 읽기 시 유효 값을 확인합니다."
 {
   "entities": [
     {
       "id": "resource",
       "name": "workspace resource",
-      "note": "A single file in a user's workspace — instructions, skill, memory, agent, MCP config, or job.",
+      "note": "사용자 작업 공간의 단일 파일(명령어, 스킬, 메모리, 에이전트, MCP 구성 또는 작업)입니다.",
       "fields": [
         { "name": "path", "type": "string", "note": "Canonical path, e.g. AGENTS.md, skills/<slug>/SKILL.md" },
-        { "name": "scope", "type": "workspace | shared | personal", "note": "Which level this row lives at" },
+        { "name": "scope", "type": "workspace | shared | personal", "note": "이 행은 어느 수준에 있나요?" },
         { "name": "owner", "type": "string", "nullable": true, "note": "u:<email> for personal scope" },
-        { "name": "content", "type": "text", "note": "Markdown / JSON / YAML body" }
+        { "name": "content", "type": "text", "note": "마크다운 / JSON / YAML 본문" }
       ]
     }
   ]
@@ -221,12 +221,12 @@ Skills는 `/skill-name`와의 채팅에서 호출되는 에이전트 주문형
 {
   "filename": "agents/design.md",
   "language": "markdown",
-  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# Role\n\nYou are a focused design agent.\n\n## Responsibilities\n\n- Review layouts and interaction flows\n- Suggest stronger visual direction\n- Be concise and opinionated",
+  "code": "---\nname: Design\ndescription: >-\n  Reviews layouts, interaction patterns, and product UX decisions.\nmodel: inherit\ntools: inherit\ndelegate-default: false\n---\n\n# 역할\n\n당신은 집중적인 디자인 에이전트입니다.\n\n## 책임\n\n- 레이아웃 및 상호 작용 흐름 검토\n- 더 강력한 시각적 방향 제안\n- 간결하고 자기 주장이 강합니다.",
   "annotations": [
-    { "lines": "2", "label": "@mention handle", "note": "`name` is what appears in the `@`-dropdown and what the main agent delegates to." },
-    { "lines": "3-4", "label": "When to delegate", "note": "The `description` is what the orchestrator reads to decide this profile fits a task." },
-    { "lines": "5", "label": "Model", "note": "`inherit` reuses the main agent's model. Override only when the profile clearly needs a different one." },
-    { "lines": "6", "note": "`tools: inherit` for now — the field is reserved for future per-agent tool policies." }
+    { "lines": "2", "label": "@mention handle", "note": "`name`은 `@`-드롭다운에 나타나는 내용이며 주 에이전트가 위임하는 내용입니다." },
+    { "lines": "3-4", "label": "위임할 시기", "note": "`description`은 이 프로필이 작업에 적합한지 결정하기 위해 오케스트레이터가 읽는 것입니다." },
+    { "lines": "5", "label": "모델", "note": "`inherit`는 주 에이전트의 모델을 재사용합니다. 프로필에 분명히 다른 프로필이 필요한 경우에만 재정의하세요." },
+    { "lines": "6", "note": "현재 `tools: inherit` — 이 필드는 향후 에이전트별 도구 정책을 위해 예약되어 있습니다." }
   ]
 }
 ```
@@ -303,21 +303,21 @@ REST 엔드포인트가 자동으로 마운트됨:
 에이전트는 이러한 기본 제공 actions를 사용합니다. 자신의 actions에서 호출할 수도 있습니다:
 
 ```bash
-# List all resources
+# 모든 리소스 나열
 pnpm action resource-list --scope all
 
-# Read a resource
+# 리소스 읽기
 pnpm action resource-read --path "skills/my-skill/SKILL.md"
 
-# Read inherited workspace context managed by Dispatch
+# Dispatch가 관리하는 상속된 작업공간 컨텍스트 읽기
 pnpm action resource-read --scope workspace --path "context/brand.md"
 
 # Show workspace -> organization/app -> personal precedence for a path
 pnpm action resource-effective --path "context/brand.md"
 
-# Write a resource
-pnpm action resource-write --path "notes/meeting.md" --content "# Meeting Notes..."
+# 리소스 작성
+pnpm action resource-write --path "notes/meeting.md" --content "# 회의록..."
 
-# Delete a resource
+# 리소스 삭제
 pnpm action resource-delete --path "notes/old.md"
 ```

package/docs/content/locales/ko-KR/writing-agent-instructions.md

@@ -1,15 +1,15 @@
 ---
-title: "작성 대리인 지침 및 Skills"
+title: "작성 대리인 지침 및 기술"
 description: "에이전트 기본 앱 또는 템플릿에 대한 훌륭한 에이전트 지침을 작성하는 방법: AGENTS.md, skills 및 도구 설명"
 ---
 
-# 작성 에이전트 지침 및 Skills
+# 작성 에이전트 지침 및 기술
 
 에이전트 기본 앱에서 에이전트의 행동은 사용자가 제공한 지침만큼만 좋습니다. 해당 지침은 `AGENTS.md`(지도), skills(심층 분석), 작업/도구 설명(에이전트가 올바른 도구를 선택하는 방법) 등 세 가지 표면에 전달됩니다. 산문이 아닌 빠른 검색을 위해 각각 작성하세요.
 
 ```an-diagram title="작성된 표면 3개 + 런타임 표면 1개" summary="AGENTS.md 및 도구 설명은 매 턴마다 로드됩니다. 수요에 따른 기술 부하; application_state는 UI를 통해 실시간으로 작성됩니다."
 {
-  "html": "<div class=\"diagram-surfaces\"><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">Every turn</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">the map: purpose, core rules, state keys, action + skills index</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">Every turn</span><strong>Tool descriptions</strong><small class=\"diagram-muted\">drive tool selection — one precise sentence each</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">On demand</span><strong>Skills</strong><small class=\"diagram-muted\">deep how-to, loaded when the description fires</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">written by your UI: navigation, selection, focus</small></div></div>",
+  "html": "<div class=\"diagram-surfaces\"><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">모든 턴</span><strong>AGENTS.md</strong><small class=\"diagram-muted\">지도: 목적, 핵심 규칙, 상태 키, action + skills 색인</small></div><div class=\"diagram-card always\" data-rough><span class=\"diagram-pill accent\">모든 턴</span><strong>도구 설명</strong><small class=\"diagram-muted\">도구 선택 유도 — 각각 정확한 한 문장</small></div><div class=\"diagram-card ondemand\" data-rough><span class=\"diagram-pill\">요청 시</span><strong>기술</strong><small class=\"diagram-muted\">상세 가이드, 설명이 맞을 때 로드</small></div><div class=\"diagram-card runtime\" data-rough><span class=\"diagram-pill ok\">Live</span><strong>application_state</strong><small class=\"diagram-muted\">UI가 작성: 탐색, 선택, 포커스</small></div></div>",
   "css": ".diagram-surfaces{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px}.diagram-surfaces .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
 }
 ```
@@ -22,28 +22,28 @@ description: "에이전트 기본 앱 또는 템플릿에 대한 훌륭한 에
 - **핵심 규칙** — 항상 유지해야 하는 몇 가지 불변 사항(SQL의 데이터, 작업은 actions를 거치고, AI는 에이전트 채팅을 거치고, 스키마 변경 사항은 추가됨). 짧고 필수적인 글머리 기호.
 - **애플리케이션 상태 키** — 에이전트가 사용자가 보고 있는 내용과 모양을 알기 위해 읽는 `navigation`/선택/초점 키입니다.
 - **작업 테이블** — 목적에 맞는 작업 이름을 간략하게 정리한 테이블입니다.
-- **Skills 인덱스** — 존재하는 skills 목록과 각각을 읽는 시기.
+- **기술 인덱스** — 존재하는 skills 목록과 각각을 읽는 시기.
 
 섹션이 화면을 넘어서 커지면 스킬에 속합니다. `AGENTS.md`는 "어려운 일을 정확히 어떻게 하는가"가 아니라 "이 앱이 무엇이고 무엇을 할 수 있는가"에 대해 답합니다.
 
 ```markdown
-# Projects App
+# 프로젝트 앱
 
 One workspace for projects, tasks, and notes. Agent and UI share the same SQL
 data and the same actions.
 
-## Core Rules
+## 핵심 규칙
 
-- Data lives in SQL via Drizzle. Use actions for all writes.
+- Data lives in Drizzle 기반 SQL. Use actions for all writes.
 - All AI work goes through the agent chat; never call an LLM inline.
 - Schema changes are additive only.
 
-## Application State
+## 애플리케이션 상태
 
 - `navigation.view`: `home` | `project`
 - `navigation.projectId`: selected project on a project page
 
-## Actions
+## 작업
 
 | Action           | Purpose                     |
 | ---------------- | --------------------------- |
@@ -51,7 +51,7 @@ data and the same actions.
 | `create-project` | Create a project            |
 | `update-project` | Rename or archive a project |
 
-## Skills
+## 기술
 
 - `project-imports` — read before importing legacy CSV exports.
 - `sharing` — read before exposing a project to other users.
@@ -84,12 +84,12 @@ description: >-
 
 ```text
 .agents/skills/project-imports/
-├── SKILL.md            # rule + happy path + do/don't
+├── SKILL.md            # 규칙 + 행복한 경로 + do/don't
 └── references/
-    └── csv-format.md   # full column spec, encodings, edge cases
+    └── csv-format.md   # 전체 열 사양, 인코딩, 엣지 케이스
 ```
 
-이것은 항상 로드되는 표면을 작게 유지하고 컨텍스트를 부풀리지 않고 깊이 확장을 가능하게 합니다. 전체 스킬 형식은 [Skills Guide](/docs/skills-guide)를 참조하세요.
+이것은 항상 로드되는 표면을 작게 유지하고 컨텍스트를 부풀리지 않고 깊이 확장을 가능하게 합니다. 전체 스킬 형식은 [기술 Guide](/docs/skills-guide)를 참조하세요.
 
 ## 행동 중심 테이블 작성 {#action-tables}
 
@@ -114,9 +114,9 @@ defineAction({
 });
 ```
 
-## Skills 대 actions {#skills-vs-actions}
+## 기술 대 actions {#skills-vs-actions}
 
-Skills 및 actions는 상호보완적입니다. 스킬은 에이전트가 읽는 지침입니다. 와
+기술 및 actions는 상호보완적입니다. 스킬은 에이전트가 읽는 지침입니다. 와
 액션은 에이전트가 실행할 수 있는 코드입니다.
 
 | 필요                                                              | 사용               |
@@ -151,7 +151,7 @@ Skills 및 actions는 상호보완적입니다. 스킬은 에이전트가 읽는
 | 표면                         | 작성자             | 로드된 경우                                        | 거기에 속한 것                                         |
 | ---------------------------- | ------------------ | -------------------------------------------------- | ------------------------------------------------------ |
 | `AGENTS.md` 지침             | 당신(개발자)       | 매 턴마다 방향으로                                 | 목적, 핵심 규칙, 상태 키, 작업 인덱스, skills 인덱스   |
-| Skills (`SKILL.md`)          | 귀하(개발자)       | 상담원이 해당 기술이 관련성이 있다고 판단하는 경우 | 특정 패턴에 대한 단계별 방법, 나열하거나 나열하지 않음 |
+| 기술 (`SKILL.md`)            | 귀하(개발자)       | 상담원이 해당 기술이 관련성이 있다고 판단하는 경우 | 특정 패턴에 대한 단계별 방법, 나열하거나 나열하지 않음 |
 | 작업 설명(도구)              | 귀하(개발자)       | 매 턴마다 도구 목록으로                            | 작업이 수행하는 작업, 반환하는 작업, 매개변수 의미     |
 | `application_state` 컨텍스트 | UI 코드(런타임 시) | 매 턴마다 라이브 앱 상태로                         | 현재 탐색, 선택, 초점 개체, URL                        |
 
@@ -163,11 +163,11 @@ Skills 및 actions는 상호보완적입니다. 스킬은 에이전트가 읽는
 ## 무엇이 어디로 가는가 {#what-goes-where}
 
 - **AGENTS.md** — 목적, 핵심 규칙, 상태 키, 작업 인덱스, skills 인덱스 등 모든 단계에서 전체 앱에 적용됩니다.
-- **Skills** — 요청 시 로드되는 특정 패턴에 대한 재사용 가능한 방법입니다. 앱에서 작업하는 모든 사람에게 적용됩니다.
+- **기술** — 요청 시 로드되는 특정 패턴에 대한 재사용 가능한 방법입니다. 앱에서 작업하는 모든 사람에게 적용됩니다.
 - **메모리(`memory/MEMORY.md`)** — 작성된 지침이 아닌 사용자별 기본 설정 및 수정 사항입니다.
 
 ## 다음 단계 {#whats-next}
 
-- [Skills Guide](/docs/skills-guide) — 스킬 파일 형식, 프레임워크 skills 및 앱 지원 skills.
+- [기술 Guide](/docs/skills-guide) — 스킬 파일 형식, 프레임워크 skills 및 앱 지원 skills.
 - [Creating Templates](/docs/creating-templates) — `AGENTS.md` 및 skills가 배송 가능한 템플릿에 어떻게 적용되는지.
 - [The four-area checklist](/docs/key-concepts#four-area-checklist) — 모든 기능이 충족해야 하는 4개 영역 모델