Skip to content

Commit 5adfcd9

Browse files
jlhe97claude
andauthored
Add Steps 7 and 8 to roadmap: pre-game agent and walkthrough coach
Step 7 — Pre-game preparation agent: Claude (Anthropic SDK) reads the structured dossier and produces a Preparation Notes section with recommended openings as White/Black and tendencies to exploit. Operates on the statistical layer only (no move calculation). Step 8 — Interactive game walkthrough coach: hybrid Stockfish + Claude agent; Stockfish evaluates positions via python-chess engine interface, Claude narrates in plain English grounded in the dossier. Step-through CLI or interactive REPL; batched API calls to keep cost low. https://claude.ai/code/session_01VQfqug9MDEyRFydkmES4n2 Co-authored-by: Claude <noreply@anthropic.com>
1 parent 8b9fe1c commit 5adfcd9

1 file changed

Lines changed: 17 additions & 1 deletion

File tree

README.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -367,6 +367,22 @@ paths = run_pipeline("Challenge34", output_dir="dossiers", max_games=50)
367367
- Single command: tournament URL → dossiers for every opponent
368368
- Name → handle resolver: Lichess autocomplete + chess.com guesser, pick best candidate automatically; flag low-confidence matches in the report
369369
- Fetches games from Lichess and chess.com and merges into a single dossier
370-
- Output: folder of Markdown files (one per opponent) + `combined.md`
370+
- Output: HTML per opponent + `combined.html` (colour-coded, print-ready)
371371
- [ ] MegaDatabase integration (once SQLite index is built)
372372
- [ ] Combined PDF output
373+
- [ ] Step 7 — Pre-game preparation agent
374+
- `agent/coach.py` calls Claude (Anthropic SDK) with the structured dossier dict as input
375+
- System prompt: chess coach persona; task is to produce concrete prep notes from the statistics
376+
- Output: a **Preparation Notes** section injected into the HTML dossier with:
377+
- Recommended opening to play as White vs this opponent (based on their worst scoring Black defences)
378+
- Recommended opening to play as Black vs this opponent (based on their worst scoring White systems)
379+
- Key tendencies to exploit (e.g. weak endgame conversion, time pressure patterns, avoids long games)
380+
- Runs as a post-processing pass in `run_pipeline` or standalone: `python -m agent.coach smith_john.html`
381+
- Operates on the **statistical layer only** — no move calculation, so hallucination risk is low
382+
- [ ] Step 8 — Interactive game walkthrough coach
383+
- Hybrid Stockfish + Claude agent for replaying an opponent's past games move by move
384+
- Stockfish (via `python-chess` engine interface) evaluates each position and identifies critical moments
385+
- Claude narrates in plain English, grounding its commentary in the dossier: "They played the Nimzo-Indian again — consistent with their repertoire. Stockfish prefers Bg5; note they've scored 2W/5L when White plays Bg5 early."
386+
- Step-through CLI (`python -m agent.walkthrough smith_john.html --pgn game.pgn`) or interactive REPL
387+
- Batches Claude calls every N moves to keep API cost low
388+
- Complements Maia Chess (human-move prediction) for deeper understanding of why an opponent chooses a line

0 commit comments

Comments
 (0)