Smart Reopen Detector

Purpose

When you report an issue with recently completed work, I’ll automatically:

1. 🔍 Scan your recent work (active + completed in last 7 days)
2. 🎯 Identify related items using keyword matching
3. 💡 Suggest what to reopen with relevance scoring
4. ⚠️ Check WIP limits before suggesting reopen

When I Activate

I automatically activate when you mention these keywords:

• Not working: “not working”, “broken”, “failing”, “error”, “crash”
• Quality issues: “bug”, “issue”, “problem”, “wrong”, “incorrect”, “missing”
• Regressions: “still broken”, “regression”, “broken again”, “came back”

How I Help

Example 1: Issue Report

User: "The GitHub sync isn't working, it was just completed yesterday"

I’ll respond with:

🔍 Scanning recent work...

Found 2 related item(s) in recent work:

📦 INCREMENT: 0031-external-tool-status-sync
   Increment: 0031-external-tool-status-sync
   Completed: 2 days ago
   Relevance: 15 points
   Matched: github, sync

✓ TASK: T-003 GitHub Content Sync
   Increment: 0031-external-tool-status-sync
   Completed: 1 day ago
   Relevance: 14 points
   Matched: github, sync

💡 Suggested action:
   /sw:reopen 0031-external-tool-status-sync --reason "GitHub sync not working"

Would you like me to:
1. Reopen the entire increment (checks WIP limits)
2. Reopen just task T-003 (targeted fix)
3. Show me the WIP status first

Example 2: Specific Feature Broken

User: "The authentication is broken after the recent deployment"

I’ll respond with:

🔍 Scanning recent work...

Found 3 related item(s) in recent work:

✓ TASK: T-012 Authentication Service
   Increment: 0025-user-auth
   Completed: 3 days ago
   Relevance: 10 points
   Matched: authentication

✓ TASK: T-014 JWT Token Validation
   Increment: 0025-user-auth
   Completed: 3 days ago
   Relevance: 7 points
   Matched: authentication

💡 Suggested action:
   /sw:reopen 0025-user-auth --task T-012 --reason "Authentication broken after deployment"

⚠️  Note: Increment 0025 was completed 3 days ago. Consider checking deployment config first.

Example 3: No Recent Work Found

User: "The payment flow is not working"

I’ll respond with:

🔍 Scanning recent work...

🔍 No related work found in recent activity (last 7 days)

The payment functionality might be:
1. From an older increment (>7 days ago)
2. Not yet implemented
3. Part of external dependencies

Would you like me to:
1. Search all increments (not just recent)
2. Create a new bug increment for investigation
3. Check the backlog for related work

What I Do

Step 1: Extract Keywords

From your message, I extract relevant keywords:

• Feature names (authentication, github, payment)
• Action words (sync, deploy, validate)
• Component names (api, database, frontend)

Step 2: Scan Recent Work

I scan:

• ✅ Active increments (currently being worked on)
• ✅ Recently completed (last 7 days)
• ✅ All tasks from these increments

Step 3: Score Matches

I assign relevance scores using:

• +10 points: Exact match in title/ID
• +7 points: Partial match in title
• +5 points: Match in increment ID
• +3 points: Match in description/AC

Step 4: Suggest Actions

I provide:

• Top matches (up to 5)
• Relevance scores
• Suggested /sw:reopen command
• WIP limit warnings (if applicable)

Smart Suggestions

For Increments

# Reopen entire increment
/sw:reopen 0031-external-tool-status-sync --reason "GitHub sync failing"

# Check WIP limits first (recommended)
/sw:status

For Specific Tasks

# Reopen single task (surgical fix)
/sw:reopen 0031 --task T-003 --reason "GitHub API 500 error"

# Reopen multiple related tasks
/sw:reopen 0031 --user-story US-001 --reason "All GitHub features broken"

Force Reopen (Bypass WIP Limits)

# Use --force for critical production issues
/sw:reopen 0031 --force --reason "Production down, critical fix needed"

WIP Limit Awareness

Before suggesting increment reopen, I check:

• ✅ Current active increment count
• ✅ Type-specific limits (feature: 2, refactor: 1, etc.)
• ⚠️ Warn if reopening will exceed limits

Example Warning:

⚠️  WIP LIMIT WARNING:
   Current active: 2 features
   Limit: 2 features
   Reopening 0031-external-tool-status-sync will EXCEED the limit!

   Options:
   1. Pause another feature first: /sw:pause 0030
   2. Complete another feature: /sw:done 0029
   3. Force reopen (not recommended): --force

Integration with Commands

I work seamlessly with:

• /sw:reopen – Execute reopen action
• /sw:status – Check WIP limits
• /sw:progress – See increment progress
• /sw:pause – Pause another increment to make room

When NOT to Use

I don’t activate for:

• ❌ General questions about code
• ❌ Feature requests (use /sw:increment)
• ❌ Documentation questions
• ❌ Status inquiries (use /sw:status)

I only activate when you explicitly report something is broken/not working.

Technical Implementation

Core Logic:

• Uses RecentWorkScanner to find matches
• Keyword extraction from user message
• Relevance scoring algorithm
• WIP limit validation before suggestions

Smart Features:

• Deduplication (same increment from active + recent)
• Recency bias (prefer more recent completions)
• Contextual hints (deployment, config, dependencies)

Examples of Activation

✅ Will Activate

• “GitHub sync not working”
• “Authentication is broken”
• “Tests are failing after the last commit”
• “Deployment crashed”
• “API returns 500 error”
• “Still broken after the fix”

❌ Won’t Activate

• “How does GitHub sync work?”
• “Can you add authentication?”
• “What’s the status of increment 0031?”
• “Show me the progress”
• “Create a new feature for payments”

Success Metrics

I’m successful when:

• ✅ You find the related work quickly (<30 seconds)
• ✅ The suggested reopen command is correct
• ✅ No false positives (only relevant matches)
• ✅ WIP limits are respected
• ✅ Clear next steps provided

Auto-loads when: You report issues with recently completed work Commands: /sw:reopen, /sw:status Related Skills: increment-planner, tdd-workflow

Project-Specific Learnings

Before starting work, check for project-specific learnings:

# Check if skill memory exists for this skill
cat .specweave/skill-memories/smart-reopen-detector.md 2>/dev/null || echo "No project learnings yet"

Project learnings are automatically captured by the reflection system when corrections or patterns are identified during development. These learnings help you understand project-specific conventions and past decisions.