Finished a chess game? Compare your ideas with engine analysis
Use Claude Code with a completed-game PGN and personal notes to prepare review notes separating engine results from explanations through the test workflow below, then review it. Matching tools and permissions are required.
Execution environment and usage
AI / software
Claude Code
Where to operate
Claude Code in a terminal, opened in a separate test folder.
Getting started
- Follow the linked official setup guide; open a terminal in the test folder, run claude and sign in.
- Supply a completed-game PGN and personal notes and the prompt below. Confirm the scope before allowing necessary actions.
- Inspect the resulting review notes separating engine results from explanations; record anything not run or not verified.
Setup and plan requirements
Requires access to Claude Code, authorized test data and a matching runtime; file writes and shell commands must stay within approved scope. Preparation: Use a completed game, its PGN, optional personal notes and your learning level. Have an existing trusted chess-engine environment. Completed games only. Requires an installed, authorized chess engine such as Stockfish and PGN parsing tools. No engine results means no fabricated scores; do not use during active games.
Prompt portability limits
Adapt the wording to another coding assistant only after separately configuring files, runtime, test tools and integrations. Renaming the tool does not establish compatibility.
Usage limitations
This workflow was not hands-on tested. Work on test copies; no automatic publishing, payment or production-data changes. Separate plans, actual results and untested areas.
Environment sources
- https://code.claude.com/docs/en/quickstart · 2026-10-19
適用情境 / When to use
Use Claude Code with a completed-game PGN and personal notes to prepare review notes separating engine results from explanations through the test workflow below, then review it. Matching tools and permissions are required. brumar publishes a Claude Code and Stockfish project with examples of annotated games, boards and narrated video.
步驟 / Steps
- Use a completed game, its PGN, optional personal notes and your learning level. Have an existing trusted chess-engine environment.
- Validate moves and positions, then distinguish your notes, engine results and model explanations without inventing player reasoning.
- Replay key lines yourself and verify annotations before any optional video; later check move/subtitle alignment.
提示詞 / Prompt
Review [completed-game PGN] and [optional personal notes] for [learning level and study questions]. Use only an already authorized, installed chess engine and record settings and reproducible lines. If unavailable, stop the verification portion. Separate my stated reasoning from your inference. First provide annotations for review; do not install packages, connect to ongoing games, create or publish video.
留意事項 / Cautions
- Never use this during an ongoing game or where outside assistance is prohibited. No improvement guarantee is made.
- Without an engine, state that verification is unavailable. Do not install dependencies automatically; audio is optional.
來源限制 / Evidence limits
The repository contains author examples, but we have not run it or measured accuracy; the author acknowledges possible errors. Its initial publication date is unconfirmed.
流程說明 / Workflow note
The following is an original, untested exercise, not a reproduction of the reported session. Check available features and permissions, then adapt it to your own constraints.
原始工具組合 / Original tool stack
Claude Code; Stockfish; PGN; whisper.cpp; HTML/video tooling
Source checked: 2026-10-19