mirror of https://github.com/rennf93/roboco.git synced 2026-08-03 07:23:24 +02:00

Files

T

Renn F ecea593a51 docs(rag): rewrite the KB docs to the real gateway verb surface

The RAG knowledge base (indexed and queried by agents at runtime)
described entire fictional MCP tool surfaces — roboco_task_*,
roboco_journal_*, roboco_message_send, roboco_notify_send, roboco_agent_*,
roboco_session_*, roboco_workspace_*, roboco_project_* — that don't exist,
so agents searching the KB were handed invented tool names.

Rewrite every affected doc (tools, roles, workflows, troubleshooting, and
the stale architecture snippets) to the real surface: the gateway intent
verbs (give_me_work, i_will_work_on, open_pr, i_am_done, claim_review,
pass, fail, claim_doc_task, i_documented, triage, delegate, i_will_plan,
unblock, complete, escalate_up, escalate_to_ceo, ...) and content tools
(commit, note(scope=...), say, dm, evidence, notify*, open_session,
channels). Also reconcile the access-control docs to code: CEO can cancel
(Board/Auditor cannot); the management-channel membership and the
Auditor's silent-but-present status now match communications.py.

2026-06-05 17:20:36 +02:00

2.4 KiB

Raw Blame History

Knowledge Base Search

ALL agents have access to KB/RAG tools. These are automatically available.

Recommended: Ask Mentor

For most questions, use roboco_ask_mentor:

roboco_ask_mentor(question="How do I handle authentication?")

It searches ALL knowledge sources and supports follow-up questions.

Search Types

Tool	Purpose	Best For
`roboco_ask_mentor`	Conversational help	Most questions
`roboco_kb_search`	Semantic search	Browsing, exploration
`roboco_rag_query`	AI-synthesized answer	Quick answers

Semantic Search

roboco_kb_search(
    query="rate limiting redis implementation",
    top_k=5,                      # Results to return
    project="roboco",             # Optional project filter
    index_types=["code", "docs"]  # Filter by type
)

Returns similar content - not just keyword matches.

RAG Query (AI Answer)

roboco_rag_query(
    query="How does authentication work in this codebase?",
    top_k=5
)

Returns AI-synthesized answer with citations.

Good for:

"How does X work?"
"What pattern should I use?"
"What decisions were made about Y?"

Mentor (Conversational)

# First question
response = roboco_ask_mentor(
    question="How do I handle authentication?",
    domain="coding"
)

# Follow-up
roboco_ask_mentor(
    question="What about refresh tokens?",
    conversation_id=response["conversation_id"]
)

Index Types

Type	Content
`code`	Source files
`docs`	Documentation
`conversations`	Channel discussions
`journals`	Agent journal entries
`errors`	Error patterns & fixes
`standards`	Coding rules
`decisions`	Architectural decisions
`reviews`	Code review patterns
`learnings`	Captured learnings

Before Starting a Task

Always search first:

roboco_kb_search(query="implementing rate limiter")
# Journal entries are part of the KB — filter to them with index_types:
roboco_kb_search(query="rate limit decisions", index_types=["journals", "decisions"])

This helps you:

Avoid repeating mistakes
Find proven patterns
Learn from others' experiences

Proactive Context

System auto-provides context when you claim:

roboco_get_proactive_context(task_id)
# Returns: similar_tasks, relevant_learnings, code_patterns,
#          applicable_standards, recent_decisions, known_issues

2.4 KiB Raw Blame History