How fernanh98/secretcodellm works
SecretCodeGame is a turn-based, two-team word-association game used to examine LLM reasoning. The principal workflow is a captain providing a clue, a teammate guessing words, and the game evaluating guesses until a team wins; results capture round and player details. The source excerpts show board setup and result construction, plus an Ollama-backed model wrapper and typed schemas. Several game-to-module interactions are implied by imports and names, but the relevant calls fall in omitted excerpts, so those links are marked unverified.
Main entry points: game.py Captains and guessers · llm_wrapper.py Model wrapper · schemas.py Game and result schemas · prompts.py Role prompts
Components 9
Game runtime
- Captains and guessers
src/game.py - Game engine
src/game.py - Board setup
src/game.py
Reasoning and models
- Role prompts
src/prompts.py - Player tools
src/tools.py - Model wrapper
src/llm_wrapper.py
Game data
- Word bank
src/words.py - Game and result schemas
src/schemas.py
Other components
- Ollama model
Connections 9
- Game engine → Board setup: sets up
src/game.py - Game engine → Game and result schemas: creates results
src/game.py - Game engine → Captains and guessers: runs turns
src/game.py - Captains and guessers → Role prompts: uses prompts
src/game.py - Captains and guessers → Model wrapper: requests responses
src/game.py - Captains and guessers → Player tools: uses tool calls
src/game.py - Board setup → Word bank: draws words
src/game.py - Model wrapper → Ollama model: invokes
src/llm_wrapper.py - Model wrapper → Game and result schemas: returns messages
src/llm_wrapper.py