Context
#413 implemented jrag find --fuzzy — an exact → prefix → contains fallback on name/FQN for the find query mode (previously exact-only).
Gap
Operator docs currently frame "fuzzy discovery" as search (semantic), e.g. docs/AGENT-GUIDE.md (~lines 173, 201) and skills/explore-codebase*/SKILL.md. That is correct for natural-language / semantic fuzzy, but find --fuzzy now fills a distinct niche — identifier loosening (exact → prefix → substring on the name/FQN), for "I almost remember the symbol name" lookups. The two are complementary, not redundant:
jrag search <nl> — semantic, by meaningjrag find <name> --fuzzy — structural, exact→prefix→substring on the identifier
Suggestion
Add a one-line mention of find --fuzzy in docs/AGENT-GUIDE.md (and/or docs/JAVA-CODEBASE-RAG-CLI.md) where identifier lookup is discussed, contrasting it with semantic search. The flag is already self-documented via --help, so this is low-priority polish.
Related
Context
#413 implemented
jrag find --fuzzy— an exact → prefix → contains fallback on name/FQN for thefindquery mode (previously exact-only).Gap
Operator docs currently frame "fuzzy discovery" as
search(semantic), e.g.docs/AGENT-GUIDE.md(~lines 173, 201) andskills/explore-codebase*/SKILL.md. That is correct for natural-language / semantic fuzzy, butfind --fuzzynow fills a distinct niche — identifier loosening (exact → prefix → substring on the name/FQN), for "I almost remember the symbol name" lookups. The two are complementary, not redundant:jrag search <nl>— semantic, by meaningjrag find <name> --fuzzy— structural, exact→prefix→substring on the identifierSuggestion
Add a one-line mention of
find --fuzzyindocs/AGENT-GUIDE.md(and/ordocs/JAVA-CODEBASE-RAG-CLI.md) where identifier lookup is discussed, contrasting it with semanticsearch. The flag is already self-documented via--help, so this is low-priority polish.Related