broken-import

What it catches#

@import names a file that does not exist.

An @path import in a CLAUDE.md, a .claude/rules/ file, a GEMINI.md, or an AGENTS.md that Claude Code reads directly, where the file does not exist. The import is silent: Claude Code and Gemini CLI load what they can find and say nothing about the rest. A token that looks like an npm package (@scope/name, one slash, no extension) is a note with a hint, because it is far more often a package name than a file, and in a heading (# @scope/name) it is not reported at all. Closing quotes and punctuation are not part of the token, and an @name inside double quotes ("Thanks @user") is a mention, not an import.

Why it matters#

Claude Code and Gemini CLI load imported files with the instructions. A missing file means the instructions are silently incomplete.

@AGENTS.md
@docs/conventions.md
@docs/missing-guide.md

@AGENTS.md
@docs/conventions.md
@docs/contributing.md

We use `@tanstack/query` for data fetching.

How to fix#

Correct the path (relative to the file that contains the import) or remove the line. Wrap package names and handles in backticks when they start a line.

Suppress or configure#

For one finding, put a comment on the line above it. The reason after -- is optional but worth writing:

<!-- asitis-disable-next-line broken-import -- why this one is fine -->

For a whole file:

<!-- asitis-disable-file broken-import -- why this file is an exception -->

For every file, turn it off or change its severity in .asitisrc.json:

{ "rules": { "broken-import": "off" } }

A .asitisrc.json overrides entry limits a change to some paths, and a baseline (asitis lint --format json --write-baseline) accepts today's findings so only new ones fail the build.

Source#

Claude Code docs: How Claude remembers your project, read on 14 October 2026.