Textbook Hierarchical Graph Retrieval

Tool families

Use five distinct tool families:

1. scripts/search_nodes.py
   • query-driven retrieval and scoped reranking
2. scripts/expand_structural.py
   • deterministic upward movement to parents, ancestors, or stable membership targets
3. scripts/get_outline.py
   • structure inspection
4. scripts/expand_neighbors.py
   • non-structural expansion after a useful anchor exists
5. scripts/fetch_content.py
   • lightweight structural + semantic cards plus optional extra fields

Do not use other local scripts or other retrieval paths as substitutes for these tool families while operating under this skill.

Read order

Use the references in this order:

1. references/workflow.md
   • retrieval posture, evidence judgment, stopping, and final answer structure
2. references/command-recipes.md
   • concrete command shapes and typical invocation patterns
3. references/tool-contracts.md
   • exact search_nodes.py and fetch_content.py I/O guarantees

Reference split:

• workflow.md
  • how to run a retrieval turn
• command-recipes.md
  • how to call the tools
• tool-contracts.md
  • what fields and interface guarantees downstream steps can rely on

Default behavior

• start with search_nodes.py
• prefer chapter for routing unless the query is already very specific
• do not treat community as the default first hop
• drill-down by keeping scope fixed and lowering level
• use expand_structural.py only for deterministic upward moves
• use expand_neighbors.py only after a useful anchor already exists
• prefer chunk evidence in the final answer whenever chunk grounding is achievable
• choose the current turn-time mode from references/workflow.md
• end with a direct answer first, then rationale, evidence, evidence path, and uncertainty
• do not end by merely restating the question or dumping retrieved text
• do not treat unrelated local corpora, eval files, or question banks as primary evidence for this skill unless the user explicitly asks about those files