sitrep git:20261008.697c89fA

Immutable. This exact content never changes and is served at /api/v1/blob/73acfe3b767a3147.

---
name: sitrep
description: Start-of-session report on where a repository stands. Reads the project's own handoff and log files, checks live git state, and reports objective, verified baseline, open tasks, blockers, and next actions. Use when resuming work. Twin of finished.
---

# Situational report

Answer one question: **where does this project actually stand right now?** The value is in the gap between what the project's own documents claim and what the repository shows. Report the gap; never launder a stale document into a current fact.

## 0. Defer to the repository first

`Glob` for `.codex/prompts/*sitrep*.md`, `.codex/prompts/*status*.md`, and the same patterns under `.claude/commands/` — they catch variants such as `project-sitrep.md`. If one matches, `Read` it, follow its instructions instead of the steps below, and say which file you used. If several match, pick the closest name and say which. Otherwise continue here.

## 1. Learn the project's conventions

Read `AGENTS.md` and `CLAUDE.md` if present; they usually state the handoff or logging convention. Fall back to `README.md` for orientation. Then find the project's own memory: `HANDOFF.md`, `CODEX_HANDOFF.md`, `STATUS.md`, `SESSION_LOG.md`, `NOTES.md`, or a `logs/` directory with dated entries.

Use what the project has. If it keeps none, say so rather than inventing a format.

## 2. Check live state

```
git status --short
git log --oneline -n 8
git branch --show-current
git status -sb | head -1
```

Two failure modes are worth the extra commands. **A detached or behind branch:** if `git status -sb` shows divergence from the upstream, run `git fetch` and report the true position — a local branch can be many commits behind while the working tree looks clean. **Working-tree drift:** if the project syncs files outside git (Syncthing, Dropbox, a shared mount), a large uncommitted diff may be someone else's committed work that this clone's `.git` has not seen. Check before treating it as local change.

## 3. Confirm load-bearing artifacts, only if the project names them

If `AGENTS.md` or `README.md` names specific data files, build outputs, or directories as load-bearing, spot-check that they exist.

## 4. Report

Order by priority, not by discovery order. Cite concrete paths and commands.

- **Current objective** — from the handoff document if one exists, otherwise inferred from recent commits and `README.md`. Say which.
- **Completed baseline** — what is done *and verified*. Distinguish "committed" from "verified"; they are not the same claim.
- **Open tasks** — what is queued, with the file or command each would start from.
- **Risks and blockers** — anything stale, missing, half-finished, or contradicted by what the repository shows. When a handoff names commits, branches, artifacts, or versions the repository no longer matches, say so and propose the exact fix.
- **Immediate next actions** — a short numbered list the user can approve in one line.