Brownfield Guide

Add YOLO Developer to an existing repository by scanning for language, frameworks, and conventions.

Table of contents

1. When to Use Brownfield Mode
2. Run the Scan
3. Scan Without Changes
4. Re-Scan Later
5. Tips

---

When to Use Brownfield Mode

Use brownfield mode when you are integrating YOLO Developer into a project with existing code, tests, and conventions.

Run the Scan

cd /path/to/existing/project
uv run yolo init --brownfield

YOLO will generate .yolo/project-context.yaml with detected structure, frameworks, and conventions.

Scan Without Changes

uv run yolo init --brownfield --scan-only

Re-Scan Later

yolo scan --refresh

Tips

• Use --hint to guide detection for atypical projects.
• Use --non-interactive for CI or scripted scans.
• Review .yolo/project-context.yaml and refine any conventions as needed.