Pre-Flight Check
Benchmarked against: Anthropic โ Effort (adaptive complexity) SOP: Cloud UB ub-a0914abf17a7 Scope: All agents, before every non-trivial task
The Pre-Flight Check is a 30-second self-assessment before any task. It scores risk across three dimensions and determines whether to proceed, research first, or escalate.
3D scoringโ
Each dimension scores 0โ2. Total score determines action.
Dimension 1: Blast Radiusโ
| Score | Meaning |
|---|---|
| 0 | Local only (one file, one config) |
| 1 | Module-level (multiple files, one service) |
| 2 | Fleet-wide (cross-ship, cross-agent, production) |
Dimension 2: Knowledge Freshnessโ
| Score | Meaning |
|---|---|
| 0 | Timeless knowledge (design patterns, algorithms) |
| 1 | Perishable but recently verified |
| 2 | Perishable, not recently verified |
Dimension 3: Reversibilityโ
| Score | Meaning |
|---|---|
| 0 | Fully reversible (git revert, config rollback) |
| 1 | Partially reversible (database migration, API change) |
| 2 | Irreversible (data deletion, external publishing) |
Action thresholdsโ
| Total Score | Color | Action |
|---|---|---|
| 0โ2 | ๐ข Green | Proceed directly |
| 3โ4 | ๐ก Yellow | Search UB first, then proceed |
| 5โ6 | ๐ด Red | Search UB + intel_search + report to Captain before acting |
Exampleโ
Task: Update LangGraph agent to use new checkpoint API
Blast Radius: 1 (module-level, affects agent pipeline)
Freshness: 2 (LangGraph API is Danger Zone, not recently verified)
Reversibility: 0 (can git revert)
Total: 3 โ ๐ก Yellow โ search UB first
Integration pointsโ
- Tech Freshness: Dimension 2 directly maps to the Danger Zone library list
- HITL Boundary: Score 5-6 always requires Captain visibility (Constitution ยง5)
- Work Orders: WO submission gates can require Pre-Flight Check record
When to skipโ
The only time you can skip Pre-Flight Check is for truly trivial tasks:
- Fixing a typo
- Adding a log statement
- Reading files for information
If you're writing code, changing config, or making any decision โ run the check.