Open-source spec · v0.1

Teach agents how to see
and use your site.

sitemap.xml tells search engines how to crawl your site.
.sightmap/ teaches agents how to use it.

Quickstart Read the spec →

A YAML map of your app's views, components, and API routes — checked into your repo, shared across every agent, and learned from the running app, not the source code.

What a coding agent sees when it opens a date picker —
before and after a sightmap.

snapshot — without .sightmap/ a11y

uid=1_0  RootWebArea "Book a flight"
uid=1_3  textbox "Departure date"
uid=1_8  button "Previous Month"
uid=1_9  button "Next Month"
uid=1_10 generic "July 2025"
uid=1_19 gridcell "Choose Tuesday, July 1st, 2025"
uid=1_20 gridcell "Choose Wednesday, July 2nd, 2025"
uid=1_21 gridcell "Choose Thursday, July 3rd, 2025"
         …28 more gridcells…

snapshot — with .sightmap/ a11y

[View: FlightSearch "/search"]
[Guide]
- DepartureDatePicker accepts typed YYYY-MM-DD
  // skips opening the calendar
- Arrow keys navigate the grid; Enter selects; Esc closes
- Past dates render but are aria-disabled
- Range: 1st click = start, 2nd = end, 3rd resets

uid=1_0  RootWebArea "Book a flight"
uid=1_1  FlightSearchForm visible
uid=1_3    DepartureDatePicker [src: src/components/DatePicker.tsx] visible interactive
uid=1_4      date-input visible interactive
uid=1_8      prev-month visible interactive
uid=1_9      next-month visible interactive
uid=1_10     month-label "July 2025" visible
uid=1_19     day "Choose Tuesday, July 1st, 2025" visible interactive
         …30 more days…