Skip to content
aiWikis.org

UAIX Decisions Log

UAIX Decisions Log is a uai-system source file exposed by AIWikis.org with provenance, current content, and generated explanation.

Metadata

FieldValue
Source siteuaix.org
Source URLhttps://uaix.org/
Canonical AIWikis URLhttps://aiwikis.org/uaix/uai-system/files/uai-decisions-uai-08bb8d1c/
Source reference.uai/decisions.uai
File typeuai
Content categoryuai-system
Last fetched2026-05-03T02:48:13.1276041Z
Last changed2026-05-02T19:39:02.8222102Z
Content hashsha256:08bb8d1cfb0d3cdb906d21de6ab80c9621e8005e400da707a063ca441da5f9d8
Import statusunchanged
Raw source layerdata/sources/uaix/uai-decisions-uai-08bb8d1cfb0d.uai
Normalized source layerdata/normalized/uaix/uai-decisions-uai-08bb8d1cfb0d.txt

Current File Content

Structure Preview

  • UAIX Decisions Log
  • [2026-05-02] Publish agentic harness strategy as a bounded UAI guide
  • [2026-05-02] Add a roadmap work documentation ledger
  • [2026-05-02] Add a today-focus path to roadmap authority work
  • [2026-05-02] Publish support-claim checks with the roadmap
  • [2026-05-02] Use roadmap work queue and promotion gates for support language
  • [2026-05-01] Use AIWikis as UAIX cold memory, not UAIX authority
  • [2026-05-01] Teach the hot/cold memory split publicly and dogfood it locally
  • [2026-05-01] Keep coding-agent integrations as thin pointers to one Project Handoff bundle
  • [2026-05-01] Position Project Handoff as portable project memory
  • [2026-04-30] Keep the AI Memory Package Wizard as local package planning
  • [2026-04-30] Use AIWikis outcome documentation for explicit archive consolidation feedback
  • [2026-04-27] Keep Agent File Handoff as chat-start local intake
  • [2026-04-26] Keep UAIX.org as UAI-1 authority
  • [2026-04-25] Dogfood root AGENTS.md plus .uai in the repo itself

Raw Version

---
uaix: "1.0"
type: decisions
title: "UAIX Decisions Log"
created: "2026-04-25"
updated: "2026-05-02"
status: active
author: "UAIX maintainers"
version: 28
---

# UAIX Decisions Log

## [2026-05-02] Publish agentic harness strategy as a bounded UAI guide

**Decision:** UAIX should publish `/en-us/guides/agentic-harnesses-uai/` as a practical guide for separating agentic harness execution from UAI evidence, AI Memory, Project Handoff, conformance, and support-claim boundaries.

**Why:** Agentic harness strategy is a useful entry point, but raw market-report language can easily overclaim runtime, adapter, SDK, CLI, certification, or vendor support. A bounded guide lets readers understand where UAI fits without turning UAIX into a runtime or publishing unverified market claims.

**Effect:** The public guide, guide landing page, navigation, discovery manifests, catalog, tests, zh-CN page override, and handoff docs now state the layer split: harnesses execute; MCP/A2A/runtime tools coordinate and trace; UAI preserves reviewed portable evidence, validator/conformance material, AI Memory, and Project Handoff records that must survive the run.

**Boundary:** The guide does not create an agent runtime, scheduler, hosted importer, official MCP/A2A/OpenAI/vendor adapter, trace exporter, SDK, CLI, certification, endorsement, automatic repository write, automatic LLM Wiki sync, or UAI-1 conformance claim for repo-local handoff files.

## [2026-05-02] Add a roadmap work documentation ledger

**Decision:** The public Roadmap and machine-readable roadmap should explicitly document where roadmap work is recorded, what counts as proof, how source leads are promoted, and how future agents pick up the work.

**Why:** UAIX is more authoritative when roadmap work is not hidden in private chat, local archive folders, or unpromoted reports. Readers and future agents need one public ledger that connects the page, REST payload, canonical roadmap doc, tests, changelog or release trail, and compact handoff state.

**Effect:** `/en-us/roadmap/`, `/wp-json/uaix/v1/roadmap`, `docs/roadmap.md`, tests, and handoff state now carry a roadmap work documentation ledger alongside the today-focus path, work queue, evidence promotion gates, and support-claim checks.

