Refocus command guidance on players

docs/eagle0pedia/src/content/docs/commands/index.md

@@ -3,10 +3,44 @@ title: Eagle Commands
 description: Strategic command reference for Eagle command panels.
 ---
 
-Eagle commands are the strategic actions a faction can take from a province command panel. The server advertises available commands with `AvailableCommand`, and the client posts the matching `SelectedCommand`.
+Eagle commands are the strategic actions a faction can take from a province command panel. The panel shows the actions that are possible for the current province and situation.
 
 Most commands belong to the province currently acting this turn. Some are reaction commands, such as resolving diplomacy offers, handling captured heroes, or choosing a battle aftermath decision.
 
+## Why commands appear and disappear
+
+The command panel changes as the game changes. If an action is not currently possible, it is usually absent instead of appearing as a disabled button.
+
+Availability can change when:
+
+- another command spends gold, food, vigor, or the province's turn;
+- a hero, battalion, prisoner, event, or incoming army moves or changes state;
+- the game advances to another phase;
+- a profession or minimum stat is required; or
+- a target is no longer valid.
+
+If a command you expected is missing, check its **Available when** entry. The most common reasons are insufficient gold, food, or vigor; no valid target; the wrong hero profession; the hero being elsewhere; or the province having already spent its turn.
+
+An **eligible hero** is simply one of the heroes you can currently choose to perform that action. Eligibility can depend on location, vigor, profession, leadership, and the command's own restrictions.
+
+## Reading a command entry
+
+- **Hero requirements** identifies profession or hero restrictions. “None” means no particular profession, not that the command never needs an acting hero.
+- **Vigor cost** is paid by the selected acting hero when the command resolves as described.
+- **Available when** summarizes the state that makes the command appear.
+- **Effect** describes what the action does.
+- **Selection** lists what you must choose before confirming it.
+
+## Turns, reactions, and command states
+
+Most commands under **Normal Command Phase Commands** spend the acting province's turn. After using one, you normally cannot choose another ordinary action for that province this round. Entries explicitly identify exceptions such as Issue Orders.
+
+Diplomacy responses, attack and defense decisions, riots, and battle aftermath are prompted by events in their own phases. Resolving one of these decisions does not replace or grant another ordinary province turn.
+
+**Travel** enters a temporary command state. Traveling commands then become available, and the player may use multiple traveling commands in the same round. **Return** leaves that state and returns to the normal province command flow. Individual traveling actions can still spend resources or alter which later choices remain available.
+
+Before confirming any command, check the selected hero, destination, units, gold, and food. Treat confirmation as issuing the order rather than previewing it.
+
 <span class="command-reference-marker" aria-hidden="true"></span>
 
 <!--