---
title: "MySpec edit for brownfield workflow"
description: "Edit the specs of an existing codebase. The AI reads the related code before every round of changes, so your specs stay true to the code."
---

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

# MySpec edit for brownfield workflow

The **MySpec edit for brownfield** workflow changes the spec files of a
Brownfield project, checking each change against your code. In the picker it is
**MySpec edit-brownfield (v1)**: "Edit specs against an existing codebase →
describe changes → review edits."

## At a glance

- **Best for:** Changing proposals, requirements deltas or tasks for an existing codebase
- **Project type:** Brownfield (or Auto)
- **Steps:** Reference → Describe → Review, reading your code before each round
- **Files:** The spec files you reference

## Before you start

The AI reads the code related to your change before it edits any spec, so
connect your codebase first: run the local MCP server's `reverse` command, or
mount the folder in your browser's **Local Workspace**. See
[Let MySpec read your code](https://docs.myspec.dev/guides/brownfield/#let-myspec-read-your-code).

If it can't read your code, the AI asks you to connect it and waits.

## Steps

The steps are the same as in [MySpec edit](https://docs.myspec.dev/workflows/edit/#steps), with one
addition: **before every round of changes, the AI reads the code behind the
change.** A requirement you change is checked against what the code does today,
so the spec doesn't drift from the code.

1. **Reference** the spec files to change with `@`.
2. **Describe** the change. The AI asks a short round of questions and reads the
   related code.
3. **Review** each change as a diff, then **Accept** or **Discard** it.

Each new round reads the code again, so you can change the code between rounds
and the next edit sees it.

## Tips

- **Keep your codebase connected for the whole session.** Leave the `reverse`
  command running, or keep the browser tab with the mounted folder open.
- **Share only the project folder.** The AI can read anything in the folder you
  share. See [Security and privacy tips](https://docs.myspec.dev/help/security/#choose-the-folder-you-share-with-care).

See [Edit sessions](https://docs.myspec.dev/guides/edit-sessions/) for every button and message.

Source: https://docs.myspec.dev/workflows/edit-brownfield/index.mdx
