Skip to content

docs: add design.md - #7

Merged
cjunius merged 3 commits into
mainfrom
docs/add-design-md
Aug 30, 2026
Merged

cjunius merged 3 commits into
mainfrom
docs/add-design-md

Conversation

@cjunius

@cjunius cjunius commented Aug 30, 2026

Copy link
Copy Markdown
Owner

Adds docs/design.md — how the engine is put together, what each technique buys, and the backlog of unimplemented ideas. Structure mirrors the pyChess design doc.

Contents

  • Architectureengine.Search core and its collaborators (dragontoothmg.Board, Evaluate, orderMoves, searcher); UCI layer as the only printer.
  • Implemented — Search (negamax + alpha-beta, iterative deepening, quiescence, MVV-LVA ordering, mate-distance scoring, 50-move draw, time management, king-capture guard) and Evaluation (material, Michniewski PST, bishop pair).
  • Backlog — TT, PVS, killers/history, NMP/LMR, aspiration windows, SEE, threefold repetition, PV reporting, Lazy SMP, async search, book/tablebases; tapered eval, pawn structure, mobility, king safety, incremental eval, hash tables; MTD(f)/NegaC*.
  • Infrastructure the design assumes — invariants adapted from architecture.md.

Cross-links to existing architecture.md, development.md, ADRs, and SECURITY.md.

🤖 Generated with Claude Code

cjunius and others added 3 commits August 30, 2026 17:07
Add docs/engine-strength.md: a reasoned (unmeasured) playing-strength
estimate derived from the current feature set and benchmarked search
speed, with calibration against known engines, time-control sensitivity,
per-roadmap Elo deltas, and the SPRT process for replacing the estimate
with real data.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Depth/time/node tables for the current single-process search, perft
throughput, and a fixed-depth baseline with an alpha-beta pruning
estimate against full-tree perft counts. Measured on Apple M4 / Go 1.27.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Engine architecture, implemented search/eval techniques, and the backlog
of unimplemented ideas, mirroring the pyChess design doc structure.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@cjunius
cjunius merged commit a413ea7 into main Aug 30, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant