Skip to content
aiWikis.org

UAIX Handoff Pattern

This file keeps the practical Project Handoff pattern small enough to load by default.

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-handoff-patter-08895072/
Source referenceraw/system-archives/uaix/recent-work-sweep/2026-05-03/.uai/handoff-pattern.uai
File typeuai
Content categoryuai-system
Last fetched2026-05-03T02:48:13.1276041Z
Last changed2026-05-02T19:40:06.9933915Z
Content hashsha256:088950726fee09654029cc2a41e70b28d209334b5dbc8619277d4e4a9310764f
Import statusunchanged
Raw source layerdata/sources/aiwikis/raw-system-archives-uaix-recent-work-sweep-2026-05-03-uai-handoff-pattern-uai-088950726fee.uai
Normalized source layerdata/normalized/aiwikis/raw-system-archives-uaix-recent-work-sweep-2026-05-03-uai-handoff-pattern-uai-088950726fee.txt

Current File Content

Structure Preview

  • UAIX Handoff Pattern
  • Purpose
  • Public Pattern Pages
  • Minimum Useful Bundle
  • Loader Rules
  • File Intake Rule
  • First Response Pattern
  • Memory Promotion Rule
  • Non-Claims
  • Maintenance Rules

Raw Version

---
uaix: "1.0"
type: custom
title: "UAIX Handoff Pattern"
created: "2026-04-25"
updated: "2026-05-02"
status: active
author: "UAIX maintainers"
version: 24
---

# UAIX Handoff Pattern

## Purpose

This file keeps the practical Project Handoff pattern small enough to load by default.

UAIX uses a hot/cold memory split:

- Hot memory stays in `AGENTS.md`, `readme.human`, and loaded `.uai` files. It covers current truth, hard constraints, active routes, current decisions, next work, active intake, and checks.
- Cold memory lives in AIWikis long-term memory. It covers long research reports, proposal wording, old roadmap detail, source-report provenance, and pre-slim handoff snapshots.

The 2026-05-01 cold-memory transfer is recorded in AIWikis at `raw/system-archives/2026-05-01-uaix-internal-memory-reorg.json` with compiled nodes `wiki/sources/uaix-internal-memory-reorg-2026-05-01.md`, `wiki/concepts/uaix-active-context-diet.md`, and `wiki/logs/uaix-internal-memory-reorg-2026-05-01.md`.

## Public Pattern Pages

Use these UAIX public pages when the task needs published guidance:

- `/en-us/ai-memory/` for broad durable AI project memory.
- `/en-us/tools/ai-memory-package-wizard/` for guided starter package planning.
- `/en-us/specification/project-handoff/` for repo-local portable project memory.
- `/en-us/guides/agentic-harnesses-uai/` for separating runtime harness strategy from UAI evidence, AI Memory, Project Handoff, conformance, and support-claim boundaries.
- `/en-us/guides/project-handoff-openai/` for OpenAI Agents and Codex positioning.
- `/en-us/guides/project-handoff-coding-agents/` for one local bundle across major coding-agent surfaces.
- `/en-us/guides/project-handoff-context-budget/` for keeping startup context compact while cold memory preserves bulky history with transfer evidence.
- `/en-us/specification/agent-file-handoff/` for chat-start file intake.
- `/en-us/specification/agents-md/` and `/en-us/reports/` for deeper proposal/report history.
- `/en-us/specification/uai-1/`, `/en-us/schemas/`, `/en-us/registry/`, `/en-us/examples/`, `/en-us/tools/validator/`, `/en-us/tools/adoption-kit/`, and `/en-us/tools/conformance-pack/` when local memory needs to become UAI-1 evidence.
- `/en-us/roadmap/` and `/en-us/governance/changelog/` before claiming what is current, planned, or changed.

## Minimum Useful Bundle

Every project using this pattern starts with:

- `AGENTS.md` at the repository root.
- `readme.human` at the repository root.
- `.uai/context.uai`.
- `.uai/stack.uai`.
- `.uai/constraints.uai`.

Add these as needed:

