Skip to content

ADR-0011 -- Naming Convention Overhaul and Atomic Rename Cascade

Status

Accepted

Context

The original artifact names mixed conventions: .instructions.md suffixes, .agent.md files, titlecase template names, and underscored singletons. Inconsistency made cross-references fragile and the surface hard to navigate.

Decision

D-LAUNCH-6 retires the legacy name forms: .instructions.md -> .md, .agent.md -> AGENT.md folder pattern, Master-Plan-Suite-Template.md -> master_template.md. D-LAUNCH-8 mandates that every rename is atomic: a pre-rename link-check sweep, a single git-mv cascade, and a post-rename link-check confirmation.

Consequences

This decision is captured as D-LAUNCH-6/8 in the launch suite spec.

See also