Reticle Docs: verification for AI coding agents

@reticlehq/eslint-plugin exists because conventions rot. Someone adds a mutation, forgets the signal, and every verdict for that flow quietly drops a grade. Nothing breaks, the tests still pass, the evidence just gets weaker. A lint rule is the only way a convention survives contact with a deadline. Version 2.8.0. Apache 2.0. Depends on @typescript-eslint/utils. Peer dependency: eslint >= 9.

npm i -D @reticlehq/eslint-plugin

Exports

Export	What it is
`default`	The plugin object: `{ meta: { name: 'reticle' }, rules, configs }`
`rules`	`{ 'require-signal-on-mutation': ..., 'no-internal-tags': ... }`
`requireSignalOnMutation`	The rule, exported individually
`noInternalTags`	The rule, exported individually

The rules

`reticle/require-signal-on-mutation`

Warns when a store mutation happens without a mapped Reticle signal. Message id: mutationWithoutSignal. Text: store mutation without a mapped Reticle signal. Options (options[0], no additional properties):

Option	Type	Default
`mutators`	`string[]`	`[]`. With the default the rule is a no-op, which is deliberate: name your own mutators
`signalCallee`	`string \| string[]`	`['reticleSignal', 'signal']`

'reticle/require-signal-on-mutation': ['warn', {
  mutators: ['setState', 'commit', 'dispatch'],
  signalCallee: ['reticleSignal'],
}]

The check is scoped per function: a mutation and its signal must live in the same function body.

`reticle/no-internal-tags`

Errors on internal design-doc reference codes and internal version strings appearing in comments, file names, directory names or test descriptions. Message id: internalTag, with a { tag } placeholder. No options. This one is mostly for contributors to Reticle itself, but the recommended config turns it on for everyone.

The recommended config

One config, recommended:

import reticle from '@reticlehq/eslint-plugin';

export default [reticle.configs.recommended];

Which is exactly:

{
  plugins: { reticle: plugin },
  rules: {
    'reticle/require-signal-on-mutation': 'warn',
    'reticle/no-internal-tags': 'error',
  },
}

recommended enables both rules, and no-internal-tags at error. An older README documented only the first rule, so the second can arrive as a surprise. Enable the rules individually if you want just the signal check.

Why signals are the strongest evidence

What a signal proves that a rendered pixel cannot.

Last modified on August 15, 2026

⌘I

Tools

Beyond the loop

CLI commands

Packages

Grammar

Long form

@reticlehq/eslint-plugin

Exports

The rules

`reticle/require-signal-on-mutation`

`reticle/no-internal-tags`

The recommended config

Why signals are the strongest evidence

​Exports

​The rules

​reticle/require-signal-on-mutation

​reticle/no-internal-tags

​The recommended config

Why signals are the strongest evidence

Exports

The rules

`reticle/require-signal-on-mutation`

`reticle/no-internal-tags`

The recommended config