Process Index

Discover and navigate the hierarchy of processes the organization runs.

Use these tools when search results feel sparse, or when you need richer process metadata than fetch returns.

Tool	When to use
search_processes	Ranked process search combining keyword matches (name, objective, team, value stream) with semantic similarity. Returns mixed hierarchy-node + process results — use when a top-level value stream or department might be a better starting point than a leaf process.
get_process_hierarchy	Browse the whole index structure. Use when search misses, or to orient before drilling in. Cap depth with max_depth; the response flags truncated branches and points you at the next call.
get_hierarchy_node_details	Inspect a single hierarchy node — parent, children, linked process, attributes. The right call for a folder / group / value stream key.
get_process_details	The rich nested payload for a process: current_version, dependencies, hierarchy_node, attributes, optional version history. Default returns a summary with operational attributes; pass scope to include tasks, observations, dependencies, linked_artifacts, policies, or history. This is what fetch reshapes — use directly when you need the structured shape.

Choosing among the lookup tools

• Semantic + keyword, broad → search (entry point) or search_processes (richer, mixed results)
• You have a resource key → get_process_details (for processes) or get_hierarchy_node_details (for folders / groups / value streams)
• Browse / orient → get_process_hierarchy, then drill in with get_hierarchy_node_details or get_process_details
• Drill further (what actually happened on a specific process) → get_process_observations → get_observation_citation. See Process observations for the full toolset.

Common chains

• “What’s in this value stream?” → get_process_hierarchy (broad) → get_hierarchy_node_details on the relevant node → get_process_details on each leaf
• “Pull every dependency of process X” → get_process_details with scope=["dependencies"] → walk the dependencies list with further get_process_details calls
• “I have a resource key, give me everything” → get_process_details with the scopes you care about (tasks, linked_artifacts, history)
• “What actually happens when this process runs?” → get_process_details → get_process_observations → get_observation_citation on a representative deviation