1. Install and scaffold a playbook

Put the binary on PATH, scaffold a skeleton playbook, and validate it before running anything.

After this lesson you can

- Install the config-weave binary (one file, no runtime) - Scaffold a skeleton playbook with config-weave init - Validate the whole pipeline and list the plays

config-weave ships as a single statically-linked executable per platform — download it from the releases page, put it on your PATH, done. There is nothing else to install on any machine it runs on.

config-weave init writes a working starting point: a playbook.wcl with one play, plus an example package under pkgs/core/ with a gatherer, a resource, and their wscript scripts. validate then runs the full pipeline — WCL syntax, schema, ref resolution, the step DAG, and wscript compilation of every script — without executing anything.

§ 1Exercise: Scaffold and validate

Create a skeleton playbook, validate it, and list its plays.

bash
config-weave init ./my-playbook
config-weave validate ./my-playbook
config-weave list ./my-playbook

Expected result

validate prints ok and exits 0; list prints the scaffold's play, baseline.

Hint

If validate reports a script-compilation error, the binary and the scaffold disagree — re-download the matching release.