# The list (the-list.jsx)

The tracker is a single-file React artifact covering every lane. `assets/the-list.jsx` ships as a seed with one example card per lane so you can see the shape; `assets/the-list.blank.jsx` is the same component with one placeholder card per section instead, for starting from nothing. The newest version always lives in the most recent HQ chat's outputs, so prefer the file you last attached over either shipped asset.

## Structure

- `KEY`: storage key, bump on every rebuild (`the-list.v1` to `v2`) so the artifact reloads from the new seed instead of stale storage.
- `TODAY`: the rebuild date, used in history stamps.
- `LANES`: your own lanes (the shipped seed uses client, business, builds, home, family, career, content). Every card carries one. The bar has a lane filter; "all" is the default.
- `SECTIONS`: now (Start right now), logoff (Before you log off tonight), tomorrow (First thing tomorrow), nextweek, weekafter, housekeeping, reviewer (Waiting on the reviewer), others (Waiting on others), parked. Rename or trim these to fit how you actually plan.
- `STATUSES`: todo, progress, blocked, waiting, done, plus ongoing.
- `SEED`: array of `{ id, lane, section, status, title, notes, history }`. Ids are stable; reuse an existing id when a card moves, allocate a new one (max + 1) for new cards.

## Card conventions

- Title: the subject first, then the thing (client, app, person, task). "Client name: two-piece build, page turn and a data-intersection page, due 9/10 call."
- Notes carry everything a fresh chat needs to write the next prompt: the deadline and who set it, the decisions made, the links (repo, PR, task, live URL, doc), who is out, and the ready prompt's chat name if one exists. Notes are the memory; titles are the scan.
- History: one line per state change, dated. Keep it terse: "Created from the call", "PR opened", "Reviewer merged".
- Waiting cards name who is being waited on in the title.
- A card that waits on the reviewer lives in the reviewer section, not with the client, so Start right now only holds what you can act on.
- Done cards keep their notes (links especially) and move to status done; they are hidden as harvested, not deleted.

## Rebuild procedure

1. Read the current file with bash. Locate `SEED`.
2. Apply every "Tracker for the list" line queued in the chat, in order. Where a queued line and a later message disagree, the later message wins.
3. Reorder Start right now so the first card is the first thing to start.
4. Bump `KEY` and `TODAY`. Update the subtitle line ("Updated ...") to the rebuild moment.
5. Write to your outputs folder, present it, and give a five-line summary of what moved.

## Kickoff file for the next HQ chat

`hq-kickoff-M-D.md`, produced alongside the rebuilt tracker at the end of a long chat. Contents: the standing rules in bullet form (label every block, complete prompts, approval gate, who merges, real URLs, attention-minute logging, your session ceiling, chat naming), then "Where things stand" as Running / Waiting on the reviewer / Waiting on others / Next up, then your preference reminders, then "Start by telling me what to do first."