Files
roboco/docs/rag
Renn F 5902c0fe38 feat(roles): add the read-only pr_reviewer role end-to-end
A global, read-only PR reviewer agent (pr-reviewer-1) that reviews inbound
external/fork PRs and posts one change-request. Wired end-to-end:

- identity: Role.PR_REVIEWER + agent + ROLE_LEVEL (QA-peer) + REVIEWER_ROLES
- lifecycle: CLAIM_RULES + ROLE_TEAM_RULES + a dedicated claim_pr_review /
  post_pr_review verb pair (distinct from QA's) + the pr_review_done action and
  its in_progress->completed transition; give_me_work / i_am_idle gain the role
- role_config: a read-only RoleConfig (allows_write=False)
- journaling: ALL_CELLS read tier so it can read internal intent like QA
- tracing: post_pr_review requires a learning entry; claim_pr_review is waived
- seeds presentation + factory prompt layer + builtin tools + the agentrole
  enum migration (037) + regenerated verb/lifecycle artifacts

Read-only at /app like QA/auditor; default-off — nothing dispatches review work
until external_pr_enabled. Foundation + role-config + enum suites green; ruff +
mypy clean; orchestrator boots.
2026-06-16 10:37:06 +02:00
..

RAG Knowledge Base Documentation

Optimized documentation for the RoboCo AI agent knowledge base. Each file is sized for effective RAG chunking.

Structure

docs/rag/
├── roles/           # Agent role responsibilities
├── workflows/       # Step-by-step task flows
├── standards/       # Coding, security, testing rules
├── architecture/    # System components
├── tools/           # MCP tools reference
└── troubleshooting/ # Common issues and fixes

Organization Principles

  1. One topic per file - Each file covers a single concept
  2. Chunk-friendly - Content fits in 512-1536 token chunks
  3. Self-contained - Each file provides complete context
  4. Actionable - Focus on what agents need to DO

For Agents

When searching the knowledge base:

  • Use roboco_kb_search() for semantic search
  • Use roboco_rag_query() for AI-synthesized answers
  • Use roboco_ask_mentor() for conversational help

See docs/rag/tools/kb-tools.md for the full KB tool reference.