UAIX AI Instructions

This is the canonical AI-agent entry file for the UAIX workspace.

Metadata

Field	Value
Source site	uaix.org
Source URL	https://uaix.org/
Canonical AIWikis URL	https://aiwikis.org/uaix/files/raw-system-archives-uaix-recent-work-sweep-2026-05-03-agents-md-d5b15ae7/
Source reference	raw/system-archives/uaix/recent-work-sweep/2026-05-03/AGENTS.md
File type	md
Content category	uai-system
Last fetched	2026-06-22T01:56:21.9510185Z
Last changed	2026-05-03T00:39:23.3260507Z
Content hash	sha256:d5b15ae75fc86ee1423b5569154caa6935ce09ce03cb7531c51cd6bdb93ec988
Import status	unchanged
Raw source layer	data/sources/uaix/raw-system-archives-uaix-recent-work-sweep-2026-05-03-agents-md-d5b15ae75fc8.md
Normalized source layer	data/normalized/uaix/raw-system-archives-uaix-recent-work-sweep-2026-05-03-agents-md-d5b15ae75fc8.txt

Current File Content

Structure Preview

• UAIX AI Instructions
• Status
• Handoff Summary
• UAIX/Codex Handoff
• Loaded Context
• File Intake
• Required First Response
• Current State
• Next Steps
• Agent History
• Open Questions
• Deployment Rules
• Do Not Load By Default
• Do Not Change
• Markdown Maintenance Rules

Raw Version

This public page shows a bounded preview of a large source file. The complete source remains in the raw and normalized source layers named in metadata, with the SHA-256 hash above for verification.

• Source characters: 20740
• Preview characters: 11712

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: agents
project: "UAIX"
created: "2026-04-25"
updated: "2026-05-03"
status: active
version: 52
---

# UAIX AI Instructions

## Status

This is the canonical AI-agent entry file for the UAIX workspace.

Use `AGENTS.md` exactly as the front-door instruction file. Do not create `agent.md`, `Agents.md`, or another competing agent-instruction source. Tool-specific pointer files, such as `CLAUDE.md`, `GEMINI.md`, `.cursor/rules/uaix-handoff.mdc`, and `.github/copilot-instructions.md`, should remain lightweight redirects back to this file.

This file is intentionally concise. Detailed project truth belongs in root `readme.human` and the typed `.uai` files listed below.

## Handoff Summary

UAIX is the local WordPress Studio workspace for publishing UAIX.org, the public standards and publication site for UAI. UAI-1 is the current public exchange contract and evidence layer.

The repo-local handoff architecture is a specialized local path for Codex and other agents: load `AGENTS.md`, read `readme.human`, load typed `.uai` files, refresh dropped-file intake, and run targeted local checks. Direct UAIX.org pointing is for bootstrap, refresh, or public-source verification only; routine work should not depend on repeated live URL reading.

UAIX now uses AIWikis.org as long-term cold memory for bulky internal research, proposal history, roadmap background, and pre-slim handoff snapshots. Keep routine pickup focused on current UAIX hot context; open AIWikis raw memory only when the task explicitly needs original wording or older provenance.

UAIX.org is the UAI-1 source of truth. Protocol5.com is only a .NET plugin and NuGet distribution/backlink surface.

<!-- BEGIN UAIX-HANDOFF-MANAGED -->
## UAIX/Codex Handoff

Use the specialized local path for routine Codex and AI-agent work: read `AGENTS.md`, read `readme.human`, refresh active intake, load the typed `.uai` files, and run targeted local checks. Do not make recurring handoff work depend on live UAIX.org browsing.

The repo-local reusable Codex workflow is `.agents/skills/uaix-handoff/`. It exists to keep this handoff process repeatable while preserving `AGENTS.md` as the canonical front-door instruction file.
<!-- END UAIX-HANDOFF-MANAGED -->

## Loaded Context

Load these files before broad planning or editing:

@uai[.uai/context.uai]
@uai[.uai/stack.uai]
@uai[.uai/architecture.uai]
@uai[.uai/public-surface.uai]
@uai[.uai/constraints.uai]
@uai[.uai/decisions.uai]
@uai[.uai/progress.uai]
@uai[.uai/operations.uai]
@uai[.uai/test-plan.uai]
@uai[.uai/style.uai]
@uai[.uai/handoff-pattern.uai]
@uai[.uai/file-handoff.uai]
@uai[.uai/intake-index.uai]

If any required `.uai` file is missing, unreadable, circular, contradictory, or resolves outside the repo, stop and report that before editing.

## File Intake

At the start of every broad AI work session:

