@agent-native/core 0.92.12 → 0.94.0

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={"세 가지 캡처 유형이 하나의 라이브러리에 포함됩니다. 상담원이 스크립트를 작성하고 제목을 지정하고 요약하면 모든 스크립트를 검색하고 공유할 수 있습니다."}>
 
@@ -77,13 +77,13 @@ Loom + Granola + Wispr Flow가 하나의 앱으로 통합되었다고 생각해
 ## 그것으로 무엇을 할 수 있나요
 
 - **내장 레코더, 웹캠 오버레이, 오디오 캡처 및 일시 중지/자르기를 사용하여 화면을 녹화**하세요.
+- **공개 Loom 동영상을 가져오세요.** 웹에서 **녹화 → Loom 가져오기**를 선택한 다음 Loom 공유 또는 삽입 URL을 붙여넣으세요. Clips는 라이브러리에 사본을 저장하고, 공개 트랜스크립트가 있으면 가져옵니다.
 - **캘린더에서 회의를 캡처하세요.** Google Calendar를 연결하고 사이드바에서 예정된 회의를 확인하고 원하는 회의를 기록하세요. 실시간 기록과 AI 요약, 글머리 기호 메모, 작업 항목이 끝나는 순간 바로 받아보실 수 있습니다.
 - **푸시 투 토크 받아쓰기.** 컴퓨터에서 Fn을 누른 채 말을 하면 정리된 텍스트가 사용 중인 앱에 드롭됩니다. 모든 받아쓰기는 원본과 AI 정리 버전이 나란히 검색 가능한 기록에 보관됩니다.
 - **모든 녹음에 대해 자동 생성된 제목, 요약 및 챕터 마커**를 받으세요. 상담원이 이를 채우고 최신 상태로 유지합니다.
 - **모든 기록을 검색**합니다. 화면 녹화, 회의, 받아쓰기가 모두 하나의 라이브러리에 있습니다. "우리가 출시 계획을 논의한 클립을 찾아보세요."
 - **클립 공유** 클립별 권한(공개, 팀, 비공개)이 있습니다. 링크 추적 및 스레드 댓글도 작동합니다.
-- **Slack에서 공개 클립을 미리 보세요** Loom 스타일의 재생 가능한 클립을 펼친 후
-  Workspace는 Clips Slack 앱을 설치합니다.
+- **Slack에서 공개 클립을 미리 보세요**. 워크스페이스가 Clips Slack 앱을 설치하면 재생 가능한 동영상 미리보기가 펼쳐집니다.
 - **Chrome 확장 프로그램을 사용하여 브라우저 로그를 캡처하세요.** 브라우저 녹화는
   수정된 콘솔 로그를 첨부하고 다음 작업에 도움이 되는 가져오기/XHR 메타데이터
   제품 버그 및 브라우저 전용 재현
@@ -511,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 기능은 에이전트 채팅에 위임됩니다.)

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

