architecture-navigator

Scan the DevPrep AI codebase and map its 7-folder architecture.

Updated Sep 21, 2025
One-click install
npx skills add https://github.com/ArieGoldkin/devPrepAi --skill architecture-navigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-navigator
Source: https://github.com/ArieGoldkin/devPrepAi/tree/main/.claude/skills/architecture-navigator
Command: npx skills add https://github.com/ArieGoldkin/devPrepAi --skill architecture-navigator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides instant architecture intelligence about the DevPrep AI codebase, enabling quick placement decisions, module discovery, and architectural validation without digging through documentation.

Core Features & Use Cases

  • Architecture Scanning: Generate a real-time map of the 7-folder structure and key locations.
  • Interactive Placement Queries: Answer questions like "where should X go?" using the 7-folder rules.
  • Module Discovery: List existing modules and explain their purpose.
  • Architecture Validation: Ensure code organization follows the 7-folder architecture rules.

Quick Start

Run the architecture scanner from project root: bash ./.claude/skills/architecture-navigator/scripts/scan_architecture.sh Review the compact markdown summary showing the 7-folder structure, key locations, and quick stats. Then ask placement questions like "Where should a new feature go?"

Frequently Asked Questions about architecture-navigator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map the DevPrep AI codebase structure to understand where code should go?

Architecture scanning generates a real-time map of the 7-folder structure showing key locations and module organization. Run the scanner from project root to visualize the entire codebase layout, then use placement queries to determine where new features belong within the established architecture rules.

Where should I place a new feature in a 7-folder architecture?

The architecture navigator answers placement questions by applying 7-folder rules to your codebase. After scanning, ask specific questions like "where should X go?" and receive recommendations based on existing module patterns and architectural constraints.

Can I validate my code organization against architecture rules?

Yes. Architecture validation checks whether your code organization follows 7-folder structure rules and flags misalignment. The scanner provides real-time validation with a compact markdown summary showing compliance status and suggested corrections.

How do I discover existing modules and understand their purpose?

Module discovery lists all existing modules in the scanned architecture and explains their purpose within the 7-folder structure. This helps you understand current code organization and find relevant modules for integration or extension.

What's the fastest way to get architectural context during development?

Run the architecture scanner as your first step to generate an instant markdown summary of the 7-folder structure, key locations, and quick statistics. This gives you immediate context for placement decisions without reading documentation.

Does this work for understanding large codebases with multiple modules?

Yes. The scanner handles real-time codebase scanning and generates architecture maps that show how multiple modules fit within the 7-folder structure, making it suitable for complex projects with many interdependent components.