Search posts, papers, and topics
3 posts · addyosmani.com
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.
Addy Osmani warns that AI agents can short‑circuit the hands‑on practice (“reps”) that builds deep expertise and judgment. He recommends deliberately inserting hypothesis‑forming, “why” questioning, diff inspection, failure prediction, and occasional manual coding into the workflow, especially for junior engineers. A 2026 Anthropic study showed junior developers using AI scored 17 % lower on a fo…
Agent configuration files (CLAUDE.md, AGENTS.md, skill packs) accumulate stale rules, inflating token usage and hurting performance. Regular audits—using Claude’s /doctor, pruning to <200 lines, and encoding hard constraints in hooks—restore lean, effective agents.
