# Local RAG Chat Workbench - Agent Guide

Compact executable packet for a local-first RAG chat app with Ollama-compatible provider seams, durable SQLite/libSQL state, document ingestion, citations, memory/settings, and repeatable browser proof.

## Agent instruction

Do not scrape the human UI. Use this agent guide, the package manifest, and raw Buildprint files.

1. Fetch package manifest: `/buildprints/local-rag-chat-workbench/package.json`
2. Read order: `BUILDPRINT.md` -> `01-questions.md` -> `02-project-setup.md` -> `blueprint.yaml` -> `03-phases/phase-index.yaml` -> `03-phases/01-provider-chat-runtime.md` -> `04-evaluation.md` -> `05-evidence/evidence-ledger.jsonl`.
3. Do not scrape human cards. Use this manifest, agent.md, and raw files. BUILDPRINT.md is the canonical execution authority. Complete 01-questions.md and 02-project-setup.md before phase work; blueprint.yaml and other structured files are machine-readable mirrors/routers, not competing instructions.
4. Follow the Buildprint's alignment/question rules before implementation.
5. Run required validation and write requested validation evidence plus the final chat handover.

## Metadata

- slug: `local-rag-chat-workbench`
- category: `Mapped Project`
- tier: `agent-grade`
- status: `proof-required`
- runtime: Local-first AI chat, Ollama-compatible provider adapter, SQLite/libSQL persistence, Browser proof required
- stack: Streaming chat, Document ingestion, RAG indexing, Vector search, Citations, Memory/settings, Lifecycle controls

## Entrypoints

- Human page: /buildprints/local-rag-chat-workbench/
- Manifest JSON: /buildprints/local-rag-chat-workbench/package.json
- Prompt: /buildprints/local-rag-chat-workbench/prompt.txt
- GitHub: https://github.com/DomEscobar/agent-buildprint/tree/main/buildprints/local-rag-chat-workbench
- Raw base: https://agent-buildprint.com/buildprints/local-rag-chat-workbench/files

## Files

- `01-questions.md` - Buildprint package file (required)
- `02-project-setup.md` - Buildprint package file (required)
- `03-phases/01-provider-chat-runtime.md` - Buildprint package file (required)
- `03-phases/02-multimodal-routing-agent-tools.md` - Buildprint package file (required)
- `03-phases/03-knowledge-base-ingestion-retrieval.md` - Buildprint package file (required)
- `03-phases/04-memory-review-injection.md` - Buildprint package file (required)
- `03-phases/05-settings-data-lifecycle-operations.md` - Buildprint package file (required)
- `03-phases/06-voice-sidecar-experience.md` - Buildprint package file (required)
- `03-phases/phase-flow.md` - Buildprint package file (required)
- `03-phases/phase-index.yaml` - machine-readable mirror (required)
- `04-evaluation.md` - Buildprint package file (required)
- `05-evidence/evidence-ledger.jsonl` - Buildprint package file (required)
- `05-evidence/evidence-ledger.schema.json` - machine-readable mirror (required)
- `06-contracts/data-persistence.md` - Buildprint package file (required)
- `06-contracts/integration-runtime.md` - Buildprint package file (required)
- `06-contracts/product-architect.md` - Buildprint package file (required)
- `06-contracts/security-boundary.md` - Buildprint package file (required)
- `06-contracts/test-and-verification.md` - Buildprint package file (required)
- `06-contracts/ux-ui-craft.md` - Buildprint package file (required)
- `blueprint.yaml` - machine-readable executable packet router (required)
- `buildprint.json` - machine-readable mirror (required)
- `BUILDPRINT.md` - compatibility bootstrap or package contract (required)
- `checks/acceptance.md` - acceptance checklist (required)
- `CONTRACTS.md` - legacy interface/data contracts, when present (required)
- `generated/agent-prompt.md` - Buildprint package file (required)
- `PLAN.md` - legacy execution index, when present (required)
- `publication.json` - machine-readable mirror (required)
- `README.md` - human overview, non-authoritative (required)
- `SPEC.md` - legacy behavior requirements, when present (required)
- `TEST_MATRIX.md` - legacy risk-to-test alignment, when present (required)
- `VALIDATION_TEMPLATE.md` - legacy completion report template, when present (required)

## Copyable implementation prompt

```txt
Use the Local RAG Chat Workbench Buildprint. First bootstrap exact snapshots: agb start https://agent-buildprint.com/buildprints/local-rag-chat-workbench/package.json . If agb is not installed, clone https://github.com/DomEscobar/agent-buildprint and run node agent-buildprint/bin/agb.js start https://agent-buildprint.com/buildprints/local-rag-chat-workbench/package.json . Then read .buildprint/next-agent.md and continue. Do not write Buildprint snapshots manually. The bootstrapped packet is the source of truth — follow its read order (BUILDPRINT.md, 01-questions.md, 02-project-setup.md, blueprint.yaml, 03-phases/phase-index.yaml, 04-evaluation.md, and the active phase files) instead of restating its rules here.
```