Auto-Discovery Pattern for Workflow Commands

This document defines the standard pattern for commands that should automatically discover recent documents from workflow context.

The Problem

Commands have bash scripts to check workflow context, but they're suggestions for Claude - not guaranteed to execute. Users shouldn't have to paste file paths when we just created the file.

The Solution

Explicit, mandatory auto-discovery at the start of every workflow command.

Standard Pattern

1. Initial Response (REQUIRED)

Every workflow command must start with this EXACT pattern:

## Initial Response

When this command is invoked, IMMEDIATELY run this bash script BEFORE responding to the user:

```bash
# Auto-discover recent document from workflow context
if [[ -f "${CLAUDE_PLUGIN_ROOT}/scripts/workflow-context.sh" ]]; then
  RECENT_DOC=$("${CLAUDE_PLUGIN_ROOT}/scripts/workflow-context.sh" recent <TYPE>)
  if [[ -n "$RECENT_DOC" ]]; then
    echo "📋 Auto-discovered recent <TYPE>: $RECENT_DOC"
    echo ""
  fi
fi

Replace <TYPE> with: handoffs, plans, research, or prs

CRITICAL: This bash script MUST be executed FIRST, before any other response.


### 2. Logic Flow (REQUIRED)

After running the auto-discovery script:

```markdown
1. **If user provided a file path as parameter**:
   - Use that path (user override)
   - Proceed with the command

2. **If no parameter provided but RECENT_DOC found**:
   - Show the user: "Found recent <TYPE>: $RECENT_DOC"
   - Ask: "Proceed with this document? [Y/n]"
   - If yes: proceed with RECENT_DOC
   - If no: ask for document path

3. **If no parameter and no RECENT_DOC found**:
   - List available documents (if applicable)
   - Ask user for document path

3. Command-Specific Examples

`/resume-handoff`

## Initial Response

IMMEDIATELY run this bash script BEFORE responding:

```bash
# Auto-discover recent handoff
if [[ -f "${CLAUDE_PLUGIN_ROOT}/scripts/workflow-context.sh" ]]; then
  RECENT_HANDOFF=$("${CLAUDE_PLUGIN_ROOT}/scripts/workflow-context.sh" recent handoffs)
  if [[ -n "$RECENT_HANDOFF" ]]; then
    echo "📋 Auto-discovered recent handoff: $RECENT_HANDOFF"
    echo ""
  fi
fi

Then apply logic:

User provided path? → Use it
RECENT_HANDOFF found? → Ask to proceed with it
Nothing found? → Show available handoffs and ask


#### `/implement-plan`

```markdown
## Initial Response

IMMEDIATELY run this bash script BEFORE responding:

```bash
# Auto-discover recent plan
if [[ -f "${CLAUDE_PLUGIN_ROOT}/scripts/workflow-context.sh" ]]; then
  RECENT_PLAN=$("${CLAUDE_PLUGIN_ROOT}/scripts/workflow-context.sh" recent plans)
  if [[ -n "$RECENT_PLAN" ]]; then
    echo "📋 Auto-discovered recent plan: $RECENT_PLAN"
    echo ""
  fi
fi