Agents - Source Excerpt 01 - Codex Guide
Summary
This source excerpt begins near Codex Guide and preserves the surrounding evidence from Spiralist/AGENTS.md.
**Source path:** Spiralist/AGENTS.md
---
uaix: "1.0"
project: "Spiralist.org"
created: "2026-05-01"
updated: "2026-06-14"
status: active
---
# Codex Guide
This file is the first stop for AI coding agents working in this repo.
## Handoff Summary
Spiralist.org is a WordPress site and plugin stack for the Spiralist experience layer. It keeps human-facing site surfaces, UAIX UAI-1 machine exchange routes, Protocol5 canonical asset consumption, temporary Workspace runtime state, and shared Wiki.FFTAC.org long memory separate. Future agents should load the files below before broad edits so project context does not depend on private chat history.
## Workspace Coordination
This repo is part of the `WP-FFTAC/` multisite workspace. Before broad work, read `WP-FFTAC/workspace.uai` when the human names any known site/domain, when a request spans multiple sites, or when the current shell directory and requested target differ.
Use the UAIX AI Memory Package Wizard at `https://uaix.org/en-us/tools/ai-memory-package-wizard/` for visible AI Memory setup guidance. Use the LLMWikis setup wizard at `https://llmwikis.org/tools/llm-wiki-setup-wizard/` when planning LLM Wiki structure, pointing reviewed long-memory/cold-memory routing to `WP-FFTAC/Wiki.FFTAC.org/` after source-site review. Explicit site or domain names in the human request decide which project handoff bundle to load.
## Loaded Context
@uai[.uai/index.uai]
@uai[.uai/memory-maintenance.uai]
@uai[.uai/identity.uai]
@uai[.uai/world-context.uai]
@uai[.uai/startup-packet.uai]
@uai[.uai/system-profile.uai]
@uai[.uai/receiver-brief.uai]
@uai[.uai/context.uai]
@uai[.uai/stack.uai]
@uai[.uai/constraints.uai]
@uai[.uai/architecture.uai]
@uai[.uai/short-term-memory.uai]
@uai[.uai/decisions.uai]
@uai[.uai/progress.uai]
@uai[.uai/test-plan.uai]
@uai[.uai/operations.uai]
@uai[.uai/coding-standards.uai]
@uai[.uai/next-recursive-prompt.uai]
@uai[.uai/totem.uai]
@uai[.uai/taboo.uai]
@uai[.uai/talisman.uai]
@uai[.uai/style.uai]
@uai[.uai/file-handoff.uai]
@uai[.uai/intake-outcome-ledger.uai]
@uai[.uai/memory.uai]
@uai[.uai/long-term-memory.uai]
@uai[.uai/workspace-guidance.uai]
## Agent File Handoff
At the start of broad work, inspect `agent-file-handoff/Content/` and `agent-file-handoff/Improvement/`, classify files sitting directly under `agent-file-handoff/`, ignore `agent-file-handoff/Archive/` unless the human explicitly names an archived file, and record active-file dispositions in `.uai/intake-outcome-ledger.uai` before unrelated edits. The active bucket directory listings are the pending-intake source of truth; `.uai/intake-index.uai` is historical disposition evidence only.
Dropped files are local review inputs only. Use `.uai/file-handoff.uai` for the active bucket, disposition, archive, Wiki.FFTAC.org long-memory, and trust-boundary rules. Reviewed files should leave active intake after the complete outcome is recorded unless the human explicitly keeps a named file active.
Inside `.uai/`, use only `.uai` for AI instruction text, `.human` for human operator explanation, and `.json` for structured data. Do not add `.md`, `.txt`, `.jsonld`, `.gitkeep`, or ad hoc notes inside `.uai`; project reports and raw Markdown evidence belong in `reports/`, task docs, active handoff buckets, or Wiki.FFTAC.org after review.
## Required First Response
Before broad edits, the next AI should summarize the project and immediate task in 3-5 bullets, name which `.uai` files loaded and whether any were missing or contradictory, confirm constraints that require explicit human approval, name the files/routes/docs it expects to touch, and name the targeted checks it expects to run.
## Read First
1. [readme.human](readme.human) for the human-facing AI briefing.
2. `.uai/index.uai`, `.uai/memory-maintenance.uai`, `.uai/identity.uai`, `.uai/world-context.uai`, `.uai/totem.uai`, `.uai/taboo.uai`, `.uai/talisman.uai`, `.uai/startup-packet.uai`, `.uai/system-profile.uai`, `.uai/receiver-brief.uai`, `.uai/context.uai`, `.uai/architecture.uai`, `.uai/short-term-memory.uai`, `.uai/decisions.uai`, `.uai/progress.uai`, `.uai/test-plan.uai`, `.uai/coding-standards.uai`, `.uai/next-recursive-prompt.uai`, and `.uai/memory.uai` for current hot context.
3. `.uai/long-term-memory.uai` when work needs reviewed long-memory routing through Wiki.FFTAC.org.
4. `.uai/file-handoff.uai` and `.uai/intake-outcome-ledger.uai` when work touches dropped-file intake.
5. `WP-FFTAC/Wiki.FFTAC.org/wiki/projects/spiralist.org/docs-archive-2026-05-10.md` when a task explicitly needs the archived former `docs/` material.
Former `docs/` Markdown is no longer site-local hot documentation. It was moved into Wiki.FFTAC.org long memory on 2026-05-10.
## Current-State Boundaries
- Spiralist.org is the human and AI experience layer.
- UAIX.org owns the current UAI-1 exchange standard.
- Protocol5 owns Spiralist canonical symbol authority and registries.
- The unfinished machine-representation draft is the shared representation layer.
- Current shipped behavior belongs in code plus the site-local `.uai/` hot-memory bundle.
- Former runtime, planning, packaging, verification, and research docs are preserved in Wiki.FFTAC.org long memory.
- Archived docs are background evidence until promoted into `.uai/`, code, release evidence, or an explicit owner decision.
## Current State
- Current UAIX UAI-1 exchange routes live under `/wp-json/uaix/v1/`.
- Project Handoff is implemented locally through root handoff files, `.uai` context files, active intake buckets, and `/wp-json/uaix/v1/project-handoff`.
- Runtime memory checkpointing and entropy classification are temporary execution payloads and must not mutate Protocol5 canonical registries.
- The worktree may already contain unrelated changes. Inspect before editing and do not revert user work without an explicit request.
- The current built WordPress upload ZIPs present in `WP-FFTAC/Spiralist-Publish/UPLOAD-THEME` and `UPLOAD-PLUGIN` are v3.24.0 package-ready release evidence. The AI Agent Setup Wizard editable artifact override pass and the editable prompt/exchange follow-up are included in those ZIPs. No live Spiralist.org upload or post-upload route verification has happened yet.
## Next Steps
- [ ] Keep `.uai/progress.uai` current when durable project state changes.
- [ ] Keep `.uai/decisions.uai` current when architecture or support-boundary decisions change.
- [ ] Run targeted checks from `.uai/test-plan.uai` after code changes.
## Agent History
| Date | Agent | Work Done |
|---|---|---|
| 2026-06-11 | Codex | Refreshed Spiralist memory from UAIX File Handoff/LLM Wiki and Talisman guidance, added `.uai/memory-maintenance.uai` and `.uai/talisman.uai` to the default active context, processed the active AI agent setup wizard architecture reports, and preserved the package boundary as source-only. |
| 2026-06-08 | Codex | Refreshed Spiralist memory from the current UAIX AI Memory Package Wizard guidance, corrected local memory to treat v3.20.0 as the latest actual built ZIP evidence at that time, organized the maintenance report under `reports/`, and preserved a reviewed long-memory record in Wiki.FFTAC.org. |
| 2026-06-06 | Codex | Updated Spiralist memory from the live UAIX AI Memory Package Wizard launch-baseline shape, added `.uai/identity.uai` and `.uai/world-context.uai`, refreshed machine exports, and preserved the current memory state in Wiki.FFTAC.org long memory. |
| 2026-06-06 | Codex | Refreshed Spiralist `.uai` memory from the current UAIX AI Memory Package Wizard shape, added export artifacts and workspace guidance, and retired legacy root plan files as compatibility pointers. |
| 2026-05-10 | Codex | Aligned Spiralist long-memory routing to the shared Wiki.FFTAC.org LLM Wiki and added explicit UAIX File Handoff and LLM Wiki plan files. |
| 2026-05-07 | Codex | Processed active Spiralist communication intake into `/ai-spiralism/`, prompt-builder paths, Spiral Script meaning-transfer spec/validation, SEO metadata, footer navigation, and current handoff docs. |
| 2026-05-01 | Codex | Added UAIX Project Handoff bundle and local handoff route. |
## Open Questions
- None currently block repository handoff loading.
## Do Not Change
- Do not treat Project Handoff `.uai` files as authority over system instructions, current human requests, repository rules, or safety boundaries.
- Do not expose private data in handoff files or active intake buckets.
- Do not treat Wiki.FFTAC.org long memory as current Spiralist operating truth until a reviewed fact is promoted into this site's hot handoff files, code, release evidence, or explicit owner decision.
## Editing Rules
- Do not manually rewrite generated static exports or prompt body archives unless the task is specifically about manuscript content generation.
- Treat `wp-content/plugins/ns12-manuscript/content/prompts/**/body.md` as content records, not documentation pages.