WFGY/ProblemMap/article
PSBigBig 82645e795a
Some checks are pending
WFGY-CI / test (push) Waiting to run
Update README.md
2025-09-04 14:09:04 +08:00
..
README.md Update README.md 2025-09-04 14:09:04 +08:00

RAG Problem Map Article Index (MVP)

single place to find every Discussion article. each line links out. this page is the canonical index.

Last updated: 2025-08-22


Day 116 index


what each article should include

keep it short, testable, and reproducible. suggested skeleton:

  1. Symptoms one paragraph with concrete failure signs that an engineer can verify.

  2. Root cause in the embedding space name the failure mode and how it maps to Problem Map No.X.

  3. 10-minute diagnosis two to four checks. keep at least one copy-paste code snippet or CLI step.

  4. Minimal fix steps that can be applied the same day. avoid vendor lock. note any defaults.

  5. Acceptance test clear pass condition. one line people can add to logs for auditability.

  6. Reproduce a semantic firewall overlay in about a minute remind that there is no infra change. one file and one prompt. show the short prompt.

  7. Mapping list all matching Problem Map items using No. numbering. example No.1 hallucination and chunk drift, No.5 semantic ≠ embedding.


This article is part of the Problem Map series (Day 116).
Series index: https://github.com/onestardao/WFGY/blob/main/ProblemMap/article/README.md
Problem Map overview: https://github.com/onestardao/WFGY/tree/main/ProblemMap/README.md

status tracker

  • Day 1 posted
  • Day 2 draft
  • Day 3 draft
  • Day 4 draft
  • Day 5 draft
  • Day 6 draft
  • Day 7 draft
  • Day 8 draft
  • Day 9 draft
  • Day 10 draft
  • Day 11 draft
  • Day 12 draft
  • Day 13 draft
  • Day 14 draft
  • Day 15 draft
  • Day 16 draft

notes

  • use No. when referencing Problem Map numbers
  • keep article links pointed to GitHub Discussions to encourage comments
  • once a week, update this index with the new discussion urls