start-fresh

Automates session capture to memento vault and updates pending work records.

Updated Oct 1, 2024
One-click install
npx skills add https://github.com/einargudnig/dotfiles --skill start-fresh-einargudnig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-fresh
Source: https://github.com/einargudnig/dotfiles/tree/main/claude/skills/start-fresh
Command: npx skills add https://github.com/einargudnig/dotfiles --skill start-fresh-einargudnig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures the current session to the memento vault and updates MEMORY.md with pending work pointers, then prompts the user to /clear.

Core Features & Use Cases

  • Session capture to the memento vault (decisions, discoveries, patterns)
  • Update MEMORY.md with per-worktree pending items and pointers to relevant files
  • Prompt user guidance to run /clear to start a fresh context

Quick Start

Capture the current session state to the memento vault and update MEMORY.md, then prompt the user to run /clear.

Frequently Asked Questions about start-fresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save my coding session state before clearing the context window?

To save your coding session state before clearing context, you can trigger a checkpoint capture that saves decisions, discoveries, and patterns to a memento vault while updating MEMORY.md with pending work pointers. This ensures no critical context is lost.

What is the best way to manage pending work items across different git worktrees?

Managing pending work items across git worktrees is handled via per-worktree scope detection using git rev-parse. The system updates MEMORY.md with pending items and pointers relevant to the specific worktree, keeping isolated branch tasks organized.

Does this session checkpoint process work automatically with git worktrees?

Yes, the session checkpoint process works with git worktrees by automatically detecting the worktree scope via git rev-parse. It ensures that saved mementos and pending items in MEMORY.md are scoped correctly to the current working directory.

How do I restore context after running /clear during a session reset?

After running /clear to reset context, previous session state is restored by referencing the updated MEMORY.md file. This file contains pointers to relevant files and pending work items saved during the checkpoint capture.

Can I use session management commands to capture context without losing track of decisions?

Yes, you can use session management commands like start fresh, save and clear, or checkpoint to capture context without losing decisions. These commands automate saving the session state to a memento vault before prompting a context reset.