orientation

Validate repository context before each pipeline phase command.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/djwmobley/pipeline --skill orientation-djwmobley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orientation
Source: https://github.com/djwmobley/pipeline/tree/main/skills/orientation
Command: npx skills add https://github.com/djwmobley/pipeline --skill orientation-djwmobley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mandatory preflight ensures cwd, branch, HEAD, and worktree identity, plus the dirty flag, are correct before executing any phase command, preventing silent operation on the wrong branch.

Core Features & Use Cases

  • Preflight probe outputs six state values to verify environment before any phase.
  • Branch and worktree validation prevents actions on the wrong context and stops progression when mismatches are detected.
  • Consistency guard runs before each phase (build, review, qa, redteam, audit, remediate, commit, finish) to maintain a safe, reproducible workflow.

Quick Start

Run node scripts/preflight-probe.js to emit the six context values and verify readiness.

Frequently Asked Questions about orientation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate my git branch and worktree state before running a build pipeline?

To validate your git branch and worktree state before a build pipeline, run a preflight probe that checks your cwd, branch, HEAD, and dirty flag to prevent silent operation on the wrong context.

What is a preflight probe for repository context validation?

A preflight probe for repository context validation is a mandatory check that outputs six state values, ensuring your cwd, branch, HEAD, worktree identity, and dirty state are correct before executing any phase command.

How do I stop pipeline execution when my working directory and HEAD mismatch?

To stop pipeline execution when your working directory and HEAD mismatch, use a consistency guard that signals misalignment during preflight, halting progression before phase commands like commit or review execute.

Does preflight validation work with git worktrees and dirty state flags?

Yes, preflight validation works with git worktrees and dirty state flags by explicitly enforcing worktree identity and checking the dirty flag to maintain a safe, reproducible workflow across all phase commands.

Do I need to run a preflight probe before every phase command like review or commit?

Yes, you need to run a preflight probe before every phase command, including build, review, qa, redteam, audit, remediate, commit, and finish, to enforce environment consistency and prevent silent operation.