# dmmulroy/anti-slop architecture

> Architecture diagram of the GitHub repository dmmulroy/anti-slop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dmmulroy/anti-slop
- Repository: https://github.com/dmmulroy/anti-slop

## Overview

anti-slop is an Oxlint plugin ruleset for flagging low-evidence and low-signal TypeScript/JavaScript patterns, with a separate opt-in plugin for Effect conventions. The main workflow is repository code being analyzed by Oxlint, which loads a plugin entry point, registers rules, and lets those rules inspect syntax and report violations; shared helpers support selected rule analyses. The README also describes a bundled agent skill for vendoring and updating the rules, but its installer internals are not mapped here. Edges reflect the entry-point imports, indexed source references, and README statements; unsampled rule internals are not assumed to call helpers.

Main entry points: [`src/index.ts`](https://github.com/dmmulroy/anti-slop/blob/main/src/index.ts) (Generic entry), [`src/rules/no-known-value-widening.ts`](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-known-value-widening.ts) (Known-value widening), [`src/effect/rules`](https://github.com/dmmulroy/anti-slop/tree/main/src/effect/rules) (Effect conventions), [`src/shared/type-alias-resolution.ts`](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/type-alias-resolution.ts) (Type alias resolution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin registration"]
  node_generic_entry["Generic entry<br/>[index.ts]"]
  node_effect_entry["Effect entry<br/>[index.ts]"]
end

subgraph group_generic["Generic rules"]
  node_generic_rules["Other generic rules"]
  node_widening["Known-value widening"]
  node_mocking["Module mocking"]
  node_object_params["Object parameters"]
  node_reduce_copy["Reducer copies"]
  node_unknown_returns["Unknown returns"]
  node_unsafe_dict["Unsafe dictionaries"]
  node_widen_assert["Widen then assert"]
  node_spacing["Readable spacing"]
  node_safety_comment["Assertion comments"]
end

subgraph group_analysis["Analysis helpers"]
  node_array_helper["Array analysis<br/>[array-method.ts]"]
  node_dict_helper["Dictionary analysis"]
  node_params_helper["Parameter analysis"]
  node_reflect_helper["Reflect analysis<br/>[reflect-method.ts]"]
  node_scope_helper["Scope resolution<br/>[scope.ts]"]
  node_alias_helper["Type alias resolution"]
  node_lexical_helper["Type parameters"]
end

subgraph group_effect["Effect rules"]
  node_effect_rules["Effect conventions"]
  node_tagged_values["Tagged values<br/>[tagged-values.ts]"]
end

node_oxlint(("Oxlint"))

node_oxlint -.->|"loads plugin"| node_generic_entry
node_oxlint -.->|"loads optionally"| node_effect_entry
node_generic_entry -->|"registers rules"| node_generic_rules
node_generic_entry -->|"registers"| node_widening
node_generic_entry -->|"registers"| node_mocking
node_generic_entry -->|"registers"| node_object_params
node_generic_entry -->|"registers"| node_reduce_copy
node_generic_entry -->|"registers"| node_unknown_returns
node_generic_entry -->|"registers"| node_unsafe_dict
node_generic_entry -->|"registers"| node_widen_assert
node_generic_entry -->|"registers"| node_spacing
node_generic_entry -->|"registers"| node_safety_comment
node_widening -->|"uses"| node_dict_helper
node_widening -->|"uses"| node_params_helper
node_widening -->|"uses"| node_scope_helper
node_reduce_copy -->|"uses"| node_array_helper
node_object_params -->|"uses"| node_params_helper
node_object_params -->|"uses"| node_alias_helper
node_unknown_returns -->|"uses"| node_alias_helper
node_unsafe_dict -->|"uses"| node_dict_helper
node_unsafe_dict -->|"uses"| node_alias_helper
node_generic_entry -.->|"separate plugin"| node_effect_entry
node_effect_entry -->|"registers rules"| node_effect_rules
node_effect_rules -->|"uses"| node_tagged_values
node_effect_rules -->|"uses"| node_tagged_values
node_effect_rules -->|"uses"| node_tagged_values
node_reflect_helper -->|"uses"| node_scope_helper
node_alias_helper -->|"uses"| node_lexical_helper

click node_generic_entry "https://github.com/dmmulroy/anti-slop/blob/main/src/index.ts"
click node_effect_entry "https://github.com/dmmulroy/anti-slop/blob/main/src/effect/index.ts"
click node_generic_rules "https://github.com/dmmulroy/anti-slop/tree/main/src/rules"
click node_widening "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-known-value-widening.ts"
click node_mocking "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-module-mocking.ts"
click node_object_params "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-object-parameters.ts"
click node_reduce_copy "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-reduce-accumulator-copy.ts"
click node_unknown_returns "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-unknown-returns.ts"
click node_unsafe_dict "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-unsafe-dictionary-type.ts"
click node_widen_assert "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-widen-then-assert.ts"
click node_spacing "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/require-readable-spacing.ts"
click node_safety_comment "https://github.com/dmmulroy/anti-slop/blob/main/src/rules/require-safety-comment-for-type-assertion.ts"
click node_array_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/array-method.ts"
click node_dict_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/dictionary-types.ts"
click node_params_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/function-parameters.ts"
click node_reflect_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/reflect-method.ts"
click node_scope_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/scope.ts"
click node_alias_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/type-alias-resolution.ts"
click node_lexical_helper "https://github.com/dmmulroy/anti-slop/blob/main/src/shared/lexical-type-parameters.ts"
click node_effect_rules "https://github.com/dmmulroy/anti-slop/tree/main/src/effect/rules"
click node_tagged_values "https://github.com/dmmulroy/anti-slop/blob/main/src/effect/shared/tagged-values.ts"

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_generic_entry,node_effect_entry toneBlue
class node_generic_rules,node_widening,node_mocking,node_object_params,node_reduce_copy,node_unknown_returns,node_unsafe_dict,node_widen_assert,node_spacing,node_safety_comment toneAmber
class node_array_helper,node_dict_helper,node_params_helper,node_reflect_helper,node_scope_helper,node_alias_helper,node_lexical_helper toneMint
class node_effect_rules,node_tagged_values toneRose
class node_oxlint toneIndigo
```

## Components

### Plugin registration

- [Generic entry](https://github.com/dmmulroy/anti-slop/blob/main/src/index.ts): `src/index.ts`
- [Effect entry](https://github.com/dmmulroy/anti-slop/blob/main/src/effect/index.ts): `src/effect/index.ts`

### Generic rules

- [Other generic rules](https://github.com/dmmulroy/anti-slop/tree/main/src/rules): `src/rules`
- [Known-value widening](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-known-value-widening.ts): `src/rules/no-known-value-widening.ts`
- [Module mocking](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-module-mocking.ts): `src/rules/no-module-mocking.ts`
- [Object parameters](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-object-parameters.ts): `src/rules/no-object-parameters.ts`
- [Reducer copies](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-reduce-accumulator-copy.ts): `src/rules/no-reduce-accumulator-copy.ts`
- [Unknown returns](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-unknown-returns.ts): `src/rules/no-unknown-returns.ts`
- [Unsafe dictionaries](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-unsafe-dictionary-type.ts): `src/rules/no-unsafe-dictionary-type.ts`
- [Widen then assert](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/no-widen-then-assert.ts): `src/rules/no-widen-then-assert.ts`
- [Readable spacing](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/require-readable-spacing.ts): `src/rules/require-readable-spacing.ts`
- [Assertion comments](https://github.com/dmmulroy/anti-slop/blob/main/src/rules/require-safety-comment-for-type-assertion.ts): `src/rules/require-safety-comment-for-type-assertion.ts`

### Analysis helpers

- [Array analysis](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/array-method.ts): `src/shared/array-method.ts`
- [Dictionary analysis](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/dictionary-types.ts): `src/shared/dictionary-types.ts`
- [Parameter analysis](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/function-parameters.ts): `src/shared/function-parameters.ts`
- [Reflect analysis](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/reflect-method.ts): `src/shared/reflect-method.ts`
- [Scope resolution](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/scope.ts): `src/shared/scope.ts`
- [Type alias resolution](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/type-alias-resolution.ts): `src/shared/type-alias-resolution.ts`
- [Type parameters](https://github.com/dmmulroy/anti-slop/blob/main/src/shared/lexical-type-parameters.ts): `src/shared/lexical-type-parameters.ts`

### Effect rules

- [Effect conventions](https://github.com/dmmulroy/anti-slop/tree/main/src/effect/rules): `src/effect/rules`
- [Tagged values](https://github.com/dmmulroy/anti-slop/blob/main/src/effect/shared/tagged-values.ts): `src/effect/shared/tagged-values.ts`

### Other components

- **Oxlint**

## Connections

- Oxlint → Generic entry: loads plugin (evidence: `README.md`)
- Oxlint → Effect entry: loads optionally (evidence: `README.md`)
- Generic entry → Other generic rules: registers rules (evidence: `src/index.ts`)
- Generic entry → Known-value widening: registers (evidence: `src/index.ts`)
- Generic entry → Module mocking: registers (evidence: `src/index.ts`)
- Generic entry → Object parameters: registers (evidence: `src/index.ts`)
- Generic entry → Reducer copies: registers (evidence: `src/index.ts`)
- Generic entry → Unknown returns: registers (evidence: `src/index.ts`)
- Generic entry → Unsafe dictionaries: registers (evidence: `src/index.ts`)
- Generic entry → Widen then assert: registers (evidence: `src/index.ts`)
- Generic entry → Readable spacing: registers (evidence: `src/index.ts`)
- Generic entry → Assertion comments: registers (evidence: `src/index.ts`)
- Known-value widening → Dictionary analysis: uses (evidence: `src/rules/no-known-value-widening.ts`)
- Known-value widening → Parameter analysis: uses (evidence: `src/rules/no-known-value-widening.ts`)
- Known-value widening → Scope resolution: uses (evidence: `src/rules/no-known-value-widening.ts`)
- Reducer copies → Array analysis: uses (evidence: `src/rules/no-reduce-accumulator-copy.ts`)
- Object parameters → Parameter analysis: uses (evidence: `src/rules/no-object-parameters.ts`)
- Object parameters → Type alias resolution: uses (evidence: `src/rules/no-object-parameters.ts`)
- Unknown returns → Type alias resolution: uses (evidence: `src/rules/no-unknown-returns.ts`)
- Unsafe dictionaries → Dictionary analysis: uses (evidence: `src/rules/no-unsafe-dictionary-type.ts`)
- Unsafe dictionaries → Type alias resolution: uses (evidence: `src/rules/no-unsafe-dictionary-type.ts`)
- Generic entry → Effect entry: separate plugin (evidence: `README.md`)
- Effect entry → Effect conventions: registers rules (evidence: `src/effect/index.ts`)
- Effect conventions → Tagged values: uses (evidence: `src/effect/rules/no-manual-effect-error-tag.ts`)
- Effect conventions → Tagged values: uses (evidence: `src/effect/rules/no-manual-tag-comparison.ts`)
- Effect conventions → Tagged values: uses (evidence: `src/effect/rules/no-manual-tagged-construction.ts`)
- Reflect analysis → Scope resolution: uses (evidence: `src/shared/reflect-method.ts`)
- Type alias resolution → Type parameters: uses (evidence: `src/shared/type-alias-resolution.ts`)
