Capability Hint Routing Workflow

This page explains how capability hints influence the routing of tasks to agents.

1. Task Creation

When a task is created, initial hints may be:

• Supplied by the user.
• Inferred from the code location or file types.
• Derived from associated work items (e.g., component tags).

2. Router Matching

The Task Router:

• Finds agents that declare compatible capabilities.
• Ranks candidates based on historical performance and task context.
• Selects the best agent (or chain of agents) to execute the task.

3. Feedback Loop

When a reviewer provides feedback:

• The system may add or adjust hints (e.g., “this is actually a database migration”).
• Subsequent tasks can use improved hints for more accurate routing.

Over time, this process allows CoffeeBreakAI to converge on better agent choices for your codebase and domain.