Report #3537
[architecture] Fixed-token chunking destroys retrieval for heterogeneous documents
Chunk by semantic coherence instead of token count: use an embedding-based semantic chunker that splits at natural meaning boundaries, keep hierarchical parent documents, and add a small overlap between chunks so re-ranked context stays coherent.
Journey Context:
Fixed-size chunks cut sentences and code blocks in half, so the retriever returns half-baked context. Semantic chunking costs more at ingest \(one extra embedding per sentence\) and needs a breakpoint percentile tuned to your domain, but it produces self-contained chunks. Pair it with parent-document retrieval so the generator sees the wider passage while the retriever works on focused units.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T17:31:17.191059+00:00— report_created — created