pre-flight

pre-flight is an agent for Claude Code from vindm/dotclaude. It costs 69 tokens per session (1,950 once invoked), scanned A, original, MIT.

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 for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter; mentions CLAUDE.md; mentions AGENTS.md.

Part of the dotclaude plugin — 7 skills, 5 agents, 5 hooks shipped together

Good fit Use it before changes that touch multiple parts of a codebase or cross boundaries such as bridges, databases, webhooks, or scheduled jobs.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/vindm/dotclaude/pre-flight
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.

Clone the repo
git clone --depth 1 https://github.com/vindm/dotclaude

Made for: Claude Code.

Or install dotclaude, the plugin that ships this one along with the rest of its 7 skills, 5 agents, 5 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pre-flight

README.md
[![agentmods](https://agentmods.dev/badge/agents/vindm/dotclaude/pre-flight/github.svg)](https://agentmods.dev/agents/vindm/dotclaude/pre-flight)
Your own site
<a href="https://agentmods.dev/agents/vindm/dotclaude/pre-flight"><img src="https://agentmods.dev/badge/agents/vindm/dotclaude/pre-flight/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pre-flight

Your own site · 80×15
<a href="https://agentmods.dev/agents/vindm/dotclaude/pre-flight"><img src="https://agentmods.dev/badge/agents/vindm/dotclaude/pre-flight.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
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. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00069 $0.01950
Opus 5.5 $0.00028 $0.00780
Sonnet 5.5 $0.00014 $0.00390
Haiku 4.5 $0.00007 $0.00195

Measured 1mo ago against content hash 02b97a492200, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 1mo ago.

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. 1mo ago 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 1mo ago), licensed MIT. It adds 69 tokens to every session and 1,950 once invoked, about $0.0003 per session on Opus 5.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

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

performance-tuner

Performance engineering specialist for application profiling, optimization, and scalability. Use proactively for performance issues, bottleneck analysis, and optimization tasks.

alirezarezvani/claude-code-tresor · 30 tokens

security-auditor

Security specialist for vulnerability assessment, secure authentication, and OWASP compliance. Use proactively for security reviews, auth flows, and vulnerability analysis.

alirezarezvani/claude-code-tresor · 32 tokens

docs-writer

Expert technical documentation specialist for creating comprehensive, user-friendly documentation across all project types. Use proactively for API docs, user guides, and technical documentation.

alirezarezvani/claude-code-tresor · 33 tokens

systems-architect

Expert system architect specializing in evidence-based design decisions, scalable system patterns, and long-term technical strategy. Use proactively for architectural reviews and system design.

alirezarezvani/claude-code-tresor · 33 tokens

root-cause-analyzer

Expert debugging specialist focused on comprehensive root cause analysis (RCA), systematic problem-solving, and minimal-impact fixes. Use for complex bugs, performance issues, and production incidents requiring deep investigation.

alirezarezvani/claude-code-tresor · 43 tokens