- `.uai/architecture.uai` for system shape and ownership.
- `.uai/public-surface.uai` for public routes and discovery surfaces.
- `.uai/decisions.uai` for current ADR-style decisions.
- `.uai/progress.uai` for recent work, focus, blockers, next work, and done criteria.
- `.uai/operations.uai` for local commands, deployment, release, and rollback.
- `.uai/test-plan.uai` for targeted checks and full-suite triggers.
- `.uai/style.uai` for code, copy, design, and naming conventions.
- `.uai/file-handoff.uai`, `.uai/intake-index.uai`, and `agent-file-handoff/` when humans or tools drop files into the project.
- Thin tool-specific pointer files only when a surface benefits from them; they must route back to `AGENTS.md`.

## Loader Rules

A new AI or loader should:

1. Read `AGENTS.md` first.
2. Read `readme.human` as the human briefing, not as an override.
3. Refresh active file intake with the local helper when available.
4. Load every `.uai` file listed under `AGENTS.md` Loaded Context.
5. Inspect and disposition every `needs-agent-review` intake file before unrelated broad work.
6. Resolve `@uai[]` references repo-locally and report missing, circular, contradictory, or escaping references.
7. Summarize the loaded context in 3-5 bullets before broad changes.
8. Confirm hard constraints, intended touchpoints, targeted checks, and skipped full-suite checks before editing.

## File Intake Rule

UAIX dogfoods Agent File Handoff with:

- `agent-file-handoff/Content/` for candidate public/editorial material.
- `agent-file-handoff/Improvement/` for audits, QA findings, SEO reports, bug notes, roadmap suggestions, and site-fix work.
- `agent-file-handoff/Archive/` for already-dispositioned files that normal AI intake ignores.
- `scripts/Invoke-UaiFileIntake.ps1` to refresh `.uai/intake-index.uai`.

No CI job, watcher, daemon, scheduled job, queue folder, repository automation, or background service is part of the base pattern. The active AI handles pickup inside the chat/work session.

## First Response Pattern

Before a broad change, the AI should state:

1. What UAIX is, what UAI-1 is, and what this repo publishes.
2. The active theme, public route shape, and machine-discovery assets.
3. Refreshed intake status and dispositions.
4. Hard constraints, especially support-claim, secrets/data, and destructive-operation boundaries.
5. Files, routes, or docs expected to change.
6. Targeted checks expected to run, and full release/package checks intentionally skipped.

## Memory Promotion Rule

AIWikis long memory is recoverable provenance, not active UAIX truth.

Promote a cold-memory fact into UAIX only by deliberately restating it in UAIX `.uai`, current docs, code, public pages, machine artifacts, tests, release notes, or roadmap state. Do not treat archived reports, copied `.uai` snapshots, or AIWikis summaries as current support evidence by themselves.

## Non-Claims

Project Handoff and this local bundle do not create hosted upload/import validation, automatic repository writes, automatic LLM Wiki sync, SDK, CLI, certification, endorsement, official vendor adapters, UAI-1 conformance evidence, runtime orchestration, or tool-calling support.

A passing local handoff lint is structural evidence only. Public UAI-1 support claims need public UAIX pages, machine artifacts, validator behavior, release notes, roadmap state, and tests.

## Maintenance Rules

- Keep `AGENTS.md` concise and operational.
- Keep `.uai` files current and compact.
- Keep historical detail in AIWikis unless it is needed for current work.
- Keep root `readme.human` useful for humans steering the AI.
- Keep public Project Handoff copy, local repo practice, and canonical docs aligned.
- Run `scripts/lint-uaix-handoff.ps1` after changing the handoff bundle or intake behavior.

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 Handoff Pattern; Purpose; Public Pattern Pages; Minimum Useful Bundle; Loader Rules; File Intake Rule; First Response Pattern; Memory Promotion Rule. 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-021 (primary)
  • Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "UAIX Handoff Pattern",
    "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-handoff-patter-08895072/",
    "source_reference":  "raw/system-archives/uaix/recent-work-sweep/2026-05-03/.uai/handoff-pattern.uai",
    "file_type":  "uai",
    "content_category":  "uai-system",
    "content_hash":  "sha256:088950726fee09654029cc2a41e70b28d209334b5dbc8619277d4e4a9310764f",
    "last_fetched":  "2026-05-03T02:48:13.1276041Z",
    "last_changed":  "2026-05-02T19:40:06.9933915Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-021",
    "duplicate_role":  "primary",
    "related_files":  [

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