Smart Intent Detection

The ReAcTree plugin includes smart detection that analyzes your prompts and suggests appropriate workflows or utility agents automatically.

How It Works

When you type a prompt, the system:

1. Checks configuration - Respects your enabled/disabled settings
2. Filters noise - Skips simple questions and explicit commands
3. Detects utility intent - Routes to specialized agents for file/code/git/log tasks
4. Detects workflow intent - Suggests feature/debug/refactor workflows
5. Outputs suggestion - Shows helpful message with recommended action

Utility Agent Routing

file-finder

Triggers: "find files", "where is file", "list directory", "show folder"

Fast file discovery using Glob and Grep:

• Find files by pattern (**/*.rb, app/models/*.rb)
• Find files by name or content
• List directory structure

code-line-finder

Triggers: "where is defined", "find method", "find usages", "who calls"

Precise code location using LSP:

• Find method/class definitions with line numbers
• Find all usages and references
• Go to definition

git-diff-analyzer

Triggers: "what changed", "show diff", "git blame", "commit history"

Git change analysis:

• Analyze staged/unstaged changes
• Compare branches
• Blame and history

log-analyzer

Triggers: "show log", "development.log", "errors in log", "slow queries"

Rails log parsing:

• Parse development.log/production.log
• Find errors and stack traces
• Identify slow SQL queries

Workflow Detection

Feature Development

Triggers: implement, build, create, add, develop, user story

Suggests:

• /reactree-dev - Full parallel workflow
• /reactree-feature - Feature-driven with user stories

Strong indicators: User story format ("As a user, I want...")

Debugging

Triggers: fix, debug, error, bug, not working, troubleshoot

Suggests:

• /reactree-debug - Systematic debugging workflow

Strong indicators: Error types (NoMethodError), stack traces, line numbers

Refactoring

Triggers: refactor, cleanup, optimize, restructure, improve

Suggests:

• /reactree-dev - With refactor focus and test preservation

Strong indicators: "code smell", "technical debt", "decouple"

TDD Mode

Triggers: test-first, TDD, with tests, ensure coverage

Adds TDD emphasis to feature suggestions.

Configuration

Edit .claude/reactree-rails-dev.local.md:

yaml
---
smart_detection_enabled: true  # Enable/disable
detection_mode: suggest        # suggest | inject | disabled
annoyance_threshold: medium    # low | medium | high
use_claude_analysis: true      # Use Claude CLI for intelligent intent analysis
---

Detection Modes

suggest (Default)

Shows a suggestion message. Non-intrusive - you can ignore and proceed.

inject

Automatically activates the workflow with context injection.

disabled

Turns off smart detection entirely. Use commands manually.

Annoyance Thresholds

low

Only triggers for very explicit keywords:

• "implement", "build", "create"
• "fix", "debug"
• "refactor"

medium (Default)

Skips:

• Simple questions (what, how, why, etc.)
• Short prompts (<5 words)
• Informational requests

high

Triggers for most Rails-related prompts with relevant keywords.

When Detection Skips

• Commands already using /reactree-*, /rails-*
• Simple questions without action verbs
• Very short prompts (<5 words)
• Non-Rails context (no Rails keywords, not in Rails project)
• Informational/documentation requests

Tips

1. Be explicit - "Implement user authentication" triggers better than "auth stuff"
2. Include context - Mention models, controllers, services for higher confidence
3. Use keywords - "fix", "build", "refactor" are strong signals
4. User stories work - "As a user, I want to..." strongly triggers feature mode
5. Utility agents - Ask for files/code/diffs/logs to trigger specialized agents