ADR file missing title

How to fix

1. Add a top-level ADR title.
2. Keep the title specific to the decision.
3. Run validation again to confirm the ADR can be indexed.

What it means

An ADR file exists but does not include the expected title heading.

Why it matters

Titles make decisions scannable in reports, reviews, and generated architecture summaries.

Common causes

• An ADR was drafted from a blank file.
• The title uses a lower-level heading.
• Generated ADR content was pasted without the template heading.

Example bad pattern

A markdown ADR starts with plain text and no # heading.

Example good pattern

# ADR 004: Dependency governance and module boundary enforcement

Related files/config

• docs/adrs
• docs/architecture/overview.md

Related CLI commands

• archpilot validate
• archpilot validate --ci