breadcrumbs

Capture goals, state, decisions, and next steps into node metadata.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/AGM1968/weave --skill breadcrumbs-agm1968
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breadcrumbs
Source: https://github.com/AGM1968/weave/tree/main/.claude/skills/breadcrumbs
Command: npx skills add https://github.com/AGM1968/weave --skill breadcrumbs-agm1968

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Breadcrumbs preserve session context by capturing current goals, state, decisions, and next steps to prevent context rot when handing off work or ending a session.

Core Features & Use Cases

  • Capture current goal, state, blocking issues, and next steps to create a concise handoff.
  • Record key files, decisions, discoveries, and questions for future reference.
  • Persist metadata at the node level and support automatic triggers (pre-compact-context and close-session) for seamless continuity.
  • Use cases include handing off a task to a teammate, pausing between tasks, or bridging sessions in long-running workstreams.

Quick Start

Invoke the breadcrumbs workflow by running the breadcrumbs command to capture the current session state and store it in the node metadata.

Frequently Asked Questions about breadcrumbs

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

FAQPage Schema
How do I preserve session context when switching tasks in AI-assisted coding workflows?

Session handoffs require capturing current goals, state, decisions, and next steps as node-level metadata. This prevents context rot by recording key files and blocking issues before transferring work to a teammate or ending a session.

What is the best way to prevent context loss when ending a long-running coding session?

Preventing context loss when ending a session involves triggering a close-session hook to automatically save current goals and discoveries. This stores essential metadata, ensuring seamless continuity for the next workstream.

How do I capture current goals and blocking issues for a teammate handoff?

Capture current goals and blocking issues for a handoff by invoking a breadcrumbs command to store session state. This records key files, decisions, and questions as concise node metadata for future reference by the next developer.

Does automatic metadata preservation work when compacting context in a session?

Automatic metadata preservation works during context compaction by exposing a pre-compact-context hook. This ensures current goals and next steps are stored before the context window is reduced, preventing loss of critical state.

Can I persist decisions and discoveries at the node level without manual triggers?

You can persist decisions and discoveries at the node level without manual triggers by enabling pre-compact-context and close-session hooks. These automatically store session metadata to bridge long-running workstreams seamlessly.