Skip to content

Routing Card Pattern

Use this pattern when adding a new situation to START-HERE.md. Keep the field names stable so the Markdown can later be parsed into a docs UI, search card, or lightweight web app route.

Blank routing card

FieldRoute
SituationShort user-facing prompt in the user’s words, such as “I have a call in the next 24 hours.”
Use whenThe conditions that make this route the right starting point.
Start hereOne primary playbook link, with optional secondary links only when they clarify the path.
Next artifactThe checklist, template, update, plan, email, or decision record the user should create next.
Common mistakeThe most likely failure mode to avoid.

Copy-paste snippet

markdown
### “Situation prompt goes here.”

| Field | Route |
| --- | --- |
| **Situation** |  |
| **Use when** |  |
| **Start here** |  |
| **Next artifact** |  |
| **Common mistake** |  |

Authoring guidelines

  • Write the Situation as a phrase someone would recognize under pressure.
  • Keep Start here focused on the first playbook to open, not every related document.
  • Make Next artifact concrete enough that the user knows what to produce before moving on.
  • Use Common mistake to prevent the behavior that usually creates rework, confusion, or customer risk.
  • Prefer relative Markdown links so the routing layer works in GitHub, local editors, generated docs sites, and future UI routes.

Example

FieldRoute
Situation“A POC is off track.”
Use whenSuccess criteria are slipping, blockers are accumulating, timeline is at risk, or stakeholder confidence is dropping.
Start herePOC recovery, then update the customer with the POC status update email.
Next artifactRecovery plan with blocker list, owner/date for each action, revised success criteria, and communication cadence.
Common mistakeWaiting until the final readout to acknowledge that the POC is not tracking to plan.

Built as a public field guide for practical Solutions Engineering and Architecture work.