Addy Osmani13 min readintermediate
Brownfield Agentic Engineering
Summary
Addy Osmani outlines a pragmatic framework for safely introducing AI‑driven agents into legacy (brownfield) codebases. He proposes zoning code by risk, documenting non‑code knowledge, preserving research in durable memos, building a reusable “harness” of tools and rules, and starting with zero‑risk, characterization‑test‑driven work.
- Classify code into green/yellow/red zones based on test coverage, isolation, and business criticality; let agents act only in green, require tests in yellow, and enforce human pairing in red.
- Record only the knowledge the code cannot convey (business nuances, trade‑offs, domain rules, historical context) to guide agent decisions.
- Create a durable “comprehension memo” after each read‑only research pass that cites files, owners, dashboards, etc., so subsequent agents don’t repeat archaeology.
- Build a harness of reusable skills, plugins, lint rules, CI checks, and scoped credentials that capture repeated corrections and enforce constraints automatically.
Legacy systems hide critical invariants in undocumented conventions and institutional knowledge. Without explicit boundaries and durable artifacts, AI agents can introduce subtle regressions, increasing technical debt. The proposed patterns give teams a concrete, low‑risk path to leverage agentic a…
6/10




