/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