Skip to content
aiWikis.org

UAIX Public Surface

Orientation and memory:

Metadata

FieldValue
Source siteaiwikis.org
Source URLhttps://aiwikis.org/
Canonical AIWikis URLhttps://aiwikis.org/files/aiwikis/raw-system-archives-uaix-recent-work-sweep-2026-05-03-uai-public-surface-d1b13990/
Source referenceraw/system-archives/uaix/recent-work-sweep/2026-05-03/.uai/public-surface.uai
File typeuai
Content categoryuai-system
Last fetched2026-05-03T02:48:13.1276041Z
Last changed2026-05-03T00:39:23.3260507Z
Content hashsha256:d1b13990b6943554d2032d6dccc8c728f3e3b7f3d5f3477da37b70a6fb753874
Import statusunchanged
Raw source layerdata/sources/aiwikis/raw-system-archives-uaix-recent-work-sweep-2026-05-03-uai-public-surface-uai-d1b13990b694.uai
Normalized source layerdata/normalized/aiwikis/raw-system-archives-uaix-recent-work-sweep-2026-05-03-uai-public-surface-uai-d1b13990b694.txt

Current File Content

Structure Preview

  • UAIX Public Surface
  • Canonical Host And Languages
  • Root Discovery Assets
  • Primary Public Routes
  • Reader Flow
  • Current Support Boundaries
  • Unsupported Until Public Evidence Exists
  • Source-Only Materials
  • Verification Notes

Raw Version

---
uaix: "1.0"
type: custom
title: "UAIX Public Surface"
created: "2026-04-25"
updated: "2026-05-03"
status: active
author: "UAIX maintainers"
version: 35
---

# UAIX Public Surface

## Canonical Host And Languages

- Canonical host: `https://uaix.org`.
- Public route shape: clean locale-prefixed paths under `/en-us/...` and `/zh-cn/...`.
- Enabled public languages: `en-US` and `zh-CN`.
- Disabled inventory languages: `es-US`, `fr-FR`, and `spiral`; do not treat them as supported until content, metadata, hreflang, sitemap, and rendered-text audits ship together.
- `uiax.org` and `www.uiax.org` are typo-domain aliases for anonymous public traffic and should redirect to `https://uaix.org` with path/query preserved. Do not redirect typo-domain `/wp-admin/`, `/wp-login.php`, or logged-in sessions away from the typo host.
- Protocol5.com is not a UAI-1 public standards surface. It may distribute .NET/NuGet implementation artifacts and backlink to UAIX.org.
- `/AI_Memory` is a non-canonical requested entry alias that redirects to `/en-us/ai-memory/`.

## Root Discovery Assets

- `/robots.txt`
- `/sitemap.xml`
- `/sitemap.html`
- `/.well-known/uaix.json`
- `/.well-known/uai.json`

## Primary Public Routes

Orientation and memory:

- `/en-us/`
- `/en-us/get-started/`
- `/en-us/ai-memory/`
- `/en-us/ai-memory/llm-wiki/`
- `/en-us/tools/ai-memory-package-wizard/`

Project Handoff and agent guidance:

- `/en-us/specification/project-handoff/`
- `/en-us/guides/agentic-harnesses-uai/`
- `/en-us/guides/project-handoff-openai/`
- `/en-us/guides/project-handoff-coding-agents/`
- `/en-us/guides/project-handoff-context-budget/`
- `/en-us/specification/agent-file-handoff/`
- `/en-us/specification/agents-md/`
- `/en-us/reports/`
- `/en-us/reports/relationship-audit-aiwikis-llmwikis-uaix/`
- `/en-us/reports/llm-wiki-vs-uaix-project-handoff/`
- `/en-us/reports/llm-wiki-and-uaix-project-handoff/`
- `/en-us/reports/refining-uai-protocol-agent-communication/`

UAI-1 contract and evidence:

- `/en-us/specification/uai-1/`
- `/en-us/specification/standards-fit/`
- `/en-us/schemas/`
- `/en-us/registry/`
- `/en-us/examples/`
- `/en-us/tools/api-reference/`
- `/en-us/tools/validator/`
- `/en-us/tools/adoption-kit/`
- `/en-us/tools/conformance-pack/`
- `/en-us/tools/uaix-agents-protocol/`
- `/en-us/roadmap/`
- `/en-us/governance/changelog/`
- `/en-us/about/related-links/`

