gaia-val-validate-plan

Validate GAIA implementation plans for file targets, version bumps, and ADR references.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-val-validate-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-val-validate-plan
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-val-validate-plan
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-val-validate-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Currently, teams running GAIA plans risk executing plans with missing targets, non-sequential version bumps, or ADRs that are out of date, leading to failed deployments and misaligned architectures.

Core Features & Use Cases

  • Plan integrity checks across file targets, version bumps, and ADR references.
  • Exposes a structured set of findings with severity labels and plan-step mapping for fast remediation.
  • Supports end-to-end validation prior to execution, preventing regressions and deployment failures.

Quick Start

Provide the path to a plan artifact to run the GAIA plan validator against.

Frequently Asked Questions about gaia-val-validate-plan

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

FAQPage Schema
How do I validate implementation plans to catch missing file targets and version issues before execution?

To validate implementation plans, you can run a plan validator against your plan artifact to identify misconfigurations in file targets, version bumps, and ADR references before execution. This prevents failed deployments by producing actionable findings with severity labels and plan-step mapping.

What does plan validation check for in GAIA workflows?

Plan validation in GAIA workflows checks target existence, version sequencing, and architecture alignment in plan artifacts. It verifies file targets, version bumps, and ADR references to prevent regressions and deployment failures caused by out-of-date architecture decisions.

How do I check if my version bumps are sequential and ADRs are aligned in my plan artifacts?

You can check version bump sequencing and ADR alignment by running a validation process on your plan artifacts. This process requires access to plan artifacts, memory loader context, and ADR-guided architecture guidance to produce structured findings with severity labels for fast remediation.

Can I validate a plan artifact without access to memory loader context and ADR guidance?

No, validating a plan artifact requires access to plan artifacts, memory loader context, and ADR-guided architecture guidance. Without these inputs, the validator cannot perform checks on target existence, version sequencing, and architecture alignment to produce actionable findings.

What is the best way to prevent deployment failures caused by misaligned architectures in implementation plans?

The best way to prevent deployment failures from misaligned architectures is to perform end-to-end plan validation prior to execution. This validates file targets, version bumps, and ADR references, exposing a structured set of findings with severity labels and plan-step mapping for fast remediation.

Why does my plan validation fail when checking ADR references and architecture alignment?

Plan validation may fail when checking ADR references if the architecture decisions in your plan artifacts are out of date or misaligned. The validator requires ADR-guided architecture guidance and memory loader context to verify architecture alignment and produce accurate findings.