==TODO== short human title

==TODO== one-sentence orientation — what this document does for the reader.

Doc class: ==TODO==

Repo: ==TODO==

Status: ==TODO==

Updated: ==TODO== 2026-09-02

Question: ==TODO==

Protocol: gator-blueprint-html-v1

==TODO== optional footer line — authors, related documents, cross-refs.

Summary

==TODO== 1-3 sentences that answer the question at the top of the page. If the reader only reads this box, what do they leave knowing?

Question / purpose

==TODO== the exact question or need this artifact answers. Restate the gator-question meta value in fuller form — the reader has already skimmed it in the header; this section gives it the space to breathe.

Flow

==TODO== one paragraph introducing the flow. For a procedure-visual, this is a numbered sequence. For a reference-explainer, this is sequential exposition that builds understanding.

==TODO== first step. Short heading, one or two sentences of body.
==TODO== second step (using the blue variant for emphasis or branching).
==TODO== third step.
==TODO== final step (green variant marks completion / done state).

==TODO== Stage A input

==TODO==

==TODO== Stage B transform

==TODO== Stage C output

Note

==TODO== a neutral aside — related context that doesn't fit inline.

Caution

==TODO== something to watch out for — a subtle constraint or a gotcha.

Warning

==TODO== a hard failure mode — mis-step here breaks something visible.

Confirmed

==TODO== a verified outcome — checked, works, safe to rely on.

Why this matters

==TODO== the load-bearing "so what?" answer. If the reader skips this, they can act on the flow above but won't know when to reach for it or when to reach past it.

Comparison / options

Option	When to use	Trade-off	Status
==TODO==	==TODO==	==TODO==	Recommended
==TODO==	==TODO==	==TODO==	Alternate
==TODO==	==TODO==	==TODO==	Not applicable

Failure modes

What breaks	Symptom	Fallback
==TODO==	==TODO==	==TODO==
==TODO==	==TODO==	==TODO==

References

==TODO== path/to/file.py — one-line description.
==TODO== Related document — one-line description.

Open questions

==TODO== what the author could not determine cleanly. Delete this section if there are none.

Protocol notes

This document conforms to the gator-blueprint-html-v1 protocol (narrative template). See .gator/procedures/authoring-html-artifacts.md for the required metadata, doc classes, and status vocabulary.