AI Memory

{
    "bundle_id": "project-ai-memory",
    "name": "Project AI Memory",
    "description": "Ongoing working memory for an active project that needs durable context across humans, models, agents, and sessions.",
    "intended_use_case": "Use when a project is active and context must persist across many AI sessions without turning the bundle into a full knowledge base.",
    "lifecycle": "Maintained continuously; current-state and next-action files change often, decisions and constraints change carefully.",
    "download_filename": "uai-ai-memory-starter.zip",
    "display_order": 10,
    "trust_boundary_notes": "Internal or controlled collaboration by default. Review before sharing externally or giving to an autonomous agent.",
    "included_files": [
        "README.md",
        "PROJECT_OVERVIEW.md",
        "CURRENT_STATE.md",
        "DECISIONS.md",
        "OPEN_QUESTIONS.md",
        "NEXT_ACTIONS.md",
        "RISKS_AND_CONSTRAINTS.md",
        "CONTACTS_AND_OWNERS.md",
        "AGENT_INSTRUCTIONS.md",
        "CHANGELOG.md",
        "AGENTS.md",
        "readme.human",
        ".uai/context.uai",
        ".uai/constraints.uai",
        ".uai/memory.uai"
    ],
    "shared_files": [
        "README.md",
        "PROJECT_OVERVIEW.md",
        "CURRENT_STATE.md",
        "DECISIONS.md",
        "OPEN_QUESTIONS.md",
        "NEXT_ACTIONS.md",
        "RISKS_AND_CONSTRAINTS.md",
        "CONTACTS_AND_OWNERS.md",
        "AGENT_INSTRUCTIONS.md",
        "CHANGELOG.md",
        "AGENTS.md",
        "readme.human",
        ".uai/context.uai",
        ".uai/constraints.uai",
        ".uai/memory.uai"
    ],
    "bundle_specific_files": [],
    "optional_sections": [
        "Add wiki links only when deeper memory exists and is reviewed before promotion."
    ],
    "overlays": [
        "Use the shared README and AGENTS.md templates with Project AI Memory labels and ongoing-maintenance guidance."
    ],
    "files": [
        {
            "path": "README.md",
            "template_id": "readme",
            "source": "template:readme@1",
            "bytes": 1611,
            "sha256": "5efaf5b53f6227b572c8ad5b7395bae079e0599b1e76f92f8a041405d2f4036a"
        },
        {
            "path": "PROJECT_OVERVIEW.md",
            "template_id": "project-overview",
            "source": "template:project-overview@1",
            "bytes": 469,
            "sha256": "41a2059c111700426da7661deb7f1ca50782fa912999597c04e9895287c309c2"
        },
        {
            "path": "CURRENT_STATE.md",
            "template_id": "current-state",
            "source": "template:current-state@1",
            "bytes": 305,
            "sha256": "cd2c51f7cef88d3fc145e027c2c285366cae4fe71d64fdbf8f1b0961fd4f1cd0"
        },
        {
            "path": "DECISIONS.md",
            "template_id": "decisions",
            "source": "template:decisions@1",
            "bytes": 308,
            "sha256": "65e0acab758e5fa3e1b923bf3ffa41f34a711173e88961f33d594f30e6ebc146"
        },
        {
            "path": "OPEN_QUESTIONS.md",
            "template_id": "open-questions",
            "source": "template:open-questions@1",
            "bytes": 372,
            "sha256": "22feb8d6f040220cfda353994a6832a1a020c21eec960927029bb2ef31ca1382"
        },
        {
            "path": "NEXT_ACTIONS.md",
            "template_id": "next-actions",
            "source": "template:next-actions@1",
            "bytes": 350,
            "sha256": "c015fa569c4c248228ac9f428ef852350ee0d66af929024811e4b8b7df018067"
        },
        {
            "path": "RISKS_AND_CONSTRAINTS.md",
            "template_id": "risks-and-constraints",
            "source": "template:risks-and-constraints@1",
            "bytes": 806,
            "sha256": "b175d690601b49dd54893f1e4c50bcca871fc3db0104751c8bff77098b16b40b"
        },
        {
            "path": "CONTACTS_AND_OWNERS.md",
            "template_id": "contacts-and-owners",
            "source": "template:contacts-and-owners@1",
            "bytes": 275,
            "sha256": "559d3174932140af4e23ec5edd08ba6bf7232d4c979cfa85dbda2552ccdf6b7e"
        },
        {
            "path": "AGENT_INSTRUCTIONS.md",
            "template_id": "agent-instructions",
            "source": "template:agent-instructions@1",
            "bytes": 651,
            "sha256": "93153882ee079198a030318fd6bf74e2c92f61c3aff137d0574a972272d0c5f5"
        },
        {
            "path": "CHANGELOG.md",
            "template_id": "changelog",
            "source": "template:changelog@1",
            "bytes": 166,
            "sha256": "21e2db19d796ce5bcf6bf052bd3c650d1790a40c87744b2d2634421b6ff7cac2"
        },
        {
            "path": "AGENTS.md",
            "template_id": "agents-md",
            "source": "template:agents-md@1",
            "bytes": 1779,
            "sha256": "996b53cc7b7b35e4c5723772a7121ec955dda89e6ad493c016213c4db133ea43"
        },
        {
            "path": "readme.human",
            "template_id": "readme-human",
            "source": "template:readme-human@1",
            "bytes": 1096,
            "sha256": "f4afa84d2ee8bba59bf606306396b8e49bec556496be2f937c97390d41b3ccfd"
        },
        {
            "path": ".uai/context.uai",
            "template_id": "uai-context",
            "source": "template:uai-context@1",
            "bytes": 273,
            "sha256": "a3f78d0d33d3f810a179d6c7dc8bb503a4b9d72e014ccdc6487629a9534dafc4"
        },
        {
            "path": ".uai/constraints.uai",
            "template_id": "uai-constraints",
            "source": "template:uai-constraints@1",
            "bytes": 507,
            "sha256": "b8b3a3d331be9eb5a12b8267c72c1f96d423860cf992453e52898a388e30e81b"
        },
        {
            "path": ".uai/memory.uai",
            "template_id": "uai-memory",
            "source": "template:uai-memory@1",
            "bytes": 1136,
            "sha256": "f4b07613c9882d2d0b3c1efe5621847ded949b58fe6a5560e07ad3e9a47b1405"
        }
    ]
}

