> For the complete documentation index, see [llms.txt](https://synapseworks.gitbook.io/synapseworks-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synapseworks.gitbook.io/synapseworks-docs/synapse/workflow.md).

# Synapse Workflow

## Purpose

Describe the operating workflow for generating, refining, validating, and creating execution artefacts.

## Who it is for

* Delivery teams standardising breakdown quality
* Process owners building repeatable issue handling patterns

## Prerequisites

* Synapse panel access on a Jira issue
* Issue context available (summary, description, comments, labels, issue type, project data)

## Steps

1. Generate preview from current issue context.
2. Review grouped output and executable BDD-style scenarios.
3. Refine content using `Refine with Synapse`:
   * Edit titles and BDD steps
   * Toggle grouping and BDD style
   * Reset individual items when needed
4. Validate path using dry-run mode.
5. Create subtasks from approved output.
6. Review creation status, including created keys and any per-item errors.

## Operational notes

* If refine is opened before preview generation, guidance is shown to direct the user to generate first.
* Friendly status mapping helps users interpret creation outcomes.
* Dev-only diagnostics are available for controlled troubleshooting in development contexts.

## Rovo positioning

Where Rovo assists with AI suggestions, Synapse adds operational control by applying consistent structure and validation before execution in Jira.

## Common issues

* Users skip dry-run and hit avoidable errors in create mode.
* Incomplete issue context can reduce preview quality.
* Mixed editing styles can reduce consistency across teams; align on BDD style toggles.

## Related pages

* [Overview](/synapseworks-docs/synapse/overview.md)
* [Quickstart](/synapseworks-docs/synapse/quickstart.md)
* [Configuration](/synapseworks-docs/synapse/configuration.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://synapseworks.gitbook.io/synapseworks-docs/synapse/workflow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.