Skip to content

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.