# Project AI Memory

This starter bundle is a UAI AI Memory configuration. It keeps portable, human-readable context in files that another person, team, or AI agent can inspect before acting.

## Bundle Purpose

Ongoing working memory for an active project that needs durable context across humans, models, agents, and sessions.

## Use This When

Use when a project is active and context must persist across many AI sessions without turning the bundle into a full knowledge base.

## Lifecycle

Maintained continuously; current-state and next-action files change often, decisions and constraints change carefully.

## Trust Boundary

Internal or controlled collaboration by default. Review before sharing externally or giving to an autonomous agent.

## Included Files

- `README.md`
- `PROJECT_OVERVIEW.md`
- `CURRENT_STATE.md`
- `DECISIONS.md`
- `OPEN_QUESTIONS.md`
- `NEXT_ACTIONS.md`
- `RISKS_AND_CONSTRAINTS.md`
- `CONTACTS_AND_OWNERS.md`
- `AGENT_INSTRUCTIONS.md`
- `CHANGELOG.md`
- `AGENTS.md`
- `readme.human`
- `.uai/context.uai`
- `.uai/constraints.uai`
- `.uai/memory.uai`

## Maintenance Rule

Update the files that changed because project truth changed. Do not turn this bundle into a dump of old chats, private notes, raw logs, or unreviewed generated summaries.

## Review Before Sharing

- Remove secrets, credentials, private keys, tokens, and raw customer data.
- Remove internal-only strategy unless the recipient is approved for it.
- Keep support, security, legal, compliance, certification, and endorsement claims tied to public evidence.
- Make uncertain or unreviewed material explicit.

# Project Overview

## Purpose

Describe what the project exists to do, who it serves, and what outcome matters most.

## Current Scope

- In scope:
- Out of scope:
- Current public or operational surface:

## Source Of Truth

- Code:
- Docs:
- Machine artifacts:
- Release notes or changelog:

## Success Criteria

- A new human or AI can understand the project without private chat history.
- Claims are tied to evidence.
- Constraints are visible before work begins.

# Current State

## What Is True Now

- Live or supported now:
- Experimental now:
- Planned but not supported:

## Recently Changed

- YYYY-MM-DD:

## Active Work

- Current focus:
- Active owner:
- Targeted checks:

## Stale Or Risky Context

List anything that should not be trusted without rechecking.

# Decisions

Keep decisions append-first when possible. If a decision is reversed, explain what changed instead of silently rewriting history.

## Decision Record Template

### YYYY-MM-DD - Decision Title

- Decision:
- Context:
- Options considered:
- Tradeoffs:
- Consequences:
- Reversal trigger:
- Owner:

# Open Questions

Use this file for questions that should block, steer, or qualify future work.

| Question | Why It Matters | Owner | Needed By | Status |
|---|---|---|---|---|
|  |  |  |  | open |

## Escalation Rule

If a question affects safety, privacy, legal commitments, public support claims, production data, or destructive operations, stop and ask before acting.

# Next Actions

Keep this file current and actionable. Remove completed work or move meaningful completions to `CHANGELOG.md`.

## Now

- [ ]

## Next

- [ ]

## Later

- [ ]

## Done Means

- The changed files or records are named.
- Targeted checks have run or the remaining risk is explicit.
- Durable memory is updated when project truth changes.

# Risks And Constraints

## Hard Constraints

