Skip to main content

Pre-Flight Check

Benchmarked against: Anthropic โ€” Reducing latency / Effort levels Rule source: EGS v1.2 Ch.5 UB ref: ub-a0914abf17a7 (Full SOP) Enforcement: Mandatory before all non-trivial tasks

The Pre-Flight Check is SuperPortia's 30-second risk assessment before any non-trivial task. It scores three dimensions on a 0โ€“2 scale to produce a composite risk score (0โ€“6) that determines the required preparation level.

Think of it as a pilot's checklist before takeoff โ€” quick, structured, and non-negotiable.


When to useโ€‹

Every non-trivial task requires a Pre-Flight Check. "Non-trivial" means anything that:

  • Modifies production data or infrastructure
  • Involves a technical decision (engine choice, architecture, approach)
  • Touches code in multiple files
  • Has external side effects (publishing, messaging, deployments)
  • Could consume significant resources (Opus tokens, API calls)

Exceptions (no PFC needed): simple queries, reading files, UB searches, casual conversation.


The 3D scoring modelโ€‹

Three dimensions, each scored 0โ€“2:

Dimension 1: Blast Radiusโ€‹

How much does this affect if it goes wrong?

ScoreLevelDescriptionExamples
0LocalAffects only my current sessionReading a file, local search
1ShipAffects this ship (SS1/SS2/SS3)Editing code, modifying config
2FleetAffects multiple ships or external systemsCloud UB changes, publishing, deployments

Dimension 2: Knowledge Freshnessโ€‹

How confident am I in my knowledge about this task?

ScoreLevelDescriptionExamples
0TimelessFrameworks, methods, stable APIsGit commands, SQL syntax, design patterns
1RecentVerified within 30 daysLibrary versions checked this month
2PerishableFast-moving tech, unverifiedAI SDK APIs, cloud platform features, pricing

Dimension 3: Reversibilityโ€‹

How hard is it to undo this action?

ScoreLevelDescriptionExamples
0EasyUndo with one commandgit checkout, file restore
1ModerateUndo requires multiple stepsDatabase migration rollback, config changes
2HardCannot undo or very costlyPublished content, deleted data, sent messages

Risk zonesโ€‹

Add the three scores to get a composite score (0โ€“6):

ScoreZoneAction required
๐ŸŸข 0โ€“2SafeProceed directly. Standard work.
๐ŸŸก 3โ€“4CautionSearch UB first (search_brain). Check for precedents, related decisions, or known issues before proceeding.
๐Ÿ”ด 5โ€“6DangerFull preparation required: search UB + intel_search for external verification + report findings to Captain before acting.

How to run a Pre-Flight Checkโ€‹

The check takes 30 seconds maximum:

Pre-Flight Check: [task description]
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Blast Radius: [0/1/2] โ€” [reason]
Knowledge Freshness: [0/1/2] โ€” [reason]
Reversibility: [0/1/2] โ€” [reason]
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Total: [X]/6 Zone: [๐ŸŸข/๐ŸŸก/๐Ÿ”ด]
Action: [proceed / search UB / full research + report]

Example: Updating a Docusaurus configโ€‹

Pre-Flight Check: Modify docusaurus.config.js to add i18n
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Blast Radius: 1 โ€” Affects this repo only (ship-level)
Knowledge Freshness: 1 โ€” Docusaurus 3.x config verified recently
Reversibility: 0 โ€” git checkout restores immediately
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Total: 2/6 Zone: ๐ŸŸข
Action: Proceed directly

Example: Migrating Cloud UB schemaโ€‹

Pre-Flight Check: Add new column to Cloud UB D1 database
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Blast Radius: 2 โ€” Affects all ships (fleet-level, Cloud UB)
Knowledge Freshness: 2 โ€” D1 migration API, need to verify current behavior
Reversibility: 2 โ€” Column changes in production DB are hard to undo
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Total: 6/6 Zone: ๐Ÿ”ด
Action: search_brain("D1 migration") + intel_search("Cloudflare D1 ALTER TABLE")
Report to Captain before executing

Example: Running Intel Patrolโ€‹

Pre-Flight Check: Run intelligence patrol on llm_tech domain
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Blast Radius: 0 โ€” Read-only search, results go to UB staging
Knowledge Freshness: 0 โ€” Patrol system is well-understood
Reversibility: 0 โ€” UB entries can be archived if bad
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
Total: 0/6 Zone: ๐ŸŸข
Action: Proceed directly

Integration with other systemsโ€‹

Work Order systemโ€‹

Pre-Flight Checks should be performed before starting any Work Order. The check result can be noted in the WO acceptance or status update:

WO-2026-0305-001 accepted
PFC: 3/6 ๐ŸŸก โ€” searched UB for precedents, found ub-xxxx
Proceeding with verified approach

Three WOs were rejected on 2026-03-01 for the same root cause: no Pre-Flight Check was performed. This led to the enforcement principle documented in EGS Compliance.

66s Reviewโ€‹

For tasks scoring ๐Ÿ”ด 5โ€“6, a Pre-Flight Check often leads to a full 66s Review. The PFC is the quick triage; the 66s Review is the deep analysis.

PFC scoreNext step
๐ŸŸข 0โ€“2Proceed
๐ŸŸก 3โ€“4UB search, then proceed
๐Ÿ”ด 5โ€“6UB search + intel search โ†’ consider 66s Review โ†’ Captain approval

Tech Freshnessโ€‹

Dimension 2 (Knowledge Freshness) directly connects to the Tech Freshness rule. Any task involving a Danger Zone library automatically scores 2 on this dimension, pushing the total higher and requiring more preparation.


Enforcementโ€‹

The Pre-Flight Check is enforced through:

MechanismHow
Agent behavior ruleCLAUDE.md references PFC as mandatory
EGS compliance checkPer-session checklist item #5
WO rejectionCaptain rejects WOs that show no evidence of PFC
Future: automated gateHook that blocks WO status transitions without PFC record

The enforcement principle from EGS Compliance: use tools to enforce, not discipline. The goal is to build automated gates that make it impossible to skip the PFC, rather than relying on agents remembering to do it.


PageRelationship
EGS CompliancePFC is a critical compliance item
66s ReviewDeep review for high-risk tasks (PFC ๐Ÿ”ด zone)
Tech FreshnessDrives the Knowledge Freshness dimension
Agent Intelligence ProtocolAIP ยง6 Research-Before-Plan triggered by PFC ๐ŸŸก/๐Ÿ”ด
Company Constitutionยง13 Knowledge freshness mandate