Files
roboco/docs/rag
862c0b27cd docs(rag): close the corpus drift — findings/collision/fast-path/forge/env-ladder coverage (#596)
Seventeen-page sweep of the agent-facing KB against shipped behavior:
required covers_parent_criteria and per-AC criteria_verified reach the
QA/PM/task-tools pages (the QA docs also named non-callable pass_review/
fail_review — the MCP tools are pass/fail); collision_context lands in the
QA/gate/planning evidence docs; the possibilities matrix gets its own
architecture page + config entry; the auditor page gains its missing
waive_finding and playbook-curation verbs; git-pr-types.md is rewritten
off the long-dead is_root_pr model; PR/workspace/git-error pages stop
assuming GitHub (forge-agnostic + env-ladder semantics).

Co-authored-by: Renn F <rennf93@users.noreply.github.com>
2026-07-19 19:00:48 +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.