Skip to main content
Attaching context is the single highest-leverage thing you can do before sending your first prompt in a recipe.

​
Two ways to attach context

Every recipe has two attachment controls at the bottom of the prompt area. The + button — opens a dropdown for structured sources: your connected app, a GitHub repository branch, a Figma design, or a Jira issue. These are live connections — Recipe reads directly from the source. The paperclip icon (📎) — opens a file picker for documents: PRDs, spec sheets, feature briefs, or any written requirements in .pdf or .doc format. Both can be used simultaneously. A well-prepared recipe session typically has an app selected, a GitHub branch chosen, a Figma file linked, and a PRD attached — all before the first prompt is sent.
Attach before your first prompt. Recipe uses the context that is present at the time of each prompt. Attaching a document after you have already sent a prompt means it was not available for that generation. Set everything up first, then prompt.

​
Your app

Selecting your app gives Recipe visibility into your app’s structure — the screens that exist, the navigation flows, and the UI patterns Mahoraga has learned through Guidance. How to attach:
  1. Click the + button at the bottom of the prompt area.
  2. Open the dropdown. Your connected apps are listed at the top.
  3. Select the app you are testing.
The selected app name appears as a tag in the prompt area. Recipe now knows which app this recipe is for and can draw on everything configured in Apps — including Guidance. If no apps appear in the dropdown, add one first in Apps→ +Add app

​
GitHub repository branch

Connecting a GitHub branch gives Recipe access to your codebase — real API endpoints, real data models, real field names, real validation logic. Tests generated with a branch connected reference what your code actually does, not what the UI implies it does. How to attach:
  1. Click the + button.
  2. Select your connected repository from the dropdown.
  3. Choose the branch that matches what you are currently testing.
Always select the right branch. A test generated from feature/checkout-v2 reflects that branch’s endpoints and business logic — which may differ significantly from main or a production branch. If you are testing a feature in active development, use the feature branch. If no repositories appear, connect one first in Apps → Knowledge. Indexing takes 4–5 minutes on first connection.

​
Figma designs

Attaching a Figma file gives Recipe direct access to your screens, components, annotations, and interaction states. This is context that neither a codebase nor a PRD captures as clearly. When Recipe has your Figma designs, it generates tests that:
  • Reference actual component and button names as labelled in the design
  • Cover states the designer explicitly accounted for — loading, empty, error, disabled
  • Include edge cases visible in annotations that would not appear in a text description
  • Match the exact copy used for error messages and confirmation text
Requirements Quash connects to Figma through its MCP server. This requires:
  • The Figma desktop app. The browser version does not expose the MCP server. If you normally work in the browser (most developers do), you will need to install the desktop app for this step.
  • A paid Figma plan. MCP is not available on free or Starter plans. You need Professional, Organization, or Enterprise. If your team is on a free plan, talk to whoever manages your Figma account about upgrading.
  • MCP enabled. Go to Figma → Preferences → Enable MCP server before you start.
How to attach:
  1. Open your file in the Figma desktop app.
  2. Click the frame you want to attach. The URL bar updates to include a node ID (e.g. figma.com/design/ABCDEF/My-File?node-id=123-456). Copy this URL from the address bar, not the Share button.
  3. In Quash, click + at the bottom of the prompt area, select Add Figma design, paste the URL, and click Add.
Always link to a specific frame. Do not paste the top-level project URL. A project-level link dumps the entire file into context and Recipe cannot tell which screens matter and which are noise. If your feature spans multiple screens, group all the relevant frames into a single parent frame in Figma first, then link to that parent frame. One URL gives Recipe the full flow without pulling in unrelated work. If you are working with a designer, ask them to create a handoff frame that collects the final screens for whatever you are testing. Use the final handoff version. Early-stage Figma files with placeholder content produce less accurate tests. If your file has both WIP and final frames, link to the completed screens.

​
Jira issues, epics, and sprints

Attaching a Jira source gives Recipe the documented requirements for the feature — user stories, acceptance criteria, bug descriptions, epics, and sprint context. Tests generated with Jira attached align directly with what was formally specified. Jira must be connected first Before you can attach a Jira source to a recipe, your Jira workspace must be connected in the Integrations section. If Jira is not connected when you click Add Jira issue, Quash shows a “Jira Not Connected” screen and directs you to Integrations. To connect Jira: go to your profile → Integrations → locate Jira → click Connect. How to attach:
  1. Click the + button at the bottom of the prompt area.
  2. Select Add Jira issue from the dropdown.
  3. Search for or paste the issue ID, epic, or sprint you want to attach.
  4. Click to confirm.
What you can attach:
  • Issues — individual feature tickets with user stories and acceptance criteria
  • Epics — for broader feature coverage across multiple tickets
  • Sprints — to give Recipe context about the full scope of current work
What Recipe reads from Jira:
  • User story description and acceptance criteria
  • Bug reproduction steps (useful for generating regression tests)
  • Linked issues and epic context
  • Labels, priority, and any notes on the ticket
Attach the most specific source available. A specific feature ticket (MYAPP-1204) produces more targeted tests than an entire epic. If your work spans multiple tickets, attach the one most directly relevant to the tests you are generating in this session.

​
PRDs and specification documents

Attaching a document gives Recipe access to written requirements, feature specifications, product briefs, or any other documentation that describes what you are building and why. Supported formats: .pdf and .doc How to attach:
  1. Click the paperclip icon (📎) next to the prompt input.
  2. Select your file from the file picker.
The document is uploaded and processed. Recipe reads it as context for all subsequent prompts in this session. What Recipe reads from documents:
  • Feature descriptions and user journeys
  • Acceptance criteria and success metrics
  • Edge cases and out-of-scope statements
  • Error handling requirements
  • Any explicit test scenarios described in the doc
Attach before your first prompt. Documents are processed at attachment time. If you attach a PRD after sending your first prompt, it was not available for that generation — you will need to re-prompt explicitly referencing the document. Be selective. A focused 10-page feature spec produces better tests than a 200-page product requirements document. If you have a large PRD, consider attaching only the relevant section or creating a focused summary document for test generation purposes.

​
Using multiple sources together

The most effective recipe sessions combine all available sources. Each one fills a gap the others cannot. They are not redundant — they are complementary. A codebase tells you what the app does. A Figma file tells you what it should look like. A PRD tells you why it exists and what counts as success. Example — full context setup for a checkout feature:
With this setup, Recipe has everything it needs to generate tests that are specific to your app, aligned with your codebase, grounded in your designs, and traceable to your requirements — without you having to describe any of it in the prompt.

​
The difference context makes

Without context, Recipe generates tests like this:
With app selected, GitHub branch connected, and Figma attached:
Same intent. Completely different specificity. The second version is directly executable without any additional interpretation. That difference comes entirely from context.

​
Context and the session token limit

Every source you attach contributes to the session’s token count. Attaching a large PRD, a full GitHub repository, and a multi-page Figma file all at once will push the context window higher. Quash auto-compacts at the 200k token limit, but you can use /compact manually before that point to keep the session sharp. → Token management & /compact