P7.MRD.002 — CHANGELOG.md at the repository root

Field	Value
Principle	P7 (Machine-readability)
Pack	agent-tool
Severity	warn
Evidence	strong
Stability	experimental

What it checks

A CHANGELOG.md (or Changelog.md, changelog.md, CHANGES.md) exists at the repository root.

Why it matters

Agents driving a tool need a machine-readable record of what changed. Diff-ing two versions of a CLI's source is expensive and imprecise; a structured changelog makes the delta discoverable.

How to fix

Follow Keep a Changelog (https://keepachangelog.com). Minimum sections:

# Changelog

## [Unreleased]

### Added
- …

### Changed
- …

### Removed
- …

## [0.1.0] - 2026-04-24

### Added
- Initial public release.

See also

• archfit's own CHANGELOG.md as a template.