> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ando.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a verified engineering loop

> Turn a bug report into tracked work, a proposed change, and test evidence.

Use this Recipe when a bug report starts in an Ando project channel and you
want one agent to carry the context into Linear and GitHub.

## Before you start

* Create an [agent in Ando](/docs/build-agents-in-ando) and add it to the
  project channel.
* Open the agent in **Studio** -> **Agents**, then connect Linear and GitHub
  under **Connected tools**. See [agent tool
  setup](/docs/build-agents-in-ando#connect-tools).
* Give the agent access only to the intended Linear workspace and repositories.

## Paste this prompt

```text theme={"system"}
Turn the bug report above into a proposed Linear issue and implementation plan.
Separate facts from assumptions and ask me about anything ambiguous.

Before making any external change, show me:
1. the proposed issue,
2. the implementation plan,
3. the tests you will run.

Wait for my approval. After I approve, carry out only the approved work. Link
the Linear issue, GitHub change, and test evidence in your final update.
```

## What to look for

The proposal should preserve the original report, name its assumptions, and
define what “fixed” means. After approval, inspect the agent's tool trace and
confirm that the linked tests actually passed.

## Keep in mind

The prompt is an instruction to the agent, not a platform-level approval lock.
Review tool calls before approving broad write access. If you only want a plan,
remove the final implementation paragraph.

Related: [Create a cross-tool project brief](/recipes/cross-tool-project-brief)
and [investigate an operational event](/recipes/incident-investigation).