gh-coalesce-labs-catalyst-plugins-dev/commands/README.md

Thoughts Commands

Context handoff and collaboration tools using the thoughts system.

Commands

/create-handoff

Create handoff document for passing work to another developer or session.

Usage:

/create-handoff
> What work are you handing off?

Creates:

• Handoff document in thoughts/shared/handoffs/YYYY-MM-DD-description.md
• Includes: Current state, work completed, next steps, blockers, context

Content:

• Current ticket/task
• Work completed (with file:line references)
• Files modified
• Next steps (prioritized)
• Known blockers
• Important context

/resume-handoff

Resume work from handoff document.

Usage:

/resume-handoff thoughts/shared/handoffs/YYYY-MM-DD-file.md

Process:

• Reads full handoff document
• Loads context (ticket, files, blockers)
• Presents next steps
• Asks how to proceed

Benefits:

• Quick context restoration
• No lost work
• Clear continuation path

Use Cases

Handoffs:

• End of day → Resume next morning
• Developer → Developer
• Blocked work → When unblocked

Collaboration:

• Pair programming context
• Code review preparation
• Onboarding new team members

Thoughts System

Commands use the HumanLayer thoughts system:

• thoughts/personal/ - Your private notes
• thoughts/shared/ - Team-shared documents
• thoughts/global/ - Cross-project knowledge

Initialize with: humanlayer thoughts init