lintai docs

Appearance

Rule Reference

SEC425lintai-ai-securitystablemarkdownwarn

AI markdown: bare Edit tool grant

AI-native markdown frontmatter grants bare `Edit` 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 Edit grants that omit a reviewed repo-local scope.

Deterministic signal basis

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

Malicious corpus
skill-unscoped-edit-allowed-tools
Benign corpus
skill-unscoped-edit-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

SEC423AI markdown: bare Read tool grantAI-native markdown frontmatter grants bare `Read` tool accessmarkdownstable
SEC424AI markdown: bare Write tool grantAI-native markdown frontmatter grants bare `Write` 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

SEC425 / MD-EDIT-UNSCOPED ​

SEC425 flags AI-native markdown frontmatter when allowed-tools or allowed_tools grants bare Edit.

This rule intentionally lives in the opt-in governance preset. Shared skills can legitimately edit files, but repo-wide default edit authority is a workflow-policy decision that deserves explicit review rather than headline security treatment.

Why It Matters ​

Bare Edit is a broad file-editing grant. In shared skills and instruction files, it makes open-ended content mutation part of the default team policy instead of a narrower reviewed edit scope.

Trigger Shape ​

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

Clean Cases ​

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

Example Trigger ​

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

Safer Example ​

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

How To Fix ​

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