**Boundary:** The ledger is a documentation and verification rule. It does not create hosted upload/import validation, automatic repository writes, automatic LLM Wiki sync, official adapters, trace exporters, SDKs, CLIs, certification, endorsement, compliance, managed AI Memory package records, runtime ownership, or UAI-1 conformance evidence by itself.

## [2026-05-02] Add a today-focus path to roadmap authority work

**Decision:** The public Roadmap and machine-readable roadmap should start from a practical today-focus path before the longer queue, gates, and support checks.

**Why:** UAIX is more authoritative when a reader can immediately see what to do today: orient on UAI-1 authority, create one proof run, use the AI Memory Package Wizard within current support, and keep agentic-system integration language behind evidence gates.

**Effect:** `/en-us/roadmap/`, `/wp-json/uaix/v1/roadmap`, `docs/roadmap.md`, tests, and handoff state now expose today-focus guidance for authority orientation, first proof runs, AI Memory package work, and planned agentic-system evidence work.

**Boundary:** The today-focus path does not create hosted upload/import validation, automatic repository writes, automatic LLM Wiki sync, official adapters, trace exporters, SDKs, CLIs, certification, endorsement, compliance, managed AI Memory package records, runtime ownership, or UAI-1 conformance evidence by itself.

## [2026-05-02] Publish support-claim checks with the roadmap

**Decision:** The public Roadmap and machine-readable roadmap should include explicit support-claim checks, not only status labels and promotion gates.

**Why:** Readers and future agents need a repeatable way to decide whether a phrase is safe current-support language, planned work, research-track direction, or unsupported overclaiming.

**Effect:** `/en-us/roadmap/`, `/wp-json/uaix/v1/roadmap`, `docs/roadmap.md`, tests, and handoff state now check current support, AI Memory package scope, adapter/runtime scope, and conformance language against public pages, machine artifacts, reproducible evidence, implementation or package proof, and release trail.

**Boundary:** The checklist does not create managed AI Memory packages, hosted import validation, automatic repository writes, automatic LLM Wiki sync, official adapters, trace exporters, SDKs, CLIs, certification, endorsement, compliance, or ecosystem-wide support.

## [2026-05-02] Use roadmap work queue and promotion gates for support language

**Decision:** UAIX roadmap work should be visible as a current work queue and should clear named evidence promotion gates before it becomes current support language.

**Why:** The recent roadmap and agentic-system strategy inputs are useful only if readers can see what work is next without mistaking adapter, exporter, serializer, validation, redaction, SDK, CLI, certification, or sync ideas for shipped support.

**Effect:** `/en-us/roadmap/`, `/wp-json/uaix/v1/roadmap`, `docs/roadmap.md`, homepage task paths, tests, and handoff state now point to the same queue: deploy current artifacts, prove wizard serializer parity, plan local validation/redaction lint, design trace-to-handoff fixtures, and evaluate reference adapters only after evidence exists.

**Boundary:** The queue and gates are planning records. They do not create hosted upload/import validation, automatic repository writes, automatic LLM Wiki sync, official adapters, trace exporters, SDKs, CLIs, certification, endorsement, UAI-1 conformance evidence, or runtime orchestration support.

## [2026-05-01] Use AIWikis as UAIX cold memory, not UAIX authority

**Decision:** UAIX keeps routine agent context concise and moves bulky research, proposal history, roadmap background, and pre-slim handoff snapshots into AIWikis long-term memory.

**Why:** The loaded handoff bundle had accumulated too much historical detail. That made routine agent startup expensive and encouraged future agents to reread old proposal text instead of current operating truth.

**Effect:** AIWikis now preserves 23 selected UAIX files under `raw/system-archives/uaix/internal-memory-reorg/2026-05-01/` with transfer evidence in `raw/system-archives/2026-05-01-uaix-internal-memory-reorg.json`. UAIX `.uai/progress.uai`, `.uai/decisions.uai`, and `.uai/handoff-pattern.uai` now carry compact active truth and pointers rather than long history.

