---
type: guide
project: fidelity
status: active
updated: 2026-04-16
tags: [onboarding, obsidian, workspace]
related:
  - start-here.md
  - ../07-maps/ai-workspace-core.md
---

# Workspace Architecture

This repository has two layers:

- `vault/` is the clean Obsidian second brain and canonical AI memory.
- Everything outside `vault/` is technical runtime, reusable core, profile configuration, scripts, commands, prompts, or raw evidence.

---

## Canonical Memory

Use these folders as the source of truth for humans and AI agents:

- `00-start/` for onboarding and usage guidance
- `01-current/` for current work state
- `02-work-items/` for ticket/task memory
- `03-context/` for systems, workstreams, process, and iOS context
- `04-people/` for people and role memory
- `05-decisions/` for confirmed decisions
- `06-daily/` for daily notes
- `07-maps/` for graph hubs
- `08-bases/` for table-style review
- `09-templates/` for note templates

---

## Runtime Outside The Vault

These folders are intentionally outside Obsidian memory:

- `.opencode/` stores agents and slash commands.
- `core/` stores reusable workspace logic.
- `profiles/` stores project-specific profile declarations.
- `scripts/` stores connectors, importers, and wrappers.
- `ai/inbox/` stores live evidence from communication sync.
- `scripts/*/generated/` stores extracted evidence.

Runtime and generated files can be used as evidence, but durable project facts should be promoted into `vault/`.

---

## Migration Rule

Legacy `ai/context`, `ai/state`, `ai/work-items`, `ai/logs`, and `knowledge` files may still exist for compatibility.

When a `vault/` equivalent exists, update `vault/` first.