ArchPilotExecutable architecture guardrails

Search docs

Docs search

Validation rule

Back to Rule Catalog
AP-ARCH-009Architecture

Project rule configuration file is valid

Checks that the project rule configuration file can be parsed and used.

errorsetup-gapNo auto-fix

How to fix

  1. Open the rule configuration file and fix schema issues.
  2. Remove unsupported fields.
  3. Run validation again and review ignored config entries.

What it means

ArchPilot found the rule configuration file but could not validate its structure.

Why it matters

Invalid rule configuration can disable intended guardrails or make validation results confusing.

Common causes

  • The rules file has invalid JSON.
  • A rule override has the wrong shape.
  • A disabled-rule or severity entry references an invalid value.

Example bad pattern

A dependency rule config contains malformed JSON or unsupported severity values.

Example good pattern

Rule configuration parses cleanly and validation reports no ignored config entries.

Related files/config

  • .archpilot/dependency-rules.json
  • .archpilot/architecture.json

Related CLI commands

  • archpilot validate
  • archpilot validate --ci

Related docs

Rule CatalogDependency Rules & Module ContractsValidation & Findings
AP-ARCH-009 - Project rule configuration file is valid | ArchPilot Docs