usm/mcp-flows

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

Intent

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.

Flows

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

Contracts

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

Tests

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