ask

Tool tools/llm/ask.py (program, Models). Ask a question of GameFrame's know-how in plain words, and get an answer that cites entries.

Run it with ./gameframe run ask ARGS or python3 tools/llm/ask.py. Source on GitHub.

Its own help

This is the help text in the tool itself, as ./gameframe tool ask prints it.

Ask a question of GameFrame's know-how in plain words, and get an answer that cites entries.

Usage:
  ask.py [--top N] [--model ID] [--show] QUESTION ...

  QUESTION  a question, an error message or a description of what you see
  --top     how many entries to send (default 8)
  --show    print the entries that would be sent and stop, spending nothing

It finds the entries with `gameframe advise`'s own search (tools/gameframe/advise.py: error
signatures, facets, then words; GameFrame's entries and the project's), sends the best N
whole, and asks the selected model to answer from them alone, naming each entry it uses. When no entry
fits, the answer says so, and the question may be a new gap (re-land, "Know-how").

One question uses one call to the configured model API (client.py).

What it does not do: search the web, the code or the docs outside docs/knowhow/. An answer
is a pointer to entries: read the entry before you act on it.