usm/mcp-flows

MCP flows tool — extracts the flows array from a feature .usm file, including id, name, description, and steps.

Why this exists

Agents need to understand user journeys described in feature files. The flows tool returns the complete flows array with step details, enabling agents to reason about the feature's behavior.

How it works

Get feature flows (get-flows)

Agent retrieves all flows for a feature

1. Get — feature .usm file path
2. Parse — flows array with steps
3. Observe — flow count and step details

Guarantees

flows-feature-only

Flows tool only works on feature files

Acceptance criteria:

• [ ] Returns error if file is not a feature
• [ ] Each flow includes id, name, description, stepCount, steps

Test specifications

flows-from-feature

Given:

• feature_with_flows: true

Then:

• assertion: flows array returned with correct count and step details

Implementation

• Primary: src/mcp/flows.ts
• Test code status: none

See Also

• usm/mcp-contracts