LlmWikis Agent File Handoff

--- title: "LlmWikis Agent File Handoff" description: "LlmWikis dogfoods chat-start file intake beside the UAIX Project Handoff pattern." slug: "llmwikis/uai-system/files/uai-file-handoff-uai-225d13ff" status: "working-draft" trust_level: "generated-evidence" source_status: "current-source-file" content_type: "source-file" generated_by: "tools/sync-source-files.ps1" last_reprocessed: "2026-04-30" source_site: "llmwikis.org" source_url: "https://llmwikis.org/" canonical_url: "https://aiwikis.org/llmwikis/uai-system/files/uai-file-handoff-uai-225d13ff/" canonical: "https://aiwikis.org/llmwikis/uai-system/files/uai-file-handoff-uai-225d13ff/" source_reference: ".uai/file-handoff.uai" file_type: "uai" content_category: "uai-system" content_hash: "sha256:225d13ff83dd2bbfc51c52332a5949fd18e43cef427795b4053d909621b7571b" last_fetched: "2026-04-30T22:07:25.2671233Z" last_changed: "2026-04-29T00:00:17.2321032Z" import_status: "unchanged" duplicate_group_id: "sfg-020" generated_explanation: true explanation_last_generated: "2026-04-30T22:07:25.2671233Z" source_domains:

tags:

related_files:

---

"llmwikis.org"
"ai-memory"
"provenance"
"llm-wiki"
"uai"
"retrieval"
"prompt-size-minimization"
""

LlmWikis Agent File Handoff

LlmWikis dogfoods chat-start file intake beside the UAIX Project Handoff pattern.

Metadata

Field	Value
Source site	llmwikis.org
Source URL	https://llmwikis.org/
Canonical AIWikis URL	https://aiwikis.org/llmwikis/uai-system/files/uai-file-handoff-uai-225d13ff/
Source reference	`.uai/file-handoff.uai`
File type	`uai`
Content category	`uai-system`
Last fetched	`2026-04-30T22:07:25.2671233Z`
Last changed	`2026-04-29T00:00:17.2321032Z`
Content hash	`sha256:225d13ff83dd2bbfc51c52332a5949fd18e43cef427795b4053d909621b7571b`
Import status	`unchanged`
Raw source layer	`data/sources/llmwikis/uai-file-handoff-uai-225d13ff83dd.uai`
Normalized source layer	`data/normalized/llmwikis/uai-file-handoff-uai-225d13ff83dd.txt`

Current File Content

Structure Preview

LlmWikis Agent File Handoff
Purpose
Current Local Behavior
Bucket Meaning
Routes
Publication Boundary
Required AI Behavior

Raw Version

Local absolute paths are redacted in this public view. The source hash and source-side raw layer are based on the unredacted source file.

---
uaix: "1.0"
type: operations
title: "LlmWikis Agent File Handoff"
created: "2026-04-27"
updated: "2026-04-28"
author: "LlmWikis maintainers"
version: 8
---

# LlmWikis Agent File Handoff

## Purpose

LlmWikis dogfoods chat-start file intake beside the UAIX Project Handoff pattern.

Humans and other AI systems can drop files into two intent buckets:

- `agent-file-handoff/Content/` for candidate public content, handbook drafts, report drafts, public source material, and editorial material that might become a site route after review.
- `agent-file-handoff/Improvement/` for audits, SEO reports, QA findings, bug notes, screenshots of broken UI, roadmap suggestions, and other work items for improving the site.

Processed files move to `agent-file-handoff/Archive/` after an explicit disposition. The archive is retained only for human reference or repossession. It is dead to routine AI intake: agents must not scan, summarize, index, or reprocess archived files unless a human explicitly names an archived file or moves it back into `Content/` or `Improvement/`.

Cross-site archive consolidation is a separate explicit workflow. When a human asks for processed archives to become long-term system memory, LlmWikis archive files may be moved into AIWikis.org under `[local path redacted]` and removed from the LlmWikis archive after a transfer manifest or equivalent evidence is recorded. The AIWikis copy is memory/provenance evidence, not canonical LlmWikis public truth and not UAIX authority.

A new AI should scan both buckets while loading `AGENTS.md` and the listed `.uai` files, before broad planning. This keeps newly supplied files visible even when the human prompt does not mention them.

Visibility is not enough. If `.uai/intake-index.uai` lists any non-blocked file, the AI must inspect the file immediately, summarize it, and give it an explicit disposition before unrelated broad work continues.

The requirement is the AGENTS.md-triggered intake behavior. `scripts/Invoke-UaiFileIntake.ps1` is the local helper for refreshing the index. Watchers, daemons, queue folders, manifests, background services, cron loops, out-of-chat auto-pickup processes, and bucket-local README instructions are discouraged because the pattern must remain portable across languages and environments.

## Current Local Behavior

- Content bucket: `agent-file-handoff/Content/`
- Improvement bucket: `agent-file-handoff/Improvement/`
- Archive folder: `agent-file-handoff/Archive/`
- Downstream long-term archive: `[local path redacted]` after explicit human-directed consolidation.
- Legacy compatibility folder: `agent-file-handoff/intake/`
- Chat-start index helper: `scripts/Invoke-UaiFileIntake.ps1`
- Generated index: `.uai/intake-index.uai`
- No watcher/daemon helpers, queue folders, manifests, or background services are part of this workspace's intake pattern.