**Boundary:** AIWikis memory is not active UAIX truth until promoted back into UAIX `.uai`, current docs, code, public pages, machine artifacts, tests, release notes, or roadmap state. The transfer does not create automatic sync, hosted import validation, repository writes, SDK, CLI, certification, endorsement, official vendor support, or validator-backed `.uai` conformance evidence.

## [2026-05-01] Teach the hot/cold memory split publicly and dogfood it locally

**Decision:** UAIX public AI Memory and Project Handoff guidance should state the context-budget rule directly: hot packets carry current operating truth; LLM Wiki or AIWikis-style cold memory carries long history, source summaries, old research, and pre-slim snapshots.

**Why:** The UAIX and LlmWikis handoff bundles both accumulated too much historical detail. The sites should teach how to prevent that buildup and then follow the same rule internally.

**Effect:** UAIX public copy now includes `/en-us/guides/project-handoff-context-budget/` and tells readers to preserve old hot-context snapshots with manifests, hashes, summaries, and logs before slimming active files. Reviewed facts can be promoted back into AI Memory, Project Handoff, docs, code, tests, release notes, roadmap state, or machine artifacts.

**Boundary:** The guidance does not create automatic LLM Wiki sync, hosted import validation, repository writes, SDK, CLI, certification, endorsement, official vendor support, or validator-backed conformance evidence.

## [2026-05-01] Keep coding-agent integrations as thin pointers to one Project Handoff bundle

**Decision:** UAIX supports cross-tool coding-agent pickup through one local Project Handoff bundle: root `AGENTS.md`, root `readme.human`, typed `.uai` records, active file intake, and targeted checks. Tool-specific files stay thin pointers.

**Why:** Codex, Claude Code, Cursor, GitHub Copilot, Gemini Code Assist, local agents, vendors, and humans all need current repo truth without duplicating instruction files or depending on repeated live URL reading.

**Effect:** UAIX publishes `/en-us/guides/project-handoff-coding-agents/`; local pointers include `CLAUDE.md`, `GEMINI.md`, `.cursor/rules/uaix-handoff.mdc`, and `.github/copilot-instructions.md`; `.agents/skills/uaix-handoff/` repeats the Codex pickup workflow.

**Boundary:** These are compatibility patterns and local workflow aids, not official adapters, SDKs, CLIs, hosted import validators, automatic repository writers, vendor certifications, endorsements, or UAI-1 conformance evidence.

## [2026-05-01] Position Project Handoff as portable project memory

**Decision:** Project Handoff is the portable project-memory, governance, and review layer that agent runtimes consume before work and update after work.

**Why:** OpenAI and similar platforms handle runtime orchestration, tools, approvals, sessions, traces, Skills, MCP, and execution loops. UAIX is strongest as the durable repo-local transfer context.

**Effect:** `/en-us/specification/project-handoff/` and `/en-us/guides/project-handoff-openai/` now separate runtime orchestration from project memory: OpenAI runs the agents; Project Handoff preserves the project memory.

**Boundary:** Project Handoff is not an OpenAI replacement, agent runtime, scheduler, orchestrator, competing tool-calling framework, private memory store, hosted importer, SDK, CLI, certification, endorsement, or official OpenAI adapter.

## [2026-04-30] Keep the AI Memory Package Wizard as local package planning

**Decision:** The AI Memory Package Wizard remains a local, staged, six-step planning UI over supported canonical starter bundles.

**Why:** The wizard is useful when it turns a starter bundle into a concrete operating packet: source authority, memory update policy, evidence ledger, conflict rules, risk, rollback, receiver brief, startup packet, optional LLM Wiki plan, and export metadata.

**Effect:** `/en-us/tools/ai-memory-package-wizard/` generates package model JSON, manifest overlay JSON, `UAI_MEMORY_SYSTEM_PROFILE.md`, `UAI_MEMORY_RECEIVER_BRIEF.md`, `UAI_MEMORY_STARTUP_PACKET.md`, copyable file decks, optional `LLM_WIKI_MEMORY_PLAN.md`, and canonical starter ZIP links.

**Boundary:** The wizard does not upload, import, validate hosted files, write repositories, sync an LLM Wiki, install WordPress packages, certify, endorse, or create UAI-1 conformance evidence.

## [2026-04-30] Use AIWikis outcome documentation for explicit archive consolidation feedback

