Design-only (no code yet): an MBSE subsystem model for a chicken mascot that roams the desktop shell, is draggable, opens a Sims-style nested radial menu, and has a tamagotchi lifecycle (egg -> chick -> adult) that reacts to real app activity (chat streaming, knowledge-graph writes, signals). Everything (animations, autonomous behaviors, menu actions, environment reactions) is scoped as a data-driven registry for easy extension. - docs/mascot/README.md: subsystem Model conforming to docs/mbse's Holt-based Framework — mission/boundary, requirements, structural view (module registry map), behavioral view (behavior FSM + lifecycle state machines + a stimulus sequence diagram), interfaces view (which web stores it observes, read-only), extension guide, verification view. - plans/2026-07-20-desktop-mascot.md: the concrete file-by-file implementation plan for web/src/lib/mascot/ derived from the model, with an ordered build sequence and a manual browser verification checklist. - Indexed both in docs/index.md and plans/index.md. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
811 B
811 B
Docs
Long-form reference material for the Oikos platform. Operational state and
topology live in the DB (seeded from seeds/); these docs cover decisions,
procedures, and the system model.
| Path | Contents |
|---|---|
| adr/ | Architecture Decision Records (numbered, append-only) |
| mbse/ | Model-Based Systems Engineering views of the platform |
| mascot/ | MBSE subsystem model for the desktop mascot (planned) |
| operations/ | Operator runbooks (deploy, rollback, recovery) |
For agent orientation see AGENTS.md; for the operating model see .agents/OIKOS.md; for development see CONTRIBUTING.md. Design plans live in plans/, not here.