Files
stack/docs/concepts/README.md
T
jason.woltje 193479b52d docs: concept annexation, provider/reference docs, ACT-1 groundwork
Mosaic concepts pages now own the adapted content; source/license
metadata under docs/reference/concepts. Adds ACT-1 agent-context
planning capture, pinned concept test package + preparation utility,
foundation observation notes (durability, evidence, federation,
onboarding, workflow), and the #1495 consolidation assessment.
TOOLS.md updated for the host-dev launcher.
2026-09-07 14:07:05 -05:00

32 lines
2.1 KiB
Markdown

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