liveBook · Manning

Multi-file task

As explained in Vibe Engineering

Multi-file code generation is the generation or modification of coordinated source-code changes across multiple files.

A multi-file task coordinates changes across several source files. Treating it like a single-file edit creates a poor tool choice: reserve agent mode for work that must preserve relationships across files, rather than for one trivial change. section 9.2.2

A practical policy starts with one binary decision: use agent mode for multi-file tasks and avoid it for isolated edits. This captures most of the savings without an elaborate usage matrix, while recognizing that autonomous sessions can remain expensive. section 9.2.2

Choose capability according to the task’s coordination burden:

  • Use local models for high-volume, simple work such as tab completion and focused single-file tasks. section 9.3.1
  • Use cloud frontier models for cross-cutting work, such as refactoring session management across an authentication system or debugging a race condition spanning three services. section 9.3.1
  • Expect a capability gap on the hardest tasks: multi-file work requires maintaining a mental model of the codebase and reasoning about architectural trade-offs. section 9.3.1

How Vibe Engineering covers it

How deep it goes
Distinguishes tool choice and model capability, but stops short of specifying implementation contracts, tests, or review procedures.
Examples
Uses accumulated chores, authentication refactoring, three-service race conditions, and codebase-wide architectural trade-offs as examples.
What you can do after
Apply agent mode to coordinated changes and route simpler work to local models while reserving cloud models for complex cross-cutting tasks.
How it connects
Connects multi-file tasks with agent mode, local models, cloud models, single-file tasks, and architectural reasoning.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Vibe Engineering. The section links point to the parts of the book it draws on.