Back to Blog

From Writing Code to Reviewing Code - The AI Shift

Fazm Team··3 min read
code-reviewclaude-codeai-workflowdeveloper-experiencespecs

The Job Changed

Six months ago, I wrote code. Now I review code from five Claude agents running in parallel on the same codebase. My primary output is CLAUDE.md specs - detailed instructions that tell agents what to build, how to build it, and what constraints to respect.

This is not a subtle shift. The core skill changed from "can I implement this?" to "can I specify this precisely enough that an AI implements it correctly, and can I review the result fast enough to keep up?"

What Writing Specs Looks Like

A good CLAUDE.md spec is not a vague description of what you want. It is a precise contract:

  • What the feature should do - with specific edge cases called out
  • What it should not do - constraints are more important than requirements
  • How to verify it works - test cases the agent should validate
  • What existing code to respect - patterns, conventions, architectural decisions

The spec is the product now. If the spec is ambiguous, the agent will make plausible but wrong decisions. If the spec is precise, the agent produces correct code on the first try.

What Reviewing at Scale Looks Like

With five agents running in parallel, you get a lot of code to review quickly. The review process changes:

  • Focus on architecture, not syntax. The syntax will be correct. The question is whether the approach fits the system.
  • Check the boundaries. Where does this code interact with other code? Are the interfaces clean?
  • Look for what is missing. Agents are good at implementing what you asked for. They are bad at noticing what you forgot to ask for.
  • Run the tests. Do not trust that it "looks right." Execute it.

The New Skills

The developers who thrive in this model are the ones who can context-switch quickly between reviewing different agents' work, write specs that leave no room for misinterpretation, and have strong enough architectural intuition to catch structural problems in a quick scan.

Writing code is becoming a smaller part of the job. Thinking clearly about what code should do is becoming the whole job.

Fazm is an open source macOS AI agent. Open source on GitHub.

More on This Topic

Related Posts