# Mosaic Stack concepts

These pages explain Mosaic's own concepts and design direction. Each states its
implementation status. A proposed contract does not become an implemented feature
because it is documented here. Current demo compatibility and ACT-1's migration
gates remain in force.

| Concept | What it explains |
|---|---|
| [Agent personality](soul.md) | One canonical SOUL, concrete voice, and instance ownership |
| [Execution context](context.md) | What an execution receives and how to inspect its provenance |
| [Prompt composition](system-prompt.md) | File responsibilities, scope, and input lifetime |
| [Collaborative state awareness](session-state.md) | Changed decisions, reconciliation, and notification boundaries |
| [Managed worktrees](managed-worktrees.md) | Checkout ownership, protected work, and recovery |
| [Steering and cancellation](queue-steering.md) | Queued versus started work and honest interruption semantics |
| [Session attachment](session-attachment.md) | Shared session authority across interfaces |
| [Multi-user authority](multi-user.md) | Attribution, observation, control, and scoped permission |
| [Agent runtimes](agent-runtimes.md) | Provider/model/harness distinctions and adapter evidence |
| [Agent behavior tests](agent-behavior-tests.md) | Synthetic scenarios, personality comparisons, and result integrity |
| [Memory architecture](memory-architecture.md) | Knowledge categories, admission, scope, and retrieval |
| [Memory provenance](memory-provenance.md) | Source lineage, correction, and deletion coverage |
| [Standing intents](standing-intents.md) | Events, schedules, aspirations, and real wake ownership |

Implementation work belongs in [ACT-1](../plans/2026-09-07_agent-context-templates-and-migration.md)
and related foundation plans. Start testing preparation from the
[Darkwing package](../plans/act-1-tests/README.md).

This directory is the home for conceptual explanations. `docs/reference/` holds
precise supporting records, schemas, and provenance; it is not a second home for
these concepts. [Source attribution](../reference/concepts/README.md) preserves
the origin and license of material adapted into this set.