Nguyen Le PhongNguyen Le Phong

Letting AI Draft While Humans Keep the Map

A practical reflection on using AI to draft faster while humans keep the system map: constraints, sources, ownership, and verification paths.

The assistant produced a useful first draft in less than a minute. It found the function, added a guard, wrote a test, and explained the change in a confident paragraph. The speed was impressive. The responsibility was unchanged. Someone still had to know whether this patch belonged on the real map of the system.

Two engineers compare an abstract code screen with a blank system map on paper at a quiet office table.
AI can draft a path, but humans still need to know where the path sits on the system map.

This is the distinction that keeps AI useful without letting it become a quiet source of drift. Drafting is not owning. A model can suggest code, summarize options, create examples, and find likely gaps. But the map of the system still belongs to the people accountable for running it.

The map is not only architecture diagrams. It includes business rules, runtime behavior, migration history, customer expectations, operational runbooks, and the ugly edge cases nobody would invent from a clean prompt. It includes the reasons a simple-looking shortcut is not safe in this codebase.

When humans keep the map, they choose what context the model sees. They point it to the spec, the failing test, the relevant files, and the live error. They ask for uncertainty, not just a patch. They make the assistant compare options against the system instead of asking it to fill a blank page with plausible code.

The review also changes. Instead of asking whether the generated code looks good, the reviewer asks whether it lands in the right place. Does it respect the boundary? Does it preserve the invariant? Does it make rollback possible? Does the test protect the behavior that matters, or only the implementation the model happened to write?

This does not make AI slow. It makes AI less wasteful. A good map lets the assistant draft in the right neighborhood. Without the map, the team may get impressive output that creates a new shortcut, duplicate helper, or policy leak. The patch can pass tests and still make the system harder to understand.

There is a healthy humility in letting AI draft. It admits that blank-page work is expensive and that machines can help us explore. There is also a necessary discipline in keeping the map. It admits that speed without orientation can still move the team in the wrong direction.

A practical habit is to end AI-assisted work with a human-owned trace. Which files grounded the answer? Which rule was protected? What was manually verified? What would make us roll this back? The trace keeps future readers from depending on a prompt they will never see.

Use AI for drafts, alternatives, checklists, and first-pass tests. But keep the map close enough that every generated line has a place to belong. In your next AI-assisted change, who is holding the map?

記事はいかがでしたか?