Next Up

Create or refresh NEXTUP.md at the current repository root so the user can resume this work after switching contexts. Resolve the root with git rev-parse --show-toplevel; outside Git, use the current working directory. Treat the file as one current snapshot rather than a history log.

Reconstruct the stopping point

1. Review the current agent conversation for the user's goal, completed work, decisions, failed attempts, validation results, unfinished work, and open questions. The conversation is the source of truth for intent.
2. Inspect the repository for the current branch, working-tree status, recent relevant commits, and the diff or changed files. Open only the artifacts needed to resolve uncertainty. The repository is the source of truth for what actually exists.
3. Read an existing NEXTUP.md for continuity. Carry forward only context that remains true and useful; rewrite the file as the present snapshot so completed or abandoned work does not accumulate.

Separate what is verified complete, what is still in progress, and what is merely recommended. State uncertainty instead of reconstructing missing context as fact. Keep secrets and sensitive personal data out of the persistent file.

Write NEXTUP.md

Get the current local time from the environment when writing the file. Use a timestamp with date, time, timezone abbreviation, and UTC offset, such as 2026-08-26 14:30:00 EDT (UTC-0400).

Use this structure: