# ansible/ansible-lint architecture

> Architecture diagram of the GitHub repository ansible/ansible-lint, 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/ansible/ansible-lint
- Repository: https://github.com/ansible/ansible-lint

## Overview

ansible-lint is a command-line quality checker for Ansible content. The principal workflow is: a developer invokes the CLI, the application configures a lint run, the runner discovers and loads files, rule checks produce violations, and formatters report results. Separate branches cover syntax checking, schema validation, skip handling, and automatic fixes. The map uses the supplied excerpts and SOURCE INDEX references; some internal calls and the implementations of several documented rule families were not sampled, so their links are omitted where evidence is insufficient.

Main entry points: [`src/ansiblelint/app.py`](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/app.py) (Lint application), [`src/ansiblelint/runner.py`](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/runner.py) (Lint runner), [`src/ansiblelint/rules/__init__.py`](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/rules/__init__.py) (Rule collection), [`src/ansiblelint/output.py`](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/output.py) (Result output)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Invocation and configuration"]
  node_cli["Command interface<br/>[cli.py]"]
  node_app["Lint application<br/>[app.py]"]
  node_config["Lint options<br/>[config.py]"]
end

subgraph group_analysis["Lint analysis"]
  node_discovery["File discovery<br/>[file_utils.py]"]
  node_yaml["YAML handling<br/>[yaml_utils.py]"]
  node_runner["Lint runner<br/>[runner.py]"]
  node_rule_collection["Rule collection<br/>[__init__.py]"]
  node_rule_engine["Rule engine<br/>[rules.py]"]
  node_rule_checks["Rule checks"]
end

subgraph group_remediation["Results and fixes"]
  node_transformer["Autofix transformer<br/>[transformer.py]"]
  node_matches["Violation records<br/>[errors.py]"]
  node_output["Result output<br/>[output.py]"]
  node_formatters["Output formatters<br/>[__init__.py]"]
  node_stats["Run summary<br/>[stats.py]"]
end

subgraph group_support["Validation support"]
  node_syntax["Syntax check<br/>[syntax_check.py]"]
  node_skip["Skip handling<br/>[skip_utils.py]"]
  node_schema["Schema validation<br/>[main.py]"]
end

node_developer(("Developer"))
node_ansible{{"Ansible runtime"}}
node_yamllint{{"yamllint library"}}

node_developer -->|"invokes"| node_cli
node_cli -->|"starts"| node_app
node_app -->|"configures"| node_config
node_app -->|"runs"| node_runner
node_runner -->|"expands files"| node_discovery
node_runner -->|"runs rules"| node_rule_collection
node_rule_collection -->|"uses base rules"| node_rule_engine
node_rule_collection -.->|"loads checks"| node_rule_checks
node_runner -->|"checks syntax"| node_syntax
node_app -->|"uses YAML helpers"| node_yaml
node_app -->|"uses skip handling"| node_skip
node_app -->|"dispatches validation"| node_schema
node_runner -->|"collects violations"| node_matches
node_app -->|"applies fixes"| node_transformer
node_app -->|"emits results"| node_output
node_output -->|"formats results"| node_formatters
node_output -->|"summarizes run"| node_stats
node_rule_checks -.->|"checks content"| node_ansible
node_yaml -.->|"uses parsing support"| node_yamllint