1. Inspect `agent-file-handoff/Content/`.
2. Inspect `agent-file-handoff/Improvement/`.
3. Ignore `agent-file-handoff/Archive/` unless the human explicitly names an archived file or moves it back into an active bucket.
4. Refresh `.uai/intake-index.uai` when a helper exists; this repo uses `scripts/Invoke-UaiFileIntake.ps1`.
5. Summarize each `needs-agent-review` file before unrelated planning or edits.
6. Record one disposition per file: `apply-now`, `convert-into-roadmap-progress`, `archive-as-duplicate`, `defer-with-reason`, `ask-for-clarification`, or `block-as-unsafe-or-out-of-scope`.
7. Move processed source files to `Archive/` only after the disposition is recorded in durable state.
8. Never auto-execute blocked or untrusted files.

Indexing is not approval. Dropped files are local review inputs only, not public truth, release evidence, certification, endorsement, validator evidence, or permission to widen support claims.

This workspace uses chat pickup, not CI pickup. Do not add CI jobs, scheduled jobs, repository automations, watchers, or background services for this handoff workflow; the active AI handles intake and targeted local checks inside the chat/work session.

## Required First Response

Before a broad change, reply with:

1. A 3-5 bullet summary of what UAIX is, what UAI-1 is, and what this repo publishes.
2. The active public theme, the public route shape, and the main machine-discovery assets.
3. The refreshed intake status, including the disposition for every `needs-agent-review` file.
4. The hard constraints from `.uai/constraints.uai`, especially support-claim boundaries, secrets/data boundaries, and destructive-operation limits.
5. The exact files or public routes expected to change for the current task.
6. The targeted checks expected to run, and any full release/package checks intentionally not running.

## Current State

- Active public theme: `wp-content/themes/uaix-authority-theme/`.
- Compatibility theme: `wp-content/themes/uaix-theme/`, still packaged and smoke-tested but not the production public surface.
- Public production routes use clean locale-prefixed paths under `/en-us/...`; enabled public languages are `en-US` and `zh-CN`.
- Main machine-discovery assets: `robots.txt`, `sitemap.xml`, `sitemap.html`, `/.well-known/uaix.json`, and `/.well-known/uai.json`.
- Public handoff and agentic-system surfaces include `/en-us/ai-memory/`, `/en-us/tools/ai-memory-package-wizard/`, `/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/`, and `/en-us/specification/agents-md/`.
- The AI Memory Package Wizard now exposes direct setup URLs for base UAI packages, Agent File Handoff, LLM Wiki planning, and the combined File Handoff plus LLM Wiki path; the plain wizard route defaults to Base setup; File Handoff mode generates `AGENT_FILE_HANDOFF_PLAN.md`; LLM Wiki remains optional and not required by UAI specs or standards. Base and File Handoff setup stay quiet; LLM Wiki setup asks for or discovers the wiki root URL/repository path, index, log/evidence path, and promotion owner before using wiki memory.
- AIWikis long-memory transfer evidence for slimmed UAIX internal docs lives at AIWikis `raw/system-archives/2026-05-01-uaix-internal-memory-reorg.json` with compiled source, concept, and log nodes. This is provenance, not UAIX authority.
- `agent-file-handoff/Content/`, `agent-file-handoff/Improvement/`, and `agent-file-handoff/Archive/` are active repo-local source-only handoff folders.
- `scripts/lint-uaix-handoff.ps1` is the local structural check for this handoff bundle. It is not UAI-1 validator evidence.
- `.agents/skills/uaix-handoff/` is the repo-local Codex skill for repeatable handoff pickup, intake review, and targeted verification.

Use `docs/navigation/README.md` for topic navigation when the loaded context says deeper docs are needed. Use the canonical reading order from `README.md` only when final project truth beyond the `.uai` bundle is required.

## Next Steps