The intake pass computes SHA-256 checksums, assigns bucket names and route hints, marks non-executable files as `needs-agent-review`, and updates the index. It does not move files, publish files, create review drafts, or mark dropped files trusted.

The legacy `agent-file-handoff/intake/` folder is retained only so old instructions have a place to point. Files left there are treated as `Unsorted` and should be moved, applied, deferred, clarified, or blocked before broad work continues.

The archive folder is intentionally excluded from `.uai/intake-index.uai`. Do not create bucket README files or rely on folder-local instructions there; durable AI behavior belongs in `AGENTS.md` and `.uai` files, and human-facing explanation belongs in root `readme.human`.

The required agent disposition for every `needs-agent-review` file is one of:

- Apply now because it is directly relevant and safe.
- Convert into roadmap, progress, decision, issue, or implementation state because it is useful but not public content.
- Convert into public content only when it is in the `Content` bucket and passes source, route, support-boundary, and release checks.
- Defer with a concrete reason.
- Ask the human for clarification.
- Block as unsafe, unsupported, out of scope, or executable/script-like.

## Bucket Meaning

- `Content` means the file might become public-facing copy, a public page, a report, an example, or editorial source material after review.
- `Improvement` means the file is about fixing, auditing, prioritizing, or improving the site. It should become roadmap/progress state, an issue, a code change, a QA check, or an implementation note, not public copy by default.
- `Archive` means the file already received a disposition. Leave it alone during normal AI handoff. A human can reference it by exact path or move it back into an intake bucket to repossess it.
- `Unsorted` means the file was dropped into the legacy `intake/` folder and needs human or agent classification before promotion.

## Routes

- `site-content-draft` for text-like files in `Content/`.
- `site-improvement-report` for text-like files in `Improvement/`.
- `handoff-context` for `.uai`, `.json`, `.yaml`, and `.yml`.
- `content-asset-review` or `improvement-evidence-review` for PDFs and images, depending on bucket.
- `package-review` for `.zip`.
- `content-data-review` or `improvement-data-review` for `.csv` and `.tsv`, depending on bucket.
- `unsorted-review` for old files left in `intake/`.

Executable/script-like drops are reported as `blocked-local-review` in the index and must not be executed or promoted.

## Publication Boundary

The handoff contract is a one-shot intake scan and review gate during `AGENTS.md` load. A project can implement that scan in any language or perform it manually, as long as both `Content/` and `Improvement/` are inspected, `Archive/` is ignored, `.uai/intake-index.uai` is updated, and every listed file has a named disposition before unrelated broad work begins.

Public LlmWikis page changes, WordPress writes, discovery files, release ZIPs, and production deployment still require the normal constraints and checks. UAIX.org remains canonical for UAI-1, Project Handoff, schemas, validator behavior, roadmap, governance, and changelog.

## Required AI Behavior

At the start of a broad task:

1. Read `AGENTS.md`.
2. Check `agent-file-handoff/Content/` and `agent-file-handoff/Improvement/`, then refresh the index. Use `scripts/Invoke-UaiFileIntake.ps1` when available.
3. Load the listed `.uai` files, including the refreshed `.uai/intake-index.uai`.
4. Inspect each `needs-agent-review` file named in the index before unrelated broad work.
5. Summarize each file and state a disposition: apply now, convert to durable state, defer with a reason, ask for clarification, or block.
6. Move already-dispositioned intake files into `agent-file-handoff/Archive/` when their useful information has been captured or explicitly rejected.
7. Promote useful content into public pages, `.uai` files, roadmap state, or release evidence only after checking source status, UAIX authority boundaries, and review requirements.

Why This File Exists

This is a UAI AI Memory handoff file from llmwikis.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 operations 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: LlmWikis Agent File Handoff; Purpose; Current Local Behavior; Bucket Meaning; Routes; Publication Boundary; Required AI Behavior. 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.

Provenance And History

Current observation: 2026-04-30T22:07:25.2671233Z
Source origin: current-source-workspace
Retrieval method: local-source-workspace
Duplicate group: sfg-020 (primary)
Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "LlmWikis Agent File Handoff",
    "source_site":  "llmwikis.org",
    "source_url":  "https://llmwikis.org/",
    "canonical_url":  "https://aiwikis.org/llmwikis/uai-system/files/uai-file-handoff-uai-225d13ff/",
    "source_reference":  ".uai/file-handoff.uai",
    "file_type":  "uai",
    "content_category":  "uai-system",
    "content_hash":  "sha256:225d13ff83dd2bbfc51c52332a5949fd18e43cef427795b4053d909621b7571b",
    "last_fetched":  "2026-04-30T22:07:25.2671233Z",
    "last_changed":  "2026-04-29T00:00:17.2321032Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-020",
    "duplicate_role":  "primary",
    "related_files":  [

                      ],
    "generated_explanation":  true,
    "explanation_last_generated":  "2026-04-30T22:07:25.2671233Z"
}

LlmWikis Agent File Handoff

LlmWikis Agent File Handoff

Metadata

Current File Content

Structure Preview

Raw Version

Why This File Exists

Role

Structure

Prompt-Size And Retrieval Benefit

How To Use It

Update Requirements

Related Pages

Provenance And History

Machine-Readable Metadata