Claude Code Best Practices vs Agency by Mozilla

“This fills a real gap. The official Claude Code docs are good for basics but thin on production patterns—subagent orchestration, hook design, memory architecture. This repo documents the emergent best practices from the community in a structured way. Bookmark it before your next agentic project.”

“The primitive here is clean: a browser-native agent runtime that binds to Firefox's internals and exposes MCP-compatible tool interfaces, all local. No cloud hop, no screenshotting your desktop and sending it to Anthropic. The DX bet Mozilla made is right — run in-process in the browser where DOM access is first-class, not bolted on from outside. The moment of truth is whether the MCP tool registration is actually ergonomic or if it buries you in schema boilerplate, and the repo suggests the latter needs polish. Still, this is a real primitive, not a wrapper — Mozilla is giving developers a composable base that a Playwright-over-CDP weekend project genuinely cannot replicate, because the privacy guarantees come from architecture, not policy.”

“Community best practice repos age fast when the underlying platform ships updates weekly. Half of what's documented here may be outdated or superseded by native Claude Code features within a month. Treat this as a starting point, not a source of truth—and watch for stale patterns that were workarounds for now-fixed limitations.”

“Category is browser automation agents; direct competitors are Anthropic Computer Use, OpenAI Operator, and Playwright-based agent wrappers. The scenario where this breaks is any user who needs a capable frontier model baked in — Agency gives you the runtime plumbing but you still have to bring your own model, and local models are still embarrassingly bad at browser task reasoning compared to GPT-4o. What kills the cloud alternatives here is regulatory pressure on enterprise data handling, which is real and accelerating — that's the thesis that survives. Mozilla ships this, it gets traction in privacy-sensitive enterprise and research contexts, and the cloud agents find their growth capped in regulated industries. I'd call this a genuine ship for the niche it's targeting, not a universal recommendation.”

“The 42k stars are a signal: agentic engineering is becoming a real discipline. We're watching the equivalent of the early DevOps playbooks—informal community knowledge that eventually becomes the baseline everyone assumes. The people building these patterns now are writing the textbooks for the next generation of AI infrastructure engineers.”

“The falsifiable thesis here is: within 3 years, regulatory and user-trust pressure will make cloud-routed browser agents legally or commercially unacceptable in enough markets that local-first agent runtimes become the default for sensitive workflows — healthcare, legal, finance, government. Agency is early to that specific bet, and being a Mozilla project means it rides the browser-vendor trust signal that no startup can buy. The second-order effect nobody's talking about: if Agency becomes the standard runtime for Firefox-native agents, Mozilla gets to define what MCP tool permissions look like in a browser context, shifting standards power back toward an open-standards body and away from the model providers. The dependency that has to hold is that local model capability closes the gap with cloud fast enough — Gemma 3 and Qwen3 suggest it's on track.”

“Even for non-engineers, the agent team and memory sections are eye-opening. Understanding how multi-agent systems are actually structured changes how you think about what to ask AI to do. This is a great read if you're hitting the ceiling of what single-session Claude Code can handle.”

“There is no buyer here, which is the whole problem — Mozilla is a nonprofit shipping open-source infrastructure, not a business, and that's fine for what it is, but framing this as a product review misses the point and also confirms the skip. Any startup trying to build on top of Agency inherits Firefox dependency, local model constraints, and a framework maintained by a nonprofit with a historically mixed record of developer-facing project continuity (see: Firefox OS, Servo, Pocket). The moat question answers itself: Mozilla can't own a market position because they're not trying to, and any company that builds a product layer on this is one browser vendor decision away from a breaking change. If you're a developer building privacy-first browser tooling, this is interesting infrastructure. If you're trying to build a business on it, that's the skip.”