Private AI Brain Input Contract: Required Fields, Rejection Rules, and Handoff

The direct answer

Define the minimum input record and deterministic rejection rules before a local retrieval-augmented knowledge system begins. The working output is A versioned input-contract table with required fields, validation rules, owners, and rejected-example fixtures.

For Private AI Brain, the bounded capability is a local retrieval-augmented knowledge system. Begin only when the team can supply approved documents or data exports, access rules, answer use cases, and evaluation examples. The documented delivery target is a local-model RAG system checked by a QA agent; anything broader requires a new scope and a new authority decision.

The copyable input contract

This input contract is for teams that need answers grounded in owned documents while keeping the retrieval and model path inside their infrastructure. It begins with approved documents or data exports, access rules, answer use cases, and evaluation examples and stays inside the documented workflow: source inventory, access classification, parsing, chunking, indexing, retrieval, answer generation, citation checks, evaluation, and refresh. For Private AI Brain, the input contract remains reviewable because its decisions have named owners, evidence fields, and stop conditions.

Copy this Private AI Brain table into an intake form or machine-readable schema. Its validation column answers whether an input is usable for a local retrieval-augmented knowledge system; its rejection column prevents an incomplete record from entering execution as though it were approved.

Example record

{
  "contract_version": "1.0",
  "request_id": "ART-15-01-EXAMPLE",
  "intended_outcome": "Define the minimum input record and deterministic rejection rules before a local retrieval-augmented knowledge system begins.",
  "input_boundary": "approved documents or data exports, access rules, answer use cases, and evaluation examples",
  "authority": "named owner approval required for consequences outside this artifact",
  "acceptance_status": "NOT_TESTED",
  "reopen_if": "restricted documents placed in a shared index"
}

Contract decision

A record is admitted only when every required field is present, its source is named, and the evaluation owner can run the associated check. It is held when a missing fact could be supplied without changing scope. It is rejected when the requested effect exceeds the authority of the recorded owner or asks this product to promise an outcome outside its boundary.

Run the workflow as a sequence of decisions

The Private AI Brain input contract follows this working sequence: source inventory, access classification, parsing, chunking, indexing, retrieval, answer generation, citation checks, evaluation, and refresh. Within this artifact, each phrase marks a state boundary for a local retrieval-augmented knowledge system. A stage output becomes the next named input, while a failed, missing, or unavailable check keeps the dependent input contract decision closed.

Separate failure register

• FAIL-01: Restricted documents placed in a shared index.
• FAIL-02: Retrieval evaluated only by answer fluency.
• FAIL-03: Stale chunks surviving source deletion.
• FAIL-04: Citations pointing to a relevant page but not the claim.
• FAIL-05: Prompt injection entering through indexed documents.

The register supplies negative cases for the complete acceptance set. A reviewer determines affected checks from observed evidence; array position never asserts that one failure proves or disproves one criterion.

The producer can explain what it attempted, but the evaluation owner evaluates the evidence. If the artifact changes, its prior verdict expires. This is especially important for a local retrieval-augmented knowledge system, where a plausible narrative can hide a stale configuration, an untested negative case, or an authority mismatch.

Failure and recovery drills

A useful Private AI Brain input contract explains what happens when its happy path breaks. These drills come from the accepted product truth record rather than a claim that every buyer has each failure. Use safe synthetic or authorized observations for a local retrieval-augmented knowledge system, and keep private credentials out of every fixture.

1. Restricted documents placed in a shared index.

Detect for Private AI Brain: data owner captures a direct readback or safe fixture that makes this input contract condition observable. Its record binds source, time, method, and the current ART-15-01 fingerprint.

Contain the input contract: stop only the affected Private AI Brain path after observing “restricted documents placed in a shared index”. Preserve its failed material and last verified state instead of erasing evidence or blindly repeating an external effect.

Recover and prove: apply the smallest authorized Private AI Brain correction, then have a distinct reviewer re-evaluate the complete accepted check set. Do not select one check merely because it shares this failure's list position. If any affected input contract check cannot run, its result remains NOT_TESTED.

2. Retrieval evaluated only by answer fluency.

Detect for Private AI Brain: privacy owner captures a direct readback or safe fixture that makes this input contract condition observable. Its record binds source, time, method, and the current ART-15-01 fingerprint.

Contain the input contract: stop only the affected Private AI Brain path after observing “retrieval evaluated only by answer fluency”. Preserve its failed material and last verified state instead of erasing evidence or blindly repeating an external effect.

Recover and prove: apply the smallest authorized Private AI Brain correction, then have a distinct reviewer re-evaluate the complete accepted check set. Do not select one check merely because it shares this failure's list position. If any affected input contract check cannot run, its result remains NOT_TESTED.

