Package Diagnostics Briefing
This chapter separates dependency shape, complexity pressure, and main-sequence distance into explicit diagnostic rules. Start with strict outliers where they exist; a Highest values group is a neutral fallback for orientation, not an AtlasArc problem verdict.
Subsystem-Level Architecture
Subsystem figures summarize boundary pressure, internal cohesion, and recursive architecture signals.
Where does boundary pressure concentrate across the visible architecture?
- Focus
- project root
- Curated view
- Boundary Risk
- Filter
- All visible packages
- Bubble
- Package-folder subsystem rollup
- X axis
- Fan-out
- Y axis
- Fan-in
- Size
- Classes
- Colour
- Instability
- How to read this graph: each bubble is a visible architecture-boundary rollup. Right means more outgoing boundary dependencies; up means more incoming boundary dependencies; size is total class count.
- Colour follows instability, so red means outgoing-heavy rather than automatically wrong. Use the figure to find boundary surfaces worth inspecting in Topology or Matrix.
- Dashed rings mark expanded aggregate boundaries whose visible descendants are also present. Terminal packages or source folders remain valid boundaries and use their own metrics.
Which subsystems expose a large public surface?
- Focus
- project root
- Curated view
- Visibility Surface
- Filter
- All visible packages
- Bubble
- Package-folder subsystem rollup
- X axis
- Relative visibility
- Y axis
- Abstractness
- Size
- Classes
- Colour
- Abstractness
- How to read this graph: each bubble is a visible architecture-boundary rollup. Right means more visible API surface; up and colour both follow abstractness; size is total class count.
- This view highlights boundary shape, not direct defect risk. A top/right bubble may be a deliberate public contract area.
- Dashed rings mark expanded aggregate boundaries whose visible descendants are also present. Terminal packages or source folders remain valid boundaries and use their own metrics.
Which subsystem areas contain internal cycle pressure?
- Focus
- project root
- Curated view
- Internal Tangles
- Filter
- All visible packages
- Bubble
- Package-folder subsystem rollup
- X axis
- cycleCount
- Y axis
- largestCycle
- Size
- packageCount
- Colour
- Cycle status
- How to read this graph: each bubble is a visible architecture-boundary rollup. Right means more fully contained package-cycle groups; up means the largest contained package cycle is larger; size is package count.
- Only package cycles fully inside the boundary count here. Terminal-package class/file tangles remain separate Package Internals evidence in Topology. Use the cycle tables, Topology, or Matrix for concrete dependency edges and cross-boundary cycle context.
- Dashed rings mark expanded aggregate boundaries whose visible descendants are also present. Terminal packages or source folders remain valid boundaries and use their own metrics.
Package Hotspots
Hotspot figures compare packages through the available coupling and complexity evidence.
Which leaf packages stand out by coupling pressure?
- Items
- Leaf packages
- Focus
- project root
- Scope
- Recursive
- Preset
- Coupling
- Bubble
- One leaf package
- X axis
- Fan-out
- Y axis
- Fan-in
- Size
- Lines of code
- Colour
- Instability
- Labels are shown for the largest report bubbles; inspect the package metrics table for the full ranked list.
Which leaf packages are visible to many callers and far from the main sequence?
- Items
- Leaf packages
- Focus
- project root
- Scope
- Recursive
- Preset
- Visibility
- Bubble
- One leaf package
- X axis
- Relative visibility
- Y axis
- Fan-in
- Size
- Classes
- Colour
- Distance from main sequence
- Labels are shown for the largest report bubbles; inspect the package metrics table for the full ranked list.
Which leaf packages sit far from the main sequence?
- Items
- Leaf packages
- Focus
- project root
- Scope
- Recursive
- Preset
- Zone Map
- Bubble
- One leaf package
- X axis
- Instability
- Y axis
- Abstractness
- Size
- Distance from main sequence
- Colour
- Distance from main sequence
- Labels are shown for the largest report bubbles; inspect the package metrics table for the full ranked list.
Package Diagnostic Signals
Use these short lists to find unusual dependency shape, complexity pressure, and main-sequence distance without treating every high value as a problem. Each rule is evaluated across the prepared report scope; cycle participation is shown only as context.
Dependency hubs
Which packages carry unusually broad dependency traffic in both directions?
These packages combine a wide consumer blast radius with broad outward knowledge. Understand their role before changing a contract or moving responsibilities.
AtlasArc found 53 values clearly separated from their peers in this report scope.
Continue in AtlasArcShow me the backboneIsolate the packages with the widest consumer blast radius and inspect who relies on them.How AtlasArc selected these rows
Rule: Fan-in or Fan-out is above its upper outlier cutoff and the other degree is at or above its 75th percentile.
Population: 1026 real leaf architecture units with Fan-in and Fan-out. Result: 53 qualified; showing 10.
Cutoff: Fan-in > 4.66 (1026 eligible values); Fan-out > 18.76 (1026 eligible values)
| Diagnostic evidence |
|---|
| Packagespring-boot-build.core.spring-boot-test.mainorg.springframework.boot.test.context |
|
| Packagespring-boot-build.module.spring-boot-jdbc.mainorg.springframework.boot.jdbc.autoconfigure |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.context.properties |
|
| Packagespring-boot-build.module.spring-boot-security.mainorg.springframework.boot.security.autoconfigure.actuate.web.servlet |
|
| Packagespring-boot-build.module.spring-boot-micrometer-metrics.mainorg.springframework.boot.micrometer.metrics.autoconfigure |
|
| Packagespring-boot-build.core.spring-boot-testcontainers.mainorg.springframework.boot.testcontainers.service.connection |
|
| Packagespring-boot-build.core.spring-boot-docker-compose.mainorg.springframework.boot.docker.compose.service.connection |
|
| Packagespring-boot-build.module.spring-boot-actuator-autoconfigure.mainorg.springframework.boot.actuate.autoconfigure.web.server |
|
| Packagespring-boot-build.module.spring-boot-r2dbc.mainorg.springframework.boot.r2dbc.autoconfigure |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot |
|
Incoming-heavy packages
Which packages are unusually depended on while relying on relatively little?
These are load-bearing packages whose contracts may affect many callers even though their own outward dependency surface stays comparatively narrow.
AtlasArc found 68 values clearly separated from their peers in this report scope.
Continue in AtlasArcShow me the backboneTrace the callers that make these packages part of the project's backbone.How AtlasArc selected these rows
Rule: Fan-in is above its upper outlier cutoff, Instability is at most 0.35, and dependency hubs are excluded.
Population: 923 real leaf architecture units with Instability. Result: 68 qualified; showing 10.
Cutoff: Fan-in > 4.66 (1026 eligible values)
| Diagnostic evidence |
|---|
| Packagespring-boot-build.core.spring-boot-autoconfigure.mainorg.springframework.boot.autoconfigure.service.connection |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.ssl |
|
| Packagespring-boot-build.module.spring-boot-actuator.mainorg.springframework.boot.actuate.endpoint |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.context.properties.bind |
|
| Packagespring-boot-build.module.spring-boot-health.mainorg.springframework.boot.health.contributor |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.convert |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.context.properties.source |
|
| Packagespring-boot-build.module.spring-boot-actuator.mainorg.springframework.boot.actuate.endpoint.web |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.web.servlet |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.util |
|
Outgoing-heavy packages
Which packages depend unusually broadly without serving many callers?
These packages know about many parts of the system. They may be healthy coordinators, or responsibilities may have accumulated in one place.
AtlasArc found 1 value clearly separated from its peers in this report scope.
Continue in AtlasArcTicking time bombsInspect the outward dependency seams and decide whether the package's responsibility is still coherent.How AtlasArc selected these rows
Rule: Fan-out is above its upper outlier cutoff, Instability is at least 0.65, and dependency hubs are excluded.
Population: 923 real leaf architecture units with Instability. Result: 1 qualified; showing 1.
Cutoff: Fan-out > 18.76 (1026 eligible values)
| Diagnostic evidence |
|---|
| Packagespring-boot-build.module.spring-boot-webmvc.mainorg.springframework.boot.webmvc.autoconfigure.actuate.web |
|
Main-sequence outliers
Which substantial packages sit unusually far from the main sequence?
These packages combine stability and abstraction in an unusual way for this project. That is a design question to inspect, not an automatic defect.
AtlasArc found 28 values clearly separated from their peers in this report scope.
Continue in AtlasArcIdentify risky hotspotsPlace these candidates beside size, dependency reach, and other hotspot evidence before prioritizing work.How AtlasArc selected these rows
Rule: Distance is above its upper outlier cutoff and at least 0.50, with total degree or LOC at or above its positive median.
Population: 923 real leaf architecture units with Distance. Result: 28 qualified; showing 10.
Cutoff: Distance > 0.83 (923 eligible values)
| Diagnostic evidence |
|---|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.system |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.context.metrics.buffering |
|
| Packagespring-boot-build.cli.spring-boot-cli.mainorg.springframework.boot.cli.command.status |
|
| Packagespring-boot-build.buildpack.spring-boot-buildpack-platform.mainorg.springframework.boot.buildpack.platform.json |
|
| Packagespring-boot-build.module.spring-boot-webclient-test.mainorg.springframework.boot.webclient.test.autoconfigure |
|
| Packagespring-boot-build.module.spring-boot-data-jdbc-test.mainorg.springframework.boot.data.jdbc.test.autoconfigure |
|
| Packagespring-boot-build.module.spring-boot-data-r2dbc-test.mainorg.springframework.boot.data.r2dbc.test.autoconfigure |
|
| Packagespring-boot-build.core.spring-boot-autoconfigure.mainorg.springframework.boot.autoconfigure.container |
|
| Packagespring-boot-build.module.spring-boot-devtools.mainorg.springframework.boot.devtools.livereload |
|
| Packagespring-boot-build.core.spring-boot.mainorg.springframework.boot.validation |
|