GSD Preflight Validator
SkillDev toolsUse 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the GSD Preflight Validator skill
What this skill tells your AI
The instructions your AI receives, as published by tibsfox/gsd-skill-creator in project-claude/skills/gsd-preflight/SKILL.md and read by ahel’s review.
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
Signals
- GitHub stars
- 69
- Forks
- 9
- Last commit
- Jul 2026
Advanced
- Catalog kind
- skill
- Gateway key
gsd-preflight- Source
- github.com/tibsfox/gsd-skill-creator