OpenParable
Skip to content
← Back to skills

Structural Pre Flight

Development
structural-pre-flight

Structural Pre Flight is an Agent Skill for development published in the neomjs/neo repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Authoritative pre-implementation discipline gate that fires when a new `.mjs` file is about to be authored. Stage 0 mechanical trigger; Stage 1 fast-path (sibling-file-lift pattern match) for matched patterns OR full Pre-Flight (ArchitectureOverview.md + ADR consultation + chief-architect framing) for novel directory choices. Closes the 0th-level discipline gap empirically demonstrated by `ai/daemons/wake/daemon.mjs` (originally misplaced in `ai/scripts/` as `bridge-daemon.mjs`) and `orchestrator-daemon.mjs` (PR #11008 same-class miss). Triggers: Use this skill before authoring or relocating any new `.mjs` file. Fires from `ticket-create` Stage 3 (Substrate), `ticket-intake` validation, `epic-review` Stage 3, and any direct authoring path. Sibling pattern match → 30-second fast-path; novel directory choice → full structural pre-flight before the file is written.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/neomjs/neo/blob/HEAD/.agents/skills/structural-pre-flight/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/structural-pre-flight, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Structural Pre-Flight Skill

If you are about to author or relocate a .mjs file (new module, daemon, service, script, helper, etc.), you MUST immediately use the view_file tool to read and strictly adhere to .agents/skills/structural-pre-flight/references/structural-pre-flight-workflow.md before touching the filesystem.

The skill has two stages: a 30-second sibling-pattern fast-path AND a full Pre-Flight for novel directory choices. Always emit the explicit Pre-Flight reasoning-statement so future graph-traversal can audit the architectural choice.