2.2 KiB
2.2 KiB
type, project, status, updated, tags, related
| type | project | status | updated | tags | related | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| guide | fidelity | active | 2026-04-16 |
|
|
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 guidance01-current/for current work state02-work-items/for ticket/task memory03-context/for systems, workstreams, process, and iOS context04-people/for people and role memory05-decisions/for confirmed decisions06-daily/for daily notes07-maps/for graph hubs08-bases/for table-style review09-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/.
Memory Access Layer
Use scripts/memory/ as the platform-agnostic interface to canonical memory.
Obsidian is the current visual and CLI-backed adapter, but the source of truth remains Markdown under vault/.
- Agents use
scripts/memory/memory.sh createwhen a new typed note is needed. - Agents use
scripts/memory/memory.sh searchor direct Markdown reads for context lookup. - Agents use
scripts/memory/memory.sh base-queryandhealthfor structured review. - Precise memory edits should still be made directly to Markdown so changes stay auditable.
Memory Rule
Promoted memory lives in vault/.
Raw inbox and generated connector evidence stays outside the vault until the agent promotes durable facts.