f-search

/f-search

skill

Find Logbook cards about a topic.

On site

The Logbook: any time. f-shift uses it to load the lessons that apply to a job.

Searches current cards only; older ones are in f-archive-search.

When

When you want to know what past jobs learned about a topic.

It's working if

It returns at most 10 cards, each with its id, type, cluster, tags, a short overview and its path.
Every hit is a live card under foreman/logbook/entries/, never one from foreman/logbook/archived/.
The card templates never show up as hits, even in an empty Logbook.
When nothing matches, it says so and points you to /f-archive-search, with no made-up list of cards.
There are no ranking scores or stats tables in the output.

Common questions

How do I write a query?: Mix plain keywords, #tag, @cluster and type:insight, type:method or type:build. The filters combine with AND; a card matches the keywords if it contains any of them, ignoring case.
Where do the cluster names come from?: From your own cards. The ## Clusters section of logbook_index.md lists the ones in use. If a cluster search finds suspiciously few cards, it retries the same word as a keyword before saying they don't exist.
Why can't it find a lesson I know we learned?: It reads live cards only. If the card was rotated out by /f-archive, search for it with /f-archive-search.
Does it look anywhere besides the Logbook files?: No. It is told to read only the live Logbook files, even if the repo has its own card database or search service.

→ Leads to 1

f-shiftStart a session as the foreman: read the role, the rules and the playbook first

skills/f-search/SKILL.mdThis page as Markdown