list-steps

When to use

• Steps need a sentence each. When each step carries a label plus a sentence of description. Lighter rosters of steps with short labels use the timeline variant; richer descriptions belong on the default cards.
• Three to five steps. Two steps wastes the layout's ledger feel; six begins to crowd. Group adjacent steps or split the process at a natural phase break.
• Prefix word names the unit. The default STEP prefix can swap to PHASE, STAGE, MILESTONE, RANK, or TIER. Pick the noun that matches how the audience already thinks about the process.

When not to use

• Light labels, no body. If each step is a single label with no description, use the timeline variant (dots on a spine). The default step cards earn their chrome only when the body adds substance.
• Parallel options. If the rows are alternatives the audience compares, use cards-grid or verdict-grid. The numbered prefix here reads as sequence — using it for parallel items mis-cues the audience.
• Author-typed step numbers. Don't write **STEP 01** into the markdown. The badge is CSS-generated from the ol counter; manual numbering double-stamps and breaks on reordering.

Common mistakes

• Authoring steps as a bullet list (-) instead of a numbered list (1.). The card chrome — background, border, STEP badge, connector arrow — is scoped to ol > li specifically; a ul renders as plain unstyled text with no cards, no counter, no badge.
• Deleting or reordering a step without checking other steps' prose for a stale reference to its old position (e.g. "as covered in step 3"). The STEP/PHASE/… badge is generated purely from a CSS counter() on the ol position — it renumbers automatically, but any prose that names a step by number does not.

Authoring

<!-- _class: list-steps -->

## How to roll this out.

1. First step — a sentence describing what you do here.
2. Second step — a sentence describing what you do here.
3. Third step — a sentence describing what you do here.
4. Fourth step — a sentence describing what you do here.

Slots

Anatomy

┌─────────────────────────────────────────┐
│  header                                 │
│  Step-by-step heading (horizontal).     │
│                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  │
│  STEP 01      STEP 02      STEP 03      │
│  label        label        label        │
│  body         body         body         │
│  └─────────┘  └─────────┘  └─────────┘  │
│  footer                           1/19  │
└─────────────────────────────────────────┘

Variant decision rule

• capsule — The tone is warmer and more editorial than an ops checklist — a personal or reflective process (a practice, a ritual, a habit). One class carries the whole look: centered masthead and cards, a pill badge per step in its own categorical hue, a serif title, no connector arrows, and no masthead hairline. Add rule-full if you want the hairline back. Its pill is the card tag at the inline placement, centered, in the categorical --cat-N-mark tier, so the tag: words (tag-plain, tag-none, tag-large, tag-foot) restyle it.
• vertical — The frame is narrow or portrait, or the step bodies need more vertical room — stacks steps down the page instead of across a row.
• chevron — The story argues through cascading stages (problem → vision → approach → plan) — down-chevron tabs read as a persuasive cascade rather than a neutral sequence.
• converge — The process narrows toward one outcome — a qualitative funnel shape without literal conversion percentages (use funnel when you have numbers).
• ghost — The argument is the point and the process is secondary — a faint chevron watermark behind one hero description, editorial in tone.
• timeline — Steps are light labels with no body copy — dots on a spine, not full description cards.
• phase — The audience already thinks of the sequence as phases rather than steps — swaps the badge prefix word; stage/milestone/rank/tier swap it to match other vocabularies the same way.
• lettered — The audience reads order as letters (A, B, C) rather than numbers — swaps the counter format; combine with a prefix-word variant (e.g. milestone lettered).
• roman — The sequence reads as eras or acts rather than a numbered checklist — swaps the counter format to roman numerals; typically paired with phase.

Variants

<!-- _class: list-steps vertical compact -->

## vertical stacks the steps down the page.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps chevron -->

## Make the case, one stage at a time.

1. Problem
   - Define the problem causing the pain.
2. Vision
   - Show the world once it is solved.
3. Approach
   - Detail the moves from here to there.
4. Plan
   - Commit to steps, owners, and a date.

<!-- _class: list-steps converge -->

## Many concerns narrow onto one plan.

1. Problem
   - Define the problem causing the pain.
2. Approach
   - Detail the moves from here to there.
3. Plan
   - Commit to steps, owners, and a date.

<!-- _class: list-steps ghost -->

## The argument, stated plainly.

1. Problem
   - Define the problem causing the pain.
2. Approach
   - Detail the moves from here to there.
3. Plan
   - Commit to steps, owners, and a date.

<!-- _class: list-steps timeline -->

## timeline strings the steps along a line.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps phase -->

## phase blocks each step as an era.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps milestone lettered -->

## milestone marks the steps as checkpoints.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps lettered -->

## lettered counts the steps with letters.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps stage -->

## stage prefixes each step with its stage tag.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps rank -->

## rank reads the numbers as standings.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps tier roman -->

## tier renders the steps as service tiers.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps phase roman -->

## roman counts the phases in numerals.

1. First
   - Three steps demo a look best.
2. Second
   - The look changes; the grammar holds.
3. Third
   - Body budgets do not move.

<!-- _class: list-steps capsule -->

## Turn the framework into a habit.

1. Name it
   - Say the verb and the reach you operate at today.
2. Pick the next move
   - One deeper verb, or the same verb carried wider.
3. Keep the evidence
   - A doc, a metric, a postmortem — proof the shift happened.

Related

• split-panelphase label + heading on the left, steps on the right
• roadmapphased grid across multiple workstreams
• listtenets or values (the principles variant) rather than a sequence; takeaway numbered for gating requirements rather than a sequence of actions
• funnela value-driven funnel with conversion percentages, rather than the qualitative converge variant