ArchPilotExecutable architecture guardrails

Search docs

Docs search

Validation rule

Back to Rule Catalog
AP-ARCH-010Architecture

Invalid ArchPilot project configuration JSON

Checks that the ArchPilot project configuration is valid JSON.

errorsetup-gapNo auto-fix

How to fix

  1. Fix the JSON syntax.
  2. Remove merge conflict markers.
  3. Validate the file with your editor or JSON parser before rerunning ArchPilot.

What the rule validates

The main ArchPilot configuration file cannot be parsed as JSON.

Why it matters

When configuration cannot be parsed, ArchPilot cannot reliably determine project type, modules, or rule settings.

Common causes

  • A trailing comma or comment was added to JSON.
  • A merge conflict marker was committed.
  • The file was partially written.

Typical violation example

{ "project": "api", }

Typical compliant example

{ "project": "api" }

Related rules

AP-ARCH-001 - Modular monolith folder structure existsAP-ARCH-002 - Implementation profile not fully supportedAP-ARCH-003 - Architecture overview artifact existsAP-ARCH-004 - Module baseline files exist

Adjacent categories

Architecture Rules

Related files/config

  • .archpilot/architecture.json

Related CLI commands

  • archpilot validate
  • archpilot validate --ci

Related docs

Rule CatalogSmart InitValidation & Findings
AP-ARCH-010 - Invalid ArchPilot project configuration JSON | ArchPilot Docs