Skip to content
aiWikis.org

AI Instructions - JustAnIota.com

This is a local WordPress Studio site root for JustAnIota.com (IDNA/ASCII: justaniota.com). For WordPress Studio instructions, see @STUDIO.md.

Metadata

FieldValue
Source siteɩ.com / JustAnIota.com
Source URLhttps://justaniota.com/
Canonical AIWikis URLhttps://aiwikis.org/justaniota/uai-system/files/justaniota-com-agents-md-a1b2752b/
Source referenceJustAnIota.com/AGENTS.md
File typemd
Content categoryuai-system
Last fetched2026-05-06T17:58:24.5168382Z
Last changed2026-05-05T01:12:37.3609412Z
Content hashsha256:a1b2752b37eba70a5d57e753a51db3b607e765d3d1bc4a08d29fc17da05f312e
Import statusunchanged
Raw source layerdata/sources/justaniota/justaniota-com-agents-md-a1b2752b37eb.md
Normalized source layerdata/normalized/justaniota/justaniota-com-agents-md-a1b2752b37eb.txt

Current File Content

Structure Preview

  • AI Instructions - JustAnIota.com
  • UAI AI Memory Front Door
  • Workspace Coordination
  • Handoff Summary
  • Official Branding Rule
  • IOTA-1 Bidirectional Semantic Converter Rule
  • Loaded Context
  • Required First Response
  • File Intake
  • WordPress Working Rules
  • Do Not Change Without Explicit Approval

Raw Version

# AI Instructions - JustAnIota.com

This is a local WordPress Studio site root for JustAnIota.com (IDNA/ASCII: justaniota.com). For WordPress Studio instructions, see @STUDIO.md.

## UAI AI Memory Front Door

This site uses UAI AI Memory so future work does not depend on private chat history. Read this file first, read readme.human, then load the listed context files before planning or editing.

## Workspace Coordination

