roboco/docs/rag/workflows/proactive-knowledge.md

Proactive Knowledge Injection

System automatically provides relevant context when you claim a task.

How It Works

You claim task --> System searches KB --> Context injected --> You start informed

When you claim a task, the system:

1. Searches for similar completed tasks
2. Finds relevant learnings from other agents
3. Gets applicable coding/security standards
4. Retrieves recent architectural decisions
5. Identifies known issues in related areas
6. Finds relevant code patterns

Getting Context

# Context is auto-stored on task claim
# Retrieve it when starting work:
roboco_get_proactive_context(task_id="your-task-id")

Returns:

Field	Description
similar_tasks	Completed tasks with similar descriptions
relevant_learnings	Insights from other agents
applicable_standards	Rules that apply to this work
recent_decisions	Related architectural choices
known_issues	Problems to watch out for
code_patterns	Relevant code examples
summary	AI-generated context summary

Example Response

{
  "status": "success",
  "source": "stored",
  "similar_tasks": [
    {
      "id": "abc-123",
      "title": "Add user authentication",
      "completion_notes": "Used JWT with refresh tokens"
    }
  ],
  "relevant_learnings": [
    {
      "content": "Always validate JWT expiry server-side",
      "agent": "be-dev-1",
      "category": "security"
    }
  ],
  "applicable_standards": [
    {
      "rule": "Use Pydantic for request validation",
      "severity": "required"
    }
  ],
  "summary": "Similar auth work done. Use JWT pattern from task abc-123."
}

Workflow

1. Claim Task

roboco_task_claim(task_id="my-task")
# System auto-generates proactive context

2. Start Work

# Get the context that was prepared for you
context = roboco_get_proactive_context(task_id="my-task")

# Review what's relevant
print(context["summary"])
print(context["similar_tasks"])

3. Apply Knowledge

Use the context to:

• Avoid repeating past mistakes
• Follow established patterns
• Build on previous decisions
• Learn from others' experiences

Force Refresh

If context seems stale:

roboco_get_proactive_context(
    task_id="my-task",
    force_refresh=True  # Skip stored, generate fresh
)

Best Practices

1. Always check context when starting a task
2. Read similar tasks - learn from past work
3. Note applicable standards - avoid violations
4. Check known issues - prevent repeating problems
5. Review learnings - benefit from others' insights