specflow-use

# SpecFlow Use

This skill helps you drive **Grid Dynamics SpecFlow** from a local workspace via **SpecFlow MCP**. Rosetta stays local; SpecFlow runs everything remotely. The skill loads project context from `gain.json` and guides the user through SpecFlow MCP tool usage.

SpecFlow MCP is the only user interface to SpecFlow: you order work and download outputs. You do not connect to or operate on the remote workspaces directly.

## Quick Start

When the user mentions SpecFlow or works in a SpecFlow-enabled project:

1. **Detect** `gain.json` at the workspace root (and up to 2 parents). If missing, SpecFlow MCP will create it on the first tool call (together with `specflow_session.json`).
2. **Load** and summarize the project context.
3. **Guide** the user to the right phase using `references/specflow-mcp-tools.md`.

## Step 1: Detect gain.json

Check for `gain.json` at the current workspace root. If not found, check parent directories up to 2 levels. If still missing, tell the user this workspace is not yet initialized for SpecFlow — the first SpecFlow MCP tool call will create both `gain.json` and `specflow_session.json`.

## Step 2: Parse and Display Context

When `gain.json` is found, present a compact summary:

```
## SpecFlow Project Context

**Description**: [gain.json.description]
**Services**: specflow — [gain.json.servicesDescription.specflow]
             rosetta  — [gain.json.servicesDescription.rosetta]
**Supported Coding Agents**: [gain.json.codingAgents]
**Versions**:
  - rosetta: [gain.json.versions.rosetta]
  - specflow:    [gain.json.versions.specflow]
**Vocabulary overrides** (if present in gain.json.vocabulary):
  - (See references/specflow-vocabulary.md for defaults.)
```

### Version Compatibility Check

Compare `gain.json.versions.rosetta` with the current Rosetta version:

- **Minor difference**: warn and continue.
- **Major difference**: alert the user about potential incompatibilities.

## Step 3: Guide the User Journey

Read `references/specflow-mcp-tools.md` to route the user to the correct phase (pregeneration, generation, or post-run).

## Step 4: Consolidate Review Feedback

When SpecFlow returns a review report and the user wants to fix their specs before another iteration, delegate to Rosetta core:

- Skill: `skills/requirements-authoring`
- Workflow: `workflows/requirements-authoring-flow.md`

That skill handles iterative requirement updates with explicit user approval — matching the "consolidate the review report into updated specs" loop.

## Reference Files

Read as needed:

- `references/specflow-mcp-tools.md` — Phase routing and post-run skill bootstrap.
- `references/specflow-vocabulary.md` — Status values and checkpoint gates users encounter in responses.
- `references/specflow-schema.md` — Session files, version channels, and status enum quick lookup.