Retrieval and embeddings · Lesson 14 of 16 · 9 min

Prepare an index rebuild plan

A safe index rebuild stages a candidate, validates counts and retrieval, and retains the current index until the candidate is accepted. Do not delete the only working index first.

Open the lab Course map

Mastery 0/3Run itExplain itApply it

learner@clairos:~ $

↑ history · Tab complete · Ctrl+C cancel · Esc, Tab to leaveExit 0

Your objectives

Hints are always available. Wrong turns never cost XP.

1
Read the case evidence
Read /opt/ai-lab/cases/aiops-retrieval-embeddings-014.json. Separate the recorded facts from your assumptions.
Hint & worked example
A safe index rebuild stages a candidate, validates counts and retrieval, and retains the current index until the candidate is accepted. Do not delete the only working index first.
The complete case JSON is read successfully.
```
cat /opt/ai-lab/cases/aiops-retrieval-embeddings-014.json
```
Common mistake to avoid: Delete index-39 immediately to make room for an unverified rebuild.
2
Isolate the deciding signal
Select the candidate_verified field from the case JSON. What does it establish—and what does it not establish?
Hint & worked example
Verify index-42 before switching traffic away from index-39.
A successful JSON query isolates candidate_verified.
```
jq .candidate_verified /opt/ai-lab/cases/aiops-retrieval-embeddings-014.json
```
Common mistake to avoid: Using a different case or an unrelated signal as the justification.
3
Record your operational decision
Choose the justified code: stage-and-verify-index, change-without-evidence, or ignore-the-signal. Save that one code followed by a newline in /home/learner/lab/aiops-retrieval-embeddings-014-decision.txt.
Hint & worked example
Verify index-42 before switching traffic away from index-39.
The decision artifact contains the correct code, not just a matching command in history.
```
printf '%s\n' 'stage-and-verify-index' > /home/learner/lab/aiops-retrieval-embeddings-014-decision.txt
```
Common mistake to avoid: Delete index-39 immediately to make room for an unverified rebuild.

Understand the pattern

A safe index rebuild stages a candidate, validates counts and retrieval, and retains the current index until the candidate is accepted. Do not delete the only working index first.

Interpret the evidence

Verify index-42 before switching traffic away from index-39.

A tempting mistake

Delete index-39 immediately to make room for an unverified rebuild.

All names, measurements, prices, versions, and thresholds in this exercise are fictional training data. The evidence supports this bounded scenario, not a claim about a live provider.

Worked example and expected result

$ cat /opt/ai-lab/cases/aiops-retrieval-embeddings-014.json

{
  "fixture": "Fictional training data; not a live measurement.",
  "current_index": "index-39",
  "candidate_index": "index-42",
  "candidate_verified": false
}

Exit status: 0. The command completed successfully in the training fixture.

$ jq .candidate_verified /opt/ai-lab/cases/aiops-retrieval-embeddings-014.json

false

Exit status: 0. The command completed successfully in the training fixture.

$ printf '%s\n' 'stage-and-verify-index' > /home/learner/lab/aiops-retrieval-embeddings-014-decision.txt

(no output; exit 0)

Exit status: 0. The command completed successfully in the training fixture.

Try a variation

Name the assumption that would have to change for “stage-and-verify-index” to stop being the justified action. Do not silently replace missing evidence with a guess.

Explain it

What does the evidence in “Prepare an index rebuild plan” justify?Make the change now and gather the missing evidence afterward.Verify index-42 before switching traffic away from index-39.Delete index-39 immediately to make room for an unverified rebuild.

Apply it elsewhere

A colleague concludes: “Delete index-39 immediately to make room for an unverified rebuild.” What should you do?Reject that conclusion; return to the case evidence and its stated limits.Accept it because the training command completed.Treat this fixture as a live measurement.

Keep the momentum.

Complete the lab, then explain and apply the pattern.

Next: Build retrieval evidence Try an incident drill

Anonymous lesson and mastery progress lasts for this session. Sign in to keep synced lesson XP between sessions; mastery stays device-local. No speed bonus, lost lives, or hint penalties.

Keep learning

Case methodology: evidence, limits, decision