# UMMAYA Documentation

> Machine-readable index for UMMAYA docs. Generated from docs-site content.

## Pages

- [Agentic RAG And Query Engine](/_llm/pages/ch/architecture/agentic-rag-query-engine.md) — 检索、推理、工具调用、权限和 stop reason 如何在一个 UMMAYA turn 中协作。
- [Harness Migration](/_llm/pages/ch/architecture/harness-migration.md) — 为什么 UMMAYA 要把 Claude Code 的 harness 迁移到国家基础设施 AX。
- [Main Primitives](/_llm/pages/ch/architecture/main-primitives.md) — 为什么 UMMAYA 只把小型 action vocabulary 暴露给模型。
- [Adapter Authoring](/_llm/pages/ch/build/adapter-authoring.md) — 贡献者如何把一个公共服务 channel 包装成带 evidence 的 UMMAYA adapter。
- [面向文档的 LLMOps](/_llm/pages/ch/build/llmops.md) — UMMAYA 如何保持 human docs、LLM-readable docs、generated metadata 和 deployment outputs 对齐。
- [Adapter Matrix](/_llm/pages/ch/coverage/adapter-matrix.md) — UMMAYA coverage、adapter status 和 primitive support 背后的 evidence ledger。
- [当前覆盖范围](/_llm/pages/ch/coverage/current-coverage.md) — 按用户任务、状态标签和证据来源说明 UMMAYA 当前 capability。
- [Domain Roadmap](/_llm/pages/ch/coverage/domain-roadmap.md) — UMMAYA 如何把 domain 从 target-state scenario 推进到 mock，再到 live capability。
- [Scenario Matrix](/_llm/pages/ch/coverage/scenario-matrix.md) — 用于判断 UMMAYA 是否覆盖真实公共服务需求的 target-state citizen scenarios。
- [UMMAYA 文档](/_llm/pages/ch.md) — 用于使用、评估和扩展 UMMAYA 这个韩国 national-infrastructure AX harness 的文档。
- [LLM-Readable Docs](/_llm/pages/ch/reference/llm-readable-docs.md) — 让 agent 不用 scraping site 就能检查 UMMAYA 的 generated documentation surfaces。
- [第一次成功会话](/_llm/pages/ch/start/first-successful-session.md) — 第一次运行应当显示什么，以及它绝不能声称什么。
- [快速开始](/_llm/pages/ch/start/quickstart.md) — 安装打包后的 UMMAYA CLI，启动会话，并运行一个安全的公共服务 prompt。
- [你提问之后会发生什么](/_llm/pages/ch/start/what-happens-after-you-ask.md) — 以用户语言解释 query routing、tool call、permission gate 和 final answer。
- [UMMAYA 今天能做什么](/_llm/pages/ch/start/what-ummaya-can-do-today.md) — 按用户任务、状态标签和证据边界解释当前 capability。
- [你可以问什么](/_llm/pages/ch/start/what-you-can-ask.md) — 按公共服务结果来 prompt UMMAYA，而不是按 agency API 或内部 adapter 名称。
- [为什么是 UMMAYA](/_llm/pages/ch/start/why-ummaya.md) — 为什么 UMMAYA 作为 national-infrastructure AX harness 存在。
- [数据、凭证与本地会话](/_llm/pages/ch/trust/data-credentials-local-sessions.md) — UMMAYA 本地保存什么、credential 意味着什么，以及 session evidence 如何保持可检查。
- [Live、Mock 与 Handoff](/_llm/pages/ch/trust/live-mock-handoff.md) — 这些状态标签让 UMMAYA 诚实说明自己实际能做什么。
- [官方 Handoff](/_llm/pages/ch/trust/official-handoff.md) — 当 UMMAYA 到达只有 official service 能完成的边界时应发生什么。
- [权限与同意](/_llm/pages/ch/trust/permissions-and-consent.md) — UMMAYA 如何区分 public lookup 和 protected public-service actions。
- [UMMAYA 不会做什么](/_llm/pages/ch/trust/what-ummaya-will-not-do.md) — 这些边界防止 UMMAYA 听起来比它实际更 official。
- [应急、医疗、天气与安全](/_llm/pages/ch/use/emergency-healthcare-weather-safety.md) — 用 UMMAYA 查找公共安全信息，同时把紧急和受保护决定留在 official channels。
- [身份、证书与 MyData](/_llm/pages/ch/use/identity-certificates-mydata.md) — 理解今天通常需要 Mock 或 official Handoff 的 identity-bound workflows。
- [搬家、住房与地方记录](/_llm/pages/ch/use/moving-housing-local-records.md) — 准备跨机构搬家和住房 workflow，而不假装已经修改 official records。
- [Sessions、Receipts 与 History](/_llm/pages/ch/use/sessions-receipts-history.md) — 理解 UMMAYA 如何通过 session、receipt 和 context compression 让长 workflow 可检查。
- [税务、罚款、支付与公用事业账单](/_llm/pages/ch/use/tax-fines-payments-utilities.md) — 准备高后果 payment 和 filing workflows，而不把 mock path 误写成 official completion。
- [故障排查](/_llm/pages/ch/use/troubleshooting.md) — 先解决用户可见问题，再进入 maintainer debugging。
- [福利与家庭支持](/_llm/pages/ch/use/welfare-household-support.md) — 用 UMMAYA 理解 welfare guidance、preparation、eligibility boundaries 和 official application handoff。
- [Agentic RAG And Query Engine](/_llm/pages/en/architecture/agentic-rag-query-engine.md) — How retrieval, reasoning, tool calling, permission gates, and stop reasons work in one UMMAYA turn.
- [Harness Migration](/_llm/pages/en/architecture/harness-migration.md) — Why UMMAYA migrates Claude Code harness mechanics from developer work to national-infrastructure work.
- [Main Primitives](/_llm/pages/en/architecture/main-primitives.md) — The small verb surface UMMAYA exposes to the model while adapters carry domain detail.
- [Adapter Authoring](/_llm/pages/en/build/adapter-authoring.md) — How contributors should wrap one public-service channel as one evidence-bearing UMMAYA adapter.
- [LLMOps For Docs](/_llm/pages/en/build/llmops.md) — How UMMAYA keeps human docs, LLM-readable docs, generated metadata, and deployment outputs aligned.
- [Adapter Matrix](/_llm/pages/en/coverage/adapter-matrix.md) — The evidence ledger behind UMMAYA coverage, adapter status, and primitive support.
- [Current Coverage](/_llm/pages/en/coverage/current-coverage.md) — Current UMMAYA capability by user task, status label, and evidence source.
- [Domain Roadmap](/_llm/pages/en/coverage/domain-roadmap.md) — How UMMAYA moves domains from target-state scenario to mock to live capability.
- [Scenario Matrix](/_llm/pages/en/coverage/scenario-matrix.md) — Target-state citizen scenarios used to judge whether UMMAYA covers real public-service demand.
- [UMMAYA Docs](/_llm/pages/en.md) — Documentation for using, evaluating, and extending UMMAYA as a Korean national-infrastructure AX harness.
- [LLM-Readable Docs](/_llm/pages/en/reference/llm-readable-docs.md) — The generated documentation surfaces that let agents inspect UMMAYA without scraping the site.
- [First Successful Session](/_llm/pages/en/start/first-successful-session.md) — What a successful first run should show, and what it must not claim.
- [Quickstart](/_llm/pages/en/start/quickstart.md) — Install the packaged UMMAYA CLI, start a session, and run one safe public-service prompt.
- [What Happens After You Ask](/_llm/pages/en/start/what-happens-after-you-ask.md) — A user-level view of query routing, tool calls, permission gates, and final answers.
- [What UMMAYA Can Do Today](/_llm/pages/en/start/what-ummaya-can-do-today.md) — Current capability explained by user task, status label, and evidence boundary.
- [What You Can Ask](/_llm/pages/en/start/what-you-can-ask.md) — Prompt UMMAYA by public-service outcome, not by agency API or internal adapter name.
- [Why UMMAYA](/_llm/pages/en/start/why-ummaya.md) — Why UMMAYA exists as a national-infrastructure AX harness.
- [Data, Credentials, And Local Sessions](/_llm/pages/en/trust/data-credentials-local-sessions.md) — What UMMAYA stores locally, what credentials mean, and how session evidence should remain inspectable.
- [Live, Mock, And Handoff](/_llm/pages/en/trust/live-mock-handoff.md) — The status labels that keep UMMAYA honest about what it can actually do.
- [Official Handoff](/_llm/pages/en/trust/official-handoff.md) — What should happen when UMMAYA reaches a boundary that only an official service can complete.
- [Permissions And Consent](/_llm/pages/en/trust/permissions-and-consent.md) — How UMMAYA separates public lookup from protected public-service actions.
- [What UMMAYA Will Not Do](/_llm/pages/en/trust/what-ummaya-will-not-do.md) — The boundaries that prevent UMMAYA from sounding more official than it is.
- [Emergency, Healthcare, Weather, And Safety](/_llm/pages/en/use/emergency-healthcare-weather-safety.md) — Use UMMAYA for public safety information while keeping urgent and protected decisions on official channels.
- [Identity, Certificates, And MyData](/_llm/pages/en/use/identity-certificates-mydata.md) — Understand identity-bound workflows that usually require Mock or official Handoff today.
- [Moving, Housing, And Local Records](/_llm/pages/en/use/moving-housing-local-records.md) — Prepare multi-agency move and housing workflows without pretending to change official records.
- [Sessions, Receipts, And History](/_llm/pages/en/use/sessions-receipts-history.md) — Understand how UMMAYA keeps long workflows inspectable across sessions, receipts, and context compression.
- [Tax, Fines, Payments, And Utility Bills](/_llm/pages/en/use/tax-fines-payments-utilities.md) — Prepare consequential payment and filing workflows without confusing mock paths with official completion.
- [Troubleshooting](/_llm/pages/en/use/troubleshooting.md) — Fix common user-facing problems before moving into maintainer debugging.
- [Welfare And Household Support](/_llm/pages/en/use/welfare-household-support.md) — Use UMMAYA to understand welfare guidance, preparation, eligibility boundaries, and official application handoff.
- [Agentic RAG And Query Engine](/_llm/pages/jg/architecture/agentic-rag-query-engine.md) — 検索、推論、tool calling、permission、stop reason が一つの UMMAYA turn で協調する仕組みです。
- [Harness Migration](/_llm/pages/jg/architecture/harness-migration.md) — Claude Code の harness を国家インフラ AX に移す理由です。
- [Main Primitives](/_llm/pages/jg/architecture/main-primitives.md) — UMMAYA が model に小さな action vocabulary だけを見せる理由です。
- [Adapter Authoring](/_llm/pages/jg/build/adapter-authoring.md) — 一つの public-service channel を evidence-bearing UMMAYA adapter として wrap する方法。
- [Docs のための LLMOps](/_llm/pages/jg/build/llmops.md) — UMMAYA が human docs、LLM-readable docs、generated metadata、deployment outputs を aligned に保つ方法。
- [Adapter Matrix](/_llm/pages/jg/coverage/adapter-matrix.md) — UMMAYA coverage、adapter status、primitive support の背後にある evidence ledger。
- [現在の coverage](/_llm/pages/jg/coverage/current-coverage.md) — user task、status label、evidence source で UMMAYA の現在 capability を説明します。
- [Domain Roadmap](/_llm/pages/jg/coverage/domain-roadmap.md) — UMMAYA が domains を target-state scenario から mock、live capability へ進める方法。
- [Scenario Matrix](/_llm/pages/jg/coverage/scenario-matrix.md) — UMMAYA が実際の public-service demand を覆うか判断する target-state citizen scenarios。
- [UMMAYA Docs](/_llm/pages/jg.md) — Korean national-infrastructure AX harness として UMMAYA を使い、評価し、拡張するための documentation。
- [LLM-Readable Docs](/_llm/pages/jg/reference/llm-readable-docs.md) — agents が site scraping なしに UMMAYA を inspect できる generated documentation surfaces。
- [最初の成功セッション](/_llm/pages/jg/start/first-successful-session.md) — 最初の実行で何が見えるべきか、そして何を主張してはいけないか。
- [クイックスタート](/_llm/pages/jg/start/quickstart.md) — packaged UMMAYA CLI をインストールし、セッションを開始し、安全な public-service prompt を一つ実行します。
- [質問した後に起きること](/_llm/pages/jg/start/what-happens-after-you-ask.md) — query routing、tool calls、permission gates、final answers をユーザー視点で説明します。
- [UMMAYA が今日できること](/_llm/pages/jg/start/what-ummaya-can-do-today.md) — current capability を user task、status label、evidence boundary で説明します。
- [何を質問できるか](/_llm/pages/jg/start/what-you-can-ask.md) — agency API や internal adapter name ではなく、public-service outcome で UMMAYA に prompt します。
- [なぜ UMMAYA なのか](/_llm/pages/jg/start/why-ummaya.md) — UMMAYA が national-infrastructure AX harness として存在する理由。
- [データ、認証情報、ローカルセッション](/_llm/pages/jg/trust/data-credentials-local-sessions.md) — UMMAYA がローカルに何を保存し、credentials が何を意味し、session evidence がどう検査可能であるべきか。
- [Live、Mock、Handoff](/_llm/pages/jg/trust/live-mock-handoff.md) — UMMAYA が実際に何をできるかを正直に保つ status labels。
- [公式 Handoff](/_llm/pages/jg/trust/official-handoff.md) — UMMAYA が official service だけが完了できる boundary に達したとき起きるべきこと。
- [権限と同意](/_llm/pages/jg/trust/permissions-and-consent.md) — UMMAYA が public lookup と protected public-service actions をどう分けるか。
- [UMMAYA がしないこと](/_llm/pages/jg/trust/what-ummaya-will-not-do.md) — UMMAYA が実際以上に official に聞こえることを防ぐ boundaries。
- [緊急、医療、天気、安全](/_llm/pages/jg/use/emergency-healthcare-weather-safety.md) — UMMAYA で公共安全情報を使い、緊急判断と protected decisions は official channels に残します。
- [ID、証明書、MyData](/_llm/pages/jg/use/identity-certificates-mydata.md) — 今日、多くが Mock または official Handoff を必要とする identity-bound workflows を理解します。
- [引っ越し、住宅、地方記録](/_llm/pages/jg/use/moving-housing-local-records.md) — official records を変更したふりをせず、multi-agency move と housing workflows を準備します。
- [Sessions、Receipts、History](/_llm/pages/jg/use/sessions-receipts-history.md) — UMMAYA が sessions、receipts、context compression で長い workflows を inspectable に保つ方法。
- [税、罰金、支払い、公共料金](/_llm/pages/jg/use/tax-fines-payments-utilities.md) — mock path を official completion と混同せず、重要な payment と filing workflows を準備します。
- [トラブルシューティング](/_llm/pages/jg/use/troubleshooting.md) — maintainer debugging に進む前に、user-facing problems を解決します。
- [福祉と世帯支援](/_llm/pages/jg/use/welfare-household-support.md) — UMMAYA で welfare guidance、preparation、eligibility boundaries、official application handoff を理解します。
- [Agentic RAG And Query Engine](/_llm/pages/ko/architecture/agentic-rag-query-engine.md) — 검색, 추론, 도구 호출, 권한, stop reason이 한 턴에서 협력하는 방식입니다.
- [Harness Migration](/_llm/pages/ko/architecture/harness-migration.md) — Claude Code 하네스 구조를 개발자 작업에서 국가 인프라 작업으로 옮기는 이유입니다.
- [Main Primitives](/_llm/pages/ko/architecture/main-primitives.md) — 도메인 세부사항은 adapter가 담당하고 모델에는 작은 동사 표면만 노출합니다.
- [어댑터 작성](/_llm/pages/ko/build/adapter-authoring.md) — 하나의 공공서비스 채널을 하나의 증거 기반 UMMAYA 어댑터로 감싸는 방법입니다.
- [문서를 위한 LLMOps](/_llm/pages/ko/build/llmops.md) — UMMAYA가 human docs, LLM-readable docs, generated metadata, deployment output을 같은 상태로 유지하는 방식입니다.
- [Adapter Matrix](/_llm/pages/ko/coverage/adapter-matrix.md) — UMMAYA coverage, adapter status, primitive support의 evidence ledger입니다.
- [현재 커버리지](/_llm/pages/ko/coverage/current-coverage.md) — 현재 UMMAYA capability를 user task, status label, evidence source로 설명합니다.
- [Domain Roadmap](/_llm/pages/ko/coverage/domain-roadmap.md) — UMMAYA가 domain을 target-state scenario에서 mock, live capability로 이동시키는 방식입니다.
- [Scenario Matrix](/_llm/pages/ko/coverage/scenario-matrix.md) — UMMAYA가 실제 public-service demand를 다루는지 판단하는 target-state citizen scenario입니다.
- [UMMAYA 문서](/_llm/pages/ko.md) — 대한민국 국가 인프라 AX harness로서 UMMAYA를 사용하고, 평가하고, 확장하기 위한 문서입니다.
- [LLM-Readable Docs](/_llm/pages/ko/reference/llm-readable-docs.md) — agent가 site scraping 없이 UMMAYA를 검사할 수 있게 하는 generated documentation surface입니다.
- [첫 성공 세션](/_llm/pages/ko/start/first-successful-session.md) — 첫 실행이 무엇을 보여야 하고 무엇을 주장하면 안 되는지 설명합니다.
- [Quickstart](/_llm/pages/ko/start/quickstart.md) — packaged UMMAYA CLI를 설치하고 session을 시작한 뒤 안전한 public-service prompt를 실행합니다.
- [질문한 뒤 일어나는 일](/_llm/pages/ko/start/what-happens-after-you-ask.md) — query routing, tool calls, permission gates, final answer를 사용자 수준에서 설명합니다.
- [UMMAYA가 오늘 할 수 있는 일](/_llm/pages/ko/start/what-ummaya-can-do-today.md) — 현재 capability를 user task, status label, evidence boundary로 설명합니다.
- [무엇을 물어볼 수 있나](/_llm/pages/ko/start/what-you-can-ask.md) — agency API나 internal adapter 이름이 아니라 public-service outcome으로 UMMAYA에 질문합니다.
- [왜 UMMAYA인가](/_llm/pages/ko/start/why-ummaya.md) — UMMAYA가 국가 인프라 AX harness로 존재해야 하는 이유입니다.
- [데이터, 자격 증명, 로컬 세션](/_llm/pages/ko/trust/data-credentials-local-sessions.md) — UMMAYA가 local에 무엇을 저장하고 credential이 무엇을 의미하며 session evidence가 어떻게 inspect 가능해야 하는지 설명합니다.
- [Live, Mock, Handoff](/_llm/pages/ko/trust/live-mock-handoff.md) — UMMAYA가 실제로 할 수 있는 일을 정직하게 표시하는 status label입니다.
- [Official Handoff](/_llm/pages/ko/trust/official-handoff.md) — UMMAYA가 official service만 완료할 수 있는 경계에 도달했을 때 일어나야 하는 일입니다.
- [Permissions And Consent](/_llm/pages/ko/trust/permissions-and-consent.md) — UMMAYA가 public lookup과 protected public-service action을 분리하는 방식입니다.
- [UMMAYA가 하지 않는 것](/_llm/pages/ko/trust/what-ummaya-will-not-do.md) — UMMAYA가 실제보다 더 official하게 들리지 않도록 막는 boundary입니다.
- [응급, 의료, 날씨, 안전](/_llm/pages/ko/use/emergency-healthcare-weather-safety.md) — 공개 안전 정보를 활용하되 긴급 판단과 보호된 결정은 공식 채널에 남기는 방법입니다.
- [신원, 증명서, MyData](/_llm/pages/ko/use/identity-certificates-mydata.md) — 대부분 Mock 또는 official Handoff가 필요한 신원 기반 workflow를 이해합니다.
- [이사, 주거, 지역 기록](/_llm/pages/ko/use/moving-housing-local-records.md) — 공식 기록을 바꾼 것처럼 말하지 않으면서 여러 기관에 걸친 이사와 주거 workflow를 준비합니다.
- [세션, 영수증, 기록](/_llm/pages/ko/use/sessions-receipts-history.md) — 긴 workflow가 session, receipt, context compression을 통해 inspect 가능하게 유지되는 방식을 설명합니다.
- [세금, 과태료, 납부, 공공요금](/_llm/pages/ko/use/tax-fines-payments-utilities.md) — Mock path와 official completion을 혼동하지 않으면서 중요한 납부와 신고 workflow를 준비합니다.
- [Troubleshooting](/_llm/pages/ko/use/troubleshooting.md) — maintainer debugging으로 들어가기 전에 common user-facing problem을 해결합니다.
- [복지와 가구 지원](/_llm/pages/ko/use/welfare-household-support.md) — 복지 안내, 준비, eligibility boundary, official application handoff를 이해합니다.

## Generated Data

- [Adapter metadata](/_llm/generated/adapters.json)
- [Citizen workflow cards](/_llm/generated/workflows.json)
- [Environment variables](/_llm/generated/env-vars.json)
- [Prompt manifest summary](/_llm/generated/prompt-manifest.json)