# dominikh/go-tools architecture

> Architecture diagram of the GitHub repository dominikh/go-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dominikh/go-tools
- Repository: https://github.com/dominikh/go-tools

## Overview

Staticcheck is a Go static-analysis suite: its main workflow loads packages, runs registered checks, and presents diagnostics, with cache-backed execution. Its checks include bug/performance diagnostics, simplifications, style rules, and unused-code analysis. The README also documents separate struct-layout tools. The graph preserves those product branches and the IR/dataflow analysis layer; some subsystem links rely on README descriptions or indexed references rather than complete source excerpts.

Main entry points: [`analysis/lint/lint.go`](https://github.com/dominikh/go-tools/blob/master/analysis/lint/lint.go) (Analysis API), [`lintcmd/runner/runner.go`](https://github.com/dominikh/go-tools/blob/master/lintcmd/runner/runner.go) (Analysis runner), [`lintcmd/cmd.go`](https://github.com/dominikh/go-tools/blob/master/lintcmd/cmd.go) (Lint frontend), [`cmd/staticcheck/staticcheck.go`](https://github.com/dominikh/go-tools/blob/master/cmd/staticcheck/staticcheck.go) (Staticcheck CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and execution"]
  node_staticcheck_cli["Staticcheck CLI<br/>[staticcheck.go]"]
  node_frontend["Lint frontend<br/>[cmd.go]"]
  node_runner["Analysis runner<br/>[runner.go]"]
  node_cache[("Result cache<br/>[cache.go]")]
  node_diagnostics["Diagnostics output<br/>[format.go]"]
end

subgraph group_checks["Analysis checks"]
  node_registry["Staticcheck registry<br/>[analysis.go]"]
  node_staticchecks["Bug checks<br/>[sa1019.go]"]
  node_simplifications["Simplification checks<br/>[analysis.go]"]
  node_stylechecks["Style checks<br/>[analysis.go]"]
  node_quickfixes["Quick fixes<br/>[analysis.go]"]
  node_unused["Unused-code analysis<br/>[unused.go]"]
end

subgraph group_engine["Analysis engine"]
  node_lint_api["Analysis API<br/>[lint.go]"]
  node_code_helpers["Code inspection<br/>[code.go]"]
  node_reports["Report helpers<br/>[report.go]"]
  node_loader["Package loader<br/>[loader.go]"]
  node_ir_builder["SSA IR builder<br/>[builder.go]"]
  node_nilness["Nilness analysis<br/>[nilness.go]"]
end

subgraph group_utilities["Go utilities"]
  node_structlayout["Struct layout<br/>[main.go]"]
  node_layout_optimize["Layout optimizer<br/>[main.go]"]
  node_layout_pretty["Layout formatter<br/>[main.go]"]
end

node_developer(("Go developer"))

node_developer -->|"runs"| node_staticcheck_cli
node_staticcheck_cli -.->|"starts"| node_frontend
node_frontend -->|"runs checks"| node_runner
node_runner -->|"loads packages"| node_loader
node_runner -->|"caches results"| node_cache
node_runner -.->|"runs analyzers"| node_registry
node_registry -->|"registers"| node_staticchecks
node_frontend -.->|"formats findings"| node_diagnostics
node_staticchecks -->|"implements checks"| node_lint_api
node_simplifications -.->|"implements checks"| node_lint_api
node_stylechecks -.->|"implements checks"| node_lint_api
node_quickfixes -.->|"implements checks"| node_lint_api
node_unused -->|"uses analysis API"| node_lint_api
node_nilness -->|"analyzes IR"| node_ir_builder
node_structlayout -->|"shows layout"| node_developer
node_layout_optimize -->|"reorders fields"| node_developer
node_layout_pretty -->|"formats layout"| node_developer

click node_staticcheck_cli "https://github.com/dominikh/go-tools/blob/master/cmd/staticcheck/staticcheck.go"
click node_frontend "https://github.com/dominikh/go-tools/blob/master/lintcmd/cmd.go"
click node_runner "https://github.com/dominikh/go-tools/blob/master/lintcmd/runner/runner.go"
click node_cache "https://github.com/dominikh/go-tools/blob/master/lintcmd/cache/cache.go"
click node_diagnostics "https://github.com/dominikh/go-tools/blob/master/lintcmd/format.go"
click node_registry "https://github.com/dominikh/go-tools/blob/master/staticcheck/analysis.go"
click node_staticchecks "https://github.com/dominikh/go-tools/blob/master/staticcheck/sa1019/sa1019.go"
click node_simplifications "https://github.com/dominikh/go-tools/blob/master/simple/analysis.go"
click node_stylechecks "https://github.com/dominikh/go-tools/blob/master/stylecheck/analysis.go"
click node_quickfixes "https://github.com/dominikh/go-tools/blob/master/quickfix/analysis.go"
click node_unused "https://github.com/dominikh/go-tools/blob/master/unused/unused.go"
click node_lint_api "https://github.com/dominikh/go-tools/blob/master/analysis/lint/lint.go"
click node_code_helpers "https://github.com/dominikh/go-tools/blob/master/analysis/code/code.go"
click node_reports "https://github.com/dominikh/go-tools/blob/master/analysis/report/report.go"
click node_loader "https://github.com/dominikh/go-tools/blob/master/go/loader/loader.go"
click node_ir_builder "https://github.com/dominikh/go-tools/blob/master/go/ir/builder.go"
click node_nilness "https://github.com/dominikh/go-tools/blob/master/analysis/facts/nilness/nilness.go"
click node_structlayout "https://github.com/dominikh/go-tools/blob/master/cmd/structlayout/main.go"
click node_layout_optimize "https://github.com/dominikh/go-tools/blob/master/cmd/structlayout-optimize/main.go"
click node_layout_pretty "https://github.com/dominikh/go-tools/blob/master/cmd/structlayout-pretty/main.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_staticcheck_cli,node_frontend,node_runner,node_cache,node_diagnostics toneBlue
class node_registry,node_staticchecks,node_simplifications,node_stylechecks,node_quickfixes,node_unused toneAmber
class node_lint_api,node_code_helpers,node_reports,node_loader,node_ir_builder,node_nilness toneMint
class node_structlayout,node_layout_optimize,node_layout_pretty toneRose
class node_developer toneIndigo
```

## Components

### CLI and execution

- [Staticcheck CLI](https://github.com/dominikh/go-tools/blob/master/cmd/staticcheck/staticcheck.go): `cmd/staticcheck/staticcheck.go`
- [Lint frontend](https://github.com/dominikh/go-tools/blob/master/lintcmd/cmd.go): `lintcmd/cmd.go`
- [Analysis runner](https://github.com/dominikh/go-tools/blob/master/lintcmd/runner/runner.go): `lintcmd/runner/runner.go`
- [Result cache](https://github.com/dominikh/go-tools/blob/master/lintcmd/cache/cache.go): `lintcmd/cache/cache.go`
- [Diagnostics output](https://github.com/dominikh/go-tools/blob/master/lintcmd/format.go): `lintcmd/format.go`

### Analysis checks

- [Staticcheck registry](https://github.com/dominikh/go-tools/blob/master/staticcheck/analysis.go): `staticcheck/analysis.go`
- [Bug checks](https://github.com/dominikh/go-tools/blob/master/staticcheck/sa1019/sa1019.go): `staticcheck/sa1019/sa1019.go`
- [Simplification checks](https://github.com/dominikh/go-tools/blob/master/simple/analysis.go): `simple/analysis.go`
- [Style checks](https://github.com/dominikh/go-tools/blob/master/stylecheck/analysis.go): `stylecheck/analysis.go`
- [Quick fixes](https://github.com/dominikh/go-tools/blob/master/quickfix/analysis.go): `quickfix/analysis.go`
- [Unused-code analysis](https://github.com/dominikh/go-tools/blob/master/unused/unused.go): `unused/unused.go`

### Analysis engine

- [Analysis API](https://github.com/dominikh/go-tools/blob/master/analysis/lint/lint.go): `analysis/lint/lint.go`
- [Code inspection](https://github.com/dominikh/go-tools/blob/master/analysis/code/code.go): `analysis/code/code.go`
- [Report helpers](https://github.com/dominikh/go-tools/blob/master/analysis/report/report.go): `analysis/report/report.go`
- [Package loader](https://github.com/dominikh/go-tools/blob/master/go/loader/loader.go): `go/loader/loader.go`
- [SSA IR builder](https://github.com/dominikh/go-tools/blob/master/go/ir/builder.go): `go/ir/builder.go`
- [Nilness analysis](https://github.com/dominikh/go-tools/blob/master/analysis/facts/nilness/nilness.go): `analysis/facts/nilness/nilness.go`

### Go utilities

- [Struct layout](https://github.com/dominikh/go-tools/blob/master/cmd/structlayout/main.go): `cmd/structlayout/main.go`
- [Layout optimizer](https://github.com/dominikh/go-tools/blob/master/cmd/structlayout-optimize/main.go): `cmd/structlayout-optimize/main.go`
- [Layout formatter](https://github.com/dominikh/go-tools/blob/master/cmd/structlayout-pretty/main.go): `cmd/structlayout-pretty/main.go`

### Other components

- **Go developer**

## Connections

- Go developer → Staticcheck CLI: runs
- Staticcheck CLI → Lint frontend: starts
- Lint frontend → Analysis runner: runs checks (evidence: `lintcmd/cmd.go`)
- Analysis runner → Package loader: loads packages (evidence: `lintcmd/runner/runner.go`)
- Analysis runner → Result cache: caches results (evidence: `lintcmd/runner/runner.go`)
- Analysis runner → Staticcheck registry: runs analyzers
- Staticcheck registry → Bug checks: registers (evidence: `staticcheck/analysis.go`)
- Lint frontend → Diagnostics output: formats findings
- Bug checks → Analysis API: implements checks (evidence: `staticcheck/sa1019/sa1019.go`)
- Simplification checks → Analysis API: implements checks
- Style checks → Analysis API: implements checks
- Quick fixes → Analysis API: implements checks
- Unused-code analysis → Analysis API: uses analysis API (evidence: `unused/unused.go`)
- Nilness analysis → SSA IR builder: analyzes IR (evidence: `analysis/facts/nilness/nilness.go`)
- Struct layout → Go developer: shows layout
- Layout optimizer → Go developer: reorders fields
- Layout formatter → Go developer: formats layout
