architecture-navigatorlisted

# Architecture Navigator ## Overview Provide instant architecture intelligence for the DevPrep AI codebase. Generate architecture maps, answer placement questions ("where should X go?"), and validate code organization against the 7-folder structure. This skill eliminates the need to manually read architecture documentation at conversation start. ## Core Capabilities ### 1. Architecture Scanning When starting a development conversation or when explicitly requested, scan the codebase to generate a real-time architecture map. **How to scan:** ```bash # Run the architecture scanner from project root bash ./.claude/skills/architecture-navigator/scripts/scan_architecture.sh ``` The scanner will output: - **7-Folder Structure**: modules/, shared/, lib/, store/, types/, styles/, app/ - **Module List**: All feature modules with file counts - **Key Locations**: API layer, state management, UI components - **Quick Stats**: Total files, module count, component count **When to scan:** - At the start of development conversations about architecture - When asked "what modules exist?" or "what's the structure?" - Before suggesting where new code should go - When validating architecture compliance **Output format:** Compact markdown summary (~50-100 lines) showing the current architecture state. --- ### 2. Interactive Placement Queries Answer "where should X go?" questions using the 7-folder placement rules. **Decision tree:** 1. **Is it a route/page?** → `app/` (but keep minima