@agent-native/core 0.76.5 → 0.76.6

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

@@ -0,0 +1,324 @@
+---
+title: "뇌"
+description: "인용된 기관 메모리, 검토 가능한 소스 수집 및 재사용 가능한 작업 공간 통합을 통해 지원되는 깔끔한 회사 채팅."
+---
+
+# 뇌
+
+브레인은 인용된 제도적 기억을 바탕으로 한 깔끔한 회사 채팅입니다. 사람들이 묻습니다
+평범한 영어 질문; 승인된 회사 지식을 바탕으로 한 두뇌 답변
+Slack 스레드, 회의, 기록, 문제 또는 웹훅 캡처로 다시 연결되는 링크
+답변을 뒷받침합니다.
+
+Brain은 승인된 Slack 채널, 클립 녹음, 그래놀라 팀 공간을 수집합니다
+노트, GitHub 문제/PR 및 일반 기록/웹훅 페이로드. 원시를 저장합니다
+영속적인 사실/의사결정/프로세스를 포착, 추출하고 민감하거나 중요한 정보를 전달
+회사에 알려지기 전 검토를 통해 자신감이 낮은 추억
+
+제품 표면은 의도적으로 단순하게 유지됩니다. **질문**이 기본 채팅입니다
+경험, **출처**, **검토** 및 **지식**은 관리/지원
+데이터 연결, 제안 승인, 인용 메모리 검사를 위한 표면
+
+```an-diagram title="From source to cited answer" summary="Brain ingests approved sources into raw captures, distills durable memory, gates it through review, and only then answers with citations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Sources</span><small class=\"diagram-muted\">Slack · Granola · GitHub · Clips · webhooks</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Raw captures<br><small class=\"diagram-muted\">deduped, redacted</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Distill<br><small class=\"diagram-muted\">facts · decisions · processes</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Review</span><small class=\"diagram-muted\">sensitive / low-confidence queue</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Knowledge</span><small class=\"diagram-muted\">approved, atomic</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Ask</span><small class=\"diagram-muted\">cited answer</small></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.diagram-flow .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-flow .diagram-arrow{font-size:20px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+```an-wireframe
+{
+  "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'>Ask company memory</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='Search'></span><strong style='flex:1'>Why did we choose usage pricing?</strong><button class='primary'>Ask</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Answer</strong><p style='margin:0'>The team chose usage pricing after pilots showed seat counts undercounted automation value.</p><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>Pricing RFC</span><span class='wf-pill'>Launch retro</span><span class='wf-pill'>Sales notes</span></div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><strong>Source timeline</strong><div class='wf-box'>May 3 · Decision captured</div><div class='wf-box'>May 8 · Customer evidence added</div><div class='wf-box'>May 12 · Legal note approved</div></div></div>"
+}
+```
+
+앱을 열면 **묻기**가 전면 중앙에 표시됩니다. 깔끔한 채팅이 검토되었습니다.
+회사 메모리. **출처**, **리뷰** 및 **지식**은
+데이터 연결, 제안 승인 및 인용 검사를 위한 관리 화면
+항목.
+
+## 선택 시기
+
+팀에서 "우리가 왜 만들었나요?"와 같은 질문에 상담원이 대답하기를 원할 때 Brain을 사용하세요.
+이 제품 결정은 무엇입니까?", "이 개발 중인 기능은 어떻게 작동합니까?" 또는 "무엇
+이 과정에서 변경되었나요?" 원본 대화, 회의로 돌아가는 링크
+또는 문제
+
+Brain과 Dispatch는 상호 보완적이지만 서로 다른 작업을 수행합니다.
+
+- **Brain은 회사 메모리를 소유합니다.** 소스를 수집하고 원시 캡처를 검토하며
+  영속적인 사실/결정/과정, 인용된 증거의 답변을 정리하고
+  승인된 지식을 상담원에게 공개합니다.
+- **Dispatch는 작업 공간 제어 영역을 소유합니다.** 메시징을 중앙 집중화합니다.
+  비밀, 반복 작업, 승인, A2A 조정 및 배포
+  작업 공간 전반의 리소스 승인
+
+다중 앱 작업 공간에서 Dispatch는 A2A를 통해 Brain으로 질문을 라우팅할 수 있으며
+Brain 공유 공급자 자격 증명을 부여할 수 있습니다. 두뇌는 여전히
+승인된 소스 수집, 검토, 검색 및 인용된 Company Brain 답변
+Brain은 읽기 전용, 인용 기반 검색을 공개 A2A 기능으로 노출합니다.
+Dispatch 및 형제 앱이 회사 메모리 질문을 할 수 있도록 — A2A 에이전트
+카드는 공개 검색 메타데이터이지만 검색은 여전히 Brain 내부에서 발생합니다.
+인증된 작업 표면.
+
+## 그것으로 무엇을 할 수 있나요
+
+- **인용된 질문을 물어보세요.** 질문은 제품의 주요 표면입니다: 깔끔한 채팅
+  소스 상태, 리뷰 횟수 및 제안을 포함하여 회사 메모리를 검토했습니다.
+  질문은 부차적으로 유지됩니다. 모든 답변은 Slack 스레드로 다시 연결됩니다.
+  이를 지원하는 회의, 이슈 또는 캡처.
+- **승인된 소스를 연결합니다.** 수동, 일반 웹훅, 클립, Slack를 구성합니다.
+  그래놀라 및 GitHub 소스. 소스는 기본적으로 조직 공유이므로 회사
+  메모리는 전체 작업 공간에 유용합니다.
+- **게시하기 전에 검토하세요.** 제안된 추억은 최고 수준의 검토 경로를 얻습니다.
+  검토자가 문구를 편집하고, 증거/소스 링크를 검사하고, 승인하거나
+  거부합니다. 신뢰도가 높고 민감하지 않은 항목은 즉시 게시할 수 있습니다.
+  회사 수준 또는 민감한 항목이 제안서로 대기열에 추가됩니다.
+- **인용된 지식을 검사합니다.** 지식 경로는 증류된 원자를 보여줍니다
+  종류, 주제, 개체, 신뢰도, 정확한 증거 인용 등이 포함된 항목
+  링크를 대체합니다.
+- **작업 공간 통합 재사용.** 브레인 소스는 공유 작업 공간을 재사용할 수 있음
+  공급자 토큰을 다시 입력하는 대신 연결 권한을 부여합니다. 소스 페이지
+  재사용 가능한 연결 허용 및 공급자 옆에 Brain 소스 레코드 표시
+  준비.
+- **승인된 메모리를 주변 컨텍스트로 미러링합니다.** 정식 승인 항목은
+  `context/company-brain/...` 아래의 작업 공간 리소스로 미러링하여 다른 것
+  앱은 이를 컨텍스트로 사용할 수 있습니다. 두 흐름 모두
+  리소스가 기록되거나 제거되었습니다.
+
+## 시작하기
+
+라이브 데모: [brain.agent-native.com](https://brain.agent-native.com).
+
+1. **데모를 사용해 보세요.** Ask를 열고 **데모 시작**을 선택하세요. 작은 두뇌 씨앗
+   제품 결정 코퍼스, 신뢰 검사를 실행하고 인용된 질문을 질문합니다.
+   추가하기 전에 답변, 인용, 리뷰 및 찾을 수 없는 동작을 볼 수 있습니다
+   실제 회사 데이터.
+2. **소스 하나를 추가하세요.** 단일 Slack 채널, Granola Team-space로 시작하세요
+   피드, GitHub 저장소, 클립 내보내기 또는 일반 성적표 웹훅. 유지
+   인용 및 리뷰 품질이 적절해 보일 때까지는 범위가 작습니다.
+3. **게시하기 전에 검토하세요.** 검토를 통해 증거를 검사하고 문구를 편집하세요.
+   내구력이 뛰어난 회사 메모리만 승인합니다.
+4. **출처에서 질문하세요.** 근거가 있어야 하는 질문에는 질문을 사용하세요.
+   원본 채팅 로그가 아닌 승인된 지식입니다.
+
+공개 데모의 경우 시드된 코퍼스는 제품 결정 회상을 보여줍니다.
+인용 링크, 대체 동작, 검토 게이팅, 수정, 개인 콘텐츠
+실제 작업 공간을 연결하지 않고 배제하고 찾을 수 없는 정직한 행동
+
+### 유용한 메시지
+
+- "연간 가격에 대해 우리는 무엇을 결정했으며, 이에 대한 논의는 어디에서 이루어졌습니까?"
+- "가장 최근의 온보딩 프로세스 변경 사항을 찾아 출처를 인용하세요."
+- "GitHub 논의가 출시 계획에 미치는 영향을 요약해 보세요."
+- "보류 중인 메모리 제안을 검토하고 게시하기에는 너무 모호한 제안을 표시하세요."
+- "어떤 소스가 오래되었거나 동기화에 실패하나요?"
+
+## 개발자용
+
+이 문서의 나머지 부분은 Brain 템플릿을 포크하거나 확장하는 모든 사람을 위한 것입니다.
+
+### 빠른 시작
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+앱을 열고 **데모 시작**을 선택하면 실제 작업 공간에 연결하지 않고도 인용 메모리를 볼 수 있습니다.
+
+### 데이터 모델
+
+Brain은 의도적으로 SQL 텍스트 검색 및 에이전트 쿼리 확장을 사용합니다.
+벡터 데이터베이스 요구 사항이 없으므로 템플릿은 SQLite 전체에서 이식성을 유지합니다.
+Postgres, Neon, D1, Turso 및 유사한 호스트. 애플리케이션 상태는
+현재 경로, 필터 및 선택된 ID를 통해 상담원은 항상 현재 정보를 알 수 있습니다.
+탐색 및 선택.
+
+Brain의 스키마는 `templates/brain/server/db/schema.ts`에 있습니다. 테이블 8개:
+
+| 테이블                   | 무엇을 담고 있는지                                                                                                          |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
+| `brain_sources`          | 커넥터 구성 — 공급자, 허용 목록에 있는 채널/저장소, 동기화 커서, 상태 검토, `ingest_token_hash`, `status`, `last_synced_at` |
+| `brain_source_shares`    | 소스별 공유 부여(뷰어/편집자/관리자)                                                                                        |
+| `brain_raw_captures`     | `external_id` 중복 제거 키, `content_hash`, 종류 및 증류 상태를 사용한 스크립트, 채널 내보내기, 메모 및 웹훅 가져오기       |
+| `brain_knowledge`        | 정제된 원자 항목 — 종류(결정/사실/과정/...), 주제, 엔터티, 증거 인용문, 신뢰도, `publish_tier`, 대체 링크                   |
+| `brain_knowledge_shares` | 지식별 공유 부여                                                                                                            |
+| `brain_proposals`        | 보류 중인 검토 항목 — 증거 및 검토자 메모가 포함된 생성/업데이트/보관 제안                                                  |
+| `brain_proposal_shares`  | 제안별 지분 부여                                                                                                            |
+| `brain_sync_runs`        | 동기화 감사 로그 — 공급자, 상태, 통계 JSON, 오류, 시작/종료 타임스탬프                                                      |
+| `brain_ingest_queue`     | 백그라운드 증류 큐 — 작업, 상태, 우선순위, 재시도 횟수, `run_after`                                                         |
+
+```an-schema title="Brain data model" summary="Connectors produce raw captures; distillation turns captures into reviewable knowledge; proposals gate sensitive entries. Sync runs and the ingest queue track background work."
+{
+  "entities": [
+    { "id": "sources", "name": "brain_sources", "note": "Connector config", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "provider", "type": "text", "note": "slack / granola / github / clips / webhook" },
+      { "name": "ingest_token_hash", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "last_synced_at", "type": "timestamp", "nullable": true }
+    ] },
+    { "id": "source_shares", "name": "brain_source_shares", "note": "viewer / editor / admin", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" }
+    ] },
+    { "id": "captures", "name": "brain_raw_captures", "note": "Ingested raw payloads", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "external_id", "type": "text", "note": "dedupe key" },
+      { "name": "content_hash", "type": "text" },
+      { "name": "kind", "type": "text" }
+    ] },
+    { "id": "knowledge", "name": "brain_knowledge", "note": "Distilled atomic entries", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "kind", "type": "text", "note": "decision / fact / process" },
+      { "name": "topic", "type": "text" },
+      { "name": "entities", "type": "json" },
+      { "name": "confidence", "type": "real" },
+      { "name": "publish_tier", "type": "text" }
+    ] },
+    { "id": "knowledge_shares", "name": "brain_knowledge_shares", "fields": [
+      { "name": "knowledge_id", "type": "id", "fk": "brain_knowledge.id" }
+    ] },
+    { "id": "proposals", "name": "brain_proposals", "note": "Pending review items", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "op", "type": "text", "note": "create / update / archive" }
+    ] },
+    { "id": "proposal_shares", "name": "brain_proposal_shares", "fields": [
+      { "name": "proposal_id", "type": "id", "fk": "brain_proposals.id" }
+    ] },
+    { "id": "sync_runs", "name": "brain_sync_runs", "note": "Sync audit log", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "status", "type": "text" },
+      { "name": "stats", "type": "json" }
+    ] },
+    { "id": "ingest_queue", "name": "brain_ingest_queue", "note": "Background distillation queue", "fields": [
+      { "name": "operation", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "priority", "type": "int" },
+      { "name": "run_after", "type": "timestamp", "nullable": true }
+    ] }
+  ],
+  "relations": [
+    { "from": "sources", "to": "captures", "kind": "1-n", "label": "ingested into" },
+    { "from": "knowledge", "to": "captures", "kind": "n-n", "label": "evidence" },
+    { "from": "knowledge", "to": "proposals", "kind": "1-n", "label": "gated by" },
+    { "from": "sources", "to": "sync_runs", "kind": "1-n", "label": "audited by" }
+  ]
+}
+```
+
+### 키 actions
+
+지역별 그룹화(`templates/brain/actions/`):
+
+- **소스 관리** — `create-source`, `update-source`, `delete-source`, `get-source`, `list-sources`, `sync-source`, `sync-due-sources`, `run-slack-pilot`, `test-slack-connection`
+- **캡처 수집** — `import-capture`, `import-transcript`, `list-captures`, `get-capture`, `mark-capture-distilled`, `resanitize-captures`
+- **증류** — `enqueue-distillation`, `enqueue-captures-distillation`, `claim-distillation`, `retry-distillation`, `list-distillation-queue`
+- **지식 및 검토** — `write-knowledge`, `get-knowledge`, `list-knowledge`, `set-knowledge-canonical`, `preview-canonical-resource`, `list-proposals`, `review-proposal`, `approve-proposal`, `reject-proposal`, `update-proposal`
+- **검색 및 조회** — `ask-brain`, `search-knowledge`, `search-everything`
+- **설정** — `get-brain-settings`, `update-brain-settings`, `set-settings`, `get-settings`
+- **평가 및 데모** — `seed-demo-data`, `run-demo-eval`, `run-retrieval-eval`
+- **컨텍스트 및 탐색** — `view-screen`, `navigate`
+- **제공자 API** — `provider-api-catalog`, `provider-api-docs`, `provider-api-request`
+
+### 소스 연결
+
+Brain은 먼저 부여된 작업 공간 연결에서 공급자 자격 증명을 확인합니다.
+그런 다음 이전 버전과 호환되는 Brain-local 또는 등록된 저장소 자격 증명에서
+브레인 소스 자격 증명은 배포 수준 환경 변수로 대체되지 않습니다.
+공유 공급자가 이미 존재하는 경우 복사하는 대신 Brain 액세스 권한을 부여하세요.
+동일한 비밀을 뇌 관련 설정에 적용합니다.
+
+**Slack.** 특정 채널 ID로 범위가 지정된 소스를 만듭니다. 커넥터
+구성된 각 대화를 확인하고 DM 및 MPIM을 거부하며 커서를 저장합니다
+상태이므로 각 동기화는 마지막 동기화가 중지된 위치에서 다시 시작됩니다. 안전한 출시 흐름
+각 Slack 소스 카드를 사용하면 자격 증명 및 허용 목록을 **테스트** 없이
+기록 읽기, 작은 캡이 있는 **안전한 파일럿** 샘플 실행, **캡처 검토**,
+질문이 가능해지기 전에 **검토 대기열**에서 승인하세요. 부여
+소스에 필요한 범위만 봇(자격 증명 검증, 허용 목록
+확인, 허용 목록에 있는 채널 기록, 영구 영구 링크).
+
+**Granola.** 폴링 창과 페이지 크기를 사용하여 소스를 만듭니다. 그래놀라
+Enterprise API 키는 개인 메모나 폴더가 아닌 팀 공간 메모를 노출합니다. 뇌
+메모 요약, 기록, 참석자, 캘린더 메타데이터 및 소스를 저장합니다
+증류 전 원시 캡처로서의 URL.
+
+**GitHub.** 승인된 리포지토리로 범위가 지정된 소스를 생성합니다. 커넥터
+안정적인 소스 URL를 사용하여 제한된 문제와 풀 요청 컨텍스트를 가져옵니다
+Slack 또는 회의 상황과 같이 증류됩니다. 이것은 뇌 컨텍스트 수집이지
+분석 스타일 GitHub 보고를 대체합니다.
+
+**클립 및 일반 webhooks.** Brain은 클립 및 일반 webhooks에 대해 서명된 웹훅을 노출합니다.
+`/api/_agent-native/brain/ingest`에서 일반 사본/캡처 가져오기. 만들기
+`sourceKey`가 있는 소스를 사용하여 베어러 토큰을 받은 후
+`RawCapturePayload`와 `Authorization: Bearer <ingestToken>`. 일반 소스
+통화 기록, 고객 조사, 가져오기에 동일한 페이로드 형태 사용
+제한된 캡처를 생성할 수 있는 노트 또는 기타 소스
+
+```an-api title="Signed ingest webhook" summary="Clips and generic transcript/capture imports post a RawCapturePayload with a per-source bearer token."
+{
+  "method": "POST",
+  "path": "/api/_agent-native/brain/ingest",
+  "summary": "Import a raw capture from Clips or a generic source",
+  "auth": "Bearer <ingestToken> issued per source via its sourceKey",
+  "request": {
+    "contentType": "application/json",
+    "example": "RawCapturePayload — bounded transcript / capture body"
+  },
+  "responses": [
+    { "status": "200", "description": "Capture accepted and queued for distillation" },
+    { "status": "401", "description": "Missing or invalid ingest bearer token" }
+  ]
+}
+```
+
+Slack, Granola 및 GitHub 소스는 다음을 사용하여 배경 `autoSync`를 선택할 수 있습니다.
+리뷰 품질이 입증되면 설문조사 주기
+
+### 개인정보 보호 및 게이팅
+
+두뇌는 개인 감시가 아닌 회사 기억을 위해 설계되었습니다:
+
+- Slack 동기화는 명시적으로 구성된 채널만 읽고 DM/MPIM을 거부합니다.
+- Granola 동기화는 비공개가 아닌 Granola의 API에 의해 노출된 팀 공간 메모를 읽습니다.
+  메모 또는 개인 폴더.
+- 원시 캡처는 기본적으로 목록/검색 표면에서 수정됩니다. 리뷰어
+  및 증류 흐름은 필요한 경우에만 미리보기 또는 원시 콘텐츠를 요청합니다.
+- 정화된 지식이 지속되기 전에 소스 구성을 검토해야 할 수 있습니다
+  회사 메모리
+- 설정은 회사 계층 지식에 필요한지 여부에 따라 기본 게시 계층을 제어합니다
+  승인, 인용 요구 사항, 이메일 수정 및 커넥터 오류
+  알림.
+
+### 맞춤 설정
+
+Brain은 에이전트 기본 4개 영역 계약을 따릅니다. 편집을 통해 동작을 변경합니다.
+일치하는 영역을 선택하면 상담원이 다음과 같은 편집 작업을 수행할 수 있습니다.
+
+- `templates/brain/app/routes/` — UI 표면: 질문, 검색, 지식,
+  검토, 소스, 설정 및 팀 경로
+- `templates/brain/actions/` — 모든 에이전트 호출 가능 작업(가져오기, 소스
+  관리, 파일럿 보고서, 증류, 제안서 검토, 인용 검색
+  탐색/컨텍스트). 새로운 파일을 노출하려면 `defineAction`로 새 파일을 추가하세요.
+  능력.
+- `templates/brain/.agents/skills/` — 증류를 위한 뇌별 지침
+  및 검색. 상담원에게 새로운 워크플로를 가르칠 때 기술을 업데이트하거나 추가하세요.
+- `templates/brain/AGENTS.md` — 최상위 에이전트 가이드. 전공 추가 시 업데이트
+  기능.
+- `templates/brain/server/db/schema.ts` — 데이터 모델. 추가 마이그레이션에만 해당;
+  경로, 필터 및 선택된 ID는 에이전트의 `application_state`에 미러링됩니다.
+  컨텍스트.
+
+에이전트에게 변경을 요청하세요. 에이전트는 자체 소스를 편집할 수 있습니다. 참조
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## 다음 단계
+
+- [**Dispatch**](/docs/dispatch) — 작업 공간 제어 평면
+- [**Dispatch template**](/docs/template-dispatch) — 비계 조정 앱
+- [**Workspace**](/docs/workspace) — 앱 전체에서 공유 리소스
+- [**A2A Protocol**](/docs/a2a-protocol) — 교차 앱 위임

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

@@ -0,0 +1,194 @@
+---
+title: "캘린더"
+description: "Google Calendar 동기화 및 Calendly 스타일 예약 링크가 포함된 에이전트 기반 달력입니다. 일반 영어를 통해 일정을 예약하고, 슬롯을 찾고, 이용 가능 여부를 관리하세요."
+---
+
+# 캘린더
+
+에이전트 기반 캘린더 앱. Google Calendar를 연결하면 상담원이 일정을 읽고, 무료 슬롯을 찾고, 이벤트를 만들고, Calendly 스타일 예약 링크를 관리할 수 있습니다. 이 모든 작업이 일반 영어로 제공됩니다. Google Calendar + Calendly 콤보를 귀하가 소유한 하나의 앱으로 대체합니다.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1.4px solid var(--wf-line)'><button>Week</button><button>Today</button><button>‹</button><button>›</button><div style='flex:1'></div><strong>May 3-9, 2026</strong><div style='flex:1'></div><button class='primary'>New Event</button></div><div style='display:grid;grid-template-columns:56px repeat(7,minmax(0,1fr));grid-template-rows:36px repeat(5,72px);gap:7px;padding:14px;flex:1'><div></div><strong>Sun 3</strong><strong>Mon 4</strong><strong>Tue 5</strong><strong>Wed 6</strong><strong>Thu 7</strong><strong>Fri 8</strong><strong>Sat 9</strong><small class='wf-muted'>7 AM</small><div class='wf-box' style='opacity:.45'></div><div></div><div></div><div></div><div></div><div></div><div></div><small class='wf-muted'>9 AM</small><div class='wf-box'>All-hands</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div></div><div class='wf-box'>Planning</div><div></div><small class='wf-muted'>11 AM</small><div class='wf-box'>Design review</div><div></div><div class='wf-box'>Design crit</div><div class='wf-box'>Roadmap</div><div class='wf-box'>Friday demo</div><div></div><div></div><small class='wf-muted'>1 PM</small><div></div><div class='wf-box'>1:1</div><div class='wf-box'>Focus block</div><div></div><div></div><div class='wf-box'>All-hands</div><div></div><small class='wf-muted'>3 PM</small><div></div><div></div><div></div><div class='wf-box'>Skip-level</div><div></div><div></div><div></div></div></div>"
+}
+```
+
+앱을 열면 활성 캘린더 보기가 기본 화면입니다. 상담원은 귀하가 보고 있는 요일, 주 또는 이벤트를 여전히 알고 있으므로 모든 내용을 철자하지 않고도 "오늘 Alex와 30분 통화 예약"이라고 말할 수 있습니다.
+
+```an-diagram title="How a scheduling request flows" summary="Whether you click in the calendar or ask the agent, the same actions read live from Google Calendar and write back to the same view."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You click<br><small class=\"diagram-muted\">drag, toolbar, shortcuts</small></div><div class=\"diagram-node\">You ask the agent<br><small class=\"diagram-muted\">\"find a 1-hour slot next week\"</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\">list-events · check-availability · create-event</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Google Calendar<br><small class=\"diagram-muted\">live, multi-account</small></div><div class=\"diagram-box\">SQL<br><small class=\"diagram-muted\">bookings · availability</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">Calendar view updates live</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 .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## 그것으로 무엇을 할 수 있나요
+
+- **실제 Google Calendar**를 일별, 주별 또는 월별 보기로 여러 계정을 오버레이하여 확인하세요.
+- **ICS 피드를 구독하세요**(HR 휴가, 회의 일정, 팀 일정) — 읽기 전용, 동일한 보기에 혼합되어 있습니다.
+- **시간대 지원을 통해 주간 가용성 설정** - 상담원이 무료 슬롯을 찾을 때 이를 사용합니다.
+- **`/book/{slug}`에서 "15분 소개" 또는 "30분 데모"와 같은 내용을 위한 공개 예약 링크**를 생성하세요. 기간, 사용자 정의 필드 및 사용할 회의 도구를 구성하세요.
+- **상담원에게 일정과 관련된 사항을 물어보세요**: "목요일 오후에 시간이 있나요?" "다음 주에 1시간짜리 시간을 찾아 '알렉스와 함께 계획하기'를 올려보세요." "데모 예약 링크를 일시중지합니다."
+- **예약 링크**를 팀원과 공유하여 팀원들도 관리할 수 있도록 하세요.
+
+## 시작하기
+
+라이브 데모: [calendar.agent-native.com](https://calendar.agent-native.com).
+
+처음 앱을 열 때:
+
+1. **설정**을 클릭하세요.
+2. **Google Calendar 연결**을 클릭하고 승인하세요.
+3. (선택사항) 개인 + 업무를 오버레이하려면 더 많은 Google 계정을 연결하세요.
+4. 기본 보기를 엽니다. 실제 달력이 로드됩니다.
+
+첫 번째 예약 링크를 생성하려면:
+
+1. 사이드바에서 **예약 링크**를 클릭하세요.
+2. **새 예약 링크**를 클릭하고 제목과 기간을 설정하세요.
+3. 공개 URL를 공유하세요. 방문자는 사용 가능한 슬롯 중에서 선택합니다.
+
+또는 상담원에게 "이름 필드가 포함된 15분 소개 예약 링크를 생성하세요."라고 물어보세요.
+
+### 유용한 메시지
+
+- "오늘 내 달력에 무슨 일이 있지?"
+- "목요일 오후에 30분간 시간이 있나요?"
+- "다음 주에 1시간짜리 시간을 찾아 '알렉스와 함께 계획하기'를 설정하세요."
+- "이 이벤트 일정을 금요일 오후 2시로 변경하세요." (이벤트 선택 시)
+- "일 보기로 전환하고 다음 월요일로 이동합니다."
+- "메모 필드를 사용하여 15분에 '15분 소개'라는 예약 링크를 생성하세요."
+- "'30분 데모' 예약 링크를 일시중지합니다."
+- "금요일 오후를 차단합니다."
+- "이번 달 '출시'에 관해 어떤 회의가 있나요?"
+
+에이전트는 Google Calendar에 실시간으로 일정 질문을 쿼리하며 절대 추측하지 않습니다.
+
+## 개발자용
+
+이 문서의 나머지 부분은 캘린더 템플릿을 포크하거나 확장하는 모든 사람을 위한 것입니다.
+
+### 빠른 시작
+
+캘린더 템플릿을 사용하여 새 작업 공간을 만듭니다.
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+`http://localhost:8082`(기본 캘린더 개발 포트)를 엽니다.
+
+개발에서 Google Calendar를 연결하려면 설정 보기를 열고 [Google Cloud Console](https://console.cloud.google.com/)에서 `GOOGLE_CLIENT_ID` 및 `GOOGLE_CLIENT_SECRET`를 붙여넣은 다음 "Google Calendar 연결"을 클릭하세요. OAuth 리디렉션 URI는 dev에서 `http://localhost:8082/_agent-native/google/callback`입니다. 토큰은 `oauth_tokens` SQL 테이블에 저장되며 자동으로 새로 고쳐집니다.
+
+### 주요 기능
+
+**실시간 캘린더 보기.** 연결된 Google 계정에서 직접 일, 주 및 월 보기를 읽을 수 있으며 선택적인 읽기 전용 ICS 피드가 동일한 일정에 계층화되어 있습니다.
+
+**가용성 및 무료 슬롯 검색.** 주간 가용성 규칙, 시간대 지원 및 기존 이벤트는 모두 UI 및 상담원이 사용하는 동일한 가용성 작업을 제공합니다.
+
+**예약 링크.** 공개 `/book/{slug}` 페이지는 이름, 이메일, 사용자 정의 필드, 회의 기본 설정 및 취소/일정 변경 토큰을 수집합니다.
+
+**공유 가능한 관리.** 예약 링크는 기본적으로 비공개이지만 actions 공유 프레임워크를 통해 팀원과 공유할 수 있습니다.
+
+**인라인 이벤트 미리보기.** 상담원은 제목, 시간, 위치, 참석자 및 뒤로 이동 버튼이 포함된 간단한 이벤트 카드를 채팅에 삽입할 수 있습니다.
+
+### 에이전트와 협력하기
+
+에이전트는 당신이 보고 있는 것을 봅니다. 현재 달력 보기, 선택한 날짜 및 선택한 이벤트가 모든 메시지에 `current-screen` 블록으로 포함되므로 "이 이벤트" 또는 "오늘"이라고 말하면 올바르게 해결됩니다.
+
+내부적으로 에이전트는 `list-events`, `check-availability`, `create-event`, `navigate` 및 `update-availability`와 같이 actions를 호출합니다. 이벤트는 Google Calendar에 있기 때문에 에이전트는 추측하는 대신 항상 API를 쿼리합니다. 먼저 스크립트를 실행하지 않으면 빈 결과를 반환하지 않습니다.
+
+### 데이터 모델
+
+`templates/calendar/server/db/schema.ts`에 정의되어 있습니다. 이벤트가 아닌 데이터만 로컬에 저장됩니다:
+
+- `bookings` — 공개 예약 페이지에서 약속이 확인되었습니다. 이름, 이메일, 시작, 종료, 슬러그, 선택적 메모, 사용자 정의 필드 응답, 회의 링크, 공개 관리용 `cancelToken` URL 및 `confirmed` 또는 `cancelled` 상태를 저장합니다.
+- `booking_links` — Calendly 스타일 링크 정의. 슬러그, 제목, 설명, 기본 `duration`, 선택적 `durations` 목록, `customFields`, `conferencing`, `color` 및 `isActive` 플래그. 공유 시스템이 적용되도록 프레임워크의 `ownableColumns`를 사용합니다.
+- `booking_slug_redirects` — 링크 이름이 변경될 때 이전 슬러그를 기억하여 기존 공개 URL가 계속 작동하도록 합니다.
+- `booking_link_shares` — 예약 링크에 대한 공유 부여.
+
+```an-schema title="Calendar data model" summary="Only non-event data is stored locally — events live in Google Calendar. Booking links use ownableColumns so the sharing system applies."
+{
+  "entities": [
+    {
+      "id": "booking_links",
+      "name": "booking_links",
+      "note": "Calendly-style link definitions (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "note": "public page at /book/{slug}" },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "duration", "type": "int", "note": "primary duration in minutes" },
+        { "name": "durations", "type": "json", "nullable": true, "note": "alternative durations" },
+        { "name": "customFields", "type": "json", "nullable": true },
+        { "name": "conferencing", "type": "string", "note": "Google Meet / Zoom / custom" },
+        { "name": "color", "type": "string", "nullable": true },
+        { "name": "isActive", "type": "bool", "note": "pause without deleting" }
+      ]
+    },
+    {
+      "id": "bookings",
+      "name": "bookings",
+      "note": "Confirmed appointments from public booking pages",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "fk": "booking_links.slug" },
+        { "name": "name", "type": "string" },
+        { "name": "email", "type": "string" },
+        { "name": "start", "type": "datetime" },
+        { "name": "end", "type": "datetime" },
+        { "name": "notes", "type": "string", "nullable": true },
+        { "name": "customFields", "type": "json", "nullable": true, "note": "custom field responses" },
+        { "name": "meetingLink", "type": "string", "nullable": true },
+        { "name": "cancelToken", "type": "string", "note": "powers /booking/manage/{token}" },
+        { "name": "status", "type": "enum", "note": "confirmed | cancelled" }
+      ]
+    },
+    {
+      "id": "booking_slug_redirects",
+      "name": "booking_slug_redirects",
+      "note": "Keeps old public URLs working after a link is renamed",
+      "fields": [
+        { "name": "oldSlug", "type": "string", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" }
+      ]
+    },
+    {
+      "id": "booking_link_shares",
+      "name": "booking_link_shares",
+      "note": "Share grants for booking links",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "booking_links", "to": "bookings", "kind": "1-n", "label": "has bookings" },
+    { "from": "booking_links", "to": "booking_slug_redirects", "kind": "1-n", "label": "has old slugs" },
+    { "from": "booking_links", "to": "booking_link_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+가용성 규칙 및 사용자별 구성은 `calendar-availability`로 입력되는 설정 테이블에 있습니다. Google OAuth 토큰은 프레임워크 `oauth_tokens` 테이블에 있습니다. 임시 UI 상태(현재 보기, 날짜, 선택한 이벤트)는 `navigation` 키 아래 `application_state`에 있습니다.
+
+### 사용자 정의
+
+앱의 모든 부분은 편집 가능한 소스입니다. 여기에서 시작하세요:
+
+- `templates/calendar/actions/` — 모든 에이전트 호출 가능 작업. 에이전트와 프런트엔드 모두에 새로운 기능을 노출하려면 `defineAction`가 포함된 새 파일을 추가하세요. 주요 파일: `check-availability.ts`, `create-event.ts`, `list-events.ts`, `create-booking-link.ts`, `update-availability.ts`, `add-external-calendar.ts`, `navigate.ts`, `view-screen.ts`.
+- `templates/calendar/app/routes/` — UI. `_app._index.tsx`는 달력이고, `_app.availability.tsx`는 일정 편집자이고, `_app.booking-links._index.tsx` 및 `_app.booking-links.$id.tsx`는 예약 링크를 관리하고, `_app.bookings.tsx`는 예약을 나열하고, `_app.settings.tsx`는 설정이고, `book.$slug.tsx`와 `meet.$username.$slug.tsx`는 공개 예약 페이지입니다.
+- `templates/calendar/server/db/schema.ts` — Drizzle를 사용하여 열이나 테이블을 추가합니다. 템플릿이 SQLite, Postgres, Turso, D1 및 Neon에서 실행되도록 코드 방언에 구애받지 않도록 유지하세요.
+- `templates/calendar/AGENTS.md` — 에이전트 지침. 상담원에게 새로운 기능이나 규칙을 가르칠 때 이를 업데이트하세요.
+- `templates/calendar/.agents/skills/` — 에이전트가 따르는 세부 패턴입니다. 관련 skills: `event-management`, `availability-booking`, `real-time-sync`, `storing-data`, `delegate-to-agent`, `frontend-design`.
+- `templates/calendar/shared/api.ts` — 서버와 클라이언트 모두에서 사용되는 공유 TypeScript 유형(`AvailabilityConfig`, `BookingLink`, `ExternalCalendar` 등).
+
+기능을 추가하는 경우 UI, 작업, 스킬 또는 AGENTS.md 항목과 에이전트가 확인해야 하는 모든 애플리케이션 상태 등 네 가지 영역을 모두 업데이트해야 합니다. 이것이 에이전트와 UI를 동등하게 유지하는 것입니다.