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

1.3 KiB

id date status supersedes superseded-by affected-paths affected-components migration_confidence migration_source
0005 2026-06-03 Superseded 0010
medium 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.