AIToday
Large Language ModelsAI Coding AssistantsZenn AI/MLPublished: Oct 9, 2026, 22:00 JST

Coding agents can read UserService.ts, so instructions shift to context and constraints

Coding agents can read UserService.ts, so instructions shift to context and constraints

The essay contrasts earlier prompts that spelled out opening UserService.ts and editing getUser with current prompts that state only the problem, constraints and a request to investigate impact — leaving the class and method choice to the AI.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Context & Analysis

The essay frames this as a moving target rather than a fixed best practice. When models could not explore a whole codebase and struggled to run long autonomous tasks, breaking work into steps like opening a file or fixing a method was a rational way to keep the AI from getting lost. Agents that can search, read files and inspect existing patterns change that calculus, because the human no longer has to be the one to decompose the work.

It also draws a line around delegation. Letting the AI choose implementation details does not remove the human role: defining the problem and done conditions, supplying business knowledge that code cannot express, setting constraints and exposure, verifying output, and making the final call on production release stay with people. The essay points to domain distinctions — for example, when customer, applicant and contractHolder are genuinely different business concepts, that difference reflects the domain model rather than naming taste, and the AI may not be able to infer it from code alone.

A caution runs alongside the argument. Detailed instructions can narrow the options the AI considers, so the author suggests letting it investigate and compare implementation approaches. But the wider the delegated range, the more important it is to decide in advance what to check to catch failures, and work without tests, review, diff checks or rollback should not be handed over unconditionally.

FAQ
What should I stop putting in my instructions to a coding AI?
The essay says to stop deciding implementation details in advance, such as naming the class to change or specifying sessionStorage. Those are things the AI can check from the codebase itself.
What should humans still decide?
Architecture decisions, security requirements and the range of changes allowed should be stated explicitly, not guessed at by the AI. Humans also keep problem definition, done criteria, verification and the final call on release.
Why can detailed instructions be a problem?
If a human decides up front that a specific class must be changed, the AI will follow that even when changing another layer would be more natural. Handing over purpose and constraints lets the AI compare implementation options instead.

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleIIHS: self-driving cars see 68% fewer crashes