Yard Docs
Sign in
On this page

Example uses and prompts

Ways teams use Yard, each with a prompt you can copy into the start box or the chat.

Updated November 4, 2026 · 3 min read

Each example says what to put in a doc or on a canvas, what to pick, and a prompt to start from. Use the prompt in the work composer (⌘J, or Home) to start a project, with Create a spec first on when you want a plan to edit first, or in a chat to ask about it without changing any code. What you tick in a doc or select on a canvas goes into the start box as its context.

Fix a bug from a report

Put the bug report in a doc (paste the issue link, the screenshot and the error from the logs into it), add the repository, tick the whole doc and start the work with Create a spec first on:

Text
Fix the crash in the screenshot. The stack trace is in the note. Find the
cause, fix it, and add a test that fails without the fix. Do not change the
public API.

Build a feature from a sketch

Drop the mockup into a doc, write the behaviour under it as a checklist, and tick both with the repository:

Text
Add bulk select to the asset grid as in the sketch. Shift-click selects a
range, the floating bar offers Move to folder and Delete, and Delete can be
undone for 8 seconds. Use the existing BulkActionBar component.

Build UI with the design system

Keep a design system sheet (see tips), drag it in, and pick the screen you want built:

Text
Build the settings page in the mockup with the components in the design
system sheet. No new colours or spacing values: use the tokens. Match the
mockup at desktop and phone widths.

Write up research without a repository

Projects do not need a repository. Select the interview notes, the survey export and the links:

Text
Summarise the interviews into the five most common problems, with a quote
for each and how many people mentioned it. Put the numbers in a table and
write the result as findings.md.

At the end, Take files into the workspace… brings the write-up into the workspace's files.

Get up to speed on a repository

Add the repository and ask in a chat:

Text
Explain how authentication works in this repository: where sessions are
created and checked, and which files I would change to add passkeys.

Review a pull request with context

Select the spec the work came from and the repository:

Text
Review the open pull request against this spec. List every acceptance
criterion it does not meet yet and anything it changes that the spec does
not ask for.

Plan before building

When the work is big, ask for a plan first and keep it in a doc:

Text
Do not change any code yet. Read the repository and the notes, and write a
step-by-step plan for moving image uploads to the storage bucket, with the
risks of each step. Write it as plan.md.

Turn a meeting into tasks

Paste the meeting notes into a doc and tick it:

Text
Turn these notes into a checklist of tasks, one line each, with the person
named next to it where the notes say who. Group them by area.
Was this page useful?
Edit this page