preflight

Use BEFORE implementing code in a project set up with this kit — loads the language rules for detected manifests, the project's CLAUDE.md, and the active task's prior handoff annotations. Replaces the

SKILL.md

GitHub

Preflight — load rules and grounding context

You are preparing to implement code. Load the project's rules and grounding context so you have the right constraints in mind. This replaces the heavy context that would otherwise be injected on every prompt.

1. Detect active languages and load rules

Check for project manifests and load the corresponding rule files:

Manifest Language Rule file
package.json JavaScript (+ React if a dep) .claude/rules/languages/javascript.md (+ javascript-react.md)
tsconfig.json TypeScript (+ React if a dep) .claude/rules/languages/typescript.md (+ typescript-react.md)
pyproject.toml / requirements.txt Python .claude/rules/languages/python.md
mix.exs Elixir (+ Phoenix if a dep) .claude/rules/languages/elixir.md (+ elixir-phoenix.md)

Only read rule files for languages actually detected in this project. shell.md has no manifest to detect — load it when editing shell scripts (*.sh).

Also read .claude/rules/quality.md and .claude/rules/rigor.md — these apply regardless of language.

2. Read project-specific and task context

Read CLAUDE.md if present, for project-specific conventions.

Read the active task's prior handoff annotations so a resuming agent picks up where the last one left off:

task project:<repo> +ACTIVE list
task <id> information

3. Scan project tree

Build spatial awareness of the project (max depth 3, max 50 entries):

ls -R --max-depth=3 | head -50

4. Check dependency versions

Read the primary manifest file (e.g., package.json, pyproject.toml) to ground yourself on actual dependency versions. Do not guess versions.

5. Print summary

Print a brief summary of what was loaded:

Preflight loaded:
  - Language rules: TypeScript, TypeScript-React
  - Quality and rigor rules
  - CLAUDE.md read
  - Active task handoff read
  - Project tree scanned (N entries)
  - Dependencies: package.json (N deps)

6. Hand off to design

You are now grounded, but grounding is not a license to start writing code. For any non-trivial creative or behavior-changing work — new functionality, an API change, a choice between approaches — invoke the brainstorming skill next (from the superpowers plugin, if installed) to work through open questions and get an approved design before any implementation begins. Only skip straight to implementation for mechanical work with no design choice (typo fixes, dependency bumps, single-line corrections).

If brainstorming isn't installed, write a short note instead covering: what you're building, the chosen approach and one rejected alternative, and how you'll know it worked — then get the user's sign-off before implementing.