Imported from Lyd1aCla1r3/coding-agent-best-practices (
platforms/posit-assistant/.posit/assistant/skills/checkpoint/SKILL.md). Install upstream withnpx skills add Lyd1aCla1r3/coding-agent-best-practices --skill checkpoint. Copyright stays with the author.
Session Checkpoint Workflow
Purpose
Persist verified session state into session_checkpoint.md (capped at 150 lines) and archive a timestamped copy in checkpoints/ so subsequent sessions start from ground truth.
Execution Steps
- Audit Current State: Run
git status -sand list all files created, modified, or verified during the current session. - Archive Full Snapshot: Write a detailed session log to
checkpoints/checkpoint_YYYY-MM-DD_<phase>.mdcontaining full command outputs, architectural rationale, and resolved questions. - Update Rolling Checkpoint: Overwrite
session_checkpoint.mdin the project root with four concise sections:## Project & Scope: Target deliverables, active phase, and restore-point commit SHA.## Constraints & Decisions: Non-negotiable rules, frozen paths, and confirmed design choices.## Accomplished & Verified: Completed deliverables and the commands that verified them.## Next Phase Tasks: Ordered, actionable checklist for the next session.
- Enforce Line Cap: Run
wc -l session_checkpoint.mdand confirm the file is 150 lines or fewer. Move verbose tables or logs into the archived snapshot undercheckpoints/.
