From agent-almanac
Writes a CONTINUE_HERE.md file capturing session state so a fresh Claude Code session can pick up where the last one left off. Use when ending a session with unfinished work or handing off context between sessions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-almanac:write-continue-hereThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Write a structured continuation file so the next session starts with full context.
Write a structured continuation file so the next session starts with full context.
Gather facts about recent work:
git log --oneline -5
git status
git diff --stat
Review the conversation context: what was the objective, what was completed, what is partially done, what was tried and failed, what decisions were made.
Expected: Clear understanding of current task state — completed items, in-progress items, and planned next steps.
On failure: If not in a git repository, skip git commands. The continuation file can still capture conversational context and task state.
Write the file to the project root using the structure below. Every section must contain actionable content, not placeholders.
# Continue Here
> Last updated: YYYY-MM-DDTHH:MM:SSZ | Branch: current-branch-name
## Objective
One-paragraph description of what we are trying to accomplish and why.
## Completed
- [x] Finished item with key file paths (e.g., `src/feature.R`)
- [x] Decisions made and their rationale
## In Progress
- [ ] Partially complete work — describe current state (branch, file:line)
- [ ] Known issues with partial work
## Next Steps
1. Immediate next action (most important)
2. Subsequent actions in priority order
3. **[USER]** Items needing user input or decision
## Context
- Failed approaches and why they did not work
- Key constraints or trade-offs discovered
- Relevant issue/PR links
Guidelines:
**[USER]**Expected: A CONTINUE_HERE.md file at the project root with all 5 sections populated with real content from the current session. The timestamp and branch are accurate.
On failure: If Write fails, check file permissions. The file should be created in the project root (same directory as .git/). Verify .gitignore contains CONTINUE_HERE.md — if not, add it.
Read back CONTINUE_HERE.md and confirm:
git branch --show-currentExpected: The file reads as a clear, actionable handoff that a fresh session could use to immediately resume work.
On failure: Edit sections that contain placeholder text or are too vague. Each section should pass the test: "Could a fresh session act on this without asking clarifying questions?"
.gitignore includes CONTINUE_HERE.mdread-continue-here — the complement: reading and acting on the continuation file at session startbootstrap-agent-identity — cold-start identity reconstruction that consumes the continuation file this skill producesmanage-memory — durable cross-session knowledge (complements this ephemeral handoff)commit-changes — save work to git before writing the continuation filewrite-claude-md — project instructions where optional continuity guidance livesnpx claudepluginhub pjt222/agent-almanacSaves session state and writes a handoff note so the next Claude Code session can continue cleanly. Read/writes a remember.md file at the project root.
Wraps up a work session by recording changed files, caveats, decisions, and next steps so a fresh session can resume without re-deriving context.
Reads a CONTINUE_HERE.md continuation file at session start and resumes from where a prior session left off, detecting freshness, parsing structured handoff, and cleaning up after consumption.