cc-os/docs/adr/0005-structured-first-seman...

35 lines
1.3 KiB
Markdown
Raw Normal View History

---
id: "0005"
date: 2026-06-03
status: Superseded
supersedes:
superseded-by: "0010"
affected-paths: []
affected-components: []
migration_confidence: medium
migration_source: "docs/memory-system/03-architecture-decisions.md### ADR-005 — Structured-first; semantic search over the vault deferred"
---
# 0005 — Structured-first; semantic search over the vault deferred
## Context
Tag filtering ("client/sesame3g + tool/semrush") may miss notes whose wording
doesn't match the query ("how do we use semrush" vs a note titled "search analytics
integration").
## Decision
Ship the knowledge layer **structured-only** (tags + summaries). **Defer**
meaning-based search over the vault until it demonstrably bites.
- **Rationale**: Structured tagging is the lightweight/fast thing the user wants, and the
summary+tag design is built to make it work. Follow the video's "only level up when it bites."
## Consequences
The knowledge layer shipped structured-only (tags + summaries), deliberately deferring meaning-based/semantic search over the vault until it demonstrably became necessary. This premise was later superseded by ADR-010, since Graphify provides structured and connection-based recall together from day one rather than requiring a separate semantic layer to be bolted on later.
## Alternatives rejected
None stated in source.