tomevault-io Conversation Handoff Summary
Required Output
This command generates and saves a markdown file. Always:
- Analyze the conversation
- Create the file using Write tool
- Save to:
./handoff-summary-YYYYMMDD-HHMMSS.md
The purpose is file creation, not just information display.
Generate comprehensive summary for AI agent handoff: $ARGUMENTS What This Command Does This command creates a detailed markdown summary of our entire conversation, structured to enable another AI agent to seamlessly continue the work. The summary includes:
Context and Background: Initial problem statement and user requirements Work Completed: Detailed list of all tasks accomplished Technical Decisions: Key architectural and implementation choices made Code Changes: Summary of files modified, created, or refactored Current State: Where the project stands now Pending Items: Any unfinished tasks or future considerations Important Notes: Critical information for continuation
Output Format The command generates a markdown file with the following structure: markdown# Project Handoff Summary Generated: [timestamp]
📋 Overview
Brief description of the project and main objectives
👤 User Context
- User's technical background and preferences
- Specific requirements and constraints
- Communication style preferences
🎯 Original Requirements
- Initial problem statement
- Key goals and objectives
- Success criteria
✅ Completed Work
Task 1: [Description]
- What was done
- Why this approach was chosen
- Key code changes
- Files affected
Task 2: [Description]
...
🏗️ Project Structure
Current state of the codebase:
- Directory structure
- Key files and their purposes
- Dependencies added/modified
🔧 Technical Decisions
Decision 1: [Topic]
- Options considered
- Chosen approach
- Rationale
Decision 2: [Topic]
...
💻 Code Examples
Key code snippets demonstrating important implementations
🚧 Current State
- What's working
- What's being worked on
- Known issues or limitations
📝 Pending Tasks
- Task 1
- Task 2
- Task 3
⚠️ Important Warnings
- Critical information to avoid breaking changes
- Security considerations
- Performance implications
🔄 Next Steps
Recommended actions for continuing the work
🗂️ Related Files
- File 1: Purpose and recent changes
- File 2: Purpose and recent changes
💡 Additional Context
Any other relevant information for smooth continuation Benefits of This Summary
Continuity: New agent can pick up exactly where we left off Context Preservation: All important decisions and rationale are documented Efficiency: Reduces need to re-explain or rediscover information Clarity: Structured format makes information easy to find Completeness: Captures both technical and conversational context
Usage Examples Basic usage: Generate handoff summary for current conversation With specific focus: Generate handoff summary focusing on authentication implementation For specific date range: Generate handoff summary for work done today Key Sections Explained User Context Captures communication preferences, technical level, and any specific requirements mentioned during conversation Technical Decisions Documents why certain approaches were chosen over others, preventing future agents from undoing intentional choices Code Examples Includes actual code snippets for complex implementations, ensuring the next agent understands the implementation style Important Warnings Highlights any critical information that could cause issues if not known (e.g., "Don't modify X because it will break Y") Related Files Lists all files that were created or modified, with brief descriptions of their purpose and changes Notes for the Next Agent The summary will include:
Conversation tone and style preferences Any tools or commands created during the session User's stated preferences (e.g., no emojis, no conventional commit prefixes) Current working directory and environment setup Any external dependencies or API keys mentioned
Output Options The command will:
Generate a comprehensive markdown file Save it as handoff-summary-[timestamp].md Display the content for review Optionally include conversation transcript excerpts for critical decisions
This ensures perfect continuity when switching between AI agents or resuming work after a break.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.