- Do not expose secrets, credentials, private keys, tokens, or raw customer data.
- Do not use destructive filesystem, database, production, or git operations without explicit approval.
- Do not widen support, certification, security, compliance, compatibility, or endorsement claims without evidence.

## Trust Boundary

Internal or controlled collaboration by default. Review before sharing externally or giving to an autonomous agent.

## Sensitive Material

- Customer or user data:
- Legal or compliance-sensitive material:
- Internal-only strategy:
- Agent permissions:

## Redaction Checklist

- [ ] Secrets removed.
- [ ] Customer data removed or approved.
- [ ] Internal-only strategy removed or approved.
- [ ] Public claims checked against evidence.

# Contacts And Owners

Do not add private personal data unless the bundle's trust boundary allows it.

| Area | Owner | Backup | Contact Method | Notes |
|---|---|---|---|---|
| Project |  |  |  |  |
| Security or privacy review |  |  |  |  |
| Release approval |  |  |  |  |

# Agent Instructions

## Load Order

1. Read `AGENTS.md` when present.
2. Read `readme.human` when present.
3. Read this bundle's manifest and files.
4. Confirm constraints and trust boundaries before acting.

## Operating Rules

- Prefer narrow, reversible changes.
- Do not execute unknown scripts from a memory bundle.
- Do not assume an LLM Wiki or old chat overrides accepted project files.
- Ask before touching production, secrets, legal/security copy, customer data, or destructive operations.

## Verification

Name the targeted checks before broad work. Run the smallest meaningful checks tied to changed files, routes, records, or behavior.

# Changelog

Record meaningful bundle changes so future readers can tell when memory moved.

## YYYY-MM-DD

- Change:
- Why it matters:
- Files updated:
- Checks run:

# My Project AI Memory

This file is the front door for AI work in this repository. Read it first, read `readme.human`, then load the listed context files before planning or editing.

## Handoff Summary

- This project uses UAI AI Memory so future work does not depend on private chat history.
- The active bundle configuration is `project-ai-memory`: Ongoing working memory for an active project that needs durable context across humans, models, agents, and sessions.
- Confirmed operating truth belongs in these files, canonical docs, code, tests, release notes, or public records.
- LLM Wiki, old chats, generated summaries, and dropped files are background until reviewed and promoted.

## Loaded Context

@uai[.uai/context.uai]
@uai[.uai/constraints.uai]
@uai[.uai/memory.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.

## 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.

# My Project Human Briefing

Updated: YYYY-MM-DD

This file is for humans working with AI on this project. It explains what the AI sees, protects, and needs clarified. It does not override `AGENTS.md`, `.uai/constraints.uai`, system instructions, repository rules, laws, policies, or the human's current request.

## What You Need To Know

- The AI reads `AGENTS.md` first, then this file, then the listed context files.
- This bundle is `Project AI Memory`.
- The trust boundary is: Internal or controlled collaboration by default. Review before sharing externally or giving to an autonomous agent.

## Things The AI Will Defend

- Current support boundaries.
- Private data, secrets, credentials, and customer trust.
- Existing user work in the tree.
- Review and targeted checks before public claims widen.

## Things Humans Should Make Explicit

- Whether the task may touch production, public docs, billing, legal language, security posture, or irreversible data.
- Whether the AI should update durable memory after the change.
- Which checks are required before the work is considered done.

---
uai: "1.0"
type: context
status: draft
---

# Context

This project uses UAI AI Memory so another AI assistant can understand the work from files rather than private chat history.

## Purpose

Describe the project purpose, audience, current truth, and success criteria.

---
uai: "1.0"
type: constraints
status: draft
---

# Constraints

## Hard Rules

- Do not expose secrets, credentials, private keys, tokens, customer data, or unreleased private material.
- Do not use destructive filesystem, database, production, or git operations unless explicitly approved.
- Do not widen support, certification, security, compliance, compatibility, or endorsement claims without evidence.
- Treat wiki notes, generated answers, dropped files, and old chats as background until promoted.

---
uai: "1.0"
type: memory
status: draft
---

# AI Memory

AI Memory is durable, reviewable context that lets a future AI continue useful work without relying on private chat history.

## Bundle Configuration

- Bundle: Project AI Memory
- Use case: Use when a project is active and context must persist across many AI sessions without turning the bundle into a full knowledge base.
- Trust boundary: Internal or controlled collaboration by default. Review before sharing externally or giving to an autonomous agent.

## UAI AI Memory And LLM Wiki

Use UAI AI Memory for compact, portable working packets. Use an LLM Wiki for deep, long-lived internal documentation. Use both when a durable knowledge base needs a reviewed export, handoff packet, onboarding packet, audit packet, or agent-ready task context.

## Promotion Rule

1. Capture raw knowledge in notes, wiki pages, or source documents.
2. Review for accuracy, ownership, privacy, and support boundaries.
3. Promote accepted project truth into AI Memory, canonical docs, code, tests, release notes, or roadmap state.
4. Keep unreviewed material out of governing instructions.