## Reader Flow

1. Start at Get Started.
2. Use AI Memory for durable AI project-context framing and supported starter bundles.
3. Use the Package Wizard to plan one supported memory starter into generated local files and exports; humans use the visible wizard controls, while visiting AI agents read the embedded digest generated from the same wizard payload.
4. Use Project Handoff when the task is repository-local transfer through `AGENTS.md`, `readme.human`, and `.uai` files.
5. Use the OpenAI/Codex guide when runtime-orchestration confusion is likely.
6. Use the Agentic Harness Strategies and UAI guide when readers need the layer split: harnesses execute, MCP/A2A/runtime tools coordinate and trace behavior, and UAI preserves reviewed portable evidence, AI Memory, Project Handoff, conformance material, and support boundaries.
7. Use the coding-agents guide when one local bundle must work across Codex, Claude Code, Cursor, Copilot, Gemini Code Assist, local agents, vendors, and humans.
8. Use the Project Handoff Context Budget guide when hot handoff files are accumulating old reports, chat history, roadmap background, or pre-slim snapshots that should move to cold memory with transfer evidence.
9. Use Agent File Handoff when dropped files must be reviewed and dispositioned during chat-start intake.
10. Use reports for proposal history and deeper rationale.
11. Use UAI-1, schemas, registry, examples, validator, Adoption Kit, and Conformance Pack when local memory becomes public exchange or reusable evidence.
12. Use Guides and Standards Fit when explaining agentic systems: runtime harnesses execute, MCP connects tools, A2A coordinates agents, observability traces behavior, and UAIX preserves the portable evidence and handoff record.
13. Use Reports as source leads only after checking whether a conclusion was promoted into current pages, machine artifacts, tests, changelog entries, roadmap state, or handoff records.
14. Use Roadmap and Changelog before making current-support or future-tooling claims.
15. Use the Roadmap today-focus path, roadmap work documentation ledger, work queue, evidence promotion gates, and support-claim checks before moving reader-orientation, first-proof, AI Memory package, source-lead promotion, future-agent pickup, agentic-system evidence, deployment, wizard serializer parity, local validation, redaction lint, trace-to-handoff, reference-adapter, SDK, CLI, certification, endorsement, conformance, or sync ideas into current support language.

## Current Support Boundaries

- AI Memory starter ZIPs and the Package Wizard are current as canonical bundle-registry outputs, local planning UI, direct setup URL fragments for base, Agent File Handoff, LLM Wiki, and combined paths, optimized human/visitor-AI entry artwork, embedded visitor-AI digest JSON, generated local files including optional `AGENT_FILE_HANDOFF_PLAN.md` and `LLM_WIKI_MEMORY_PLAN.md`, JSON exports, copyable decks, readiness metadata, and canonical starter downloads. The plain wizard route defaults to Base setup. LLM Wiki setup asks for or discovers the wiki root URL/repository path, index, log/evidence path, and promotion owner before using wiki memory; base and File Handoff setup do not force that question.
- Project Handoff is portable project memory for humans and AI agents, not a runtime, scheduler, orchestrator, OpenAI replacement, tool-calling framework, or official vendor adapter.
- LLM Wiki guidance is optional package-tailoring support for projects that already use or deliberately choose deeper wiki memory; it is not required by UAI specs or standards. The guide should stay aligned with LLMWikis.org's build guidance: preserve raw sources, compile reviewed wiki pages, maintain index/log navigation, use metadata and trust labels, review ingest before writing durable memory, keep retrieval behind curated sources, and promote only reviewed facts into compact UAI packages or current project truth.
- Agent File Handoff is chat-start intake and review, not CI pickup, a queue, a watcher, a daemon, a background service, or automatic publication.
- Reports are permanent source/proposal history and role-boundary context, not automatic current support evidence.
- Related Links is external context, not UAIX endorsement, certification, implementation support, or canonical authority.
- Public machine JSON routes are discovery or execution surfaces; human docs remain the indexable citation surfaces.

