lintai docs

Appearance

Rule Reference

SEC423lintai-ai-securitystablemarkdownwarn

AI markdown: bare Read tool grant

AI-native markdown frontmatter grants bare `Read` tool access

Provider
lintai-ai-security
Surface
markdown
Scope
per_file
Tier
stable
Severity
warn
Confidence
high
Detection
structural
Remediation
message_only

Activation Model

Preset Membership

This rule is part of the builtin activation graph through these preset memberships.

governancemembership

Lifecycle

Stable Lifecycle Contract

State

stable_gated

Graduation rationale

Checks AI-native frontmatter for bare Read grants that omit a reviewed repo-local scope.

Deterministic signal basis

MarkdownSignals exact frontmatter token detection for bare `Read` inside allowed-tools or allowed_tools.

Malicious corpus
skill-unscoped-read-allowed-tools
Benign corpus
skill-unscoped-read-allowed-tools-specific-safe
structured evidence required remediation reviewed
Canonical note

Structural stable rule intended as a high-precision check with deterministic evidence.

Nearby Signals

Related Rules

SEC424AI markdown: bare Write tool grantAI-native markdown frontmatter grants bare `Write` tool accessmarkdownstable
SEC425AI markdown: bare Edit tool grantAI-native markdown frontmatter grants bare `Edit` tool accessmarkdownstable
SEC426AI markdown: bare Glob tool grantAI-native markdown frontmatter grants bare `Glob` tool accessmarkdownstable
SEC427AI markdown: bare Grep tool grantAI-native markdown frontmatter grants bare `Grep` tool accessmarkdownstable
SEC505AI markdown: shared gh api POST tool grantAI-native markdown frontmatter grants `Bash(gh api --method POST:*)` tool accessmarkdownstable
SEC506AI markdown: shared gh issue create tool grantAI-native markdown frontmatter grants `Bash(gh issue create:*)` tool accessmarkdownstable

SEC423 / MD-READ-UNSCOPED ​

SEC423 flags AI-native markdown frontmatter when allowed-tools or allowed_tools grants bare Read.

This rule intentionally lives in the opt-in governance preset. Shared skills often need repository context, but repo-wide default read authority is a policy choice that deserves explicit review rather than headline security treatment.

Why It Matters ​

Bare Read is a broad file-access grant. In shared skills and instruction files, it turns open-ended repository reading into default policy instead of a narrower reviewed read scope.

Trigger Shape ​

  • AI-native markdown surface with parsed frontmatter
  • path is not fixture-like
  • allowed-tools or allowed_tools contains the exact token Read

Clean Cases ​

  • scoped patterns such as Read(./docs/**)
  • frontmatter that does not grant bare Read
  • fixture-like examples under test or fixture paths

Example Trigger ​

md
---
allowed-tools: Read, Write(./artifacts/**)
---

Safer Example ​

md
---
allowed-tools: Read(./docs/**), Write(./artifacts/**)
---

How To Fix ​

Review whether shared bare Read authority is really needed, or replace it with a narrower workflow-specific read scope instead of a default repo-wide grant.