Documents runtime versions, frameworks, plugins, dependencies, hosting assumptions, service boundaries, and integration shape.
| File | .uai/stack.uai |
|---|---|
| Category | Developer and release evidence files |
| Required status | Required for project/developer packages that declare runtime, framework, hosting, or dependency stack |
| Main reader | Developer agent, reviewer, operator |
| Update frequency | When runtimes, dependencies, hosting, plugins, frameworks, or integration boundaries change. |
| Human review requirement | Required before dependency, hosting, or runtime changes drive implementation or deployment. |
| No-op trigger type | Unknown dependency, stale runtime, missing host boundary, or tool action against the wrong stack. |
What this file is
stack.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/developer packages that declare runtime, framework, hosting, or dependency stack.
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
# stack.uai
file: .uai/stack.uai
required_status: Required for project/developer packages that declare runtime, framework, hosting, or dependency stack
owner: human-reviewed owner or steward
current_state: accepted current record for this package scope
no_op_trigger: Unknown dependency, stale runtime, missing host boundary, or tool action against the wrong stack.
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.