## Unsupported Until Public Evidence Exists

Do not claim hosted `.uai` upload/import validation, automatic repository writes, automatic LLM Wiki sync, SDK, CLI, certification, endorsement, official vendor adapters, OpenAI adapter support, trace-to-handoff exporter support, WordPress admin package installation, or validator-backed conformance for repo-local `AGENTS.md`, `readme.human`, `.uai`, or AIWikis archive copies.

## Source-Only Materials

- Repository Markdown, `.uai`, `readme.human`, active intake files, archive files, and slimmed source-note stubs are internal source guidance. They are not public sitemap/discovery payloads or WordPress upload-package content unless deliberately rewritten as public pages.
- AIWikis cold-memory copies and the 2026-05-01 UAIX internal memory reorganization manifest are provenance. They do not change UAIX.org authority and should not widen public support claims.

## Verification Notes

- Route, discovery, machine-artifact, SEO, locale, package, and response-header changes should use targeted checks from `.uai/test-plan.uai`.
- Full launch-surface, performance, locale, package, and smoke-test sweeps are release/package gates, broad launch-surface gates, or explicit human requests.
- Production can lag local source truth; if production response checks fail while local static checks pass, treat that as deployment drift rather than source truth reversal.

Why This File Exists

This is a UAI AI Memory handoff file from aiwikis.org. It is shown here because AIWikis.org is demonstrating the real source files that make the UAIX / LLM Wiki memory system work, not only summarizing those systems after the fact.

Role

This .uai file is a compact custom packet. It keeps one kind of durable project truth separate from the rest of the archive so an agent can load the topic it needs without pulling the whole project history into prompt context.

Structure

The file is structured around these visible headings: UAIX Public Surface; Canonical Host And Languages; Root Discovery Assets; Primary Public Routes; Reader Flow; Current Support Boundaries; Unsupported Until Public Evidence Exists; Source-Only Materials. Those headings are retrieval anchors: a crawler or LLM can decide whether the file is relevant before reading every line.

Prompt-Size And Retrieval Benefit

Keeping this material in a separate file reduces prompt pressure because an agent can load this exact unit only when its role, source site, category, or hash is relevant. The surrounding index pages point to it, while this page preserves the full content for audit and exact recall.

How To Use It

  • Humans should read the metadata first, then inspect the raw content when they need exact wording or provenance.
  • LLMs and agents should use the source site, category, hash, headings, and related files to decide whether this file belongs in the active prompt.
  • Crawlers should treat the AIWikis page as transparent evidence and follow the source URL/source reference for authority boundaries.
  • Future maintainers should regenerate this page whenever the source hash changes, then review the explanation if the role or structure changed.

Update Requirements

When this source file changes, update the raw source layer, normalized source layer, hash history, this rendered page, generated explanation, source-file inventory, changed-files report, and any source-section index that links to it.

Related Pages

Provenance And History

  • Current observation: 2026-05-03T02:48:13.1276041Z
  • Source origin: current-source-workspace
  • Retrieval method: local-source-workspace
  • Duplicate group: sfg-395 (primary)
  • Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "UAIX Public Surface",
    "source_site":  "aiwikis.org",
    "source_url":  "https://aiwikis.org/",
    "canonical_url":  "https://aiwikis.org/files/aiwikis/raw-system-archives-uaix-recent-work-sweep-2026-05-03-uai-public-surface-d1b13990/",
    "source_reference":  "raw/system-archives/uaix/recent-work-sweep/2026-05-03/.uai/public-surface.uai",
    "file_type":  "uai",
    "content_category":  "uai-system",
    "content_hash":  "sha256:d1b13990b6943554d2032d6dccc8c728f3e3b7f3d5f3477da37b70a6fb753874",
    "last_fetched":  "2026-05-03T02:48:13.1276041Z",
    "last_changed":  "2026-05-03T00:39:23.3260507Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-395",
    "duplicate_role":  "primary",
    "related_files":  [

                      ],
    "generated_explanation":  true,
    "explanation_last_generated":  "2026-05-03T02:48:13.1276041Z"
}