Carries the compact next-loop resume prompt for code-bearing agents without replacing authoritative .uai records or current human instruction.
| File | .uai/next-recursive-prompt.uai |
|---|---|
| Category | Developer and release evidence files |
| Required status | next-recursive-prompt.uai is required for agents that deal with code, automation, executable workflows, or code-like artifacts. It is not required for agents that don't deal with any coding. |
| Main reader | Developer agent, automation agent, workflow agent, and reviewer |
| Update frequency | After meaningful work, test results, blockers, deployment, handoff, intake processing, or context compaction. |
| Human review requirement | Required when the next-loop prompt changes release scope, authority, public claims, or deployment actions. |
| No-op trigger type | Missing, stale, invalid, contradictory, or evidence-broken next-recursive prompt in a required code-bearing scope. |
next-recursive-prompt.uai is not required for agents that don't deal with any coding.
What this file is
A derived hot-memory resume artifact using canonical JSON profile uaix.next-recursive-prompt.v1. It is not a second source of truth.
Why necessary
Recursive coding sessions often lose the exact next work chunk after compaction or handoff. This file keeps the next loop executable while forcing authoritative records to win on conflict.
When required
next-recursive-prompt.uai is required for agents that deal with code, automation, executable workflows, or code-like artifacts. It is not required for agents that don't deal with any coding..
What belongs
- The next safe work chunk and acceptance evidence.
- Authoritative source references to read before acting.
- Checks to run and blocked-recovery behavior.
- Refresh triggers and writeback targets for the next loop.
What does not belong
- Secrets, credentials, access tokens, private keys, or private incident details.
- Durable project truth that belongs in short-term memory, progress, decisions, constraints, test-plan, stack, or architecture records.
- Raw chat logs, broad speculation, or stale history that belongs in archives.
- A YAML mirror or alternate source of truth.
How receiving AI should use it
- Read authoritative_refs before using the prompt.
- Use the stored plan when the user asks to continue, keep going, do the next thing, resume, proceed, or otherwise continues the recorded next loop.
- When the current request directly relates to the stored next loop, review this file for useful plan ideas before discarding or superseding it.
- When the user gives a specific unrelated instruction, current user instruction governs the turn and this file is regenerated after accepted work.
- Treat the file as derived hot-memory only.
- If it conflicts with authoritative .uai records, stop and regenerate it from those records.
- Fail closed or enter blocked recovery when the file is stale, invalid, contradictory, or points to missing evidence in a required code-bearing scope.
How human reviewer should use it
- Confirm the file is JSON with profile uaix.next-recursive-prompt.v1.
- Confirm it names the exact next work chunk, checks, blockers, and update targets.
- Confirm no secret or private credential is present.
- Confirm it does not override authoritative .uai records.
Scenario examples
- After a long coding pass, regenerate the file so the next agent can continue without replaying the full transcript.
- When a human says keep going, use it to recover the next work chunk after reviewing authoritative memory.
- When a human asks for an unrelated task, review it only for relevant context, then follow the current request and regenerate afterward.
- After a failed test run, record the blocker and the next recovery step.
- After processing active intake, point the next loop at the updated ledger and remaining work.
No-op and human-review triggers
- The file is required but absent from a code-bearing package.
- The file is not valid JSON or does not use profile uaix.next-recursive-prompt.v1.
- The next-loop prompt contradicts short-term memory, progress, constraints, coding standards, stack, architecture, or test-plan.
- The file contains secrets or unsupported public claims.
Update and maintenance rules
- Regenerate after meaningful work, test results, blockers, deployment, handoff, intake processing, and context compaction.
- Keep bulky history in archives and preserve only the current next-loop slice here.
- Write accepted current truth into authoritative .uai records first, then regenerate this file from those records.
Relationship to other .uai files
- Derived from AGENTS.md, identity, world-context, Totem, Taboo, short-term memory, startup packet, system profile, receiver brief, coding standards, stack, architecture, context, constraints, progress, current state, next actions, test plan, and manifest.
- Short-term memory keeps current truth; this file keeps the next recursive prompt.
- Progress and test-plan carry evidence; this file points to the next action and checks.
Minimal example
# next-recursive-prompt.uai
file: .uai/next-recursive-prompt.uai
required_status: next-recursive-prompt.uai is required for agents that deal with code, automation, executable workflows, or code-like artifacts. It is not required for agents that don't deal with any coding.
owner: human-reviewed owner or steward
current_state: accepted current record for this package scope
no_op_trigger: Missing, stale, invalid, contradictory, or evidence-broken next-recursive prompt in a required code-bearing scope.
evidence: link or local pointer to reviewed source
last_reviewed: YYYY-MM-DDCompleteness checklist
- Top-level fields match uaix.next-recursive-prompt.v1.
- Authoritative refs are present and current.
- Next loop names a concrete work chunk, checks, blockers, and writeback policy.
- No secrets, private credentials, unsupported claims, or stale instructions are present.
Common mistakes
- Using it as a second source of truth.
- Letting it override a newer unrelated human instruction.
- Discarding a related stored plan without reviewing it for useful work ideas.
- Letting it survive after authoritative records changed.
- Storing a full chat transcript instead of a compact next-loop prompt.
- Adding it to no-code assistant packages before code, automation, executable workflow, or code-like artifacts are declared or detected.
Related UAIX records
Machine-readable digest
Agents should treat this digest as page-orientation evidence, not runtime authority.