@@ -11,7 +11,7 @@ Design은 에이전트 기반 HTML 프로토타이핑 스튜디오입니다. 에
   <Screen
     surface="desktop"
     html={
-      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>제품 출시 페이지</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>생성된 HTML 프로토타입</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>히어로를 더 밀도 있게 만들고 CTA를 더 명확하게 하세요.</span><div style='flex:1'></div><button class='primary'>수정 적용</button></div></div></div>"
+      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>제품 출시 페이지</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>Agent-Native로 더 빠르게 출시하세요</strong><span class='wf-muted' style='max-width:70%'>프롬프트에서 작동하는 프로토타입을 생성한 다음 그 자리에서 다듬으세요.</span><button class='primary'>시작하기</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>히어로를 더 밀도 있게 만들고 CTA를 더 명확하게 하세요.</span><div style='flex:1'></div><button class='primary'>수정 적용</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -89,6 +89,7 @@ Design은 에이전트 기반 HTML 프로토타이핑 스튜디오입니다. 에
 ## 그것으로 무엇을 할 수 있나요
 
 - **완전한 프로토타입을 생성합니다.** 필요한 화면이나 페이지를 설명하면 상담원이 Tailwind 스타일과 Alpine interactions를 사용하여 작동하는 HTML 문서를 만듭니다.
+- **재사용 가능한 템플릿에서 시작하세요.** 광고, 원페이지, 랜딩 페이지 등에 맞는 크기의 템플릿을 선택하거나 인라인 디자인을 템플릿으로 저장할 수 있습니다. 프롬프트는 잠기지 않은 내용만 조정하고 잠긴 로고와 배경은 그대로 유지합니다.
 - **변형을 비교하세요.** 여러 방향으로 시작하여 가장 강력한 방향을 선택한 다음 계속해서 개선하세요.
 - **시각적으로 조정하세요.** 일반적인 변경 사항에는 내장된 조정 컨트롤을 사용하거나 상담원에게 복사, 레이아웃, 색상, 간격 및 상호 작용 업데이트를 요청하세요.
 - **디자인 시스템을 적용합니다.** 디자인 시스템 기본 설정을 저장하고 재사용하여 생성된 작업이 귀하의 브랜드에 더 가깝게 유지됩니다.
@@ -133,6 +134,8 @@ pnpm dev
 
 모든 데이터는 Drizzle ORM를 통해 SQL에 있습니다. 스키마: `templates/design/server/db/schema.ts`. 디자인 및 디자인 시스템은 표준 `ownableColumns`와 일치하는 프레임워크 공유 테이블을 전달하므로 사용자별/조직별 공유 모델에 속합니다.
 
+아래 표는 디자인, 파일, 템플릿, 버전, 디자인 시스템이라는 핵심 소유 가능 리소스를 다룹니다. 같은 스키마의 다른 7개 테이블은 핵심 리소스 모델이 아니라 이 문서의 다른 부분에서 설명하는 기능을 지원합니다. `design_localhost_connections`와 `design_localhost_write_grants`(localhost 소스 모드), `component_index`(컴포넌트 인덱싱), `motion_timeline`(모션), `design_state`(편집기 상태 스냅샷), `design_fusion_edits`(전체 앱 Fusion 모드), `design_review_snapshot`(리뷰 스냅샷)입니다.
+
 | 테이블                                   | 무엇을 담고 있는지                                                                                                                   |
 | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `designs`                                | 디자인 프로젝트 — `title`, `description`, `project_type` (`prototype` / `other`), `data` JSON blob 및 선택적 `design_system_id` 링크 |

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

@@ -5,7 +5,11 @@ description: "Dispatch는 중앙 받은 편지함, 앱 간 오케스트레이션
 
 # 파견
 
-> **참조:** Dispatch의 기능과 원하는 시기에 대한 개념적 개요는 [Dispatch](/docs/dispatch)를 참조하세요. 이 페이지는 템플릿별 참조입니다.
+<Callout tone="info">
+
+**참조:** Dispatch의 기능과 원하는 시기에 대한 개념적 개요는 [Dispatch](/docs/dispatch)를 참조하세요. 이 페이지는 템플릿별 참조입니다.
+
+</Callout>
 
 디스패치는 **작업공간 제어 평면**입니다. 다른 템플릿이 도메인 앱(Mail, Calendar, Analytics, Brain)인 경우 Dispatch는 중앙 받은 편지함, 비밀 저장소, 예약된 작업, Slack/Telegram 통합, 도메인 작업을 [A2A](/docs/a2a-protocol)를 통해 올바른 전문 앱에 위임하는 오케스트레이터 에이전트 등 모든 것을 조정하기 위해 템플릿과 함께 실행하는 앱입니다.
 

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

@@ -362,3 +362,11 @@ UI의 경로:
 **키보드 단축키 변경.** 키 바인딩 핸들러는 `templates/mail/app/components/email/`에 있습니다. `useHotkeys` 또는 `addEventListener("keydown"`를 검색하여 각 키가 연결된 위치를 찾으세요.
 
 상담원에게 이러한 변경을 요청하세요. 에이전트는 자체 소스를 편집할 수 있습니다. [Self-Modifying Code](/docs/key-concepts#agent-modifies-code)를 참조하세요.
+
+## 다음 단계
+
+- [**템플릿**](/docs/cloneable-saas) — 복제해 소유하는 모델과 시작점으로 사용할 수 있는 다른 모든 도메인 템플릿
+- [**시작하기**](/docs/getting-started) — actions, application state, 실시간 동기화 등 프레임워크의 기본 사항
+- [**캘린더**](/docs/template-calendar) — 일정 관리와 예약을 다루는 관련 도메인 템플릿
+- [**자동화**](/docs/automations) — Mail의 자동 분류 규칙이 기반으로 삼는 이벤트 트리거 엔진
+- [**Actions**](/docs/actions) — 채팅, 단축키, 자동화가 호출하는 action 시스템

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

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ interface TrackingEvent {
 ## 다음 단계
 
 - [**Actions**](/docs/actions) — 대부분의 추적 통화가 발생하는 곳
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()`는 시작 시 핵심 경로 플러그인에서 실행됩니다.
-- [**Secrets**](/docs/security) — 추적 제공자를 위한 API 키 관리
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()`는 시작 시 핵심 경로 플러그인에서 실행됩니다.
+- [**보안 — 비밀 관리**](/docs/security#secrets) — 추적 제공자를 위한 API 키 관리

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

@@ -92,21 +92,14 @@ description: "에이전트와 함께 작업하는 일상적인 루프: 에이전
 
 에이전트는 탭하여 이동할 수 있는 별도의 앱이 아닙니다. 사이드바, 원시 패널 및 `sendToAgentChat()` 호출과 같은 소수의 React 구성 요소로 제공되며 모든 앱에 드롭됩니다. `<AgentSidebar>`를 렌더링하여 모든 화면에 전환 가능한 에이전트를 제공하거나 일회성 LLM 호출을 실행하는 대신 버튼을 연결하여 특정 작업을 채팅에 전달할 수 있습니다.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) — `<AgentPanel>`, `<AgentSidebar>` 및 `sendToAgentChat()`를 React 앱에 마운트합니다.
-→ [**Agent Surfaces**](/docs/agent-surfaces) — 워크플로가 헤드리스, 채팅 우선, 내장형 또는 전체 앱인지 선택하세요.
-
 ## 가벼운 UI로 갈 수 있습니다 {#ui-light}
 
 모든 앱에 전체 대시보드가 필요한 것은 아닙니다. 상담원이 제품인 경우 대부분의 맞춤 UI를 건너뛸 수 있습니다. 앱을 열고 원하는 것을 요청하면 상담원이 나머지 작업을 수행하게 됩니다. 에이전트에는 여전히 기록, 작업 공간, 설정 등 관리 영역이 있지만 주요 상호 작용은 클릭이 아닌 대화입니다.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) — jobs, queues, scripts, external agents를 위한 브라우저 없는 앱
-
 ## 함께 편집하세요 {#you-co-edit}
 
 귀하와 상담원이 동일한 문서를 작업할 때는 교대로 작업하지 않습니다. 실시간 공동작업을 통해 에이전트의 편집 내용이 팀원과 동일한 방식으로 실시간 커서로 사용자의 편집 내용과 함께 스트리밍됩니다. 덮어쓰기는 없습니다. 작동하는 동안 계속 입력할 수 있으며 변경사항이 발생하는 대로 표시됩니다.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — 동일한 문서에서 실시간 커서 및 에이전트 편집을 통한 다중 사용자 공동 편집.
-
 ## 다음 단계 {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — 상담원은 귀하가 무엇을 보고 있는지 알고 있습니다.

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

@@ -9,6 +9,12 @@ description: "에이전트 채팅 작성기의 음성 받아쓰기 — Builder G
 
 프레임워크는 이 모든 것을 자동으로 처리합니다. Builder에 연결된 사용자는 기본적으로 Builder에서 호스팅되는 Gemini Flash-Lite를 얻습니다. 그렇지 않으면 사용자가 자신의 공급자 키를 가져오거나 브라우저 음성 인식으로 돌아갈 수 있습니다.
 
+## 실시간 음성 모드 {#realtime-speech-mode}
+
+마이크를 열면 팝오버에서 **실시간 음성 대화**와 **편집 가능한 받아쓰기** 중 하나를 선택할 수 있습니다. 실시간 모드에는 사용자 범위의 `OPENAI_API_KEY`가 필요하며, WebRTC를 통해 브라우저를 `gpt-realtime-2.1`에 연결합니다. 채팅은 오른쪽 아래의 음성 오브로 접힙니다. 오브를 클릭하면 대화를 끝내지 않고 채팅을 표시하거나 숨길 수 있습니다.
+
+음성 모델은 채팅과 동일한 인증된 Agent Native 도구를 사용하므로 말하는 동안 앱을 탐색하고 작업을 호출할 수 있습니다. 승인이 필요한 작업은 사용자가 승인할 때까지 일시 중지된 상태로 유지됩니다. 오디오는 SQL에 저장되지 않으며 Agent Native는 간결한 세션 및 대화 내용 상태만 보관합니다. 실시간 세션은 최대 60분 동안 지속됩니다.
+
 ## 작동 방식 {#how-it-works}
 
 작곡가의 음성 버튼은 브라우저에서 오디오를 녹음한 다음 제공자를 선택합니다.

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

@@ -425,10 +425,9 @@ Brain의 소스 페이지는 참조 구현입니다. Brain 소스 레코드 옆
 
 ### 디스패치 제어 평면 설정
 
-Dispatch는 앱이 직접 호출할 수 있는 동일한 공유 저장소 기능을 작성하는 제어 평면 actions를 노출합니다.
+Dispatch는 앱이 직접 호출할 수 있는 것과 동일한 공유 저장소 함수를 사용하는 제어 평면 actions를 제공합니다. `upsert-workspace-connection` action은 공급자 카탈로그를 기준으로 입력을 검증한 다음 이 페이지에 나온 동일한 `upsertWorkspaceConnection()`에 위임합니다.
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ await upsertWorkspaceConnectionGrant({
 경계를 엄격하게 유지하십시오. 제공자 메타데이터는 표시해도 안전합니다. 자격 증명 값은 저장소에 유지됩니다.
 
 </details>
+
+## 다음 단계 {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — 일반적으로 작업 공간 연결 설정과 Vault를 관리하는 앱
+- [**보안**](/docs/security) — 연결이 가리키는 자격 증명 Vault, 시크릿 범위, 접근 모델
+- [**온보딩**](/docs/onboarding#checking-workspace-connections-in-onboarding) — 템플릿 설정 체크리스트에서 연결 준비 상태를 확인하는 방법
+- [**MCP 클라이언트**](/docs/mcp-clients) — 작업 공간 전체에서 MCP 서버 자격 증명을 공유하는 관련 재사용 가능 구성 패턴
+- [**Brain**](/docs/template-brain) — 이 모델을 기반으로 구축된 공급자 Sources 페이지의 참조 구현

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

@@ -5,7 +5,11 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 
 # 작업 공간
 
-> **어떤 작업공간 문서입니까?** 이 페이지에서는 **사용자 정의 레이어**, 즉 작업공간이*무엇인지* 다룹니다. 배포 형태(하나의 단일 저장소, 많은 앱)는 [Multi-App Workspaces](/docs/multi-app-workspace)를 참조하세요. 거버넌스(누가 무엇을 검토하고, 승인하고, 소유하는지)에 대해서는 [Workspace Governance](/docs/workspace-management)를 참조하세요.
+<Callout tone="info">
+
+**어떤 작업공간 문서입니까?** 이 페이지에서는 **사용자 정의 레이어**, 즉 작업공간이*무엇인지* 다룹니다. 배포 형태(하나의 단일 저장소, 많은 앱)는 [Multi-App Workspaces](/docs/multi-app-workspace)를 참조하세요. 거버넌스(누가 무엇을 검토하고, 승인하고, 소유하는지)에 대해서는 [Workspace Governance](/docs/workspace-management)를 참조하세요.
+
+</Callout>
 
 모든 에이전트 기반 앱에는 **작업 공간**, 즉 에이전트를 나만의 것으로 만드는 사용자 정의 레이어가 함께 제공됩니다. 여기에는 팀 지침(`AGENTS.md`), 공유 학습(`LEARNINGS.md`), 개인 구조적 메모리(`memory/MEMORY.md`), 에이전트가 요청 시 가져오는 skills, 사용자 정의 하위 에이전트, 예약된 작업 및 연결된 MCP 서버 등 Claude 코드/Codex 설정에서 기대할 수 있는 모든 것이 포함되어 있습니다.
 
@@ -82,7 +86,7 @@ description: "Claude-사용자별 코드 수준 사용자 정의 — skills, 메
 | 프로젝트별 `CLAUDE.md` / skills      | 앱별 `AGENTS.md` + 작업 공간 메모리 리소스     |
 | JSON 파일의 MCP 구성                 | JSON의 MCP 구성 _또는_ 범위당 UI 설정          |
 
-동일한 기능. 다른 경제학. 이것이 SaaS에 중요한 이유는 [Templates](/docs/cloneable-saas)를 참조하세요.
+동일한 기능. 다른 경제학. 이것이 SaaS에 중요한 이유는 [앱](/docs/cloneable-saas)를 참조하세요.
 
 ## 개요 {#overview}
 
@@ -219,11 +223,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-`context/` 파일을 짧고 사실대로 유지하세요. 상담원이 훑어볼 수 있는 몇 가지 글머리 기호는 다음과 같습니다.
-
-```text
-<!-- context/brand.md -->
+예:
 
+```text filename="context/brand.md"
 # 브랜드
 
 - Voice: direct, warm, concrete
@@ -388,15 +390,9 @@ Workspace에는 두 가지 에이전트 유형이 있습니다.
 
 하나의 앱 내에서 위임을 위해 사용자 정의 에이전트를 사용합니다. A2A를 통해 다른 앱에 전화해야 할 때 연결된 에이전트를 사용하세요.
 
-## @태깅 {#at-tagging}
-
-작업 영역 항목을 참조하려면 채팅 입력에 `@`를 입력하세요. 일치하는 에이전트와 파일을 보여주는 드롭다운이 커서에 나타납니다. 탐색하려면 화살표 키를 사용하고 선택하려면 Enter를 사용하세요. 선택한 항목이 입력에 인라인 칩으로 나타납니다.
-
-메시지를 보내면 **파일/리소스**는 에이전트가 읽을 수 있는 참조로 전달되고, **사용자 지정 에이전트**는 프로필 지침에 따라 로컬로 실행되며, **연결된 에이전트**는 A2A를 통해 호출됩니다.
+## @ 태그와 / 슬래시 명령 {#at-tagging}
 
-## / 슬래시 명령 {#slash-commands}
-
-스킬을 호출하려면 줄 시작 부분에 `/`를 입력하세요. 드롭다운에는 사용 가능한 skills가 이름 및 설명과 함께 표시됩니다. 하나를 선택하면 인라인 칩이 추가되고 메시지가 전송될 때 해당 내용이 컨텍스트로 포함됩니다. skills가 구성되지 않은 경우 드롭다운이 이 문서로 연결됩니다.
+채팅 입력에 `@`를 입력해 에이전트, 파일 또는 리소스를 참조하거나 `/`를 입력해 skill을 호출하세요. 둘 다 커서 위치에 드롭다운을 열고 항목을 선택하면 인라인 칩을 추가합니다. 전체 작동 방식(라우팅, `MentionProvider`, 하위 에이전트 선택)은 [에이전트 멘션](/docs/agent-mentions)을, skills 작성 및 검색 방법은 [Skills 가이드](/docs/skills-guide)를 참조하세요.
 
 ## 코드 대 앱 모드 {#dev-vs-prod}
 
@@ -416,10 +412,6 @@ Workspace에는 두 가지 에이전트 유형이 있습니다.
 
 빠른 시작, 연결/부여/자격 증명 참조 API 및 구체적인 Slack, HubSpot 및 GitHub 예는 [Workspace Connections](/docs/workspace-connections)를 참조하세요.
 
----
-
-# 참고자료
-
 ## 자원 API {#resource-api}
 
 리소스는 서버 코드 actions 또는 REST API에서 관리할 수 있습니다.
@@ -463,3 +455,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# 회의록..."
 # 리소스 삭제
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## 다음 단계 {#whats-next}
+
+- [**Skills 가이드**](/docs/skills-guide) — `skills/`에서 참조하는 skill 파일을 작성하고 범위 지정하기
+- [**에이전트 멘션**](/docs/agent-mentions) — `@` 멘션과 `/` 명령의 전체 작동 방식
+- [**반복 작업**](/docs/recurring-jobs) — Scheduled Tasks에서 만든 프롬프트 예약하기
+- [**Workspace 거버넌스**](/docs/workspace-management) — workspace 변경을 검토하고 승인하며 소유하는 주체
+- [**다중 앱 Workspace**](/docs/multi-app-workspace) — 하나의 workspace가 포괄하는 배포 형태
+- [**Workspace 연결**](/docs/workspace-connections) — 앱 간에 제공업체 자격 증명 공유하기

package/docs/content/locales/pt-BR/actions.mdx

@@ -11,7 +11,7 @@ Actions são a única fonte de verdade para tudo o que seu aplicativo faz. Defin
 - **Ganchos Typesafe React** — `useActionQuery("name")` e `useActionMutation("name")` no frontend, tipos inferidos do esquema.
 - **Chamadas de cliente imperativas** — `callAction("name", params)` quando um gancho não cabe.
 - **Transporte de estrutura** — montado automaticamente pela estrutura por trás desses ganchos e disponível para clientes HTTP externos.
-- **Uma ferramenta MCP** — exposta a aplicativos Claude ChatGPT personalizados MCP, Claude Desktop/Code, Cursor, Codex e qualquer outro cliente MCP.
+- **Uma ferramenta MCP** — exposta a aplicativos Claude ChatGPT personalizados MCP, Claude Desktop/Code, Cursor, Codex e qualquer outro host MCP.
 - **Uma ferramenta A2A** — chamada por outros aplicativos nativos do agente em A2A.
 - **Um comando CLI** — `pnpm action <name>` para scripts e loops de desenvolvimento.
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-Mantenha `link` como substituto para clientes CLI e não UI MCP; é também o alvo de lançamento da incorporação. A ponte de incorporação (a sessão de início de incorporação assinada, transplante vs. renderização de quadro controlado, a ponte de host `ui/*`, CSP e fixação de altura) é propriedade de [External Agents](/docs/external-agents#mcp-app-bridge).
+Mantenha `link` como substituto para a CLI e hosts MCP sem interface de usuário; é também o alvo de lançamento da incorporação. A ponte de incorporação (a sessão de início de incorporação assinada, transplante vs. renderização de quadro controlado, a ponte de host `ui/*`, CSP e fixação de altura) é propriedade de [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## actions padrão {#standard-actions}
 

package/docs/content/locales/pt-BR/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/docs/content/locales/pt-BR/agent-surfaces.mdx

@@ -141,8 +141,7 @@ pnpm install
 
 Em seguida, defina a operação durável:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -496,12 +495,11 @@ Mantenha o contrato pequeno: defina operações duráveis como actions, retorne
 resultados de widget quando o bate-papo precisa de UI rico e adicionar telas inteiras somente quando os usuários
 precisa navegar, comparar, configurar ou colaborar em objetos persistentes.
 
-## Documentos relacionados {#related-docs}
+## Próximos passos {#related-docs}
 
-- [Actions](/docs/actions) — defina a operação sem comando uma vez.
-- [Native Interface de chat](/docs/native-chat-ui) — renderiza os resultados da ação digitada no bate-papo.
-- [Drop-in Agent](/docs/drop-in-agent) — monte bate-papo, barra lateral ou superfícies de painel.
-- [Component API](/docs/components) — peças de bate-papo/compositor React de nível inferior.
-- [Embedding SDK](/docs/embedding-sdk) — adicione Agent-Native a um aplicativo existente.
-- [External Agents](/docs/external-agents) — conecta hosts compatíveis com MCP a um aplicativo.
-- [A2A Protocol](/docs/a2a-protocol) — liga para agentes de outros agentes.
+- [**Actions**](/docs/actions) — defina a operação uma vez; todas as superfícies acima chamam a mesma operação
+- [**Native Interface de chat**](/docs/native-chat-ui) — renderize resultados tipados como tabelas, gráficos e cartões no chat
+- [**Generative UI**](/docs/generative-ui) — gere UI em sandbox, transitória ou persistida, diretamente no chat
+- [**Automation-First Apps**](/docs/pure-agent-apps) — o padrão completo sem navegador para trabalhos, filas, scripts e agentes externos
+- [**External Agents**](/docs/external-agents) — conecte hosts compatíveis com MCP a um aplicativo
+- [**A2A Protocol**](/docs/a2a-protocol) — chame agentes de outros aplicativos Agent-Native

package/docs/content/locales/pt-BR/agent-teams.mdx

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

package/docs/content/locales/pt-BR/authentication.mdx

@@ -15,7 +15,7 @@ A autenticação é configurada automaticamente via `autoMountAuth(app)` no plug
 - **MCP remoto OAuth:** OAuth 2.1 padrão para hosts MCP, como código Claude e conectores ChatGPT.
 - **Personalizado:** Traga sua própria autenticação por meio do retorno de chamada `getSession`.
 
-<Diagram id="doc-block-1rujd8s" title={"Três entradas, uma sessão"} summary={"Visitantes do navegador, clientes MCP programáticos e provedores personalizados resolvem para a mesma AuthSession que o escopo downstream lê."}>
+<Diagram id="doc-block-1rujd8s" title={"Três entradas, uma sessão"} summary={"Visitantes do navegador, hosts MCP e provedores personalizados resolvem para a mesma AuthSession que o escopo downstream lê."}>
 
 ```html
 <div class="auth-modes">

package/docs/content/locales/pt-BR/components.mdx

@@ -476,10 +476,12 @@ ação para que UI e o agente compartilhem a mesma capacidade.
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -494,3 +496,11 @@ export default defineAction({
 Use `sendToAgentChat({ background: true, openSidebar: false })` quando
 o trabalho precisa de ferramentas, estado, auditabilidade, orientação do usuário ou várias etapas
 raciocínio.
+
+## O que vem a seguir {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — monte `<AgentSidebar>` e `<AgentPanel>` com um passo a passo voltado ao tutorial
+- [**Native Chat UI**](/docs/native-chat-ui) — o contrato de resultado de ações por trás de widgets de dados e renderizadores personalizados
+- [**Actions**](/docs/actions) — `defineAction()`, esquemas e a superfície de ações chamada por esses componentes
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — detalhes dos hooks de colaboração e componentes de presença
+- [**Sharing**](/docs/sharing) — configuração de `<ShareButton>` e `<ShareDialog>` para recursos com proprietário

package/docs/content/locales/pt-BR/creating-templates.mdx

@@ -44,7 +44,6 @@ Cada modelo segue o mesmo layout amplo:
 <FileTree
   id="doc-block-1mjrrpg"
   title="Layout do projeto de template"
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ As quatro áreas de cada modelo se conectam por meio de uma superfície de açã
 
 Defina tabelas de domínio com os auxiliares da estrutura Drizzle para que os esquemas permaneçam portáveis em SQLite, Postgres, D1, Turso, Supabase, Neon e outros back-ends suportados:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ As alterações de esquema devem ser aditivas. Adicione tabelas e colunas atrav
 
 Para leituras e gravações de aplicativos, use o construtor de consultas do Drizzle e os operadores portáteis do `drizzle-orm`. Não escreva o código do produto com SQL bruto quando Drizzle puder expressar a consulta e não importe de `drizzle-orm/sqlite-core` ou `drizzle-orm/pg-core` em modelos.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ Para navegação no aplicativo, prefira um comando `navigate` que inclua uma mes
 `path` quando o URL é conhecido. Não escreva também `__set_url__` para o mesmo movimento;
 essa chave é reservada para as ferramentas da estrutura URL e alterações de filtro somente URL.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";