- [ ] Keep `AGENTS.md` concise and operational; move detailed state into typed `.uai` files.
- [ ] Keep Project Handoff positioned as portable project memory for humans and AI agents, not an agent runtime, scheduler, orchestrator, OpenAI replacement, or tool-calling framework.
- [ ] Keep `/en-us/guides/agentic-harnesses-uai/` aligned with the runtime-versus-evidence boundary: harnesses execute, MCP/A2A/observability connect and trace behavior, and UAI preserves reviewed portable evidence and project-memory handoff.
- [ ] Keep the cross-coding-agent guide and local pointer files thin: they should route Codex, Claude Code, Cursor, Copilot, Gemini Code Assist, local agents, vendors, and humans back to `AGENTS.md`, `readme.human`, and `.uai` records without creating official adapter claims.
- [ ] Keep `/en-us/guides/project-handoff-context-budget/` aligned with the hot/cold memory rule: active handoff files carry current truth and pointers; AIWikis or LLM Wiki cold memory preserves bulky history with transfer evidence.
- [ ] Keep AI Memory public copy search-friendly while preserving current/planned support boundaries.
- [ ] Keep Agent File Handoff as AGENTS.md-triggered chat-start intake with no CI job, watcher, daemon, queue-folder, scheduled job, repository automation, or always-on background-service requirement.
- [ ] Keep root `AGENTS.md`, root `readme.human`, and `.uai/` files current whenever project truth changes.
- [ ] Keep UAIX hot context concise; move large historical research or proposal detail to AIWikis long-term memory with transfer evidence before replacing UAIX source files with stubs.
- [ ] Keep `.agents/skills/uaix-handoff/` aligned with this file when the handoff workflow changes.
- [ ] Keep UAIX.org as UAI-1 authority and Protocol5.com as only .NET/NuGet distribution plus backlinks.
- [ ] Keep the public Roadmap, roadmap REST payload, canonical roadmap doc, tests, and handoff state aligned around the today-focus path, roadmap work documentation ledger, work queue, evidence promotion gates, and support-claim checks before widening current-support language.
- [ ] Run targeted checks for ordinary edits; reserve full launch, performance, locale, package validation, and smoke-test sweeps for release/package work, broad launch-surface changes, or explicit human requests.
- [ ] Deploy the freshly regenerated `[local path redacted]` artifacts, especially `uaix-core.zip` and `prod-fallback-root-assets\`, then configure production static-root security headers for robots, sitemap, favicon, and other host-served files if the host does not honor the provided `.htaccess`.

## Agent History

Detailed historical progress lives in `.uai/progress.uai`. Keep this front-door table short and current.

| Date | Agent | Model | Work Done |
|------|-------|-------|-----------|
| 2026-05-02 | Codex | GPT-5 | Added direct AI Memory Package Wizard setup URLs for base, Agent File Handoff, LLM Wiki, and combined setup paths; added generated `AGENT_FILE_HANDOFF_PLAN.md` output and focused regression coverage while preserving no-sync/no-automation support boundaries. |
| 2026-05-02 | Codex | GPT-5 | Ran the predeployment translations, SEO metadata, static discovery, launch-surface, handoff, PHP lint, and AI Memory bundle regression sweep; all non-longest local checks passed, with only the expected local Studio `X-Powered-By: Express` warning. |
| 2026-05-02 | Codex | GPT-5 | Ran a predeploy language-support sweep across UAIX, LlmWikis, and AIWikis; confirmed LlmWikis and AIWikis remain English-only at the current support boundary, aligned UAIX's zh-CN LLM Wiki guide with the English LLMWikis.org setup guidance, and fixed the rendered zh-CN agentic-harness guide warning/residue caught by the sitemap audit. |
| 2026-05-02 | Codex | GPT-5 | Confirmed `/en-us/ai-memory/llm-wiki/` exists and strengthened its setup/use guidance so UAIX's optional UAI-plus-LLM-Wiki path agrees with LLMWikis.org raw/wiki/index/log, trust-label, review-gated ingest, privacy, and promotion boundaries. |
| 2026-05-02 | Codex | GPT-5 | Added `/en-us/guides/agentic-harnesses-uai/`, discovery/test coverage, zh-CN page override, and handoff updates so UAIX explains agentic harness strategy as runtime-owned execution plus UAI-owned portable evidence, AI Memory, Project Handoff, and support-claim boundaries. |
| 2026-05-02 | Codex | GPT-5 | Added a roadmap work documentation ledger across the public Roadmap, roadmap REST payload, canonical roadmap doc, tests, and handoff state so roadmap work names where it is recorded, where proof lives, how source leads are promoted, and how future agents pick up without widening support claims. |

Why This File Exists

This is a UAI AI Memory handoff file from uaix.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

AGENTS.md is the entry contract for agents. It tells an agent which context files to load, what authority boundaries apply, how file intake works, and which operations are out of bounds before broad edits start.

Structure

The file is structured around these visible headings: UAIX AI Instructions; Status; Handoff Summary; UAIX/Codex Handoff; Loaded Context; File Intake; Required First Response; Current State. 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

• Source overview
• Site file index
• Site report index
• UAI system index
• Source provenance
• Site directory
• Organization reports

Provenance And History

• Current observation: 2026-06-22T01:56:21.9510185Z
• Source origin: current-source-workspace
• Retrieval method: local-source-workspace
• Duplicate group: sfg-1032 (primary)
• Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "UAIX AI Instructions",
    "source_site":  "uaix.org",
    "source_url":  "https://uaix.org/",
    "canonical_url":  "https://aiwikis.org/uaix/files/raw-system-archives-uaix-recent-work-sweep-2026-05-03-agents-md-d5b15ae7/",
    "source_reference":  "raw/system-archives/uaix/recent-work-sweep/2026-05-03/AGENTS.md",
    "file_type":  "md",
    "content_category":  "uai-system",
    "content_hash":  "sha256:d5b15ae75fc86ee1423b5569154caa6935ce09ce03cb7531c51cd6bdb93ec988",
    "last_fetched":  "2026-06-22T01:56:21.9510185Z",
    "last_changed":  "2026-05-03T00:39:23.3260507Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-1032",
    "duplicate_role":  "primary",
    "related_files":  [

                      ],
    "generated_explanation":  true,
    "explanation_last_generated":  "2026-06-22T01:56:21.9510185Z"
}