santiago revised this gist . Go to revision
1 file changed, 5 insertions, 2 deletions
important-indexes.md
| @@ -12,8 +12,11 @@ These indexes are how future sessions access project knowledge without re-readin | |||
| 12 | 12 | | `atomique-menu` | `Disks/System.atdsk/Lua/menu/system/` | 17 files — MenuBarView.lua, MenuBarController.lua, SystemMenuBar.lua, MenuBarComponent.lua, DropDownMenu.lua, MenuFlowView.lua, etc. | | |
| 13 | 13 | | `atomique-desk` | `Disks/System.atdsk/Lua/desk/` | 6 files — DeskView.lua, DeskIcons.lua, DeskItemView.lua, Wallpaper.lua, etc. | | |
| 14 | 14 | | `atomique-c` | `src/` | 39 files — main.c, bindings_common.c, lua_runtime.c, app_thread.c, view.c, wm.c, draw.c, fb.c, mouse.c, readable_c/ etc. | | |
| 15 | - | | `atomique-agents` | `agents.md` | Agent instructions, conventions, build rules | | |
| 16 | - | | `atomique-session-summary` | `SESSION_SUMMARY.md` | Session history and architecture overview | | |
| 15 | + | | `atomique-agents` | `dev_docs/agents.md` | Agent instructions, conventions, build rules | | |
| 16 | + | | `atomique-architecture` | `dev_docs/architecture.md` | Architecture overview (view system, events, threads, etc.) | | |
| 17 | + | | `atomique-bugs` | `dev_docs/bugs.md` | Known bugs and pending issues | | |
| 18 | + | | `atomique-session-summary` | `dev_docs/SESSION_SUMMARY.md` | Session history and milestones | | |
| 19 | + | | `atomique-important-indexes` | `dev_docs/important-indexes.md` | This file — index catalog | | |
| 17 | 20 | ||
| 18 | 21 | ## Searching | |
| 19 | 22 | ||
santiago revised this gist . Go to revision
1 file changed, 1 insertion
important-indexes.md
| @@ -11,6 +11,7 @@ These indexes are how future sessions access project knowledge without re-readin | |||
| 11 | 11 | | `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. | | |
| 12 | 12 | | `atomique-menu` | `Disks/System.atdsk/Lua/menu/system/` | 17 files — MenuBarView.lua, MenuBarController.lua, SystemMenuBar.lua, MenuBarComponent.lua, DropDownMenu.lua, MenuFlowView.lua, etc. | | |
| 13 | 13 | | `atomique-desk` | `Disks/System.atdsk/Lua/desk/` | 6 files — DeskView.lua, DeskIcons.lua, DeskItemView.lua, Wallpaper.lua, etc. | | |
| 14 | + | | `atomique-c` | `src/` | 39 files — main.c, bindings_common.c, lua_runtime.c, app_thread.c, view.c, wm.c, draw.c, fb.c, mouse.c, readable_c/ etc. | | |
| 14 | 15 | | `atomique-agents` | `agents.md` | Agent instructions, conventions, build rules | | |
| 15 | 16 | | `atomique-session-summary` | `SESSION_SUMMARY.md` | Session history and architecture overview | | |
| 16 | 17 | ||
santiago revised this gist . Go to revision
1 file changed, 51 insertions
important-indexes.md(file created)
| @@ -0,0 +1,51 @@ | |||
| 1 | + | # Important Indexes — Atomique Knowledge Base | |
| 2 | + | ||
| 3 | + | The atomique codebase is indexed in the context-mode knowledge base for cross-session recall. | |
| 4 | + | These indexes are how future sessions access project knowledge without re-reading source files. | |
| 5 | + | ||
| 6 | + | ## Indexed Sources | |
| 7 | + | ||
| 8 | + | | Source label | Path | Contents | | |
| 9 | + | |-------------|------|----------| | |
| 10 | + | | `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. | | |
| 11 | + | | `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. | | |
| 12 | + | | `atomique-menu` | `Disks/System.atdsk/Lua/menu/system/` | 17 files — MenuBarView.lua, MenuBarController.lua, SystemMenuBar.lua, MenuBarComponent.lua, DropDownMenu.lua, MenuFlowView.lua, etc. | | |
| 13 | + | | `atomique-desk` | `Disks/System.atdsk/Lua/desk/` | 6 files — DeskView.lua, DeskIcons.lua, DeskItemView.lua, Wallpaper.lua, etc. | | |
| 14 | + | | `atomique-agents` | `agents.md` | Agent instructions, conventions, build rules | | |
| 15 | + | | `atomique-session-summary` | `SESSION_SUMMARY.md` | Session history and architecture overview | | |
| 16 | + | ||
| 17 | + | ## Searching | |
| 18 | + | ||
| 19 | + | Use `ctx_search` with optional `source` filter to scope results: | |
| 20 | + | ||
| 21 | + | ```lua | |
| 22 | + | ctx_search(queries: ["mouse event dispatch", "addSubview coordinate"]) | |
| 23 | + | ctx_search(queries: ["menu bar coordinate system"], source: "atomique-menu") | |
| 24 | + | ctx_search(queries: ["constants list"], source: "atomique-core") | |
| 25 | + | ``` | |
| 26 | + | ||
| 27 | + | ## Re-indexing After Changes | |
| 28 | + | ||
| 29 | + | The index is static — it captures file content at the time of indexing. | |
| 30 | + | After modifying any file in an indexed source, re-index that source: | |
| 31 | + | ||
| 32 | + | ```lua | |
| 33 | + | -- Single file | |
| 34 | + | ctx_index(path: "Disks/System.atdsk/Lua/core/atm.lua", source: "atomique-core") | |
| 35 | + | ||
| 36 | + | -- Entire directory (preferred after batch changes) | |
| 37 | + | ctx_index(path: "Disks/System.atdsk/Lua/core", source: "atomique-core") | |
| 38 | + | ``` | |
| 39 | + | ||
| 40 | + | **Rule:** Every agent that modifies a file in an indexed source must re-index | |
| 41 | + | that source before reporting done. | |
| 42 | + | ||
| 43 | + | ## Adding New Indexes | |
| 44 | + | ||
| 45 | + | When a new module or file becomes important enough to search across sessions: | |
| 46 | + | ||
| 47 | + | ```lua | |
| 48 | + | ctx_index(path: "path/to/file.lua", source: "atomique-<category>") | |
| 49 | + | ``` | |
| 50 | + | ||
| 51 | + | Add it to the table above and update the source label in `agents.md`. | |
Newer
Older