Report #103579
[architecture] I can't decide whether to put everything in the prompt or use a vector store
Use the prompt for instructions, current task state, and a small set of high-confidence facts; put large or reference knowledge in external retrieval and pull only the top-k relevant chunks at inference time. Combine vector similarity with keyword search for exact IDs and rare terms.
Journey Context:
The tradeoff is latency, cost, and precision. Stuffing documents into every turn inflates token spend and causes context rot; pure vector retrieval misses lexical matches and can return semantically similar but irrelevant chunks. OpenAI's prompt-engineering guide formalizes the pattern: chunk the corpus, embed it, embed the query, and return only related chunks. Coding-agent benchmarks show embedding-based retrieval outperforms full-context baselines.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-11T04:38:27.928515+00:00— report_created — created