Smarter Module Navigation: intentIndex & find-module CLI Tool

[kaanozhan]

As a project grows, so does STRUCTURE.json. For example Frame is currently 3,690 lines / 90KB covering 40 modules. AI agents read this file at every session start, but when they need to find files for a specific feature, they have to scan through all of it. The data is there, but there's no fast path to it.

What We Added

intentIndex — The structure update script now auto-groups modules by feature. 40 modules become 22 searchable features.
Generated on every commit, zero maintenance. For example :
find-module CLI tool — Instead of reading 3,690 lines, agents run a single command:

$ node scripts/find-module.js github
Feature: github
  src/main/githubManager.js    — GitHub Manager Module
  src/renderer/githubPanel.js  — GitHub Panel Module
  IPC: LOAD_GITHUB_ISSUES, OPEN_GITHUB_ISSUE, TOGGLE_GITHUB_PANEL
Three-layer search: exact match in intentIndex → partial match in module names → deep search in descriptions, exports, and IPC
channels.
Key Insight : 
Adding an index inside a large JSON file isn't enough — agents naturally default to grep/glob when searching. The fix was meeting the agent where it already works: the terminal. A CLI tool that returns 5 lines beats an index buried in 3,690 lines. AGENTS.md now  instructs agents to run find-module before manual searches.
Nothing in the existing system changed — session-start reading, pre-commit hook, module parsing all work exactly as before.