Scripts
The agent runs these scripts during a design; you do not need to. They are documented here for review, debugging and contributors. Each script also prints its options with --help.
All scripts require Python 3.11 or newer, import only standard-library modules, and take --blueprint <path> and --catalog <dir> (default: the skill’s own catalog).
| Script | Reads | Writes | Exit codes |
|---|---|---|---|
tier.py |
answers |
tier |
0 ok, 2 missing or invalid answers (listed by ID), 3 environment |
size.py |
answers |
sizing, assumptions |
0 ok, 2 missing or invalid answers, 3 environment |
manifest.py |
decisions, workload.models and hardware.gpus from answers, catalog |
transfer-manifest.md |
0 ok, 2 unknown component or no answers object, 3 environment |
lint.py |
Everything | Report as text or JSON | 0 clean, 1 errors found, 3 environment |
Every script also exits 2 when blueprint.json cannot be read, holds a value the scripts cannot use, or, for a script that writes, cannot be written. Exit 3, environment, means that Python is older than 3.11 or that the catalog cannot be read or fails validation; the skill then stops and tells the user.
lint.py --catalog-only validates the catalog alone and is used in CI. It reports catalog problems as findings with exit 1; its exit 3 means that Python is too old or that the catalog folder cannot be read.
Lint codes are listed on Lint codes.