# Important Indexes — Atomique Knowledge Base

The atomique codebase is indexed in the context-mode knowledge base for cross-session recall.
These indexes are how future sessions access project knowledge without re-reading source files.

## Indexed Sources

| Source label | Path | Contents |
|-------------|------|----------|
| `atomique-core` | `Disks/System.atdsk/Lua/core/` | 22 files — atm.lua, boot.lua, constants.lua, Window.lua, bookmarks.lua, url.lua, mainloop.lua, gfx.lua, animation.lua, etc. |
| `atomique-views` | `Disks/System.atdsk/Lua/views/` | 49 files — View.lua, TableView.lua, ButtonView.lua, ScrollView.lua, FlowView.lua, TextInput.lua, TextArea.lua, protocols/ etc. |
| `atomique-menu` | `Disks/System.atdsk/Lua/menu/system/` | 17 files — MenuBarView.lua, MenuBarController.lua, SystemMenuBar.lua, MenuBarComponent.lua, DropDownMenu.lua, MenuFlowView.lua, etc. |
| `atomique-desk` | `Disks/System.atdsk/Lua/desk/` | 6 files — DeskView.lua, DeskIcons.lua, DeskItemView.lua, Wallpaper.lua, etc. |
| `atomique-agents` | `agents.md` | Agent instructions, conventions, build rules |
| `atomique-session-summary` | `SESSION_SUMMARY.md` | Session history and architecture overview |

## Searching

Use `ctx_search` with optional `source` filter to scope results:

```lua
ctx_search(queries: ["mouse event dispatch", "addSubview coordinate"])
ctx_search(queries: ["menu bar coordinate system"], source: "atomique-menu")
ctx_search(queries: ["constants list"], source: "atomique-core")
```

## Re-indexing After Changes

The index is static — it captures file content at the time of indexing.
After modifying any file in an indexed source, re-index that source:

```lua
-- Single file
ctx_index(path: "Disks/System.atdsk/Lua/core/atm.lua", source: "atomique-core")

-- Entire directory (preferred after batch changes)
ctx_index(path: "Disks/System.atdsk/Lua/core", source: "atomique-core")
```

**Rule:** Every agent that modifies a file in an indexed source must re-index
that source before reporting done.

## Adding New Indexes

When a new module or file becomes important enough to search across sessions:

```lua
ctx_index(path: "path/to/file.lua", source: "atomique-<category>")
```

Add it to the table above and update the source label in `agents.md`.