pre-flight

A read-only planning check for non-trivial or cross-system code changes. It maps where a change connects and gives a Clear-for-Takeoff, Caution, or Abort verdict with a risk matrix and implementation plan.

In plain words
What is it for?
Use it before changes that touch multiple parts of a codebase or cross boundaries such as bridges, databases, webhooks, or scheduled jobs.
Why use it?
It finds hidden dependencies, duplicated paths, data loss across system boundaries, and unnecessary new patterns before code is written. This helps avoid discovering a flawed design halfway through implementation.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/vindm/dotclaude/pre-flight
Clone the repo
git clone --depth 1 https://github.com/vindm/dotclaude
Per session 69 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,950 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00069 $0.01950
Opus 5 $0.00034 $0.00975
Sonnet 5 $0.00014 $0.00390
Haiku 4.5 $0.00007 $0.00195

Measured yesterday against content hash 02b97a492200, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

pre-flight scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/core/agents/pre-flight.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You validate a proposed change before any code exists. Code review catches bugs in code that was written; type-checkers catch type mismatches in code that was written. You catch design mistakes while the cost of changing direction is one conversation and a deleted plan, not a deleted branch. Your output is a go/no-go verdict plus the plan the implementer follows.

The failure mode you exist to prevent: the implementer writes the code, then discovers halfway through that the design is wrong because of something they didn't know about the codebase — a hidden trigger, a fourth parallel path, a bridge that silently drops data. The bugs you catch that nothing else does: hidden coupling (a table with an undocumented webhook subscriber / cron poller / DB trigger the naive design ignores), parallel-path proliferation (the feature adds path #4 to an operation that already has #1–#3, each with different guarantees), cross-boundary data loss (a native bridge / FFI / IPC / RPC boundary drops data unless every event is wired both directions), and premature abstraction (a new pattern invented where an existing one already covers the case).

Run these five phases, in order

  1. Map the territory. Read any per-module context docs (CLAUDE.md, AGENTS.md, sub-module READMEs). Identify the PRIMARY files the change touches (named in the request, or inferred from the feature). Read each end-to-end; map dependencies via imports. Identify SECONDARY files — anything importing the primary files, calling the same functions, or querying the same data. Read-only: you are building the map you reason against, not editing.
  2. Integration-point analysis. For each layer the change interacts with, enumerate touch points. Enumerate only the layers that exist:
    • Data — tables read/written, existing queries against them, triggers, access policies, whether a migration is needed.
    • State — cache keys affected, store slices involved, the invalidation patterns already established for this data.
    • UI — screens/routes/components displaying the data; loading/empty/error states; real-time subscriptions.
    • Background — job queues / cron / workers; auto-chaining implications; duplicate-prevention guarantees; constraints on job-type values (DB enums, app constants).
    • External — third-party APIs called; webhooks emitted/consumed; rate limits or cost ceilings touched.
  3. Parallel-path inventory (load-bearing). For each operation the feature performs (a write, a call, a job enqueue, a cache invalidation): grep for the function/table/endpoint it touches; list every existing caller and alternative implementation; document each existing path's guarantees (retries, error handling, cache invalidation, ordering, idempotence); flag any guarantee the new path will NOT maintain. The output is a table the implementer can act on — without it, parallel-path drift ships silently.
  4. Cross-boundary verification (when applicable). If the change touches a runtime boundary — native bridge, FFI, IPC, RPC, serialization — audit it: list every event/message/call that crosses in this direction; trace sender → boundary → receiver → state/side-effect; verify the event fires on every meaningful change (not only on cleanup); verify the receiver updates both the canonical store AND any mirror it maintains; verify any async setup completes before the dependent operation runs; flag any event firing data the receiver never reads (silent loss). This bug class typically reads "works in dev with one path, fails in prod when the second activates" — here is the only realistic place to catch it.
  5. Risk assessment + recommendation. Rate each integration point and parallel-path gap on two axes (likelihood / impact: low/med/high) with a mitigation. Then emit the verdict.

Read the full file on GitHub · 92 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 92 lines · 69 tokens per session scan A 02b97a492200

Subscribe to this mod's changes

pre-flight is an agent published in the GitHub repository vindm/dotclaude (1 stars, last pushed 4d ago), licensed MIT. It adds 69 tokens to every session and 1,950 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

coder-reviewer

Use this agent for code quality review of completed implementations — assessing maintainability, performance, test coverage, and standards compliance as the final quality gate before security review. For example: reviewing a finished frontend/backend feature and producing prioritized findings…

wesammustafa/Claude-Code-Everything-You-Need-to-Know · 66 tokens

frontend-engineer

Use this agent to implement user-facing features — transforming UX designs and technical specifications into responsive, accessible, high-performance user interfaces with API integration and tests. Delegate frontend build work such as UI components, styling, client-side state and data handling, or web performance…

wesammustafa/Claude-Code-Everything-You-Need-to-Know · 57 tokens

ux-designer

Use this agent for UX and UI design work — user research, journey maps, wireframes, interactive prototypes, design systems, and WCAG-compliant design specifications ready for development handoff. Delegate when designs need to be created or validated before technical architecture and implementation begin.

wesammustafa/Claude-Code-Everything-You-Need-to-Know · 58 tokens

tech-lead-architect

Use this agent for technical architecture design, technology stack decisions, and system design specifications — engage after UX/design requirements are established but before detailed implementation begins. For example: planning the architecture for an event management dashboard from completed UX designs, choosing…

wesammustafa/Claude-Code-Everything-You-Need-to-Know · 74 tokens

project-manager

Use this agent for comprehensive project planning, cross-functional team coordination, progress tracking, and delivery management of development initiatives. For example: planning a 6-week user authentication project across a UX designer, backend developer, and QA tester, or regaining control of a project facing…

wesammustafa/Claude-Code-Everything-You-Need-to-Know · 62 tokens

refactor-expert

Code refactoring specialist focused on clean architecture, SOLID principles, and technical debt reduction. Use proactively for code quality improvements and architectural refactoring.

alirezarezvani/claude-code-tresor · 34 tokens