scdenney/open-science-skills / codex/sitrep
sitrep
VerifiedStart-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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |