Holds accepted project context, definitions, domain facts, constraints already reviewed, and current operating assumptions.
| File | .uai/context.uai |
|---|---|
| Category | Active project memory files |
| Required status | Required for Project Handoff packages and project/developer packages |
| Main reader | Receiving AI and project reviewer |
| Update frequency | After reviewed facts change or new accepted context becomes necessary for future work. |
| Human review requirement | Required for facts that affect public claims, ownership, architecture, security, legal posture, or user commitments. |
| No-op trigger type | Unreviewed context, stale domain fact, source conflict, or contradiction with world-context.uai. |
What this file is
context.uai is a bounded UAIX memory record. It is meant to be read before action, compared against related package files, and updated only through a reviewed package-memory change.
Why necessary
The file keeps this class of knowledge explicit instead of burying it in chat history, private assumptions, or stale generated summaries.
When required
Required for Project Handoff packages and project/developer packages.
What belongs
- Accepted current facts for the declared package scope.
- Source, owner, reviewer, or evidence pointers needed to verify the record.
- No-op or escalation triggers that protect the package boundary.
- Compact instructions the next reader can act on without guessing.
What does not belong
- Raw chat dumps, unresolved brainstorming, or unreviewed generated summaries.
- Secrets, private credentials, personal data beyond the declared minimum, or unsupported public claims.
- Rules that belong in a more specific file such as taboo.uai, constraints.uai, test-plan.uai, or deployment-memory-and-test-report.uai.
- Historical notes that should live in archives until reviewed and promoted.
How receiving AI should use it
- Read it before acting in the scope it controls.
- Compare it with identity.uai, world-context.uai, totem.uai, taboo.uai, and short-term-memory.uai before trusting it as current.
- Use the no-op trigger as a stop point when the file is missing, stale, contradictory, or outside the declared package profile.
- Record any update in short-term-memory.uai and the package changelog when the change affects future agents.
How human reviewer should use it
- Confirm the file states a concrete required scope rather than a softer invitation to read it.
- Check that current facts have an owner, evidence path, or review source.
- Confirm outdated material was moved to archives or replaced with a dated current record.
- Reject vague language that lets agents ignore package-critical material.
Scenario examples
- A receiving agent opens a Project Handoff package and uses this record to decide whether work may proceed.
- A reviewer sees a contradiction between files and uses the no-op trigger to require clarification before release.
- A maintenance pass promotes a reviewed fact into this file and retires the stale note from active memory.
No-op and human-review triggers
- Missing file for its declared required scope.
- Conflict with universal launch-baseline files.
- Current package work depends on an unreviewed fact.
- The file claims authority beyond its declared profile, mode, package type, or capability.
Update and maintenance rules
- Keep entries short enough to be read at startup.
- Date meaningful updates and record why the change happened.
- Move stale detail to archives after accepted current facts are captured.
- Align generated exports and human-facing memory after changes.
Relationship to other .uai files
- identity.uai names the package and owner.
- world-context.uai locates the operating environment.
- totem.uai and taboo.uai anchor mission and boundaries.
- short-term-memory.uai points to the newest active state.
Minimal example
# context.uai
file: .uai/context.uai
required_status: Required for Project Handoff packages and project/developer packages
owner: human-reviewed owner or steward
current_state: accepted current record for this package scope
no_op_trigger: Unreviewed context, stale domain fact, source conflict, or contradiction with world-context.uai.
evidence: link or local pointer to reviewed source
last_reviewed: YYYY-MM-DDCompleteness checklist
- Required status names the exact scope.
- Owner or reviewer is clear.
- Current facts match related .uai files.
- No-op triggers are concrete.
- Stale material has an archive or replacement path.
Common mistakes
- Using softer language that agents treat as skippable.
- Mixing current truth with raw source intake.
- Letting the file contradict another required record.
- Leaving no review path for high-impact changes.
Related UAIX records
Machine-readable digest
Agents should treat this digest as page-orientation evidence, not runtime authority.