Agent GOTCHAS

Gotchas

God Nodes (high connectivity)

These files have the most connections. Changes here have high blast radius.

• readmenator/_models.py (score: 206.30, imported by 101 files)
• readmenator/_config.py (score: 200.10, imported by 100 files)
• readmenator/_pipeline.py (score: 93.30, imported by 1 files)
• readmenator/_app.py (score: 92.70, imported by 16 files)
• readmenator/parsers/__init__.py (score: 48.20, imported by 3 files)
• readmenator/parsers/_base.py (score: 44.60, imported by 20 files)
• readmenator/_forcegraph.py (score: 44.30, imported by 10 files)
• readmenator/_diagrams.py (score: 39.70, imported by 9 files)

Blast Radius (change impact)

Editing these files can break the listed number of dependents. Run their tests after any change.

• readmenator/_category.py -- 9 direct, 104 total dependents
• readmenator/_models.py -- 50 direct, 101 total dependents
• readmenator/_config.py -- 50 direct, 100 total dependents
• readmenator/parsers/_base.py -- 20 direct, 45 total dependents
• readmenator/_purpose.py -- 7 direct, 38 total dependents
• readmenator/_rank.py -- 11 direct, 38 total dependents
• readmenator/_resolver.py -- 7 direct, 36 total dependents
• readmenator/_project_config.py -- 9 direct, 34 total dependents
• readmenator/_htmlpack.py -- 8 direct, 33 total dependents
• readmenator/_viewer_ui.py -- 5 direct, 33 total dependents

Hotspots (complexity + centrality)

• readmenator/_vendor/force-graph.min.js -- complexity: 0.4, centrality: 1.0, combined: 0.7
• readmenator/_diagrams.py -- complexity: 1.0, centrality: 0.0, combined: 0.4
• readmenator/_app.py -- complexity: 0.9, centrality: 0.1, combined: 0.4
• readmenator/_video.py -- complexity: 0.9, centrality: 0.0, combined: 0.4
• readmenator/_mcp_server.py -- complexity: 0.7, centrality: 0.0, combined: 0.3
• readmenator/_pipeline.py -- complexity: 0.5, centrality: 0.1, combined: 0.2
• readmenator/_flowcharts.py -- complexity: 0.6, centrality: 0.0, combined: 0.2
• readmenator/_graphrag.py -- complexity: 0.5, centrality: 0.0, combined: 0.2
• readmenator/_apidocs.py -- complexity: 0.5, centrality: 0.0, combined: 0.2
• readmenator/_apidocs_render.py -- complexity: 0.5, centrality: 0.0, combined: 0.2

Layer Violations

• tests/test_apidocs.py (testing) -> readmenator/_apidocs_page.py (presentation): testing must not import presentation
• tests/test_apidocs.py (testing) -> readmenator/_apidocs_render.py (presentation): testing must not import presentation
• tests/test_components.py (testing) -> readmenator/_components.py (presentation): testing must not import presentation
• tests/test_flowcharts.py (testing) -> readmenator/_apidocs_page.py (presentation): testing must not import presentation
• tests/test_folder_readme.py (testing) -> readmenator/_components.py (presentation): testing must not import presentation
• tests/test_layout_quality.py (testing) -> readmenator/_forcegraph_page.py (presentation): testing must not import presentation
• tests/test_project_config.py (testing) -> readmenator/_viewer_ui.py (presentation): testing must not import presentation
• tests/test_project_config.py (testing) -> readmenator/_viewer_ui.py (presentation): testing must not import presentation
• tests/test_project_config.py (testing) -> readmenator/_viewer_ui.py (presentation): testing must not import presentation
• tests/test_project_config.py (testing) -> readmenator/_forcegraph_page.py (presentation): testing must not import presentation