Stay updated โ€” Join the build list for tutorials and AI insights. No spam.

Architecture Queries

Advanced architecture questions for system understanding, design reviews, and onboarding.

Architecture Queries

Deeper architecture questions for system understanding, design reviews, and technical decision-making.

๐Ÿ—๏ธ System-Level Questions

Overall Architecture

1graphify query "describe the overall architecture of this project"
2graphify query "what are the main architectural patterns used?"
3graphify query "how is the codebase organized at a high level?"

Data Flow

1graphify query "describe the data flow from YouTube URL to Hugo content page"
2graphify query "how does data flow through the dictionary extraction pipeline?"
3graphify query "what is the data flow for anki flashcard generation?"

Module Boundaries

1graphify query "what are the module boundaries in this project?"
2graphify query "which modules are tightly coupled?"
3graphify query "show the dependency graph between major subsystems"

๐Ÿ”ง Subsystem Deep-Dives

Pipeline Architecture

1graphify query "describe the youtube content pipeline architecture"
2graphify query "how does the vocabulary extraction pipeline handle errors?"
3graphify query "what are the stages in the anki generation pipeline?"

Configuration & Extensibility

1graphify query "how is configuration managed across the project?"
2graphify query "how do skills integrate with the main application?"
3graphify query "what extension points exist for adding new content types?"

Build & Deployment

1graphify query "describe the Hugo build process and customizations"
2graphify query "how does the task automation work?"
3graphify query "what are the deployment steps for this site?"

๐ŸŽฏ Design Review Questions

Before Adding Features

1graphify query "where would a new content type fit in the current architecture?"
2graphify query "what existing patterns should a new skill follow?"
3graphify query "which modules would a new pipeline stage touch?"

Refactoring Candidates

1graphify query "which modules have the most incoming dependencies?"
2graphify query "what are the most complex functions by cyclomatic complexity?"
3graphify query "which files are central hubs in the dependency graph?"

Technical Debt

1graphify query "where are the circular dependencies?"
2graphify query "which modules violate layering principles?"
3graphify query "what code is unused or unreachable?"

๐Ÿ“Š Visualization Queries

Community Structure

1graphify query "what communities exist in the codebase?"
2graphify query "which files belong to the 'YouTube Pipeline' community?"
3graphify query "show the relationship between communities"

Centrality & Importance

1graphify query "which files are most central in the graph?"
2graphify query "what are the hub files that connect subsystems?"
3graphify query "which symbols are most referenced across the codebase?"

๐Ÿงช Example Session: Onboarding

 1# 1. Big picture
 2graphify query "project overview"
 3
 4# 2. Subsystems
 5graphify query "what are the main subsystems?"
 6# โ†’ Dictionary, YouTube, Anki, Lexicon, JupyterLite
 7
 8# 3. Pick one
 9graphify query "how does the Dictionary subsystem work?"
10
11# 4. Pipeline
12graphify query "describe the data flow in the Dictionary pipeline"
13
14# 5. Key files
15graphify explain scripts/dictionary/extract_vocab.py
16
17# 5. Config
18graphify query "how is the Dictionary pipeline configured?"
19
20# 6. Extension
21graphify query "how would I add a new vocabulary source?"

๐Ÿ’ก Query Tips for Architecture

TipExample
Ask for “architecture” or “design”graphify query "architecture of the skill system"
Use “data flow” for pipelinesgraphify query "data flow from transcript to Hugo page"
Ask for “boundaries” for couplinggraphify query "module boundaries in scripts/dictionary"
Request “patterns” for conventionsgraphify query "patterns used for Hugo content generation"

Next Steps