Decision 0003 · Superseded
Skill naming and
catalog shape
Flow consolidated upstream skills into a self-contained skills/ directory. Legacy names were verbose, metaphor-heavy, or duplicated behavior.
- Status
- Superseded
- Built from:
- da88c48
Status: superseded for catalog shape by 0004 (2026-10-27). Naming patterns below remain historical context.
Context
Flow consolidated upstream skills into a self-contained skills/ directory. Legacy names were verbose, metaphor-heavy, or duplicated behavior. The distribution also carried a handoff skill outside the intended catalog and referenced retired setup workflows.
Decision
Adopt twenty-five short, technically accurate skill names grouped as core, discovery, delivery, quality, and writing. Rename managed skills on upgrade when the prior copy matches the installation manifest and has not been customized. Retire handoff and setup-matt-pocock-skills from the catalog; preserve customized copies on disk until reconciled.
Installation and catalog size were superseded by 0004.
Consequences
- Directory names, frontmatter
namefields, adapters, tests, and user-facing docs use the new vocabulary. exploreandrequirementsare distinct fromgrillandto-spec.- Historical research and archive material may retain old names as evidence.
Supersedes
None. This decision narrows the descriptive naming proposals recorded in writing.md without adopting that document's longer alternative names.