User Manual & Engine Guide
This guide details how to interpret the metrics generated by the chessAI 360 engine. Our system does not just provide an evaluation bar; it runs alongside traditional chess engines to calculate human-readable positional metrics, aggregates your historical data, and generates customized training tools.
Interpreting Game Analysis
When you submit a single game or play against the computer, our Custom Positional Engine evaluates every single move across 10 distinct categories. These scores help explain *why* a position is good or bad beyond just a simple number.
The 10 Positional Metrics
King Safety & Pawn Structure
- King Safety: Measures the shield protecting your King and how close enemy pieces are. Example: Pushing a pawn directly in front of your castled King immediately drops this score.
- Pawn Structure: Penalizes isolated, doubled, and backward pawns. Rewards connected passed pawns.
- Center Control: A numerical representation of your dominance over the center squares (e4, d4, e5, and d5).
Piece Dynamics
- Harmony: Calculates how well your pieces defend each other. A very low score often precedes a blunder because you have too many loose, undefended pieces.
- Mobility: The raw count of safe, legal moves available to your pieces.
- Activity: Rewards pieces placed on advanced outposts (like a Knight permanently planted on d6).
Combat Metrics
Attack vs. Defence: These opposing metrics measure immediate threats. High Attack paired with Low Defence indicates a reckless, all-in assault. Space: Measures the territory you control behind your pawns. Material: The standard piece point count, adjusted slightly for positional advantages (like having the Bishop pair).
Move-by-Move Meta Metrics
Sharpness & Criticality
How it works: Sharpness looks at the difference between what a perfect computer would do versus how hard the position is for a human to play.
Example: If you have a forced checkmate in 5 moves, but the sequence is incredibly complicated to calculate, the Sharpness score spikes. High criticality means finding the absolute best move is mandatory, or you will lose your advantage.
Future Phase Prediction
How it works: The system looks a few moves into the future based on the best lines. If a recommended move forces the game to transition from the Opening into the Middlegame, or triggers a specific endgame (e.g., "Rook & Pawn Endgame"), the UI will display a prediction arrow ().
Time Efficiency
How it works: This compares the time you spent on a move with how critical the position actually was. Thinking for 3 minutes on an obvious recapture is flagged as "Poor Time Management", while thinking deeply in a highly critical position is praised as a "Deep Think".
Understanding Player Insights
When you sync your Chess.com or Lichess account, our system analyzes hundreds of your past games at once. It merges new games with your historical stats using a weighted average to ensure a few bad days don't destroy your overall ratings.
The 12 Radar Attributes
Scores (0-99) are normalized based on your opponent's skill level. This ensures that a beginner playing accurately against other beginners doesn't automatically receive Grandmaster-level stats.
| ACC (Accuracy): How closely your moves match the perfect computer move. |
| OPN (Opening): Your accuracy in the first 12 moves of the game. |
| MID (Middlegame): Your performance in complex, crowded board states. |
| END (Endgame): Your technique when very few pieces are left on the board. |
| TAC (Tactics): Your ability to spot and execute forcing sequences (like forks or pins). |
| CAL (Calculation): Your accuracy specifically in highly sharp, critical positions. |
| STR (Strategy): How well you maintain pawn structure and piece harmony. |
| INT (Intuition): Finding the right move quickly without burning all your clock time. |
| ATK (Attacking): Your proficiency when you have the advantage and are pushing forward. |
| DEF (Defending): Your resilience and ability to bounce back when facing a strong attack. |
| TMG (Time Mngmt): The overall efficiency of your clock usage. |
| RES (Resourceful): Your ability to find saving tricks or stalemates in losing positions. |
Title Generation Logic
Titles aren't assigned randomly; they are awarded based on strict mathematical thresholds calculated over your entire match history.
- Speed Demon: Over 80% of your moves are played in under 3 seconds.
- The Simplifier: You force trades quickly, transitioning to the endgame earlier than average.
- The Pawn Grabber: You average an unusually high number of pawn captures per game.
- The Theoretician: Your opening accuracy is consistently near perfect.
- Blunder Master: Your overall game accuracy frequently falls below 40%.
Galleries & Opening Trees
Blunder Recovery Puzzles
When analyzing your past games, the system flags any major mistake you made. It then captures the exact board layout from *one move before* you blundered, creating a custom tactics puzzle. This allows you to go back and see if you can find the correct move you missed during the real game.
Your Opening Repertoire
The system scans the beginning of all your games and groups them by the opening names you played (e.g., "Sicilian Defense"). It then builds an interactive tree showing your exact Win, Loss, and Draw rates for every specific variation you've ever tried.