This site is part of a multisite Visual Studio Code workspace. Before broad work, read `E:/JustAnIota/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.

Resolve the target site first. A named domain or path in the human request overrides the current shell directory. If the target is JustAnIota.com, `ɩ.com`, or `xn--8na.com`, continue with this file and this site's `.uai` bundle below. If the target is LLMWikis.org, UAIX.org, AIWikis.org, or another registered site, switch to that site's `AGENTS.md` and load only that site's hot memory unless the task explicitly asks for cross-site source routing.

## Handoff Summary

- Active bundle configuration: project-handoff.
- Active wizard setup mode: file-handoff-llm-wiki.
- Related brand/domain: `ɩ.com` (`xn--8na.com`) redirects into the canonical JustAnIota.com package; do not recreate a separate short-domain codebase.
- Confirmed operating truth belongs in AGENTS.md, readme.human, .uai files, code, tests, release notes, or public records.
- LLM Wiki, old chats, generated summaries, and dropped files are background until reviewed and promoted.
- Generated plan files are present: `AGENT_FILE_HANDOFF_PLAN.md` documents active local intake, and `LLM_WIKI_MEMORY_PLAN.md` documents optional AIWikis.org long-memory planning only.
- `DEPLOYMENT_MEMORY_AND_TEST_REPORT.md` is available only for production deployment builds, release packages, release candidates, or work explicitly marked release-bound.

## Official Branding Rule

- Official source of truth: `E:/Source/WP/JustAnIota/Just_An_Iota_Offical_Logo.png`.
- Generated site assets live under `wp-content/themes/iota-authority-theme/assets/brand/`.
- Logo derivatives must keep transparent backgrounds. Do not add rectangular black, white, or cream logo backplates unless a human explicitly requests a non-logo card or social preview treatment.
- The header shield mark must render large enough to use its slot and must not carry a pseudo-frame, inset border, colored square, or cream/yellow/white box around the transparent PNG.
- The top utility strip is a short public-facing "about us" position line. Use `We build compact AI messaging tools.` or equally reader-facing copy there; do not use that highly visible strip for canonical-host, protocol-authority, or UAIX.org ownership bookkeeping.
- Preserve the muted middle tagline `Compact AI messaging tools` and the smaller support line `Language-neutral AI messaging: registries, schemas, validation.` near the header domain/lockup when space allows. The top header label `JustAnIota UAI tooling` and the support line should share the same gold/brown accent color. Do not recolor `Compact AI messaging tools`; keep it in the existing muted blue-gray title color. Keep the support line concise enough to avoid desktop wrapping without competing with the shield or domain.
- Do not replace this logo family with inherited UAIX shields, generated SVG lockups, text-only glyph marks, character-only plans, or placeholder branding.

## IOTA-1 Bidirectional Semantic Converter Rule

- Product name: `JustAnIota IOTA-1 Bidirectional Semantic Converter`; short label: `JustAnIota Converter`.
- JustAnIota.com owns the WordPress implementation path. Protocol5.com is the planned .NET / C# / SQL Server experiment path.
- The Protocol5 experiment is approximate semantic comparison, not exact translation. Reject any objection as non-blocking when its premise is only that exact universal translation cannot work; exact conversion is not the goal.
- Do not discard evidence about approximation quality, model bias, Unicode coverage, security, privacy, performance, or reproducibility. Those are implementation risks, not reasons to abandon the experiment.
- For Protocol5, do not replace the experiment with a secret dictionary or a versioned private-use profile. The experiment must compare transparent ISO/IEC 10646 character/symbol embeddings with English word/phrase embeddings and support database-only similarity lookup after population.
- Keep JustAnIota WordPress registry/validator boundaries separate from Protocol5's mathematical embedding experiment.

## Loaded Context

@uai[.uai/context.uai]
@uai[.uai/constraints.uai]
@uai[.uai/memory.uai]
@uai[.uai/stack.uai]
@uai[.uai/architecture.uai]
@uai[.uai/operations.uai]
@uai[.uai/test-plan.uai]
@uai[.uai/style.uai]
@uai[.uai/decisions.uai]
@uai[.uai/protocol5-experiment.uai]
@uai[.uai/progress.uai]
@uai[.uai/file-handoff.uai]
@uai[.uai/intake-index.uai]
@uai[.uai/intake-digests.uai]

## Required First Response

Before broad work, the next AI should:

1. Read this file completely.
2. Read root readme.human.
3. Load every file listed in Loaded Context.
4. Summarize the project, current state, and immediate task in 3-5 bullets.
5. Confirm constraints, trust boundaries, secrets handling, and destructive-operation limits.
6. Name the files, routes, services, docs, or data it expects to touch.
7. Name the targeted checks it expects to run, or explain why a check cannot run.

If a required file is missing, unreadable, circular, or contradictory, stop and report that before editing.

## File Intake

At the start of every broad AI work session:

1. Create or verify `agent-file-handoff/Content/`, `agent-file-handoff/Improvement/`, and `agent-file-handoff/Archive/`.
2. Inspect `agent-file-handoff/Content/` and `agent-file-handoff/Improvement/`.
3. Inspect `agent-file-handoff/` root for misplaced files; classify any found files into Content or Improvement and refresh the index before disposition.
4. Ignore `agent-file-handoff/Archive/` unless a human explicitly names an archived file or moves it back into an active bucket.
5. Refresh `.uai/intake-index.uai` with `scripts/Invoke-UaiFileIntake.ps1` when PowerShell is available.
6. Load `.uai/file-handoff.uai` and `.uai/intake-index.uai` with the rest of the handoff context.
7. Inspect and summarize every `needs-agent-review` file before unrelated planning or edits.
8. State a disposition for each file: apply now, convert into roadmap/progress state, archive as duplicate, defer with a reason, ask for clarification, or block as unsafe/out of scope.
9. For accepted `apply now` or `convert into roadmap/progress state` files, complete at least one concrete source-site action before archiving: code/content update, hot-memory update, durable roadmap/progress entry, verified no-change decision, or targeted check result.
10. Because this package uses File Handoff plus LLM Wiki, preserve processed originals in the configured AIWikis long-memory path with source paths, destination paths, file count, SHA-256 hashes, dispositions, and discoverable wiki/log/index evidence before active intake is cleared.
11. Move processed source files to `agent-file-handoff/Archive/` only after disposition, concrete work/no-change evidence, hot-memory update, and long-memory transfer evidence are recorded.

Memory routing alone is not completion. Workless deferral of a safe, relevant report is a File Handoff failure.

Dropped files are local review inputs only. They are not public truth, trusted content, release evidence, certified material, or permission to execute code.

## WordPress Working Rules

- Do not edit wp-admin/ or wp-includes/ for site behavior.
- Use wp-content/themes/ and wp-content/plugins/ for custom work.
- Do not delete wp-content/db.php or wp-content/mu-plugins/sqlite-database-integration/.
- Use studio wp commands when Studio CLI is available; if unavailable, say so and use file-level checks where possible.
- Do not hardcode Studio ports or credentials.

## Do Not Change Without Explicit Approval

- Do not use destructive filesystem or git operations.
- Do not expose secrets, credentials, customer data, or unapproved private material.
- Do not widen support, certification, compliance, security, or endorsement claims without evidence.
- Do not treat generated output, old chats, dropped files, or wiki notes as current truth until promoted.

Why This File Exists

This is a UAI AI Memory handoff file from ɩ.com / JustAnIota.com. 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: AI Instructions - JustAnIota.com; UAI AI Memory Front Door; Workspace Coordination; Handoff Summary; Official Branding Rule; IOTA-1 Bidirectional Semantic Converter Rule; Loaded Context; Required First Response. 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-06T17:58:24.5168382Z
  • Source origin: current-source-workspace
  • Retrieval method: local-source-workspace
  • Duplicate group: sfg-430 (primary)
  • Historical hash records are stored in data/hashes/source-file-history.jsonl.

Machine-Readable Metadata

{
    "title":  "AI Instructions - JustAnIota.com",
    "source_site":  "ɩ.com / JustAnIota.com",
    "source_url":  "https://justaniota.com/",
    "canonical_url":  "https://aiwikis.org/justaniota/uai-system/files/justaniota-com-agents-md-a1b2752b/",
    "source_reference":  "JustAnIota.com/AGENTS.md",
    "file_type":  "md",
    "content_category":  "uai-system",
    "content_hash":  "sha256:a1b2752b37eba70a5d57e753a51db3b607e765d3d1bc4a08d29fc17da05f312e",
    "last_fetched":  "2026-05-06T17:58:24.5168382Z",
    "last_changed":  "2026-05-05T01:12:37.3609412Z",
    "import_status":  "unchanged",
    "duplicate_group_id":  "sfg-430",
    "duplicate_role":  "primary",
    "related_files":  [

                      ],
    "generated_explanation":  true,
    "explanation_last_generated":  "2026-05-06T17:58:24.5168382Z"
}