What is a steering file?

Definition

An AI steering file stores guidance that should apply across agent tasks. It can describe architecture, commands, coding conventions, safety boundaries, review requirements and sources of truth so the agent does not depend on repeated conversational instructions.

Steering files need maintenance as tools and models improve. Stale or conflicting guidance can reduce performance, so teams should keep the file concise, test important rules outside the model and remove instructions that no longer serve the project.

ELI5

A steering file is a repository document that gives AI coding agents durable project guidance. It can describe architecture, commands, conventions, safety boundaries, review rules, and the sources that should be treated as authoritative.

For example, a project can state which test command must run and which folders an agent may edit. The file should stay concise and current because stale or conflicting instructions can misdirect every future agent task.

What belongs in an AI steering file?

It can include project structure, commands, conventions, required checks, permission boundaries, source-of-truth documents and escalation rules.

Why should steering files be updated?

Models, tools and codebases change, so outdated instructions can conflict with current behavior and create unnecessary constraints or errors.

  1. Clare Liguori beside the words Stop Babysitting Agents
Definition card for steering file: What is a steering file?

An AI steering file is a repository document that gives coding agents durable project context, conventions, constraints and workflow instructions.