Use this index as the source map for Alcove's user workflows, operating model, and implementation constraints. Keep the README short; put durable details here.
- Usage Guide: daily CLI/MCP workflows and common commands.
- Entry Modes: hub workspace, global MCP, managed KB, and local service entry profiles.
- Agent Workspaces: fixed Hub plus lightweight business workspaces and workspace-local OKF for family/work/travel-style conversations.
- Modules: feature groups, ownership boundaries, and storage contracts.
- Prompt Library: reusable prompt records, curation, search, scenario recommendation, composition, and quality audit.
- Data and Backup: data locations, export, Git sync, and encryption recommendations.
- Configurable Radars: generic radar definitions, presets, source adapters, scheduled runs, AI summaries, and notification sinks.
- Automations: repeatable user jobs, service scheduling, and task notification behavior.
- Architecture: system relationship map, feature groups, storage boundaries, and implementation overview.
- Alcove OKF Profile: official OKF compatibility plus Alcove's stricter document, index, and refresh profile.
- Read/Write Operating Model: broad AI-led reads and narrow CLI/MCP-governed writes.
- Coverage: pytest-cov, CI upload, and Codecov badge setup.
- Local Smoke / Agent Eval: deterministic smoke checks and AI eval workflows.
- Agent Quality Gates: Codex/Claude hook automation, trigger rules, coach mode, and strict mode.
- ADR 0001: Alcove Home and Managed KB
- ADR 0002: CLI and MCP Adapters Use Application
- ADR 0003: Link Uses Runtime Search Scope
- ADR 0004: Link Direct Index Lookup
- ADR 0005: Application Private Capability Groups
- ADR 0006: MCP Adapter Invocation Context
- ADR 0007: External Index Refresh and Fetch
- Archive Index: historical design notes that are no longer the current command surface.
- Original 2026-07-07 design notes: historical phase-1 planning. Use current guides and ADRs as the source of truth.