3. Stale chunks surviving source deletion.

Detect for Private AI Brain: retrieval engineer captures a direct readback or safe fixture that makes this input contract condition observable. Its record binds source, time, method, and the current ART-15-01 fingerprint.

Contain the input contract: stop only the affected Private AI Brain path after observing “stale chunks surviving source deletion”. Preserve its failed material and last verified state instead of erasing evidence or blindly repeating an external effect.

Recover and prove: apply the smallest authorized Private AI Brain correction, then have a distinct reviewer re-evaluate the complete accepted check set. Do not select one check merely because it shares this failure's list position. If any affected input contract check cannot run, its result remains NOT_TESTED.

4. Citations pointing to a relevant page but not the claim.

Detect for Private AI Brain: evaluation owner captures a direct readback or safe fixture that makes this input contract condition observable. Its record binds source, time, method, and the current ART-15-01 fingerprint.

Contain the input contract: stop only the affected Private AI Brain path after observing “citations pointing to a relevant page but not the claim”. Preserve its failed material and last verified state instead of erasing evidence or blindly repeating an external effect.

Recover and prove: apply the smallest authorized Private AI Brain correction, then have a distinct reviewer re-evaluate the complete accepted check set. Do not select one check merely because it shares this failure's list position. If any affected input contract check cannot run, its result remains NOT_TESTED.

5. Prompt injection entering through indexed documents.

Detect for Private AI Brain: system operator captures a direct readback or safe fixture that makes this input contract condition observable. Its record binds source, time, method, and the current ART-15-01 fingerprint.

Contain the input contract: stop only the affected Private AI Brain path after observing “prompt injection entering through indexed documents”. Preserve its failed material and last verified state instead of erasing evidence or blindly repeating an external effect.

Recover and prove: apply the smallest authorized Private AI Brain correction, then have a distinct reviewer re-evaluate the complete accepted check set. Do not select one check merely because it shares this failure's list position. If any affected input contract check cannot run, its result remains NOT_TESTED.

Ownership and handoff

For this Private AI Brain input contract, the adjudication role is evaluation owner. That role judges frozen acceptance evidence for a local retrieval-augmented knowledge system without becoming the product owner, legal adviser, security authority, or buyer. Its handoff retains open gaps, failed evidence, changed hashes, and the next action permitted for ART-15-01.

Evidence and acceptance

Use these product-specific statements as candidate acceptance checks:

• Sources and access classes are inventoried.
• Retrieval permissions match source permissions.
• Answers cite claim-level evidence.
• Deletion and refresh propagate to the index.
• Adversarial documents are included in tests.

For every Private AI Brain input contract check, retain the tested object, environment or source, observation time, method, expected result, actual result, verifier identity, and artifact hash. In this ART-15-01 record, label a direct readback OBSERVED, a reproducible transformation COMPUTED, and an interpretation JUDGMENT; never merge those states into one confident claim.

The research packet observed 3 impressions across adjacent site queries such as “which of the following statements is true about retrieval” for the exact Search Console property https://sincllm.com/ during 2026-06-02/2026-08-30. Those observations help locate an existing audience vocabulary. They are not search-volume estimates, do not prove demand for this exact page, and do not predict clicks or rankings.

The product boundary remains controlling: Local deployment reduces some egress paths but does not make the data correct, the retrieval complete, or the answer safe. Access control, backups, logs, and operators remain part of the threat model.

Implementation checklist

• The input contract names the distinct reader job: Define the minimum input record and deterministic rejection rules before a local retrieval-augmented knowledge system begins.
• The input boundary is explicit: approved documents or data exports, access rules, answer use cases, and evaluation examples.
• The intended deliverable is explicit: a local-model RAG system checked by a QA agent.
• Every required acceptance check has current evidence or an honest NOT_TESTED status.
• At least one negative fixture covers restricted documents placed in a shared index.
• The evaluation owner is distinct from the artifact producer.
• Rollback or reopen conditions are written before consequential action.
• No ranking, traffic, conversion, compliance, certification, or buyer-outcome guarantee was added.

When this Private AI Brain input contract has a failed item, repair that named item and rerun its dependent checks. Keep the frozen threshold intact; the remaining checks cannot establish that the failed ART-15-01 condition probably holds.

Related campaign guides

These four crawlable links cover the other Private AI Brain operator artifacts. Each leads from the current input contract to a different reader task and promised artifact, rather than to a keyword variation of this page.

• Private AI Brain Evidence Packet: What to Capture Before a Decision
• Private AI Brain Operator Runbook: Daily Checks, Escalations, and Handoff
• Private AI Brain Control Dashboard: Signals, Alerts, and Review Cadence
• Private AI Brain Change Protocol: Versioning, Canary Tests, and Rollback