| 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:
- Frontmatter — YAML frontmatter must include: name, type, description, and optionally uses/deps
- References — All
uses: entries must resolve against library.yaml
- Structure — Must contain required sections: description, tasks, acceptance criteria
- Dependencies — All referenced packages/tools must be installable
- 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.
