extract-context

Extract Context Command

Captures and persists all valuable knowledge from ticket work: technical decisions, blockers, code patterns, gotchas, and cross-references. Saves to .claude/progress/<ticket>/context-extract.md and optionally to Confluence.

Usage

/extract-context [TICKET_ID] [--confluence] [--memory] [--force]

Options:

• TICKET_ID: Jira ticket ID (e.g., PROJ-123). Auto-detect from git branch if omitted.
• --confluence: Also create/update Confluence page with extracted context
• --memory: Add key findings to memory system for future conversations
• --force: Overwrite existing context-extract.md without prompting

Phase 1: Ticket Detection

// Detect ticket ID from branch or user input
const detectTicketId = async (provided) => {
  if (provided) return provided;

  try {
    const branch = await exec('git rev-parse --abbrev-ref HEAD');
    const match = branch.match(/([A-Z]+-\d+)/);
    if (match) return match[1];
  } catch (e) {
    // Not in git repo or can't get branch
  }
  return null;
};

const ticketId = await detectTicketId(args[0]);
if (!ticketId) {
  console.error('❌ No ticket ID provided and could not detect from branch');
  console.log('Usage: /extract-context PROJ-123');
  return;
}

console.log(`\n📋 Extracting context for ${ticketId}...`);

// Load existing progress directory
const progressDir = `.claude/progress/${ticketId}`;
let existingData = {
  research: null,
  plans: null,
  tasks: null
};

try {
  if (fs.existsSync(progressDir)) {
    const files = fs.readdirSync(progressDir);
    if (files.includes('research.md')) {
      existingData.research = fs.readFileSync(
        `${progressDir}/research.md`, 'utf8'
      );
    }
    if (files.includes('plan.md')) {
      existingData.plans = fs.readFileSync(
        `${progressDir}/plan.md`, 'utf8'
      );
    }
    if (files.includes('tasks.md')) {
      existingData.tasks = fs.readFileSync(
        `${progressDir}/tasks.md`, 'utf8'
      );
    }
  }
  console.log('✓ Loaded existing progress data');
} catch (e) {
  console.log('ℹ️  No existing progress directory');
}