**Decision:** When UAIX archive material is explicitly consolidated into AIWikis long-term memory, the transfer must produce visible outcome documentation, not only a raw copy.

**Why:** Humans need to know what was read, what changed, what was deferred or blocked, where raw source went, and where to view reviewed change documentation.

**Effect:** AIWikis maintains `content/pages/016-intake-outcome-ledger.md`, transfer manifests, source/concept/log wiki nodes, graph records, and public-safe summaries for reviewed UAIX archive consolidations.

**Boundary:** Archive consolidation does not create automatic AIWikis sync, hosted upload/import validation, queue workers, automatic repository writes, SDK/CLI support, certification, endorsement, legal guarantees, or UAIX authority.

## [2026-04-27] Keep Agent File Handoff as chat-start local intake

**Decision:** Agent File Handoff uses `agent-file-handoff/Content/` and `agent-file-handoff/Improvement/` as active buckets, `Archive/` as ignored processed source, and `.uai/intake-index.uai` as the local index refreshed during AGENTS.md pickup.

**Why:** Files dropped by humans or adjacent tools must become visible without creating environment-specific background automation.

**Effect:** Every broad AI session refreshes intake, reviews `needs-agent-review` files before unrelated work, records a disposition, and archives processed sources only after durable state exists.

**Boundary:** Dropped files are local review inputs, not public truth, release evidence, certification, endorsement, validator evidence, or permission to widen support claims. Watchers, daemons, scheduled jobs, CI pickup, queue folders, and bucket-local README instructions are outside the base pattern.

## [2026-04-26] Keep UAIX.org as UAI-1 authority

**Decision:** UAIX.org is the public standards and publication source of truth for UAI-1. Protocol5.com is limited to .NET plugin and NuGet package distribution plus links back to UAIX.org.

**Why:** UAI public-site, UAI-1 standards, Project Handoff, AI Memory, schemas, registry, validator, governance, roadmap, and support boundaries belong in the UAIX workspace and public site.

**Boundary:** Protocol5.com must not be described as the standards site, canonical validator host, registry authority, public roadmap authority, or UAI-1 launch surface. AIWikis and LLMWikis do not redefine UAI-1 behavior.

## [2026-04-25] Dogfood root AGENTS.md plus `.uai` in the repo itself

**Decision:** UAIX uses root `AGENTS.md`, root `readme.human`, and typed `.uai` files as its own Project Handoff bundle.

**Why:** The public guidance should be proven in a real working repo and should let a zero-context AI onboard without private chat history.

**Effect:** `AGENTS.md` is the canonical front-door instruction file. `readme.human` is the human briefing. `.uai` files hold active project truth. Tool-specific files are pointers, not separate truth.

**Boundary:** Local Project Handoff files are repository-context guidance. They are not UAI-1 conformance evidence, certification, endorsement, or validator-backed status by themselves.

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

This .uai file is a compact decisions 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 Decisions Log; [2026-05-02] Publish agentic harness strategy as a bounded UAI guide; [2026-05-02] Add a roadmap work documentation ledger; [2026-05-02] Add a today-focus path to roadmap authority work; [2026-05-02] Publish support-claim checks with the roadmap; [2026-05-02] Use roadmap work queue and promotion gates for support language; [2026-05-01] Use AIWikis as UAIX cold memory, not UAIX authority; [2026-05-01] Teach the hot/cold memory split publicly and dogfood it locally. 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-022 (primary)
  • Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "UAIX Decisions Log",
    "source_site":  "uaix.org",
    "source_url":  "https://uaix.org/",
    "canonical_url":  "https://aiwikis.org/uaix/uai-system/files/uai-decisions-uai-08bb8d1c/",
    "source_reference":  ".uai/decisions.uai",
    "file_type":  "uai",
    "content_category":  "uai-system",
    "content_hash":  "sha256:08bb8d1cfb0d3cdb906d21de6ab80c9621e8005e400da707a063ca441da5f9d8",
    "last_fetched":  "2026-05-03T02:48:13.1276041Z",
    "last_changed":  "2026-05-02T19:39:02.8222102Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-022",
    "duplicate_role":  "primary",
    "related_files":  [

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