Journey Rag

Part of the Butterbase guided journey that handles stage 3g: setting up RAG collections and ingesting initial documents. It reads your plan from 02-plan.md, delegates the heavy lifting to rag-dev (which calls create_collection and ingest_document), then runs a smoke test with rag_query to make sure retrieval actually works. Gets skipped entirely if your plan doesn't include a knowledge base feature. The preflight check is smart, it won't proceed if your app_id is missing or docs are stale. One thing I appreciate is the anti-pattern callout about not ingesting huge document sets in one go, that's the kind of mistake you only make once.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add butterbase-ai/butterbase-skills --skill journey-rag --agent claude-code

Installs into .claude/skills of the current project.

Files

Journey: RAG

Stage 3g of the guided journey. Create RAG collections and ingest initial documents.

When to use

Dispatched by journey when current_stage: rag.
Directly via /butterbase-skills:journey-rag.
Skipped (annotated (n/a)) if the plan has no RAG section.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Inputs

docs/butterbase/02-plan.md — the RAG section.
docs/butterbase/00-state.md — for app_id.

Procedure

Refresh docs. Call butterbase_docs with topic: "rag". For ingestion + retrieval patterns, also WebFetch https://docs.butterbase.ai/ai/rag. Skip if cache is fresh.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly