Every app is a building.

The code is the blueprint. The running app is the building. The people inside are your users and your agents. Sightmap is the wayfinding that lets an agent find its way around without reading the blueprints first.

Code describes every wall.

Source files are the drawings the building was built from: components, routes, API handlers. They are complete and exact, and almost useless to someone standing in the lobby. Nothing on a blueprint says where the front desk is or which door sticks.

The running app is the building.

Deploy the code and the drawings become floors. Each view is a floor with its own route. Components are the rooms on that floor. API requests are the service risers running up the core, carrying data between the floors and the basement.

A sightmap is the signage.

Real buildings do not hand visitors blueprints. They put a directory in the lobby, numbers on the doors, and a note on the door that sticks. A .sightmap/ does the same for agents: names for every floor, room and riser, links back to the drawings, and memory for the quirks the drawings never recorded.

Every day, people move through it.

Users book a flight. Agents reproduce a bug, verify a fix, run a checkout. Each trip is a journey through rooms and floors, and Subtext records those journeys against the map, so a session reads as FlightSearch → FareCard → PaymentForm instead of a list of divs.

Tests that find the moved door.

When a room moves, a test written against selectors walks into a wall. A test written against the map asks the building where the room went. The selector changes, the name does not, and the run finishes.

Journeys you can name and rerun.

Codify a journey on top of the primitives: the floors it visits, the rooms it touches, the requests it expects on the way. A trajectory is a route through the building any agent can follow, and any run can be checked against.

A front desk for agents.

Once the building knows its own rooms, it can offer services at the door. Generate MCP tools from the map: search_flights, select_fare, create_booking, each backed by a real view and a real request. An agent walks up to the counter instead of wandering the halls.

Hand your agent the map.

A sightmap is YAML in your repo. Install the CLI, let an agent walk the building, and commit the wayfinding alongside the code.