Agent Atlas

Atlas · fluency

Files and folders

Where agents read and write. A path names a file by the folders that lead to it.

Established practiceDepth 1 of 4Reviewed 2026-11-08

See it working: Plate III

In plain words

Your computer keeps files in folders, and folders can hold more folders. A path such as my-app/src/AGENTS.md lists the folders to walk through to reach one file.

How it works

A path that starts with / begins at the root of the whole disk. Any other path starts from the folder you are in, called the current working directory. Two names are special: . means this folder and .. means the folder above it.

Going deeper

Agents use paths the same way you do. The folder a session starts in decides which instruction files load, and relative paths in its commands are read from there. On Plate III, watch the map as you cd up and down.

Sources

  1. POSIX.1-2024 Base Definitions: Pathname Resolution The Open Group / IEEE
    • The special filename dot-dot shall refer to the parent directory of its predecessor directory.
    • If the pathname begins with a <slash>, the predecessor of the first filename in the pathname shall be taken to be the root directory of the process
    • shall be taken to be either the current working directory of the process
  2. Custom instructions with AGENTS.md OpenAI
    • defaults to ~/.codex
    • Codex stops searching once it reaches your current directory
    • Codex includes at most one file per directory.

Quotes were checked against the live pages on 2026-11-08.