CLI and workspace hygiene · Lesson 12 of 12 · 6 min

Workspace hygiene checkpoint

Workspace hygiene protects evidence as well as credentials. A clean handoff keeps the baseline, redacts secrets and records the reversible next action.

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-cli-workspace-012.json. Separate the recorded facts from your assumptions.
Hint & worked example
Workspace hygiene protects evidence as well as credentials. A clean handoff keeps the baseline, redacts secrets and records the reversible next action.
The complete case JSON is read successfully.
```
cat /opt/ai-lab/cases/aiops-cli-workspace-012.json
```
Common mistake to avoid: Overwrite the baseline before another operator can reproduce it.
2
Isolate the deciding signal
Select the baseline_preserved field from the case JSON. What does it establish—and what does it not establish?
Hint & worked example
Hand off the bounded, redacted bundle with the baseline preserved.
A successful JSON query isolates baseline_preserved.
```
jq .baseline_preserved /opt/ai-lab/cases/aiops-cli-workspace-012.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: handoff-bundle, change-without-evidence, or ignore-the-signal. Save that one code followed by a newline in /home/learner/lab/aiops-cli-workspace-012-decision.txt.
Hint & worked example
Hand off the bounded, redacted bundle with the baseline preserved.
The decision artifact contains the correct code, not just a matching command in history.
```
printf '%s\n' 'handoff-bundle' > /home/learner/lab/aiops-cli-workspace-012-decision.txt
```
Common mistake to avoid: Overwrite the baseline before another operator can reproduce it.

Understand the pattern

Workspace hygiene protects evidence as well as credentials. A clean handoff keeps the baseline, redacts secrets and records the reversible next action.

Interpret the evidence

Hand off the bounded, redacted bundle with the baseline preserved.

A tempting mistake

Overwrite the baseline before another operator can reproduce it.

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-cli-workspace-012.json

{
  "fixture": "Fictional training data; not a live measurement.",
  "baseline_preserved": true,
  "secret_in_bundle": false,
  "decision_recorded": true
}

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

$ jq .baseline_preserved /opt/ai-lab/cases/aiops-cli-workspace-012.json

true

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

$ printf '%s\n' 'handoff-bundle' > /home/learner/lab/aiops-cli-workspace-012-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 “handoff-bundle” to stop being the justified action. Do not silently replace missing evidence with a guess.

Explain it

What does the evidence in “Workspace hygiene checkpoint” justify?Hand off the bounded, redacted bundle with the baseline preserved.Overwrite the baseline before another operator can reproduce it.Make the change now and gather the missing evidence afterward.

Apply it elsewhere

A colleague concludes: “Overwrite the baseline before another operator can reproduce it.” What should you do?Accept it because the training command completed.Treat this fixture as a live measurement.Reject that conclusion; return to the case evidence and its stated limits.

Keep the momentum.

Complete the lab, then explain and apply the pattern.

Review this course 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

01Write an operator noteA useful operator note distinguishes observation, interpretation and next action. Include identifiers and limits so the next person can reproduce the investigation.Practice

Case methodology: evidence, limits, decision