Configuration schema reference

Reference for the published aislop JSON Schema and every top-level .aislop/config.yml key.

The canonical JSON Schema for .aislop/config.yml is published at:

https://scanaislop.com/schema/aislop.config.schema.json

Use it with YAML Language Server for editor autocomplete and validation:

# yaml-language-server: $schema=https://scanaislop.com/schema/aislop.config.schema.json
version: 1

Top-level keys

Key	Type	Default	Description
version	number	1	Config schema version
engines	object	all true except architecture	Engine toggles
quality	object	function 80, file 400, nesting 5, params 6	Complexity thresholds
lint	object	typecheck: false	Lint-engine options
security	object	audit: true, auditTimeout: 25000	Security audit settings
scoring	object	default weights and labels	Score calculation settings
ci	object	failBelow: 70, format: json	CI gate settings
telemetry	object	enabled: true	Anonymous telemetry opt-in setting
rules	object	{}	Per-rule severity overrides
exclude	string array	node_modules, .git, dist, build, coverage	Paths to skip
include	string array	[]	Paths to include
extends	string or string array	none	Parent config paths

Engine keys

engines:
  format: true
  lint: true
  code-quality: true
  ai-slop: true
  architecture: false
  security: true

All engine values are booleans. architecture is disabled by default because it requires .aislop/rules.yml.

Quality keys

quality:
  maxFunctionLoc: 80
  maxFileLoc: 400
  maxNesting: 5
  maxParams: 6

All quality values must be positive numbers.

Scoring keys

scoring:
  weights:
    format: 0.3
    lint: 0.6
    code-quality: 0.8
    ai-slop: 1.0
    architecture: 1.0
    security: 1.5
  thresholds:
    good: 75
    ok: 50
  smoothing: 20
  maxPerRule: 40

weights accepts numeric values by engine name. thresholds.good controls the Healthy label, and thresholds.ok controls the Needs Work/Critical boundary.

Rule override values

The rules map accepts rule IDs as keys and one of three values:

Value	Meaning
error	Escalate matching findings to error
warning	Report matching findings as warnings
off	Remove matching findings before scoring

rules:
  ai-slop/narrative-comment: warning
  ai-slop/trivial-comment: "off"
  security/hardcoded-secret: error

Extends

extends can be a single path or an array of paths.

extends: ../../.aislop/base.yml

extends:
  - ../../.aislop/base.yml
  - ./local-overrides.yml

Paths are resolved relative to the config file that declares extends. Nested objects are deep-merged. Arrays are replaced wholesale. Chains deeper than five levels and circular references are rejected.

Related pages

• Config File gives the full config guide.
• Example Configs provides copy-ready profiles.
• Ignoring Code explains exclude, include, and .aislopignore.