Use when GSD commands are failing or .planning/ artifacts look inconsistent. Run before any GSD execute-phase or verify-work attempt to catch cross-artifact mismatches early.
Installs into .claude/skills of the current project.
Are you the author of Gsd Preflight?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/tibsfox-gsd-preflight)
---
name: gsd-preflight
description: Use when GSD commands are failing or .planning/ artifacts look inconsistent. Run before any GSD execute-phase or verify-work attempt to catch cross-artifact mismatches early.
description-frequency: on-demand
version: 1.0.0
format: 2025-10-02
triggers:
- GSD commands are failing or
updated: 2026-04-25
status: ACTIVE
---
# GSD Preflight Validator
Pre-flight checks on `.planning/` artifacts to catch issues before workflows fail.
## Core Artifact Checks
**PROJECT.md** — Sections: What This Is, Requirements, Constraints, Key Decisions
**ROADMAP.md** — Sequential phase numbers, each with Goal/Deliverables/Success Criteria
**STATE.md** — Current Position matches ROADMAP status, reasonable progress %
**config.json** — Valid JSON, valid enum values (mode, model_profile, depth)
## Cross-Artifact Consistency
- STATE.md phase exists in ROADMAP.md
- Completed phases have matching SUMMARY files for each PLAN
- Phase directories exist for all ROADMAP phases
- No orphaned files (PLAN without phase, SUMMARY without PLAN)
## Severity
| Level | Definition | Action |
|-------|------------|--------|
| BLOCKER | Will cause workflow failure | Must fix first |
| WARNING | May cause confusion | Should fix |
| INFO | Informational | No action needed |
## Common Fixes
- **STATE/ROADMAP out of sync:** Run /gsd:progress
- **Missing SUMMARY for completed plan:** Re-execute or mark incomplete
- **Invalid config.json:** Check for trailing commas, invalid values
- **Orphaned directories:** Add to ROADMAP or remove
