Hamburger Cross Icon
Shell Guardrails - Shellcheck Clean

Shellcheck Clean

✓ Guardrail Shell Guardrails Beta Testing And Quality
shell.shellcheck-clean

Ensures ShellCheck finds no issues at or above the configured severity level (default: error). Skips if no shell scripts are detected. Severity filtering and warning threshold are both configurable.

shellcheck shell bash linting clean code quality
Get Started View All Shell Guardrails

Compatible Integrations

This guardrail works with the following integrations. Click to see how to use Shellcheck Clean with each collector.

+
Shellcheck Clean + Shell Collector Provides ShellCheck lint data for shell scripts
→

Enable This Guardrail

Add the parent policy to your lunar-config.yml to enable this guardrail.

📄 lunar-config.yml 
policies:
  - uses: github://earthly/lunar-lib/policies/shell@v1.0.5
    include: [shellcheck-clean]
    # with: ...

How This Guardrail Works

This guardrail is part of the Shell Guardrails policy. It evaluates data collected by integrations and produces a pass/fail check with actionable feedback.

When enabled, this check runs automatically on every PR and in AI coding workflows, providing real-time enforcement of your engineering standards.

Learn How Lunar Works →
1
↓ Integrations Gather Data
Collectors extract metadata from code, CI pipelines, tool outputs, and scans
2
{ } Centralized as JSON
All data merged into each component's unified metadata document
3
✓ This Guardrail Checks Current
Shellcheck Clean runs and provides pass/fail feedback

Configuration Options

These inputs can be configured in your lunar-config.yml to customize how the parent policy (and this guardrail) behaves.

Input Required Default Description
min_severity Optional error Minimum severity level to enforce (error, warning, info, style). Issues below this level are ignored.
max_shellcheck_warnings Optional 0 Maximum number of ShellCheck warnings allowed at or above min_severity (0 = must be completely clean)
Shell Guardrails

Shell Guardrails

This guardrail is part of the Shell Guardrails policy, which includes 1 guardrail for testing and quality.

View Policy

Ready to Automate Your Standards?

See how Lunar can turn your AGENTS.md, engineering wiki, compliance docs, or postmortem action items into automated guardrails with our 100+ built-in guardrails.

Works with any process
check AI agent rules & prompt files
check Post-mortem action items
check Security & compliance policies
check Testing & quality requirements
Automate Now
Paste your AGENTS.md or manual process doc and get guardrails in minutes
Book a Demo