click node_cli "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/cli.py"
click node_app "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/app.py"
click node_config "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/config.py"
click node_discovery "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/file_utils.py"
click node_yaml "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/yaml_utils.py"
click node_runner "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/runner.py"
click node_rule_collection "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/rules/__init__.py"
click node_rule_engine "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/_internal/rules.py"
click node_rule_checks "https://github.com/ansible/ansible-lint/tree/main/src/ansiblelint/rules"
click node_syntax "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/rules/syntax_check.py"
click node_skip "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/skip_utils.py"
click node_schema "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/schemas/main.py"
click node_transformer "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/transformer.py"
click node_matches "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/errors.py"
click node_output "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/output.py"
click node_formatters "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/formatters/__init__.py"
click node_stats "https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/stats.py"

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_cli,node_app,node_config toneBlue
class node_discovery,node_yaml,node_runner,node_rule_collection,node_rule_engine,node_rule_checks toneAmber
class node_transformer,node_matches,node_output,node_formatters,node_stats toneMint
class node_syntax,node_skip,node_schema toneRose
class node_developer,node_ansible,node_yamllint toneIndigo
```

## Components

### Invocation and configuration

- [Command interface](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/cli.py): `src/ansiblelint/cli.py`
- [Lint application](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/app.py): `src/ansiblelint/app.py`
- [Lint options](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/config.py): `src/ansiblelint/config.py`

### Lint analysis

- [File discovery](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/file_utils.py): `src/ansiblelint/file_utils.py`
- [YAML handling](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/yaml_utils.py): `src/ansiblelint/yaml_utils.py`
- [Lint runner](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/runner.py): `src/ansiblelint/runner.py`
- [Rule collection](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/rules/__init__.py): `src/ansiblelint/rules/__init__.py`
- [Rule engine](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/_internal/rules.py): `src/ansiblelint/_internal/rules.py`
- [Rule checks](https://github.com/ansible/ansible-lint/tree/main/src/ansiblelint/rules): `src/ansiblelint/rules`

### Results and fixes

- [Autofix transformer](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/transformer.py): `src/ansiblelint/transformer.py`
- [Violation records](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/errors.py): `src/ansiblelint/errors.py`
- [Result output](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/output.py): `src/ansiblelint/output.py`
- [Output formatters](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/formatters/__init__.py): `src/ansiblelint/formatters/__init__.py`
- [Run summary](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/stats.py): `src/ansiblelint/stats.py`

### Validation support

- [Syntax check](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/rules/syntax_check.py): `src/ansiblelint/rules/syntax_check.py`
- [Skip handling](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/skip_utils.py): `src/ansiblelint/skip_utils.py`
- [Schema validation](https://github.com/ansible/ansible-lint/blob/main/src/ansiblelint/schemas/main.py): `src/ansiblelint/schemas/main.py`

### Other components

- **Developer**
- **Ansible runtime**
- **yamllint library**

## Connections

- Developer → Command interface: invokes (evidence: `README.md`)
- Command interface → Lint application: starts (evidence: `src/ansiblelint/__main__.py`)
- Lint application → Lint options: configures (evidence: `src/ansiblelint/app.py`)
- Lint application → Lint runner: runs (evidence: `src/ansiblelint/app.py`)
- Lint runner → File discovery: expands files (evidence: `src/ansiblelint/runner.py`)
- Lint runner → Rule collection: runs rules (evidence: `src/ansiblelint/runner.py`)
- Rule collection → Rule engine: uses base rules (evidence: `src/ansiblelint/rules/__init__.py`)
- Rule collection → Rule checks: loads checks (evidence: `src/ansiblelint/rules/no_handler.py`)
- Lint runner → Syntax check: checks syntax (evidence: `src/ansiblelint/runner.py`)
- Lint application → YAML handling: uses YAML helpers (evidence: `src/ansiblelint/app.py`)
- Lint application → Skip handling: uses skip handling (evidence: `src/ansiblelint/app.py`)
- Lint application → Schema validation: dispatches validation
- Lint runner → Violation records: collects violations (evidence: `src/ansiblelint/runner.py`)
- Lint application → Autofix transformer: applies fixes (evidence: `src/ansiblelint/__main__.py`)
- Lint application → Result output: emits results (evidence: `src/ansiblelint/app.py`)
- Result output → Output formatters: formats results (evidence: `src/ansiblelint/app.py`)
- Result output → Run summary: summarizes run (evidence: `src/ansiblelint/app.py`)
- Rule checks → Ansible runtime: checks content (evidence: `README.md`)
- YAML handling → yamllint library: uses parsing support (evidence: `README.md`)
