ADR-0001: Verb-Noun Skill Naming
ADR-0001: Verb-Noun Skill Naming
Section titled “ADR-0001: Verb-Noun Skill Naming”Status: Accepted Date: 2026-05-18
Context
Section titled “Context”Skills need names that are memorable, discoverable by agents scanning a directory, and unambiguous
when grep’d. Early naming (single nouns like tdd, review) caused collisions and unclear intent.
Decision
Section titled “Decision”All skill directories use a two-word verb-noun kebab-case pair (e.g., develop-tdd,
audit-code, plan-work). Exceptions (meta-skills, mode toggles) must be documented in
CONVENTIONS.md — they are not silent deviations.
Consequences
Section titled “Consequences”- A global
grepfor any skill name returns < 5 results (grep-ability mandate, Akita #3). - Skills self-document their intent:
investigate-bugis unambiguous;debugis not. - Two-word constraint prevents sprawl — a skill that needs three words is probably two skills.
terse-modeandvisual-dashboardare named exceptions (adjective-noun); noted in CONVENTIONS.md.