start
Zero-state on-ramp: "there is nothing here yet, where do I begin?". Reads the live graph and, for an empty or barely-started graph, recommends the first canonical playbook (from UPG_PLAYBOOKS) plus the exact create_node call for its anchor entity. Established graphs are routed to plan / inspect / get_graph_digest instead. Takes no arguments.
Context & Sessionatomic (read-only)
Arguments
No arguments: this tool takes no input.
Returns
Shape
{ graph_state: "empty" | "young" | "established", product, node_count, recommended_playbook?, first_action?, recommendation, next_tools }recommended_playbook and first_action are present only for empty/young graphs.
Examples
Output
// Input (empty graph):
{}
// Output (truncated):
{
"graph_state": "empty",
"node_count": 0,
"recommended_playbook": { "id": "playbook:users-needs", "name": "Users & Needs", "target_anchor_entity": "persona" },
"first_action": { "tool": "create_node", "args": { "type": "persona", "title": "<your first persona>" } },
"recommendation": "Your graph is empty. Begin with the \"Users & Needs\" playbook: create your first persona."
}