Back to registry
↻ Workflow • Proof trail Updated Not dated

Perfect RAG Retrieval

A stack-adaptable phase-flow Buildprint for implementing production-grade RAG. It preserves deterministic local proof mode while separating live provider, persistence, security, and eval claims into explicit proof gates.

Package JSON
What this builds

A scoped product implementation packet.

A fresh agent can run the packet from BUILDPRINT.md through phase-flow to implement a permission-safe, citation-grounded retrieval system without reducing the product to vector search plus a prompt.

  • Mapper execution spine
  • Corpus and threat-model setup gate
  • Document source and chunk contracts
  • Ingestion, chunking, and index phase
  • Hybrid lexical/sparse plus dense retrieval phase
  • Fusion, dedupe, permission filtering, and rerank contract
Core capabilities

The useful parts the finished build should expose.

01 Read BUILDPRINT.md first
02 Complete setup gate before phase work
03 Create phase-flow artifacts before implementation evidence
04 Run deterministic fixture checks without live credentials
05 Record live provider, persistence, browser, and eval blockers honestly
06 Append runtime evidence only to .buildprint/evidence/evidence-ledger.jsonl
What you need

Local first, live proof explicit.

  • Your document corpus and permission model
  • Target backend and persistence/search infrastructure
  • Embedding, vector, reranker, or LLM provider keys only for live mode
  • Eval cases representing real success and failure
  • Human approval for paid providers, external writes, destructive re-indexing, or public deployment
System shape

What kind of artifact this becomes.

Product surface

A fresh agent can run the packet from BUILDPRINT.md through phase-flow to implement a permission-safe, citation-grounded retrieval system without reducing the product to vector search plus a prompt.

Runtime layer

Any backend, Deterministic proof mode, Optional live providers

Build materials

Setup gate / Corpus contracts / Ingestion and chunks / Hybrid indexes

Proof boundary

Mapper / Hybrid + rerank by default

Build scope

Included, required from you, and outside the claim.

Included
  • Mapper execution spine
  • Corpus and threat-model setup gate
  • Document source and chunk contracts
  • Ingestion, chunking, and index phase
Bring yourself
  • Your document corpus and permission model
  • Target backend and persistence/search infrastructure
  • Embedding, vector, reranker, or LLM provider keys only for live mode
  • Eval cases representing real success and failure
Out of scope
  • Vector-only false confidence
  • Hallucinated uncited answers
  • Permission leakage
  • Eval-free quality drift
Agent handoff

Start from the packet, not the UI.

agb start https://agent-buildprint.com/buildprints/perfect-rag-retrieval/package.json
Agent guide Manifest GitHub files
Key files

The first files an agent should read.

BUILDPRINT.md compatibility bootstrap or package contract 01-questions.md Buildprint package file 02-project-setup.md Buildprint package file blueprint.yaml machine-readable executable packet router 03-phases/phase-index.yaml machine-readable mirror 03-phases/01-corpus-contracts.md Buildprint package file 04-evaluation.md Buildprint package file 05-evidence/evidence-ledger.jsonl Buildprint package file
All package files
01-questions.md Buildprint package file
02-project-setup.md Buildprint package file
03-phases/01-corpus-contracts.md Buildprint package file
03-phases/02-ingestion-indexing.md Buildprint package file
03-phases/03-retrieval-answering.md Buildprint package file
03-phases/04-evaluation-operations.md Buildprint package file
03-phases/phase-flow.md Buildprint package file
03-phases/phase-index.yaml machine-readable mirror
04-evaluation.md Buildprint package file
05-evidence/evidence-ledger.jsonl Buildprint package file
05-evidence/evidence-ledger.schema.json machine-readable mirror
06-contracts/data-persistence.md Buildprint package file
06-contracts/integration-runtime.md Buildprint package file
06-contracts/product-architect.md Buildprint package file
06-contracts/security-boundary.md Buildprint package file
06-contracts/test-and-verification.md Buildprint package file
06-contracts/ux-ui-craft.md Buildprint package file
blueprint.yaml machine-readable executable packet router
BUILDPRINT.md compatibility bootstrap or package contract
checks/acceptance.md acceptance checklist
CONTRACTS.md legacy interface/data contracts, when present
generated/agent-prompt.md Buildprint package file
PLAN.md legacy execution index, when present
publication.json machine-readable mirror
README.md human overview, non-authoritative
SPEC.md legacy behavior requirements, when present
TEST_MATRIX.md legacy risk-to-test alignment, when present
VALIDATION_TEMPLATE.md legacy completion report template, when present