rootstock-validator

name	rootstock-validator
description	Validate Rootstock (plan) files for completeness, correct frontmatter, resolvable library references, and Graftline readiness.
version	0.1.0
author	Jero (LATTICE / MARPA Design Studios)
triggers	["validate the plan","check the rootstock","is this plan ready","plan file check"]
tools	["Read","Glob","Grep","Bash"]

Rootstock Validator

USE WHEN the user wants to validate a plan file before running the Graftline, check if a Rootstock is complete, or diagnose why a build failed at Phase Zero.

What It Does

Validates *.plan.md files against GRAFTKIT requirements:

1. Frontmatter — YAML frontmatter must include: name, type, description, and optionally uses/deps
2. References — All uses: entries must resolve against library.yaml
3. Structure — Must contain required sections: description, tasks, acceptance criteria
4. Dependencies — All referenced packages/tools must be installable
5. Naming — File must follow *.plan.md convention

Usage

# Validate a specific plan
validate the rootstock tool.plan.md

# Check all plans in the directory
check all rootstocks

Validation Checks

Check	What It Verifies
Frontmatter parse	Valid YAML between --- delimiters
Required fields	name, type, description present
Library resolution	Every uses: entry exists in library.yaml
Task completeness	At least one task defined
Dependency check	Referenced packages exist in PyPI/npm

Output

A checklist report: check name, PASS/FAIL, details for failures.