TALAMANA · THE AI LITERACY MAP FOR ARCHITECTURE AND DESIGN · Studio Practice · AGE 19—22 · POSITIONAL · METHOD

Files a stranger can navigate

A folder an agent can read is one a person can read, because both are strangers.

When to use

At the start of every project, and on the first morning anyone new — human or machine — is expected to work in your folder.

The method

Treat the folder as a place a stranger has to find their way through. One entry point: a short read-me at the top that says what the project is, where the live files are, and where not to look. Paths that are obvious: folders named for what they hold, not for when they were made. One version convention, used everywhere: date and version in the name, never "final_final". One landmark: the current deliverable, marked so it cannot be mistaken for a superseded one. Archive the old; never leave it beside the live. Then test it — hand the folder to someone who has never seen it, and time them.

Watch for this

Legibility that lives in your head. You know which of the six "plan_v3" files is current. A convention is not a convention until it works with you out of the room.

The Lab's note

Legibility is a practice you train, not a knack. The Lab holds that a folder an agent can read is a folder a person can read, for one reason: both are strangers to it. This card draws on the Lab's own essay on agent legibility as wayfinding — its own material, not yet published. The book behind it is Lynch's.

Try it

Tidy one messy project folder so a stranger can find the current deliverable in one pass. Then write a naming convention, in ten lines, that a colleague and an agent could both follow unaided.

Prove it

Hand the folder to someone who has never seen it. How long before they find the live file, and know that it is the live one?

How it works

Kevin Lynch studied what makes a city readable to someone walking it for the first time — paths, edges, districts, nodes, landmarks. A project folder is the same problem at desk scale. A software lab reached the same conclusion from the other side: an agent working in a codebase needs "a map, not a 1,000-page instruction manual" — a short entry file that points onward, not an encyclopaedia. Legibility is a property of the place, not of the visitor.

What this idea builds on

What this idea opens up

Sources

Open this idea on the map · The complete map · Logika · RBDS AI Lab, India · revised every edition.

Age grows from 11 at the centre to 22 at the edge, and six sectors show the learning strands. Tab into the map and the arrow keys step from idea to idea, following the links where there is one. Enter opens the idea under the cursor, and E reads out its links and the reason recorded on each. Press slash for Search, question mark for the full key list, and Escape to leave. Open Ideas for the complete readable list, including what each idea builds on and what it opens up.

LOGIKA · RBDS AI LAB INDIA
ON-RAMP · AGE 11 · FIRST ENCOUNTERS, NOT GATES — IDEAS · — DEPENDENCIES
DONE
OPENS NEXT
SOLID — STANDS ON